派 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]>
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/upDownShelfgetFlowSelector/getTreeList/getFlowEngineListByIds/getCollectFlowList/setCollectFlow/getSubFlowUserListgetDecisionParameter/getCommentList/createComment/delComment/getWebhookUrl/getWebhookParams/webhookStart/getAiInfo
-
web/.../api/workFlow/task.ts(181 行, 35+ 函数) — 流程运行时getFlowLaunchList/getFlowTaskInfo/create/update/delFlowLaunch/launchRecall/revoke/press/getLogListgetFlowBeforeList/batchSign/sign/cancelSign/batchHandle/handle/audittransfer/assist/batchOperation/getBatchCandidatefreeApprover/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/templatePUT /api/workflow/template/{id}DELETE /api/workflow/template/{id} - 流程实例:
POST /api/workflow/taskPUT /api/workflow/task/{id}/Recall/{id} - 审批操作:
POST /api/workflow/operator/Audit/{operatorId}TransferAddSignReduceApprover - 决策流:
GET /api/workflow/template/{id}/DecisionParameter - 委托:
POST /api/workflow/delegatePUT /api/workflow/delegate/{id}/Stop - 监控:
POST /api/workflow/monitor/Cancel/{id}PauseRebootAssign
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 (核心)
-
workflow info <id>— 流程模板详情- API:
GET /api/workflow/template/{id}(web getInfo) - 场景: AI 创建流程后查看 flowNodes/flowConfig/flowXml 完整 schema
- API:
-
workflow update <id>— 修改流程模板- API:
PUT /api/workflow/template/{id}(web update) - 场景: AI 调整流程 (改 flowNodes, 改分类), 修复错误流程
- API:
-
workflow delete <id>— 删除流程模板- API:
DELETE /api/workflow/template/{id}(web delFlow) - 场景: AI 清理测试流程
- API:
-
workflow tasks— 我的待办 (细分)- API:
GET /api/workflow/operator/List/{1|2|3}(web getFlowBeforeList) - 场景: AI 审批前查 todo, 区分 list --todo=1
- API:
优先级 P1 (常用)
-
workflow done— 已审批查询 (type=2) -
workflow transfer <operatorId>— 转办- API:
POST /api/workflow/operator/Transfer/{operatorId}(web transfer)
- API:
-
workflow delegate <operatorId>— 委派- API:
POST /api/workflow/operator/Assist/{operatorId}(web assist)
- API:
-
workflow recall <taskId>— 撤回发起- API:
PUT /api/workflow/task/Recall/{taskId}(web launchRecall)
- API:
-
workflow revoke <taskId>— 撤销流程- API:
PUT /api/workflow/task/Revoke/{taskId}(web revoke)
- API:
-
workflow copy <id>— 复制流程- API:
POST /api/workflow/template/{id}/Actions/Copy(web copy)
- API:
-
workflow version <id>— 流程版本管理- API: getVersionList/copyVersion/delVersion/upDownShelf
- 场景: AI 版本切换 (生产/灰度)
优先级 P2 (边缘)
workflow export <id>— 导出 (web exportData)workflow import <file>— 导入workflow monitor <taskId>— 监控 (pause/cancel/reboot)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 (我的待办) 缺。
缺失:
- 转办 (transfer) — AI 委托代理无命令
- 委派 (delegate/assist) — AI 多人协办无命令
- 加签/减签 (freeApprover/reduceApprover) — AI 动态调整审批人无命令
- 批量审批 (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 天)
- REFACTOR-WEBAPI: list/decision/approve 切 webapi/workflow.ts
- NEW-CMD P0: info/update/delete (3 个基础 CRUD)
- 文档同步: BS-44/bindFlow 闭环说明
Phase 2B (短期, 5-7 天)
- NEW-CMD P0: tasks/done (细分 list --todo)
- NEW-CMD P1: transfer/delegate/recall/revoke (4 个审批操作)
- task.ts shim 评估 (useUserStore mock)
Phase 2C (中期, 7-10 天)
- NEW-CMD P1: copy/version (流程版本管理)
- NEW-CMD P2: export/import (BPMN 导入导出)
- 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):
- REFACTOR-WEBAPI: list/decision/approve 切 webapi (一致性)
- NEW-CMD P0: info/update/delete (基础 CRUD)
- NEW-CMD P0: tasks (细分我的待办)
- NEW-CMD P1: transfer/delegate (审批闭环)
- NEW-CMD P1: version (版本管理)