# 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 `** — 流程模板详情 - API: `GET /api/workflow/template/{id}` (web getInfo) - 场景: AI 创建流程后查看 flowNodes/flowConfig/flowXml 完整 schema 2. **`workflow update `** — 修改流程模板 - API: `PUT /api/workflow/template/{id}` (web update) - 场景: AI 调整流程 (改 flowNodes, 改分类), 修复错误流程 3. **`workflow delete `** — 删除流程模板 - 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 (常用) 5. **`workflow done`** — 已审批查询 (type=2) 6. **`workflow transfer `** — 转办 - API: `POST /api/workflow/operator/Transfer/{operatorId}` (web transfer) 7. **`workflow delegate `** — 委派 - API: `POST /api/workflow/operator/Assist/{operatorId}` (web assist) 8. **`workflow recall `** — 撤回发起 - API: `PUT /api/workflow/task/Recall/{taskId}` (web launchRecall) 9. **`workflow revoke `** — 撤销流程 - API: `PUT /api/workflow/task/Revoke/{taskId}` (web revoke) 10. **`workflow copy `** — 复制流程 - API: `POST /api/workflow/template/{id}/Actions/Copy` (web copy) 11. **`workflow version `** — 流程版本管理 - API: getVersionList/copyVersion/delVersion/upDownShelf - 场景: AI 版本切换 (生产/灰度) #### 优先级 P2 (边缘) 12. **`workflow export `** — 导出 (web exportData) 13. **`workflow import `** — 导入 14. **`workflow monitor `** — 监控 (pause/cancel/reboot) 15. **`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 ` | 缺 | NEW-CMD | P0 | AI 创建后查看 schema | | `update ` | 缺 | NEW-CMD | P0 | AI 修改流程 | | `delete ` | 缺 | 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 (版本管理)