droboticflow/.agents/ORIGINAL_REQUEST.md

3.4 KiB
Raw Permalink Blame History

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 交付清单。