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

251 lines
11 KiB
Markdown

# 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 (常用)
5. **`workflow done`** — 已审批查询 (type=2)
6. **`workflow transfer <operatorId>`** — 转办
- API: `POST /api/workflow/operator/Transfer/{operatorId}` (web transfer)
7. **`workflow delegate <operatorId>`** — 委派
- API: `POST /api/workflow/operator/Assist/{operatorId}` (web assist)
8. **`workflow recall <taskId>`** — 撤回发起
- API: `PUT /api/workflow/task/Recall/{taskId}` (web launchRecall)
9. **`workflow revoke <taskId>`** — 撤销流程
- API: `PUT /api/workflow/task/Revoke/{taskId}` (web revoke)
10. **`workflow copy <id>`** — 复制流程
- API: `POST /api/workflow/template/{id}/Actions/Copy` (web copy)
11. **`workflow version <id>`** — 流程版本管理
- API: getVersionList/copyVersion/delVersion/upDownShelf
- 场景: AI 版本切换 (生产/灰度)
#### 优先级 P2 (边缘)
12. **`workflow export <id>`** — 导出 (web exportData)
13. **`workflow import <file>`** — 导入
14. **`workflow monitor <taskId>`** — 监控 (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 <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 (版本管理)