2.3 KiB
Workflow Interface Pattern Migration
Workflow is the optional visual authoring and inspection surface for the headless Workflow Engine. It composes native BPMN graph editing, immutable revision inspection, governed activation, and instance evidence without owning runtime persistence or importing module-private action implementations.
| Surface | Task and archetype | Consequence and state contract |
|---|---|---|
/workflow definition catalogue |
List-detail workspace | Search, loading, empty, selected, current/historical revision, baseline, override, and update-available states retain definition context. |
| Native BPMN graph | Specialized create/edit workspace | Palette nodes can be dragged or added with keyboard activation. Nodes and edges can be selected, edited, reconnected, or removed through explicit controls; drag is not the only path. |
| Definition settings and derivation | Governed create/edit dialogs | Scope, kind, execution mode, inherited visibility, reuse, automation, and immutable View revision expose field help and policy provenance. |
| Validate/save/activate/archive/delete/reset | Review and consequential actions | Validation diagnostics identify graph elements. Save creates a revision; activation changes the runnable revision; archive/delete/reset use explicit state gates and Core confirmation dialogs. |
| Runs dialog and open-work widget | Monitoring, progress, and human decision | Instance/step status, handoff instructions, evidence references, transitions, retries, cancellation, reconciliation, failures, and partial outcomes remain durable Workflow Engine evidence. |
Core owns buttons, icon buttons, dialog/focus behavior, alerts, status, form help, toggles, selectors, unsaved-navigation protection, and documentation help. The graph itself is the authorized domain-specific editor. Module standards and optional Views/Policy integrations are consumed through public capabilities. Responsive layouts move catalogue, palette, graph, and inspector into task order; reduced-motion preferences disable editor animation as a source of meaning.
Verification:
npm run typechecknpm run test:interface-pattern- Workflow editor and Workflow Engine backend suites
- manifest shape, optional-module permutations, structural localization, theme, and full-product bundle-budget checks