Adopt the shared interface pattern language

2026-08-04 08:21:50 +02:00
parent 06f93f4f7a
commit 629f76440b
7 changed files with 102 additions and 1 deletions
@@ -0,0 +1,30 @@
+# 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