31 lines
2.3 KiB
Markdown
31 lines
2.3 KiB
Markdown
# 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 typecheck`
|
|
- `npm 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
|