Files
dacli/docs/decisions/0006-workflow-create-startformid.md
T

2.0 KiB

0006-workflow-create-startformid

日期: 2026-07-17 状态: Accepted 作者: claude-code

Context

dacli workflow create 创建工作流时, 必须绑定一个发起表单 (startFormId)。当 --ai 模式或手动模式未传 --startFormId 时, 工作流创建成功但前端访问时报 workFlowForm/undefined.vue 错误 — 发起表单路由未正确绑定。

BS-E3 首次记录: jxcj auditrecord 工作流创建时未指定 startFormId, 浏览器访问流程发起页面 404。

影响范围: AP-wc-1, 涉及所有 workflow create 调用。

Decision

dacli workflow create 强制必传 --startFormId=<formId>, 命令行 parseArgs 阶段校验。formId 必须是已发布表单的 ID (state=1)。

工作流创建前, 用户需:

  1. dacli form list --state=1 确认目标表单已发布
  2. 记下 formId
  3. dacli workflow create --startFormId=<formId> ...

CLAUDE.md § dacli 已知限制 提到 workflow 必传参数规则。

Alternatives Considered

  1. dacli 从 formId 自动推导 startFormId: workflow create 可能同时传入 --formId (流程绑定的表单), dacli 可以直接复用为 startFormId。但 workflow 可能绑定多个 form, 发起表单不一定是主表单, 自动推导不可靠。
  2. workflow create --ai 自动匹配: AI 模式下, 让 user 在描述中指明 "发起表单为 xxx", NCPF backend 解析填充。同样不可靠 (依赖 LLM 准确率)。
  3. 创建后再绑定: JNPF web 端支持事后修改发起表单, dacli 可以先创建 workflow 再调 API 绑定。但增加 API 调用数, 且部分场景下发起的 workflow 无法修改。

Consequences

正面

  • 明确的参数要求, 消除 workflow 创建后无法发起的静默错误
  • 命令行校验在 parseArgs 阶段即报错, 不等到 API 调用

负面

  • 用户需额外查询 formId, 多一步操作
  • CLI 不提供事后修复路径 (需跳转到 web 端操作)

Cross-refs

  • ANTI_PATTERNS: AP-wc-1
  • BS-E3: 原始问题报告
  • CLAUDE.md § dacli 已知限制: workflow 必传参数