docs: add workflow migration plan and checkpoint current state

2026-04-07 08:38:16 +02:00
parent 2a00abe91f
commit bc9ab5f864
5 changed files with 322 additions and 15 deletions
@@ -0,0 +1,95 @@
+# Workflow Delivery Checklist
+
+## Phase Checklist
+
+### Phase 1
+
+- [ ] Canonical workflow schema finalized
+- [ ] Frontend and backend workflow types aligned
+- [ ] Preset workflow migration helpers added
+- [ ] Tests added for legacy preset conversion
+- [ ] Legacy dispatch remains default
+
+### Phase 2
+
+- [ ] Node registry implemented
+- [ ] Node definitions API available
+- [ ] All required nodes have settings schemas
+- [ ] Editor consumes node definitions from backend
+
+### Phase 3
+
+- [ ] Missing legacy steps extracted into reusable executors
+- [ ] Extracted node behavior matches legacy services
+- [ ] Node-level tests cover success and failure paths
+
+### Phase 4
+
+- [ ] Workflow context introduced
+- [ ] Node outputs are persisted and reusable
+- [ ] Graph runtime supports legacy fallback
+- [ ] `legacy`, `graph`, and `shadow` modes exist
+
+### Phase 5
+
+- [ ] Editor saves nodes and edges
+- [ ] Editor roundtrip preserves workflow configs
+- [ ] All node settings are editable
+- [ ] Validate, dry-run, and dispatch are available
+- [ ] Runs are visible with node-level status and logs
+
+### Phase 6
+
+- [ ] Shadow mode parity checks run on real workflows
+- [ ] Golden cases pass against legacy outputs
+- [ ] Rollout can be enabled per workflow or output type
+- [ ] Rollback to legacy is immediate
+
+## Quality Gates
+
+### QG-1: Model Gate
+
+- New workflow saves only use canonical schema.
+- Backend rejects malformed configs with clear errors.
+- Existing preset workflows can be migrated without data loss.
+
+### QG-2: Node Gate
+
+- Every editor-visible node has:
+  - backend node definition
+  - validated settings schema
+  - default params
+  - executor coverage or explicit disabled status
+
+### QG-3: Legacy Safety Gate
+
+- Legacy render dispatch remains callable and unchanged in behavior.
+- Existing output types still render without workflow migration.
+- Graph failures do not block legacy renders.
+
+### QG-4: Parity Gate
+
+- Golden cases match on:
+  - render status
+  - generated output file
+  - media asset creation
+  - notifications
+  - core render log fields
+
+### QG-5: Editor Gate
+
+- Workflow configs survive save/load roundtrip without loss.
+- Invalid graphs are blocked before dispatch.
+- All node settings needed for parity are present in the editor.
+
+### QG-6: Rollout Gate
+
+- Shadow mode has been exercised on representative workflows.
+- Graph runtime error rate is at or below legacy error rate.
+- Rollout and rollback are possible per workflow or output type.
+
+## Definition of Done
+
+- `/workflows` is production-capable for authoring and running workflows.
+- Legacy functionality is available in graph form with parity coverage.
+- Legacy execution still exists as a supported fallback.