Files
dacli/docs/cmd-review/workflow.md
T
sswandClaude b9c9e318af feat(v0.11+): Phase 1 - 23 个 dacli 父命令审计完成
派 25 个 Explore 子代理 (5 批 × 5) 审计 23 个父命令.
产出 cmd-review/{cmd}.md (24 文件) + _summary.md.

关键发现:
- webapi 镜像使用率 < 30% (12+ 父命令 100% 绕 webapi)
- 30+ P0 必补新命令 (form update, log exception, di CRUD, role authorize 等)
- 3 处 P0 端点错误 (假 PASS):
  * integration emailTest/smsTest
  * msg templateCreate
- 用户关键修正: bigscreen → jnpf-web-datascreen-vue3 (独立子项目)
- 用户关键修正: report → jnpf-web-datareport (独立子项目)

下一步: Phase 2 按 P0 优先级执行 (修端点 + 新命令 + webapi 化)

Co-Authored-By: Claude <[email protected]>
2026-06-25 14:58:32 +08:00

11 KiB

dacli workflow 命令审计 (v0.11+)

1. 命令清单

命令 别名 API 用途
workflow list - GET /api/workflow/template 或 /api/workflow/operator/List/{type} 流程模板列表 / 我的待办 (--todo=1/2/3)
workflow create - POST /api/workflow/template 新建流程模板 (--ai 走平台 LLM)
workflow launch - POST /api/workflow/task 发起流程实例 (formId + flowId + data)
workflow approve - POST /api/workflow/operator/Audit/{operatorId} 审批 (status: 0同意/1不同意/2退回)
workflow selector select web getFlowSelector 流程模板下拉框 (菜单挂工作流必跑)
workflow decision - GET /api/workflow/template/{id}/DecisionParameter 决策流参数 (5.6.5 漏斗/覆盖/规则集等)

公开命令: 6 个 (list/create/launch/approve/selector/decision)


2. web 端对应

2.1 web API 文件结构

  • web/.../api/workFlow/template.ts (138 行, 25+ 函数) — 流程模板管理

    • getList/getFlowList/create/update/getInfo/delFlow/copy/exportData/changeType/saveFlow/getFlowInfo/getVersionList/delVersion/copyVersion/upDownShelf
    • getFlowSelector/getTreeList/getFlowEngineListByIds/getCollectFlowList/setCollectFlow/getSubFlowUserList
    • getDecisionParameter/getCommentList/createComment/delComment/getWebhookUrl/getWebhookParams/webhookStart/getAiInfo
  • web/.../api/workFlow/task.ts (181 行, 35+ 函数) — 流程运行时

    • getFlowLaunchList/getFlowTaskInfo/create/update/delFlowLaunch/launchRecall/revoke/press/getLogList
    • getFlowBeforeList/batchSign/sign/cancelSign/batchHandle/handle/audit
    • transfer/assist/batchOperation/getBatchCandidate
    • freeApprover/reduceApprover/saveAudit/saveAssist/auditRecall/back/getBackNodeCodeList
  • web/.../api/workFlow/flowMonitor.ts (51 行, 11 函数) — 流程监控

    • getFlowMonitorList/delMonitorList/getLogList/cancel/assign/resurgence/getPauseType/pause/reboot/getFlowTodoCount/getFlowTodoList
  • web/.../api/workFlow/flowDelegate.ts (42 行, 10 函数) — 流程委托

    • getFlowDelegateList/create/update/getInfo/del/getDelegateUser/stop/getFlowDelegateInfo/notarize

2.2 JNPF 后端 API 路由

  • 模板管理: POST /api/workflow/template PUT /api/workflow/template/{id} DELETE /api/workflow/template/{id}
  • 流程实例: POST /api/workflow/task PUT /api/workflow/task/{id}/Recall/{id}
  • 审批操作: POST /api/workflow/operator/Audit/{operatorId} Transfer AddSign ReduceApprover
  • 决策流: GET /api/workflow/template/{id}/DecisionParameter
  • 委托: POST /api/workflow/delegate PUT /api/workflow/delegate/{id}/Stop
  • 监控: POST /api/workflow/monitor/Cancel/{id} Pause Reboot Assign

3. 改/删/留 建议

3.1 [KEEP] — 保留命令

