7.6 KiB
7.6 KiB
Project: droboticflow Dual-Track Workflow Execution Isolation (Debug Run vs Production Run)
Architecture
The system establishes strict dual-track isolation between Production Runs (正式运行) and Debug Runs (调试运行) across the entire lifecycle:
- Frontend Experience:
- Dual action buttons in the Workflow Editor: Orange 【调试运行】 (Debug Run) and Green/Blue 【正式运行】 (Production Run).
- Production Data Input Panel: Exclusively exposes root workflow input ports (
syncRootWorkflowInputs), rendering all intermediate nodes and hyperparameters as collapsed, read-only sections with "🔒 已锁定不可篡改". - Developer Debug Console: Enables instant node hyperparameter overrides, dev/poc environment switching, and step/single-node execution on draft workflows.
- Monitoring & Project Views: Dedicated
modefilter (all|production|debug) with distinct visual badges and temporary artifact indicators.
- Backend Security & API Layer:
POST /api/workflow-releases/:id/runs: Dedicated production execution endpoint bound strictly to immutableWorkflowReleaseRecord. Returns HTTP422 production_input_forbiddenif any non-root inputs, node overrides, or topology modifications are present.POST /api/workflows/:id/run: Supports debug execution with transientnodeOverrides,debugTarget(single-node or subtree), and draft state execution.- Immutable metadata binding for production runs (
mode: "production",releaseId,workflowVersion,gitCommitSha,imageDigest).
- Execution Engine & Worker:
- Worker runtime applies
NodeOverridesduring execution without mutating the database workflow record. - Support for single-node execution targets and transient execution states.
- Worker runtime applies
- Metrics, Delivery & Audit Isolation:
- Workforce calculations (
dashboard_workforce.go) and platform metrics (memory.go:BuildDashboardSummaryAt) strictly filter out debug runs/events. - DeliveryPackage creation and listing isolate production deliverables; debug artifacts are tagged as temporary.
- Workforce calculations (
Feature Inventory
| # | Feature | Description | Milestone | Source |
|---|---|---|---|---|
| F1 | RunMode Domain & Storage Models | Add RunMode (production / debug) and provenance fields (ReleaseID, WorkflowVersion, GitCommitSha, ImageDigest, NodeOverrides, DebugTarget) to RunRecord, RunSummary, RunSummaryQuery, and update Memory/Mongo stores |
M1 | Survey (Backend/Metrics) |
| F2 | Metrics & Worklog Event Domain Models | Add Mode and temporary tagging to AnnotationWorklogEventRecord, DeliveryPackageRecord, and ExecutionArtifact |
M1 | Survey (Metrics) |
| F3 | Production Run Release API & Security Gate | Implement POST /api/workflow-releases/:id/runs with 422 production_input_forbidden rejection for non-root inputs or parameter tampering |
M2 | Survey (Backend) & R1/R2 |
| F4 | Debug Run API & Node Overrides | Enhance /api/workflows/:id/run for draft execution, transient node overrides, and single-node debug targeting |
M2 | Survey (Backend) & R1/R2 |
| F5 | Worker Runtime Transient Overrides & Single-Node | Enable worker scheduler to execute single nodes and apply per-run node parameter overrides | M2 | Survey (Backend) & R1 |
| F6 | Workforce Metrics Isolation | Filter out debug events from QualityPassRate, AcceptancePassRate, ReworkRate, and DurationSeconds in dashboard_workforce.go |
M3 | Survey (Metrics) & R4 |
| F7 | DeliveryPackage & Artifact Isolation | Isolate formal DeliveryPackages to production runs and tag debug artifacts as temporary | M3 | Survey (Metrics) & R4 |
| F8 | Frontend Action Bar Dual Triggers | Dual action buttons (Debug Run vs Production Run) in WorkflowEditor.tsx & WorkflowEditorControls.tsx |
M4 | Survey (Frontend) & R3 |
| F9 | Production Data Input Panel with Locked Nodes | Modal showing root inputs with intermediate nodes locked ("🔒 已锁定不可篡改") | M4 | Survey (Frontend) & R3 |
| F10 | Developer Debug Console UI | Modal supporting node parameter overrides, dev/poc env selector, and step/single-node execution | M4 | Survey (Frontend) & R3 |
| F11 | Monitoring Center & History Mode Filters | Add mode filter (all / production / debug) and badges to Monitoring.tsx, monitoring.ts, and ProjectDetail.tsx |
M5 | Survey (Frontend) & R4 |
| F12 | Comprehensive E2E Testing Suite | Requirements-driven 4-tier test suite covering R1-R4 acceptance criteria | E2E Track | Survey (Metrics) & AC |
| F13 | Final Integration & Adversarial Hardening | Pass 100% E2E tests + Tier 5 white-box adversarial verification | M6 | Survey & Dual Track |
Milestones
| # | Name | Scope | Dependencies | Status |
|---|---|---|---|---|
| M1 | Domain Models & Storage Persistence | internal/domain, internal/store (RunMode, RunRecord, RunSummary, Store queries) |
none | DONE |
| M2 | Backend APIs, Security Gate & Worker Engine | internal/api (/api/workflow-releases/:id/runs, 422 gate, debug run), internal/worker (overrides, single-node) |
M1 | IN_PROGRESS |
| M3 | Metrics, Delivery & Audit Isolation | internal/api/dashboard_workforce.go, internal/api/delivery_packages.go, internal/worker/human_release.go |
M1, M2 | PLANNED |
| M4 | Frontend Workflow Editor Dual-Track Controls & Modals | src/pages/WorkflowEditor.tsx, src/components/WorkflowEditorControls.tsx, src/lib/workflow-editor.js |
M2 | PLANNED |
| M5 | Frontend Monitoring & History Mode Filters | src/pages/Monitoring.tsx, src/services/api/monitoring.ts, src/pages/ProjectDetail.tsx |
M1, M2 | PLANNED |
| M6 | Final Verification & Adversarial Hardening | 100% E2E test suite pass + Tier 5 adversarial testing loop | M1, M2, M3, M4, M5, E2E Track | PLANNED |
Interface Contracts
Client ↔ Backend API
- Production Run:
POST /api/workflow-releases/:id/runs- Request Body:
{ "trigger": "manual", "inputs": { [portKey: string]: ArtifactPayload } } - Response:
202 AcceptedwithRunRecord(wheremode: "production",releaseId,workflowVersion,gitCommitSha,imageDigest). - Error on tampering:
422 Unprocessable Entitywith{ "error": "...", "code": "production_input_forbidden", "issues": [...] }.
- Request Body:
- Debug Run:
POST /api/workflows/:id/run- Request Body:
{ "trigger": "manual", "mode": "debug", "inputs": { ... }, "nodeOverrides": { [nodeId: string]: NodeOverride }, "debugTarget": { "targetNodeId": string, "singleNode": boolean } } - Response:
202 AcceptedwithRunRecord(wheremode: "debug").
- Request Body:
- Run Query:
GET /api/runs?mode=production|debug|all&status=...&projectId=...- Response: Paginated list of
RunSummaryrecords matching the mode filter.
- Response: Paginated list of
Code Layout
internal/domain/: Domain models (types.go,workflow_release.go,workflow_inputs.go,delivery_package.go,annotation_operations.go).internal/store/: Store interfaces & implementations (store.go,memory.go,mongo.go).internal/api/: REST handlers (server.go,workflow_releases.go,dashboard_workforce.go,delivery_packages.go,tenant.go).internal/worker/: Workflow execution runtime (runtime.go,executor.go,human_release.go).src/lib/: Frontend utilities (workflow-editor.js,workflow-inputs.js).src/components/: Frontend components (WorkflowEditorControls.tsx,WorkflowEditorModals.tsx, etc.).src/pages/: Frontend pages (WorkflowEditor.tsx,Monitoring.tsx,ProjectDetail.tsx,Dashboard.tsx).src/services/api/: Frontend API clients (workflows.ts,monitoring.ts,workflow-releases.ts).tests/: Automated tests (tests/frontend/, backend Go tests ininternal/*).