forked from longtao.wu/droboticflow
3.4 KiB
3.4 KiB
Original User Request
2026-08-19T16:11:00Z
实现工作流“调试运行(Debug Run)”与“正式运行(Production Run)”的双轨隔离体系。正式运行严格绑定不可变工作流发布版本(WorkflowRelease),在运行触发时仅允许配置/修改无前置依赖的根输入算子端口(Root Inputs),全面锁定中间节点参数、拓扑结构与算子版本;调试运行支持画布草稿态即时运行、任意中间节点参数覆盖、单步调试与子树重跑,并实现运行历史与统计数据的环境隔离。
Working directory: /Users/d-robotics/workSpace/droboticflow Integrity mode: demo
Requirements
R1. 运行模式与触发入口严格解耦
- 正式运行(Production Run):必须基于已发布的不可变
WorkflowRelease发起,禁止在未发布的草稿态直接发起正式运行。触发运行弹窗仅暴露根输入表单(syncRootWorkflowInputs),禁止编辑中间节点的超参数、输入端口映射或算子镜像版本。 - 调试运行(Debug Run):允许直接基于工作流草稿(Draft)发起,允许开发者在触发时覆盖任意节点的超参数或注入特定测试输入,支持单节点执行与子树重跑。
R2. 后端校验与不可变性安全门禁
- 在正式运行 API(
/api/workflow-releases/:id/runs)中增加服务端强校验:若请求携带任何非根节点的输入修改或超参数篡改,直接拒绝并返回422 production_input_forbidden。 - 正式运行的元数据显式标记
mode: "production"并固化releaseId、workflowVersion与精确gitCommitSha/imageDigest。
R3. 前端工作流编辑器与运行弹窗体验分离
- 编辑器顶部提供清晰的 【调试运行】(橙色/黄色标识)与 【正式运行 / 发布版本运行】(绿色/蓝色标识)双操作入口。
- 正式运行弹窗精简为“生产数据输入面板”,自动列出所有根算子的输入字段(如 BOS 路径、数据源目录、批次 ID 等),其余节点呈现折叠/只读状态并显示“🔒 已锁定不可篡改”。
- 调试运行面板提供完整的“开发调试控制台”,支持节点参数即时 override、环境切换(dev/poc)与局部调试。
R4. 运行历史、指标统计与审计隔离
- 在监控中心(
/monitoring)和项目详情页提供production与debug运行环境过滤器。 - 供应商绩效、工时统计、正式交付产物(DeliveryPackage)仅统计
production模式的 Run,调试运行产生的产物自动标记临时标签,避免污染正式生产数据与看板指标。
Acceptance Criteria
API 与安全门禁
- 尝试在正式运行请求中篡改中间节点参数时,API 返回 422 错误且错误码为
production_input_forbidden。 - 正式运行仅读取
rootNodeIds对应的输入端口配置,能正确传递给根算子并顺利执行全流程。 - 调试运行支持直接在草稿态运行,并正确应用单节点参数 override。
前端交互与表单
- 工作流编辑器提供明确区分的“调试运行”与“正式发布运行”入口。
- 正式运行弹窗仅渲染根输入表单,中间节点参数与算子信息展示为只读锁定状态。
- 监控列表与项目运行历史支持按
production / debug筛选。
生产数据与审计隔离
- 调试运行不计入供应商正式产出看板与 DeliveryPackage 交付清单。