命令 价值 改进
workflow list AI 看流程模板 / 我的待办 仍用 c.get, 建议 REFACTOR-WEBAPI
workflow create AI 核心场景, --ai 走 LLM v0.11 已对齐后端字段
workflow launch AI 端到端 (form → workflow) 依赖 BS-44 bindFlow 闭环
workflow approve AI 审批场景 缺批量 + 转办/委派, 需补充
workflow selector v0.11+ 已 webapi 新范式典型
workflow decision 5.6.5 决策流参数 只读, 写更新留 v0.10+

3.2 [REFACTOR-WEBAPI] — 切换 webapi

命令 现状 建议 理由
list c.get 手写 URL loadWorkflow.getList 或 getFlowSelector selector 已 webapi, list 应一致
approve c.postJson 手写 loadWorkflow.audit(id, data) 或 task.ts 复杂审批 API 多, webapi 统一
decision c.get 手写 loadWorkflow.getDecisionParameter webapi 已有, 切一致性
launch c.postJson 手写 webapi 应补 task.ts (useUserStore 限制) 需决策是否 shim useUserStore

3.3 [DEPRECATE] — 标记废弃

无: 当前 6 个命令均有 AI 场景, 不建议删除

3.4 [NEW-CMD] — 新增命令 (按优先级)

优先级 P0 (核心)

  1. workflow info <id> — 流程模板详情

    • API: GET /api/workflow/template/{id} (web getInfo)
    • 场景: AI 创建流程后查看 flowNodes/flowConfig/flowXml 完整 schema
  2. workflow update <id> — 修改流程模板

    • API: PUT /api/workflow/template/{id} (web update)
    • 场景: AI 调整流程 (改 flowNodes, 改分类), 修复错误流程
  3. workflow delete <id> — 删除流程模板

    • API: DELETE /api/workflow/template/{id} (web delFlow)
    • 场景: AI 清理测试流程
  4. workflow tasks — 我的待办 (细分)

    • API: GET /api/workflow/operator/List/{1|2|3} (web getFlowBeforeList)
    • 场景: AI 审批前查 todo, 区分 list --todo=1

优先级 P1 (常用)

  1. workflow done — 已审批查询 (type=2)

  2. workflow transfer <operatorId> — 转办

    • API: POST /api/workflow/operator/Transfer/{operatorId} (web transfer)
  3. workflow delegate <operatorId> — 委派

    • API: POST /api/workflow/operator/Assist/{operatorId} (web assist)
  4. workflow recall <taskId> — 撤回发起

    • API: PUT /api/workflow/task/Recall/{taskId} (web launchRecall)
  5. workflow revoke <taskId> — 撤销流程

    • API: PUT /api/workflow/task/Revoke/{taskId} (web revoke)
  6. workflow copy <id> — 复制流程

    • API: POST /api/workflow/template/{id}/Actions/Copy (web copy)
  7. workflow version <id> — 流程版本管理

    • API: getVersionList/copyVersion/delVersion/upDownShelf
    • 场景: AI 版本切换 (生产/灰度)

优先级 P2 (边缘)

  1. workflow export <id> — 导出 (web exportData)
  2. workflow import <file> — 导入
  3. workflow monitor <taskId> — 监控 (pause/cancel/reboot)
  4. workflow delegate-config — 委托规则配置 (web flowDelegate.ts)

4. AI 痛点评估

4.1 form bindFlow 闭环 (BS-44 / D-7)

现状: form.bindFlow 走三步 API (PUT form + PUT workflow + Release), 但 backend PUT workflow onLineformId 不一定落库, 完整绑定可能仍需 web UI。

痛点: AI 创建 form → launch workflow 可能报"流程未绑定", BS-44 风险仍在。

建议: 加 --verify 标志验证绑定, 文档明示局限。

4.2 selector 闭环 vs 其他

selector ✓ (闭环): webapi 已切, AI dacli workflow selector --json 拿模板列表传给 menu.create, 完美闭环。

list ✗ (半闭环): 仍用 c.get 手写, selector 已 webapi, list 应一致。

launch ✗ (盲点): 依赖 form.enableFlow + flowId, 但 bindFlow 可能不完整。

4.3 AI 审批场景

现状: workflow approve 存在 (单审批), workflow tasks (我的待办) 缺。

缺失:

  1. 转办 (transfer) — AI 委托代理无命令
  2. 委派 (delegate/assist) — AI 多人协办无命令
  3. 加签/减签 (freeApprover/reduceApprover) — AI 动态调整审批人无命令
  4. 批量审批 (batchOperation) — AI 批量处理无命令

建议: 至少补 transfer + delegate (P1), 加签减签 P2。

4.4 流程版本管理

现状: web template.ts 有 getVersionList/copyVersion/delVersion/upDownShelf (10+ 函数), dacli 完全无版本管理命令。

业务场景: AI 创建流程 → 上线 v1 → 调整 → 上线 v2 (灰度), web 走 tdp_workflow_template.version 字段。

建议: P1 加 workflow version 命令 (list/add/del/switch), P2 加 up-down-shelf。

4.5 决策流闭环

现状: decision 命令只读, AI 决策流配置需解析 FlowConfigModel + 跟现有 flowConfig 合并。

建议: 短期保留只读, --list 加缓存; 长期 v0.12+ 加 update 支持。

4.6 运行时 API (task.ts) 加载

现状: webapi/workflow.ts 只加载 template.ts (25+ 函数), task.ts 未加载因为 useUserStore 依赖。

影响: workflow runtime (launch/approve/recall) 走手写 c.postJson, 维护成本高。

建议: 中期 shim useUserStore 后加载 task.ts, 决策点: 是否值得为 task.ts 增加 shim 复杂度?


5. 优先级矩阵

命令 当前状态 改/留 优先级 理由
list c.get 手写 REFACTOR-WEBAPI P1 selector 已 webapi, 应一致
create webapi 待加 保留 + webapi P1 核心, AI 创建高频
launch c.postJson 手写 保留 (考虑 webapi) P1 核心, BS-44 风险
approve c.postJson 手写 REFACTOR-WEBAPI P1 复杂 API 多, webapi 统一
selector webapi ✓ 保留 - 新范式
decision c.get 手写 REFACTOR-WEBAPI P2 webapi 已有
info <id> 缺 NEW-CMD P0 AI 创建后查看 schema
update <id> 缺 NEW-CMD P0 AI 修改流程
delete <id> 缺 NEW-CMD P0 AI 清理
tasks 部分 (list --todo) NEW-CMD P0 细分语义
done 部分 (list --todo=2) NEW-CMD P1 独立语义
transfer 缺 NEW-CMD P1 AI 转办
delegate 缺 NEW-CMD P1 AI 委派
recall 缺 NEW-CMD P1 AI 撤回
revoke 缺 NEW-CMD P1 AI 撤销
copy 缺 NEW-CMD P1 AI 复制修改
version 缺 NEW-CMD P1 AI 版本管理
export 缺 NEW-CMD P2 AI 导出
import 缺 NEW-CMD P2 AI 导入
monitor 缺 NEW-CMD P2 AI 管理员介入
delegate-config 缺 NEW-CMD P2 AI 委托规则配置

6. 实施路线图

Phase 2A (立即, 2-3 天)

  1. REFACTOR-WEBAPI: list/decision/approve 切 webapi/workflow.ts
  2. NEW-CMD P0: info/update/delete (3 个基础 CRUD)
  3. 文档同步: BS-44/bindFlow 闭环说明

Phase 2B (短期, 5-7 天)

  1. NEW-CMD P0: tasks/done (细分 list --todo)
  2. NEW-CMD P1: transfer/delegate/recall/revoke (4 个审批操作)
  3. task.ts shim 评估 (useUserStore mock)

Phase 2C (中期, 7-10 天)

  1. NEW-CMD P1: copy/version (流程版本管理)
  2. NEW-CMD P2: export/import (BPMN 导入导出)
  3. monitor 命令 (管理员场景)

7. 总结

dacli workflow 命令 6 个公开 + decision 已覆盖核心 (模板/发起/审批/决策), 但相对 web API (70+ 函数) 覆盖严重不足:

强项:

  • selector 已 webapi 化 (新范式典型)
  • create --ai 走平台 LLM (白皮书 5.10.3)
  • bindFlow BS-44 已文档化

弱点:

  • 6 命令中 4 个仍走 c.get/postJson 手写, webapi 一致性差
  • 缺核心 CRUD: info/update/delete (web 有, dacli 无)
  • 缺审批闭环: transfer/delegate/recall/revoke (web 有 10+ 审批操作)
  • 缺版本管理: version/copy (web 有, 业务高频)
  • form bindFlow 闭环仍存 BS-44 风险

关键改进 (Top 5):

  1. REFACTOR-WEBAPI: list/decision/approve 切 webapi (一致性)
  2. NEW-CMD P0: info/update/delete (基础 CRUD)
  3. NEW-CMD P0: tasks (细分我的待办)
  4. NEW-CMD P1: transfer/delegate (审批闭环)
  5. NEW-CMD P1: version (版本管理)