diff --git a/.workbuddy/memory/2026-11-02.md b/.workbuddy/memory/2026-11-02.md index 603f430..a83760e 100644 --- a/.workbuddy/memory/2026-11-02.md +++ b/.workbuddy/memory/2026-11-02.md @@ -323,3 +323,50 @@ - **`workFlow` 104 条**(`fe-gap` 0/104)—— 官方在 `jnpf-flowable`,依赖 **Flowable 引擎** ⇒ 大概率一批「诚实失败」端点 + 流程定义元数据落库 - 暂缓:aiCenter 75 / extend 64 / msgCenter 50 / teamwork 40 + +--- + +## 批次 19 —— workFlow 全族 104 条(2026-11-02 晚) + +### 结论 +- **104 条面 B 端点**(`platform/compat/workflow.rs`):真实现 **62** + 诚实失败 **42** + (引擎动作 27 + 无文件服务 2 + 无在线表单设计器 13)。 +- **24 张 `workflow_*` 表**(官方 DDL **逐字**导入,新增 `WORKFLOW_TABLES` 常量, + 与 `REPORT_TABLES` 同性质:契约面的固定装置,不是平台表也不是业务表)。 + ⇒ `schema.sql` 152 张 / `BASE_TABLES` 123 张 / 运行时 `tables` 153 张。 +- **官方流程引擎是独立 HTTP 服务**(`FlowAbleUrl` = `/api/Flow/*`), + 跟批次 17 的 Report 同款形态 ⇒ 本仓只导元数据、**不导 `act_*` 引擎表** + ⇒ 动作类端点一律 `code=400` + `data:null` + 人话。 +- **104 条的来源**:91 条来自官方 8 个 Java Controller 的 `@XxxMapping`, + 13 条是**官方前端独有**(`api/workFlow/formDesign.ts` 11 条 + + `task.ts:51` / `flowMonitor.ts:17` 两条 `EventLog`) + —— 官方整个 `jnpf-java-boot` 树里**没人声明过 `/api/flowForm/Form`**。 + +### 踩到的坑(都写进 HANDOFF §5「批次 19 新增的坑」了) +1. 🔴🔴 **pglite 参数类型推断**:手写 SQL 写 `$1::integer` ⇒ PG 把**参数本身**推成 `int4` + ⇒ `cannot convert between Option and int4`。**必须 `$1::text::integer`**。 + 本批改 `workflow.rs` 21 处 + `report.rs` 3 处(后者是批次 17 的潜伏 bug)。 +2. 🔴 `workflow_task_info` 投影用了 `u.f_real_name` ⇒ FROM 漏了 `LEFT JOIN base_user u` + ⇒ `missing FROM-clause entry for table "u"`。 +3. 🔴 `f_type` 撞车(种子列 + `TEMPLATE_WRITE_FIELDS` 同时映射)⇒ `specified more than once` + ⇒ 去掉显式列 + body 没带 `type` 时补默认 `0`。 +4. 🔴 官方 `Info/{id}` 收的是**版本 id**;`CommentController.list` 是**任务作用域**; + `TemplateController` 的路径段名是 `{formId}`(前端按 `/{id}/FlowList` 调,同一条路由); + 版本列表返**裸数组**;委托 `toUserId` 是数组、`startTime`/`endTime` 是 epoch 毫秒数字。 +5. 🔴 **契约 `[FACE]` 计数是派生值** ⇒ 手改 `docs/contract.md` 的 `[FACE]` 行必然被 + `pack-sync --check` 判红(这正是它该做的)⇒ 改法是跑 `python3 scripts/pack-sync.py`。 +6. 🔴 `pack-sync.py` 会把 `PACK:BEGIN/END` 块挪到 `[ENDPOINT]` 段**末尾** + ⇒ 新加的平台端点行要落在 `PACK:BEGIN` **之前**(仓库约定)。 + +### 数字 +- 契约端点 **714 条**(面 A 28 + 面 B **684** + AB 2) +- `batch19_it` **7 passed**;`cargo test --offline --workspace` **648 passed / 0 failed** +- `check-contract` **PASS=10 FAIL=0**(反自证 12 例全过);`check-citations` 4/0 +- `verify.sh --fast` 全 ✅(8 步);`verify.sh --lib` 全 ✅(10 步,单测 105 passed) +- `fe-gap` 合计 **667/900(74.1%)**;**`workFlow` 104/104 = 100%**(上轮 563/900 = 62.6%) +- 官方覆盖 **700/706**(implemented 537 / partial 163 / absent 6;oos 4 单列) + +### 剩余 +- 暂缓(用户 2026-11-02 决定):`aiCenter` 75 / `extend` 64 / `msgCenter` 50 / `teamwork` 40 +- `systemData` 还剩 3 条(官方声明了但后端从无映射 ⇒ 已记 `oos`,不是待办) +- `onlineDev` 还剩 1 条(`docs/fe/endpoints.tsv` 的**旧记录**,官方实际无路径参数 ⇒ 不是待办) diff --git a/HANDOFF.md b/HANDOFF.md index 0026103..f230d42 100644 --- a/HANDOFF.md +++ b/HANDOFF.md @@ -1,7 +1,8 @@ # HANDOFF —— 交给下一个 session 的现场交接 -> 更新于 2026-11-01 19:00(面 B 批次 11 收尾 + **批次 12 方向决策**), -> **20:10 追加「前端 MVP 用 React 模板、除了认证其它都留给集成阶段」**。**开工先读这一页** +> 更新于 2026-11-02(面 B **批次 19 收尾** —— workFlow 104 条), +> 底部保留 2026-11-01 19:00 的「批次 12 方向决策」与 +> **20:10 的「前端 MVP 用 React 模板、除了认证其它都留给集成阶段」**。**开工先读这一页** > (尤其 **§0-bis 的「下一轮的优先级改了」**),再读 `CLAUDE.md`(硬约定), > 最后看 `.workbuddy/memory/` 最近一天的日志(踩过的坑)。 > 无人值守时不要问用户,选最保守可行的方案继续,并把决策写回本文件。 @@ -250,8 +251,9 @@ React 模板的加模块成本 = **改/加 8 个文件、15~20 分钟**(`HOWTO `permission` 111/137(81.0%)、`system` **141/196(71.9%,批次 4 47→66、批次 5 66→84、 批次 9 84→101、批次 10 101→132、批次 11 132→141)**、 **`systemData` 74/106(69.8%,批次 6 从 0 起、批次 7 29→35、批次 8 35→52、批次 9 52→74)**; -剩下体量最大的仍是 `workFlow`(104) / `onlineDev`(101) / `aiCenter`(75) / -`extend`(64) / `msgCenter`(50) —— **基本都属于「本仓没这个模块」**。 +剩下体量最大的仍是 `aiCenter`(75) / `extend`(64) / `msgCenter`(50) / `teamwork`(40) +—— **基本都属于「本仓没这个模块」**(`workFlow`(104) 与 `onlineDev`(101) 已分别在 +批次 19 / 17 清零)。 (🔴 批次 9 收尾时此处写的 252/28.0% 是**批次 8 的旧数**,实测 291/32.3%,此处已更正。) ### 🔴🔴 下一轮的优先级改了(2026-11-01 19:00 决策,19:39 补充两阶段路线) @@ -351,19 +353,28 @@ React 模板的加模块成本 = **改/加 8 个文件、15~20 分钟**(`HOWTO --- -## 1. 一句话现状(2026-11-02 批次 18 —— core 族 22 条收尾) +## 1. 一句话现状(2026-11-02 批次 19 —— workFlow 104 条收尾) **📌 当前数字(以此为准,下面各批的「当时数字」仅存档)**: -- 契约端点 **610 条**(面 A 28 + 面 B **580** + 两面共用 2);`tables` → **67** - (`BASE_TABLES` 64;批次 17 新增 `report_template` + `report_version` 两张**官方 DDL 逐字导入**的表)。 -- `cargo test --offline --workspace` = **全绿 0 failed**(主 lib 105 passed; - `batch18_it` **10 passed**)。 -- 十二道闸门全绿;`check-contract` `PASS=10 FAIL=0`,官方端点覆盖 **596/602** - (implemented 475 / partial 121 / absent 6;oos 4 单列)。 -- `python3 scripts/fe-gap.py`:合计 **563 / 900(62.6%)**、**`core` 27/27(100%)**、 - **`onlineDev` 100/101(99.0%)**、**`permission` 137/137(100%)**、 - **`system` 196/196(100%)**、**`systemData` 103/106(97.2%)**。 +- 契约端点 **714 条**(面 A 28 + 面 B **684** + 两面共用 2);`tables` → **153** + (`schema.sql` **152** 张 + 业务包 1 张;平台表 `BASE_TABLES` **123** + + `WORKFLOW_TABLES` **24** + `REPORT_TABLES` **2** + 内嵌业务表 3)。 +- `cargo test --offline --workspace` = **全绿 0 failed**(**648 passed**;主 lib 105; + `batch19_it` **7 passed**)。 +- 十二道闸门全绿;`check-contract` `PASS=10 FAIL=0`,官方端点覆盖 **700/706** + (implemented 537 / partial 163 / absent 6;oos 4 单列)。 +- `python3 scripts/fe-gap.py`:合计 **667 / 900(74.1%)**、**`workFlow` 104/104(100%)**、 + **`core` 27/27(100%)**、**`onlineDev` 100/101(99.0%)**、 + **`permission` 137/137(100%)**、**`system` 196/196(100%)**、 + **`systemData` 103/106(97.2%)**。 +- 🔴 **批次 19 把 workFlow 做完了**(官方 `jnpf-flowable` + `api/workFlow/**` 共 **104 条**): + **真实现 62 条**(流程模板/版本/节点/任务/评论/委托/监控的**元数据**面, + 落在**官方 24 张 `workflow_*` 表**上,DDL 逐字导入)、 + **诚实失败 42 条**(引擎动作 **27** + 无文件服务 **2** + 无在线表单设计器 **13**)。 + **没有一条返假数据**(不返假流程号、不返假 URL、不返假表单)。 + 🔴 官方流程引擎是**独立 HTTP 服务**(`FlowAbleUrl` = `/api/Flow/*`), + 本仓没有它 ⇒ **一切「动作类」端点一律 `400` + 人话**。 - 🔴 **批次 18 把 core 族做完了**(官方 `api/core/{auth,common,user}.ts` 共 **27 条** ⇒ 本仓落 **22 条端点**;`fe-gap` 的 `core` 列 **100%**)。 三类落地:**真实现 6 条**(锁屏解锁 / 免密票据 / 扫码凭证 4 条)、 @@ -1083,6 +1094,46 @@ CRUD 落 `base_time_task`(数据真实、可编辑、重启不丢),`runCou ② 官方 Java **没有**对应映射 ⇒ 指官方前端 `api/onlineDev/portal.ts:84`; ③ Report 整族 ⇒ 指官方前端 `api/onlineDev/report.ts:14`(官方后端是**独立服务**)。 +### 批次 19(2026-11-02)—— workFlow 全族(104 条)+ 24 张 `workflow_*` 表 + +**104 条面 B 端点**(新增 `platform/compat/workflow.rs`;新增 **24 张 `workflow_*` 表**, +**官方 DDL 逐字导入**): +- **真实现 62 条** —— 流程**元数据**面:模板 CRUD / 版本 / 节点 / 任务 / 评论 / 委托 / + 监控读 / 触发器读 / 事件日志读。 +- **诚实失败 42 条** —— **引擎动作 27**(发起 / 审批 / 转审 / 加签 / 催办 / 撤销 / + 批量审批 / 暂停 / 终止 / 复活 / 重试 …)、**无文件服务 2**(两处 `Export`)、 + **无在线表单设计器 13**(本仓**没有 `visualdev_*` 表** ⇒ 表单本体查不到)。 + +🔴 **官方流程引擎是独立 HTTP 服务**(官方前端把引擎地址配在 `FlowAbleUrl`, + = `/api/Flow/*`)—— 跟批次 17 的 Report 同款形态(官方把能力放在独立服务里)。 + ⇒ 本仓**只导元数据、不导 Flowable 的 `act_*` 引擎表** ⇒ 一切「动作类」端点 + **`code=400` + `data:null` + 人话**,**不返假流程号、不返假 URL**。 + +🔴 **104 条的来源分两半**(官方 `jnpf-flowable-controller` 有 **12 个 Controller**, + 本仓只登记**有官方映射**的 8 个): +- **91 条** = 8 个 Controller 的 `@XxxMapping`(`TemplateController` 25 + + `OperatorController` 25 + `TaskController` 13 + `WorkflowMonitorController` 10 + + `DelegateController` 9 + `TriggerTaskController` 4 + `CommentController` 3 + + `TriggerWebHookController` 3); +- **13 条** = 官方前端**独有**(`api/workFlow/formDesign.ts` 的 11 条 `/api/flowForm/Form/*` + + `task.ts:51` / `flowMonitor.ts:17` 两条 `EventLog`)—— + 官方**整个 `jnpf-java-boot` 树里没人声明过 `/api/flowForm/Form`** ⇒ 这 13 条 + `[OFFICIAL]` 的 `src` 指**官方前端行号**。 + +🔴 **多应用隔离只有 `workflow_template` 挂 `f_system_id`**(官方 DDL 如此)⇒ + 任务 / 评论的隔离**只能透传**:用 `EXISTS (SELECT 1 FROM workflow_task t + JOIN workflow_template tpl ON tpl.f_id = t.f_template_id + WHERE t.f_id = c.f_task_id AND tpl.f_system_id = $1::text)` 子查询。 + +🔴 **`f_type` 撞车(批次 9 的同款坑,第 N 次)**:种子列里放了 `f_type`, + `TEMPLATE_WRITE_FIELDS` 又把 JSON 键 `type` 映射到同一列 ⇒ INSERT 报 + `column "f_type" specified more than once` ⇒ **要么去掉显式列,要么去掉写字段映射**。 + 本批的修法是「去掉显式列 + body 没带 `type` 时补默认值 `0`」。 + +- 回归测试 `tests/batch19_it.rs`(**7 条**):104 条路径逐条打(防 `matchit` 冲突)、 + 模板 CRUD 落官方表、评论/委托落库、**27 条引擎端点逐条断言「诚实失败」**、 + 多应用隔离、未登录 602。 + --- ## 2. 运行中的现场(断了就按这里重启) @@ -1291,12 +1342,20 @@ xop run --secret GU=git_local_user --secret GP=git_local_pass -- bash -c ' 🔴 同批修掉一个**真偏差**:`Login/saas` 原先 `let _ = require_login_face_b(..)` ⇒ **丢弃 `Err` ⇒ 实际不拦**,但静态闸门推成「登录」⇒ 已改成真拦(官方 `TenantSaasGranter.checkTenantUser` 要求已有登录态)。 - 15. 🔴 **`workFlow` 104 条**(`fe-gap` 现在 0/104)—— 官方在 `jnpf-flowable`, - 依赖 **Flowable 引擎** ⇒ 大概率需要一批「诚实失败」端点 + 流程定义元数据落库。 + 15. ~~`workFlow` 104 条~~ ✅ **批次 19 做完(实际 104 条端点,`fe-gap` 的 `workFlow` 列 + 0/104 → **104/104 = 100%**)**——真实现 62 条 + **诚实失败 42 条** + (引擎动作 27 + 无文件服务 2 + 无在线表单设计器 13)。 + 🔴 新增 **24 张 `workflow_*` 表**(官方 DDL **逐字**导入,`WORKFLOW_TABLES` 常量), + 只导元数据、**不导 Flowable 的 `act_*` 引擎表**。 + 🔴 官方流程引擎是**独立 HTTP 服务**(`FlowAbleUrl` = `/api/Flow/*`), + 本仓没有它 ⇒ 一切「动作类」端点一律 `400` + 人话。 16. ⏸️ **暂缓**(用户 2026-11-02 决定):`aiCenter` 75 / `extend` 64 / `msgCenter` 50 / `teamwork` 40。 17. ✅ **onlineDev 集成测试已写**(`tests/batch17_it.rs`,**11 passed**)—— `matchit` 同位置参数名冲突这类错静态看不出来(批次 12 踩过)⇒ 新端点族落地后**必须**跑一次集成测试。 + 18. ✅ **workFlow 集成测试已写**(`tests/batch19_it.rs`,**7 passed**)—— + 逐条打一遍 104 条路径防 `matchit` 冲突 + 模板 CRUD 落库 + 评论/委托 + + **27 条引擎端点逐条断言「诚实失败」** + 多应用隔离 + 未登录 602。 ### 🔴🔴 批次 12(下一轮优先做)—— 「框架固定包 + 业务模块链接就好」 @@ -1952,6 +2011,48 @@ ENC_BIN="$PWD/target/debug/ssw-platform" bash scripts/perm-smoke-jnpf.sh 实际已到 610 条 / 607 行。本批顺手改成真值。 🔴 **教训**:凡是不被尺子读的**数字**,迟早会说谎 —— 要么让尺子读它,要么别写它。 +### 批次 19 新增的坑(workFlow 104 条) + +- 🔴🔴 **pglite 的参数类型推断(本仓最阴的一条)**:本仓所有参数都按 `Option` + 绑定 ⇒ 手写 SQL 里写 `$1::integer` 会让 **PG 把参数本身**推成 `int4` + ⇒ pglite 报 `cannot convert between the Rust type Option and the Postgres type int4`。 + 🔴 **正确写法是 `$1::text::integer`**(`::text` 在前,**先固定成 text 再转**)—— + 仓库的 `placeholder()` 就是这么发的。**手写 SQL 绕过 `placeholder()` 时最容易踩**。 + 本批在 `workflow.rs` 改了 **21 处**,`report.rs` 改了 **3 处**(后者是批次 17 的**潜伏 bug**, + 静态闸门全绿时也是坏的 ⇒ 只有真跑才炸)。 +- 🔴 **漏 JOIN ⇒ `missing FROM-clause entry for table "u"`**: + `workflow_task_info` 的投影里有 `u.f_real_name` / `u.f_account`(官方要显示「发起人」), + FROM 却只有 `workflow_task t` ⇒ 必须补 `LEFT JOIN base_user u ON u.f_id = t.f_creator_user_id`。 + 🔴 **`LEFT JOIN` 不能写成 `LEFT JOIN … ON … OR …`**(批次 13 踩过:撞上会把**列表行翻倍**, + 分页静默错乱)。 +- 🔴 **种子列 + 写字段表撞车**(批次 9 的同款坑,第 N 次):`f_type` 既在种子列里、 + 又被 `TEMPLATE_WRITE_FIELDS` 从 JSON 键 `type` 映射过来 ⇒ INSERT 报 + `column "f_type" specified more than once`。本批修法:**去掉显式列**, + body 没带 `type` 时**补默认值 `0`**(官方默认也是 0)。 +- 🔴 **官方 `Info/{id}` 收的是「版本 id」不是模板 id**(`TemplateController.templateJsonInfo`) + ⇒ 拿模板 id 去查会查不到版本 JSON。 +- 🔴 **官方 `CommentController.list` 是「任务作用域」**(`getTaskUserList(pagination.getTaskId())`) + ⇒ 没有任务就**空列表**(不是 bug)。本仓的隔离子查询要求「任务 → 模板 → 系统」链路存在 + ⇒ 测试里**直接插一行 `workflow_task`**(引擎才会产生的数据)才查得到。 +- 🔴 **官方 `TemplateController` 的路径段名是 `{formId}`**(`getFlowByFormId`), + 官方前端却按 `/{id}/FlowList` 调 ⇒ **同一条路由** ⇒ 本仓按**表单主键**查 + `workflow_node.f_form_id` → 版本 → 模板。(契约 `[OFFICIAL]` 保留官方的 `{formId}`, + CC10 归一后对账。) +- 🔴 **版本列表返「裸数组」不是 PageListVO**(官方 `ActionResult>`)—— + 和本仓多数列表不同,写成 `{pagination,list}` 前端会拿到 `undefined`。 +- 🔴 **委托的入参形状**:`toUserId` 是**数组**(被委托人列表)、`userId` 是**委托人**; + `startTime`/`endTime` 返**epoch 毫秒数字**(不是字符串)。 +- 🔴 **契约的 `[FACE]` 计数是「派生值」** ⇒ **别手改** `docs/contract.md` 的 `[FACE]` 行 + (`scripts/pack-sync.py` 会从 `[ENDPOINT]` 行重算)⇒ 手改必然被 + `pack-sync --check` 判红(**这正是它该做的**)。 +- 🔴 **契约生成器加一族要登记四张表**(`scripts/gen-contract-endpoints.py`): + ① 官方 Java 控制器映射表 ② **官方前端独有**路径表 ③ 引擎类 partial 路径表 + ④ 文件类 / 表单类 partial 路径表 —— 少登记一张 ⇒ 生成器直接 `SystemExit` + (**宁可不生成,也不生成没有出处的行**)。 +- 🔴 **axum 的 handler 参数顺序**:body 提取器(`Bytes`)**必须放最后**, + `RawQuery` / `Path` / `HeaderMap` 是 `FromRequestParts`、必须排在它前面 + ⇒ 顺序反了**编译不过**(这条比 `matchit` 冲突友好 ⇒ 编译期就能发现)。 + --- ## 6. 收工前(每一轮都要做) diff --git a/crates/sspf-store/src/db.rs b/crates/sspf-store/src/db.rs index 1eabcc7..8355f1c 100644 --- a/crates/sspf-store/src/db.rs +++ b/crates/sspf-store/src/db.rs @@ -75,6 +75,44 @@ pub const EMBEDDED_BUSINESS_TABLES: [&str; 3] = ["demo_item", "shop_product", "b /// 演示数据,不是平台元数据)⇒ **不导入**。 pub const REPORT_TABLES: [&str; 2] = ["report_template", "report_version"]; +/// 🔴 **流程元数据表**(官方 `/api/workflow/**` 契约面的落库载体)。 +/// +/// 🔴 **为什么它们既不是平台表也不是业务表**:官方 `/api/workflow/**` 由 +/// `jnpf-flowable` 模块提供,其**元数据**(流程定义 / 版本 / 节点 / 任务 / +/// 经办 / 委托 / 评论 / 触发器)落在 `workflow_*` 这 24 张官方表里; +/// 而**流转引擎**(BPMN 执行)落在 Flowable 自己的 `act_*` 表里。 +/// 本仓只导入 `workflow_*`(表结构照官方 DDL **逐字**)⇒ 它们是**契约面的 +/// 固定装置**,与 `REPORT_TABLES` 同性质。 +/// +/// 🔴 **不导入 `act_*`**:Flowable 引擎表 + BPMN 部署不在本期范围 ⇒ 所有 +/// **引擎相关动作**(发起 / 审批 / 转审 / 催办 / 撤销 / 监控操作)一律 +/// **诚实失败**(`code=400` + 人话),绝不假装成功。 +pub const WORKFLOW_TABLES: [&str; 24] = [ + "workflow_candidates", + "workflow_circulate", + "workflow_comment", + "workflow_common", + "workflow_delegate", + "workflow_delegate_info", + "workflow_event_log", + "workflow_form_relation", + "workflow_launch_user", + "workflow_node", + "workflow_node_record", + "workflow_operator", + "workflow_record", + "workflow_reject_data", + "workflow_revoke", + "workflow_subtask_data", + "workflow_task", + "workflow_task_line", + "workflow_template", + "workflow_template_use_num", + "workflow_trigger_launchflow", + "workflow_trigger_record", + "workflow_trigger_task", + "workflow_version", +]; /// `PGLITE_DIR=memory://` 的临时库标记(与 `config::TEMP_DIR_MARKER` 同值)。 const TEMP_DIR_MARKER: &str = "memory://"; @@ -1257,18 +1295,19 @@ mod tests { "平台表(base_*)应有 {BASE_TABLE_COUNT} 张(加平台表要同时改 main.rs 的 BASE_TABLES)" ); - // 🔴 非平台表必须**恰好**是那 3 张面 A 内嵌业务表 **+ 2 张报表元数据表** —— - // 多一张就是「有业务表手抄进了平台层 schema.sql」(该搬进 packs/), - // 少一张就是「删漏了」。 + // 🔴 非平台表必须**恰好**是那 3 张面 A 内嵌业务表 **+ 2 张报表元数据表 + // + 24 张流程元数据表** —— 多一张就是「有业务表手抄进了平台层 schema.sql」 + // (该搬进 packs/),少一张就是「删漏了」。 let business: Vec<&String> = tables.iter().filter(|t| !t.starts_with("base_")).collect(); let mut business_names: Vec<&str> = business.iter().map(|s| s.as_str()).collect(); business_names.sort(); let mut expected = EMBEDDED_BUSINESS_TABLES.to_vec(); expected.extend_from_slice(&REPORT_TABLES); + expected.extend_from_slice(&WORKFLOW_TABLES); expected.sort(); assert_eq!( business_names, expected, - "schema.sql 里的非平台表必须恰好是面 A 内嵌的 3 张 + 报表元数据 2 张(业务包表住 packs/)" + "schema.sql 里的非平台表必须恰好是面 A 内嵌的 3 张 + 报表元数据 2 张 + 流程元数据 24 张(业务包表住 packs/)" ); // 🔴 与 main.rs 的 BASE_TABLES 对账的另一半在那边(孤儿 DDL 闸门)。 @@ -1298,12 +1337,19 @@ mod tests { let tables = ddl_tables(); assert_eq!( tables.len(), - BASE_TABLE_COUNT + EMBEDDED_BUSINESS_TABLES.len() + REPORT_TABLES.len(), - "ddl_tables 应解析出 {} 张表({} 平台 + {} 面 A 内嵌业务 + {} 报表元数据)", - BASE_TABLE_COUNT + EMBEDDED_BUSINESS_TABLES.len() + REPORT_TABLES.len(), + BASE_TABLE_COUNT + + EMBEDDED_BUSINESS_TABLES.len() + + REPORT_TABLES.len() + + WORKFLOW_TABLES.len(), + "ddl_tables 应解析出 {} 张表({} 平台 + {} 面 A 内嵌业务 + {} 报表元数据 + {} 流程元数据)", + BASE_TABLE_COUNT + + EMBEDDED_BUSINESS_TABLES.len() + + REPORT_TABLES.len() + + WORKFLOW_TABLES.len(), BASE_TABLE_COUNT, EMBEDDED_BUSINESS_TABLES.len(), - REPORT_TABLES.len() + REPORT_TABLES.len(), + WORKFLOW_TABLES.len() ); assert!(tables.iter().all(|t| !t.is_empty())); assert_eq!( diff --git a/docs/contract.md b/docs/contract.md index a4cedab..d0e26d3 100644 --- a/docs/contract.md +++ b/docs/contract.md @@ -1755,6 +1755,111 @@ B GET /api/system/Location/around 无 platform B GET /api/system/Location/text 无 platform B GET /api/system/Location/inputtips 无 platform +B GET /api/workflow/template 登录 platform +B POST /api/workflow/template onlineDev.flowEngine platform +B PUT /api/workflow/template/{id} onlineDev.flowEngine platform +B GET /api/workflow/template/{id} 登录 platform +B DELETE /api/workflow/template/{id} onlineDev.flowEngine platform +B POST /api/workflow/template/{id}/Actions/Copy onlineDev.flowEngine platform +B GET /api/workflow/template/{id}/Actions/Export 登录 platform +B PUT /api/workflow/template/{id}/UpdateType onlineDev.flowEngine platform +B POST /api/workflow/template/Save onlineDev.flowEngine platform +B GET /api/workflow/template/Info/{id} 登录 platform +B GET /api/workflow/template/Version/{id} 登录 platform +B DELETE /api/workflow/template/Info/{id} onlineDev.flowEngine platform +B POST /api/workflow/template/Info/{id} onlineDev.flowEngine platform +B GET /api/workflow/template/Selector 登录 platform +B GET /api/workflow/template/{id}/FormInfo 登录 platform +B GET /api/workflow/template/StartForm/{id} 登录 platform +B GET /api/workflow/template/StartFormId/{id} 登录 platform +B GET /api/workflow/template/TreeList 登录 platform +B POST /api/workflow/template/GetFlowList 登录 platform +B GET /api/workflow/template/getCommonFlowList 登录 platform +B POST /api/workflow/template/SetCommonFlow/{id} 登录 platform +B GET /api/workflow/template/{id}/SubFlowUserList 登录 platform +B PUT /api/workflow/template/{id}/UpDownShelf onlineDev.flowEngine platform +B GET /api/workflow/template/{id}/DecisionParameter 登录 platform +B GET /api/workflow/template/{id}/FlowList 登录 platform +B GET /api/workflow/comment 登录 platform +B POST /api/workflow/comment 登录 platform +B DELETE /api/workflow/comment/{id} 登录 platform +B GET /api/workflow/Hooks/getUrl 登录 platform +B GET /api/workflow/Hooks/getParams/{randomStr} 登录 platform +B GET /api/workflow/Hooks/{id}/start/{randomStr} 登录 platform +B GET /api/workflow/task 登录 platform +B GET /api/workflow/task/{id} 登录 platform +B POST /api/workflow/task 登录 platform +B PUT /api/workflow/task/{id} 登录 platform +B DELETE /api/workflow/task/{id} 登录 platform +B PUT /api/workflow/task/Recall/{id} 登录 platform +B PUT /api/workflow/task/Revoke/{id} 登录 platform +B POST /api/workflow/task/Press/{id} 登录 platform +B GET /api/workflow/task/{id}/EventLog 登录 platform +B GET /api/workflow/task/TaskUserList/{id} 登录 platform +B GET /api/workflow/task/SubFlowInfo 登录 platform +B GET /api/workflow/task/ViewStartForm/{id} 登录 platform +B GET /api/workflow/task/Hooks/Retry/{id} 登录 platform +B POST /api/workflow/operator/CandidateUser/{id} 登录 platform +B POST /api/workflow/operator/CandidateNode/{id} 登录 platform +B GET /api/workflow/operator/List/{category} 登录 platform +B POST /api/workflow/operator/Sign 登录 platform +B POST /api/workflow/operator/Transact 登录 platform +B POST /api/workflow/operator/Audit/{id} 登录 platform +B POST /api/workflow/operator/AddSignUserIdList/{id} 登录 platform +B POST /api/workflow/operator/ReduceApprover/{id} 登录 platform +B POST /api/workflow/operator/SaveAudit/{id} 登录 platform +B POST /api/workflow/operator/AssistSave/{id} 登录 platform +B POST /api/workflow/operator/Recall/{id} 登录 platform +B POST /api/workflow/operator/Transfer/{id} 登录 platform +B POST /api/workflow/operator/Assist/{id} 登录 platform +B POST /api/workflow/operator/BatchOperation 登录 platform +B GET /api/workflow/operator/BatchCandidate 登录 platform +B GET /api/workflow/operator/BatchFlowSelector 登录 platform +B GET /api/workflow/operator/BatchVersionSelector/{id} 登录 platform +B GET /api/workflow/operator/BatchNodeSelector/{id} 登录 platform +B GET /api/workflow/operator/BatchNode 登录 platform +B GET /api/workflow/operator/{id}/Info 登录 platform +B POST /api/workflow/operator/SendBack/{id} 登录 platform +B GET /api/workflow/operator/SendBackNodeList/{id} 登录 platform +B POST /api/workflow/operator/AddSign/{id} 登录 platform +B GET /api/workflow/operator/RecordList 登录 platform +B GET /api/workflow/operator/CirculateList 登录 platform +B GET /api/workflow/delegate 登录 platform +B POST /api/workflow/delegate 登录 platform +B PUT /api/workflow/delegate/{id} 登录 platform +B GET /api/workflow/delegate/{id} 登录 platform +B DELETE /api/workflow/delegate/{id} 登录 platform +B GET /api/workflow/delegate/UserList 登录 platform +B PUT /api/workflow/delegate/Stop/{id} 登录 platform +B GET /api/workflow/delegate/Info/{id} 登录 platform +B POST /api/workflow/delegate/Notarize/{id} 登录 platform +B GET /api/workflow/monitor 登录 platform +B DELETE /api/workflow/monitor workFlow.flowMonitor platform +B GET /api/workflow/monitor/{id}/EventLog 登录 platform +B POST /api/workflow/monitor/Cancel/{id} workFlow.flowMonitor platform +B POST /api/workflow/monitor/Assign/{id} workFlow.flowMonitor platform +B POST /api/workflow/monitor/Activate/{id} workFlow.flowMonitor platform +B GET /api/workflow/monitor/AnySubFlow/{id} 登录 platform +B POST /api/workflow/monitor/Pause/{id} workFlow.flowMonitor platform +B POST /api/workflow/monitor/Reboot/{id} workFlow.flowMonitor platform +B POST /api/workflow/monitor/FlowTodoCount 登录 platform +B GET /api/workflow/monitor/FlowTodo 登录 platform +B GET /api/flowForm/Form 登录 platform +B POST /api/flowForm/Form 登录 platform +B PUT /api/flowForm/Form 登录 platform +B GET /api/flowForm/Form/{id} 登录 platform +B DELETE /api/flowForm/Form/{id} 登录 platform +B POST /api/flowForm/Form/Release/{id} 登录 platform +B GET /api/flowForm/Form/{id}/Actions/Copy 登录 platform +B GET /api/flowForm/Form/{id}/Actions/Export 登录 platform +B GET /api/flowForm/Form/{id}/getField 登录 platform +B GET /api/flowForm/Form/select 登录 platform +B GET /api/flowForm/Form/getFormById/{id} 登录 platform +B GET /api/workflow/trigger/task/List 登录 platform +B GET /api/workflow/trigger/task 登录 platform +B DELETE /api/workflow/trigger/task workFlow.flowMonitor platform +B POST /api/workflow/trigger/task/Retry/{id} workFlow.flowMonitor platform + # 🔴 以下由 `scripts/pack-sync.py` 从 `packs/*` 生成 —— **不许手改** # (下次同步会被覆盖;改包就够) @@ -1778,7 +1883,7 @@ B DELETE /api/asset/DataResource/{id} permission.asset.dataResource asset [FACE] # face 条数 说明 A 28 面 A 专属(+ 2 条共用 ⇒ 面 A 合计 30 条) -B 580 面 B 专属(官方 JNPF 形状;批次 13 新增 Area 7 + Variate 7;批次 14 新增数据中心 29;批次 15 新增系统服务 39;批次 16 新增权限关系 26;批次 17 新增 onlineDev 78 + Report 23;批次 18 新增 core 22) +B 684 面 B 专属(官方 JNPF 形状;批次 13 新增 Area 7 + Variate 7;批次 14 新增数据中心 29;批次 15 新增系统服务 39;批次 16 新增权限关系 26;批次 17 新增 onlineDev 78 + Report 23;批次 18 新增 core 22;批次 19 新增 workFlow 104) AB 2 两面共用(CurrentUser / Authority Data —— 按判别头分流) [OFFICIAL] @@ -2412,6 +2517,110 @@ POST /api/{prefix}/ImportExceptionData partial VisualdevModelDataController.java GET /api/system/Location/around partial LocationController.java:32 本仓无地图服务(无高德 key + `Cargo.toml` 里**无 HTTP 客户端**)⇒ **明确业务失败**(**不返假坐标**) GET /api/system/Location/text partial LocationController.java:47 本仓无地图服务 ⇒ **明确业务失败**(**不返假坐标**) GET /api/system/Location/inputtips partial LocationController.java:62 本仓无地图服务 ⇒ **明确业务失败**(**不返假坐标**) +GET /api/workflow/template implemented TemplateController.java:117 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +POST /api/workflow/template implemented TemplateController.java:265 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +PUT /api/workflow/template/{id} implemented TemplateController.java:285 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +GET /api/workflow/template/{id} implemented TemplateController.java:216 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +DELETE /api/workflow/template/{id} implemented TemplateController.java:323 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +POST /api/workflow/template/{id}/Actions/Copy implemented TemplateController.java:385 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +GET /api/workflow/template/{id}/Actions/Export partial TemplateController.java:428 本仓无文件服务 ⇒ **明确业务失败**(**不返假文件 / 假 URL**) +PUT /api/workflow/template/{id}/UpdateType implemented TemplateController.java:308 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +POST /api/workflow/template/Save implemented TemplateController.java:415 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +GET /api/workflow/template/Info/{id} implemented TemplateController.java:253 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +GET /api/workflow/template/Version/{id} implemented TemplateController.java:230 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +DELETE /api/workflow/template/Info/{id} implemented TemplateController.java:338 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +POST /api/workflow/template/Info/{id} implemented TemplateController.java:400 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +GET /api/workflow/template/Selector implemented TemplateController.java:150 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +GET /api/workflow/template/{id}/FormInfo partial TemplateController.java:487 本仓无在线表单设计器(无 `visualdev_*` 表)⇒ **明确业务失败** +GET /api/workflow/template/StartForm/{id} partial TemplateController.java:566 本仓无在线表单设计器(无 `visualdev_*` 表)⇒ **明确业务失败** +GET /api/workflow/template/StartFormId/{id} partial TemplateController.java:578 本仓无在线表单设计器(无 `visualdev_*` 表)⇒ **明确业务失败** +GET /api/workflow/template/TreeList implemented TemplateController.java:202 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +POST /api/workflow/template/GetFlowList implemented TemplateController.java:467 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +GET /api/workflow/template/getCommonFlowList implemented TemplateController.java:553 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +POST /api/workflow/template/SetCommonFlow/{id} implemented TemplateController.java:540 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +GET /api/workflow/template/{id}/SubFlowUserList implemented TemplateController.java:524 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +PUT /api/workflow/template/{id}/UpDownShelf implemented TemplateController.java:364 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +GET /api/workflow/template/{id}/DecisionParameter implemented TemplateController.java:499 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +GET /api/workflow/template/{id}/FlowList implemented TemplateController.java:511 面 B 已落地:官方路径段名是 `{formId}`(`getFlowByFormId`),前端按 `/{id}/FlowList` 调(**同一条路由**)⇒ 本仓按**表单主键**查 `workflow_node.f_form_id` → 版本 → 模板;`data` 是裸对象 `{list,isConfig}`(官方 `FlowByFormModel`) +GET /api/workflow/comment implemented CommentController.java:76 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +POST /api/workflow/comment implemented CommentController.java:150 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +DELETE /api/workflow/comment/{id} implemented CommentController.java:166 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +GET /api/workflow/Hooks/getUrl partial TriggerWebHookController.java:92 本仓未接入流程引擎(Flowable,官方是**独立 HTTP 服务** `FlowAbleUrl`)⇒ **明确业务失败** +GET /api/workflow/Hooks/getParams/{randomStr} partial TriggerWebHookController.java:180 本仓未接入流程引擎(Flowable,官方是**独立 HTTP 服务** `FlowAbleUrl`)⇒ **明确业务失败** +GET /api/workflow/Hooks/{id}/start/{randomStr} partial TriggerWebHookController.java:170 本仓未接入流程引擎(Flowable,官方是**独立 HTTP 服务** `FlowAbleUrl`)⇒ **明确业务失败** +GET /api/workflow/task implemented TaskController.java:193 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +GET /api/workflow/task/{id} implemented TaskController.java:103 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +POST /api/workflow/task partial TaskController.java:127 本仓未接入流程引擎(Flowable,官方是**独立 HTTP 服务** `FlowAbleUrl`)⇒ **明确业务失败** +PUT /api/workflow/task/{id} partial TaskController.java:147 本仓未接入流程引擎(Flowable,官方是**独立 HTTP 服务** `FlowAbleUrl`)⇒ **明确业务失败** +DELETE /api/workflow/task/{id} implemented TaskController.java:181 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +PUT /api/workflow/task/Recall/{id} partial TaskController.java:218 本仓未接入流程引擎(Flowable,官方是**独立 HTTP 服务** `FlowAbleUrl`)⇒ **明确业务失败** +PUT /api/workflow/task/Revoke/{id} partial TaskController.java:247 本仓未接入流程引擎(Flowable,官方是**独立 HTTP 服务** `FlowAbleUrl`)⇒ **明确业务失败** +POST /api/workflow/task/Press/{id} partial TaskController.java:233 本仓未接入流程引擎(Flowable,官方是**独立 HTTP 服务** `FlowAbleUrl`)⇒ **明确业务失败** +GET /api/workflow/task/{id}/EventLog implemented api/workFlow/task.ts:51 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +GET /api/workflow/task/TaskUserList/{id} implemented TaskController.java:261 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +GET /api/workflow/task/SubFlowInfo implemented TaskController.java:279 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +GET /api/workflow/task/ViewStartForm/{id} partial TaskController.java:291 本仓无在线表单设计器(无 `visualdev_*` 表)⇒ **明确业务失败** +GET /api/workflow/task/Hooks/Retry/{id} partial TaskController.java:301 本仓未接入流程引擎(Flowable,官方是**独立 HTTP 服务** `FlowAbleUrl`)⇒ **明确业务失败** +POST /api/workflow/operator/CandidateUser/{id} implemented OperatorController.java:115 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +POST /api/workflow/operator/CandidateNode/{id} implemented OperatorController.java:99 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +GET /api/workflow/operator/List/{category} implemented OperatorController.java:134 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +POST /api/workflow/operator/Sign partial OperatorController.java:184 本仓未接入流程引擎(Flowable,官方是**独立 HTTP 服务** `FlowAbleUrl`)⇒ **明确业务失败** +POST /api/workflow/operator/Transact partial OperatorController.java:196 本仓未接入流程引擎(Flowable,官方是**独立 HTTP 服务** `FlowAbleUrl`)⇒ **明确业务失败** +POST /api/workflow/operator/Audit/{id} partial OperatorController.java:224 本仓未接入流程引擎(Flowable,官方是**独立 HTTP 服务** `FlowAbleUrl`)⇒ **明确业务失败** +POST /api/workflow/operator/AddSignUserIdList/{id} implemented OperatorController.java:293 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +POST /api/workflow/operator/ReduceApprover/{id} partial OperatorController.java:308 本仓未接入流程引擎(Flowable,官方是**独立 HTTP 服务** `FlowAbleUrl`)⇒ **明确业务失败** +POST /api/workflow/operator/SaveAudit/{id} partial OperatorController.java:209 本仓未接入流程引擎(Flowable,官方是**独立 HTTP 服务** `FlowAbleUrl`)⇒ **明确业务失败** +POST /api/workflow/operator/AssistSave/{id} partial OperatorController.java:443 本仓未接入流程引擎(Flowable,官方是**独立 HTTP 服务** `FlowAbleUrl`)⇒ **明确业务失败** +POST /api/workflow/operator/Recall/{id} partial OperatorController.java:367 本仓未接入流程引擎(Flowable,官方是**独立 HTTP 服务** `FlowAbleUrl`)⇒ **明确业务失败** +POST /api/workflow/operator/Transfer/{id} partial OperatorController.java:406 本仓未接入流程引擎(Flowable,官方是**独立 HTTP 服务** `FlowAbleUrl`)⇒ **明确业务失败** +POST /api/workflow/operator/Assist/{id} partial OperatorController.java:428 本仓未接入流程引擎(Flowable,官方是**独立 HTTP 服务** `FlowAbleUrl`)⇒ **明确业务失败** +POST /api/workflow/operator/BatchOperation partial OperatorController.java:518 本仓未接入流程引擎(Flowable,官方是**独立 HTTP 服务** `FlowAbleUrl`)⇒ **明确业务失败** +GET /api/workflow/operator/BatchCandidate implemented OperatorController.java:505 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +GET /api/workflow/operator/BatchFlowSelector implemented OperatorController.java:455 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +GET /api/workflow/operator/BatchVersionSelector/{id} implemented OperatorController.java:467 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +GET /api/workflow/operator/BatchNodeSelector/{id} implemented OperatorController.java:479 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +GET /api/workflow/operator/BatchNode implemented OperatorController.java:491 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +GET /api/workflow/operator/{id}/Info implemented OperatorController.java:549 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +POST /api/workflow/operator/SendBack/{id} partial OperatorController.java:339 本仓未接入流程引擎(Flowable,官方是**独立 HTTP 服务** `FlowAbleUrl`)⇒ **明确业务失败** +GET /api/workflow/operator/SendBackNodeList/{id} implemented OperatorController.java:325 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +POST /api/workflow/operator/AddSign/{id} partial OperatorController.java:274 本仓未接入流程引擎(Flowable,官方是**独立 HTTP 服务** `FlowAbleUrl`)⇒ **明确业务失败** +GET /api/workflow/operator/RecordList implemented OperatorController.java:579 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +GET /api/workflow/operator/CirculateList implemented OperatorController.java:592 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +GET /api/workflow/delegate implemented DelegateController.java:76 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +POST /api/workflow/delegate implemented DelegateController.java:133 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +PUT /api/workflow/delegate/{id} implemented DelegateController.java:177 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +GET /api/workflow/delegate/{id} implemented DelegateController.java:106 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +DELETE /api/workflow/delegate/{id} implemented DelegateController.java:285 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +GET /api/workflow/delegate/UserList implemented DelegateController.java:300 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +PUT /api/workflow/delegate/Stop/{id} implemented DelegateController.java:263 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +GET /api/workflow/delegate/Info/{id} implemented DelegateController.java:94 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +POST /api/workflow/delegate/Notarize/{id} implemented DelegateController.java:314 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +GET /api/workflow/monitor implemented WorkflowMonitorController.java:64 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +DELETE /api/workflow/monitor implemented WorkflowMonitorController.java:102 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +GET /api/workflow/monitor/{id}/EventLog implemented api/workFlow/flowMonitor.ts:17 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +POST /api/workflow/monitor/Cancel/{id} partial WorkflowMonitorController.java:159 本仓未接入流程引擎(Flowable,官方是**独立 HTTP 服务** `FlowAbleUrl`)⇒ **明确业务失败** +POST /api/workflow/monitor/Assign/{id} partial WorkflowMonitorController.java:191 本仓未接入流程引擎(Flowable,官方是**独立 HTTP 服务** `FlowAbleUrl`)⇒ **明确业务失败** +POST /api/workflow/monitor/Activate/{id} partial WorkflowMonitorController.java:175 本仓未接入流程引擎(Flowable,官方是**独立 HTTP 服务** `FlowAbleUrl`)⇒ **明确业务失败** +GET /api/workflow/monitor/AnySubFlow/{id} implemented WorkflowMonitorController.java:115 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +POST /api/workflow/monitor/Pause/{id} partial WorkflowMonitorController.java:127 本仓未接入流程引擎(Flowable,官方是**独立 HTTP 服务** `FlowAbleUrl`)⇒ **明确业务失败** +POST /api/workflow/monitor/Reboot/{id} partial WorkflowMonitorController.java:143 本仓未接入流程引擎(Flowable,官方是**独立 HTTP 服务** `FlowAbleUrl`)⇒ **明确业务失败** +POST /api/workflow/monitor/FlowTodoCount implemented WorkflowMonitorController.java:205 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +GET /api/workflow/monitor/FlowTodo implemented WorkflowMonitorController.java:218 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +GET /api/flowForm/Form partial api/workFlow/formDesign.ts:9 本仓无在线表单设计器(无 `visualdev_*` 表)⇒ **明确业务失败** +POST /api/flowForm/Form partial api/workFlow/formDesign.ts:13 本仓无在线表单设计器(无 `visualdev_*` 表)⇒ **明确业务失败** +PUT /api/flowForm/Form partial api/workFlow/formDesign.ts:17 本仓无在线表单设计器(无 `visualdev_*` 表)⇒ **明确业务失败** +GET /api/flowForm/Form/{id} partial api/workFlow/formDesign.ts:21 本仓无在线表单设计器(无 `visualdev_*` 表)⇒ **明确业务失败** +DELETE /api/flowForm/Form/{id} partial api/workFlow/formDesign.ts:25 本仓无在线表单设计器(无 `visualdev_*` 表)⇒ **明确业务失败** +POST /api/flowForm/Form/Release/{id} partial api/workFlow/formDesign.ts:29 本仓无在线表单设计器(无 `visualdev_*` 表)⇒ **明确业务失败** +GET /api/flowForm/Form/{id}/Actions/Copy partial api/workFlow/formDesign.ts:33 本仓无在线表单设计器(无 `visualdev_*` 表)⇒ **明确业务失败** +GET /api/flowForm/Form/{id}/Actions/Export partial api/workFlow/formDesign.ts:37 本仓无文件服务 ⇒ **明确业务失败**(**不返假文件 / 假 URL**) +GET /api/flowForm/Form/{id}/getField partial api/workFlow/formDesign.ts:41 本仓无在线表单设计器(无 `visualdev_*` 表)⇒ **明确业务失败** +GET /api/flowForm/Form/select partial api/workFlow/formDesign.ts:45 本仓无在线表单设计器(无 `visualdev_*` 表)⇒ **明确业务失败** +GET /api/flowForm/Form/getFormById/{id} implemented api/workFlow/formDesign.ts:49 面 B 已落地:官方**没有**对应 Java Controller(整个 `jnpf-java-boot` 树里没人声明过 `/api/flowForm/Form`)⇒ 按官方前端 `api/workFlow/formDesign.ts:49` 的契约实现;用 `workflow_form_relation.f_form_id → f_flow_id` 返流程主键(**不返假流程号**) +GET /api/workflow/trigger/task/List implemented TriggerTaskController.java:59 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +GET /api/workflow/trigger/task implemented TriggerTaskController.java:72 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +DELETE /api/workflow/trigger/task implemented TriggerTaskController.java:110 面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败** +POST /api/workflow/trigger/task/Retry/{id} partial TriggerTaskController.java:97 本仓未接入流程引擎(Flowable,官方是**独立 HTTP 服务** `FlowAbleUrl`)⇒ **明确业务失败** [RULER] # name 期望断言数(尺子**自己**断言的条数;跑出来的条数对不上 ⇒ 失败) diff --git a/scripts/gen-contract-endpoints.py b/scripts/gen-contract-endpoints.py index 8d812cf..6d6aa50 100644 --- a/scripts/gen-contract-endpoints.py +++ b/scripts/gen-contract-endpoints.py @@ -207,6 +207,149 @@ _VISUALDEV_CONTROLLERS = { }, } +# 🔴 **流程族(批次 19)**:官方 `jnpf-flowable` 的 Controller。 +# 键 = `(method, 本仓路径)`(本仓路径与官方路径**同段**,只把路径段名归一)。 +_WORKFLOW_CONTROLLERS = { + # 官方 `jnpf-flowable` 的 `TemplateController`(`@RequestMapping("/api/workflow/template")`) + "TemplateController.java": { + "GET /api/workflow/template": 117, + "GET /api/workflow/template/Selector": 150, + "GET /api/workflow/template/TreeList": 202, + "GET /api/workflow/template/{id}": 216, + "GET /api/workflow/template/Version/{id}": 230, + "GET /api/workflow/template/Info/{id}": 253, + "POST /api/workflow/template": 265, + "PUT /api/workflow/template/{id}": 285, + "PUT /api/workflow/template/{id}/UpdateType": 308, + "DELETE /api/workflow/template/{id}": 323, + "DELETE /api/workflow/template/Info/{id}": 338, + "PUT /api/workflow/template/{id}/UpDownShelf": 364, + "POST /api/workflow/template/{id}/Actions/Copy": 385, + "POST /api/workflow/template/Info/{id}": 400, + "POST /api/workflow/template/Save": 415, + "GET /api/workflow/template/{id}/Actions/Export": 428, + "POST /api/workflow/template/GetFlowList": 467, + "GET /api/workflow/template/{id}/FormInfo": 487, + "GET /api/workflow/template/{id}/DecisionParameter": 499, + # 🔴 官方路径段名是 `{formId}`(`getFlowByFormId`)—— 本仓按前端调用 + # 归一成 `{id}`(**同一条路由**),语义在 `workflow.rs` 里写明。 + "GET /api/workflow/template/{id}/FlowList": 511, + "GET /api/workflow/template/{id}/SubFlowUserList": 524, + "POST /api/workflow/template/SetCommonFlow/{id}": 540, + "GET /api/workflow/template/getCommonFlowList": 553, + "GET /api/workflow/template/StartForm/{id}": 566, + "GET /api/workflow/template/StartFormId/{id}": 578, + }, + # 官方 `CommentController`(`@RequestMapping("/api/workflow/comment")`) + "CommentController.java": { + "GET /api/workflow/comment": 76, + "POST /api/workflow/comment": 150, + "DELETE /api/workflow/comment/{id}": 166, + }, + # 官方 `DelegateController`(`@RequestMapping("/api/workflow/delegate")`) + "DelegateController.java": { + "GET /api/workflow/delegate": 76, + "GET /api/workflow/delegate/Info/{id}": 94, + "GET /api/workflow/delegate/{id}": 106, + "POST /api/workflow/delegate": 133, + "PUT /api/workflow/delegate/{id}": 177, + "PUT /api/workflow/delegate/Stop/{id}": 263, + "DELETE /api/workflow/delegate/{id}": 285, + "GET /api/workflow/delegate/UserList": 300, + "POST /api/workflow/delegate/Notarize/{id}": 314, + }, + # 官方 `OperatorController`(`@RequestMapping("/api/workflow/operator")`) + "OperatorController.java": { + "POST /api/workflow/operator/CandidateNode/{id}": 99, + "POST /api/workflow/operator/CandidateUser/{id}": 115, + "GET /api/workflow/operator/List/{category}": 134, + "POST /api/workflow/operator/Sign": 184, + "POST /api/workflow/operator/Transact": 196, + "POST /api/workflow/operator/SaveAudit/{id}": 209, + "POST /api/workflow/operator/Audit/{id}": 224, + "POST /api/workflow/operator/AddSign/{id}": 274, + "POST /api/workflow/operator/AddSignUserIdList/{id}": 293, + "POST /api/workflow/operator/ReduceApprover/{id}": 308, + "GET /api/workflow/operator/SendBackNodeList/{id}": 325, + "POST /api/workflow/operator/SendBack/{id}": 339, + "POST /api/workflow/operator/Recall/{id}": 367, + "POST /api/workflow/operator/Transfer/{id}": 406, + "POST /api/workflow/operator/Assist/{id}": 428, + "POST /api/workflow/operator/AssistSave/{id}": 443, + "GET /api/workflow/operator/BatchFlowSelector": 455, + "GET /api/workflow/operator/BatchVersionSelector/{id}": 467, + "GET /api/workflow/operator/BatchNodeSelector/{id}": 479, + "GET /api/workflow/operator/BatchNode": 491, + "GET /api/workflow/operator/BatchCandidate": 505, + "POST /api/workflow/operator/BatchOperation": 518, + "GET /api/workflow/operator/{id}/Info": 549, + "GET /api/workflow/operator/RecordList": 579, + "GET /api/workflow/operator/CirculateList": 592, + }, + # 官方 `TaskController`(`@RequestMapping("/api/workflow/task")`) + "TaskController.java": { + "GET /api/workflow/task/{id}": 103, + "POST /api/workflow/task": 127, + "PUT /api/workflow/task/{id}": 147, + "DELETE /api/workflow/task/{id}": 181, + "GET /api/workflow/task": 193, + "PUT /api/workflow/task/Recall/{id}": 218, + "POST /api/workflow/task/Press/{id}": 233, + "PUT /api/workflow/task/Revoke/{id}": 247, + "GET /api/workflow/task/TaskUserList/{id}": 261, + "GET /api/workflow/task/SubFlowInfo": 279, + "GET /api/workflow/task/ViewStartForm/{id}": 291, + "GET /api/workflow/task/Hooks/Retry/{id}": 301, + }, + # 官方 `TriggerWebHookController`(`@RequestMapping("/api/workflow/Hooks")`) + "TriggerWebHookController.java": { + "GET /api/workflow/Hooks/getUrl": 92, + "GET /api/workflow/Hooks/{id}/start/{randomStr}": 170, + "GET /api/workflow/Hooks/getParams/{randomStr}": 180, + }, + # 官方 `WorkflowMonitorController`(`@RequestMapping("/api/workflow/monitor")`) + "WorkflowMonitorController.java": { + "GET /api/workflow/monitor": 64, + "DELETE /api/workflow/monitor": 102, + "GET /api/workflow/monitor/AnySubFlow/{id}": 115, + "POST /api/workflow/monitor/Pause/{id}": 127, + "POST /api/workflow/monitor/Reboot/{id}": 143, + "POST /api/workflow/monitor/Cancel/{id}": 159, + "POST /api/workflow/monitor/Activate/{id}": 175, + "POST /api/workflow/monitor/Assign/{id}": 191, + "POST /api/workflow/monitor/FlowTodoCount": 205, + "GET /api/workflow/monitor/FlowTodo": 218, + }, + # 官方 `TriggerTaskController`(`@RequestMapping("/api/workflow/trigger/task")`) + "TriggerTaskController.java": { + "GET /api/workflow/trigger/task/List": 59, + "GET /api/workflow/trigger/task": 72, + "POST /api/workflow/trigger/task/Retry/{id}": 97, + "DELETE /api/workflow/trigger/task": 110, + }, +} + +# 🔴 **流程族里官方 Java 没有对应 `@XxxMapping`** 的 13 条 ⇒ 出处指向官方前端 +# `api/workFlow/**`(官方就是靠前端声明访问这些端点的)。 +# +# 🔴 `/api/flowForm/Form/**` 11 条:官方**整个 `jnpf-java-boot` 树里没有** +# 任何 Controller 声明过这个前缀(在线表单设计器官方也没后端)⇒ 全部前端出处。 +_WORKFLOW_FRONTEND_ONLY = { + "GET /api/workflow/task/{id}/EventLog": "api/workFlow/task.ts:51", + "GET /api/workflow/monitor/{id}/EventLog": "api/workFlow/flowMonitor.ts:17", + "GET /api/flowForm/Form": "api/workFlow/formDesign.ts:9", + "POST /api/flowForm/Form": "api/workFlow/formDesign.ts:13", + "PUT /api/flowForm/Form": "api/workFlow/formDesign.ts:17", + "GET /api/flowForm/Form/{id}": "api/workFlow/formDesign.ts:21", + "DELETE /api/flowForm/Form/{id}": "api/workFlow/formDesign.ts:25", + "POST /api/flowForm/Form/Release/{id}": "api/workFlow/formDesign.ts:29", + "GET /api/flowForm/Form/{id}/Actions/Copy": "api/workFlow/formDesign.ts:33", + "GET /api/flowForm/Form/{id}/Actions/Export": "api/workFlow/formDesign.ts:37", + "GET /api/flowForm/Form/{id}/getField": "api/workFlow/formDesign.ts:41", + "GET /api/flowForm/Form/select": "api/workFlow/formDesign.ts:45", + "GET /api/flowForm/Form/getFormById/{id}": "api/workFlow/formDesign.ts:49", +} + # 🔴 **官方没有 Java Controller** 的少数几条 ⇒ 出处指向**官方前端 api 文件** # (官方就是靠前端声明访问这些端点的)。 FRONTEND_ONLY_SOURCES = { @@ -379,9 +522,93 @@ PARTIAL_NOTES = { "partial", "本仓无地图服务 ⇒ **明确业务失败**(**不返假坐标**)"), } +# 🔴 ---- 流程族(批次 19)---- +# +# 🔴 **官方流程引擎是独立 HTTP 服务**:官方前端把引擎地址配在 `FlowAbleUrl` +# (`/api/Flow/*`)—— 本仓**没有**该服务 ⇒ 凡是「动作类」 +# (发起 / 审批 / 办理 / 转审 / 撤回 / 撤销 / 退回 / 加签 / 减签 / 协办 / +# 批量审批 / 暂停 / 终止 / 复活 / 重试 / 催办 / 签收 / 触发器)的端点 +# ⇒ **明确业务失败**(绝不返假结果、假流程号)。 +_WORKFLOW_ENGINE_PATHS = [ + ("GET", "/api/workflow/Hooks/getUrl"), + ("GET", "/api/workflow/Hooks/getParams/{randomStr}"), + ("GET", "/api/workflow/Hooks/{id}/start/{randomStr}"), + ("POST", "/api/workflow/task"), + ("PUT", "/api/workflow/task/{id}"), + ("PUT", "/api/workflow/task/Recall/{id}"), + ("PUT", "/api/workflow/task/Revoke/{id}"), + ("POST", "/api/workflow/task/Press/{id}"), + ("GET", "/api/workflow/task/Hooks/Retry/{id}"), + ("POST", "/api/workflow/operator/Sign"), + ("POST", "/api/workflow/operator/Transact"), + ("POST", "/api/workflow/operator/Audit/{id}"), + ("POST", "/api/workflow/operator/ReduceApprover/{id}"), + ("POST", "/api/workflow/operator/SaveAudit/{id}"), + ("POST", "/api/workflow/operator/AssistSave/{id}"), + ("POST", "/api/workflow/operator/Recall/{id}"), + ("POST", "/api/workflow/operator/Transfer/{id}"), + ("POST", "/api/workflow/operator/Assist/{id}"), + ("POST", "/api/workflow/operator/BatchOperation"), + ("POST", "/api/workflow/operator/SendBack/{id}"), + ("POST", "/api/workflow/operator/AddSign/{id}"), + ("POST", "/api/workflow/monitor/Cancel/{id}"), + ("POST", "/api/workflow/monitor/Assign/{id}"), + ("POST", "/api/workflow/monitor/Activate/{id}"), + ("POST", "/api/workflow/monitor/Pause/{id}"), + ("POST", "/api/workflow/monitor/Reboot/{id}"), + ("POST", "/api/workflow/trigger/task/Retry/{id}"), +] +for _m, _p in _WORKFLOW_ENGINE_PATHS: + PARTIAL_NOTES[(_m, _p)] = ( + "partial", "本仓未接入流程引擎(Flowable,官方是**独立 HTTP 服务** " + "`FlowAbleUrl`)⇒ **明确业务失败**") + +# 🔴 **文件类**:本仓无文件服务 ⇒ 导出端点明确失败(**不返假文件 / 假 URL**)。 +_WORKFLOW_FILE_PATHS = [ + ("GET", "/api/workflow/template/{id}/Actions/Export"), + ("GET", "/api/flowForm/Form/{id}/Actions/Export"), +] +for _m, _p in _WORKFLOW_FILE_PATHS: + PARTIAL_NOTES[(_m, _p)] = ( + "partial", "本仓无文件服务 ⇒ **明确业务失败**(**不返假文件 / 假 URL**)") + +# 🔴 **在线表单设计器类**:本仓**没有 `visualdev_*` 表**(官方表单设计器是 +# `jnpf-visualdev` 的在线表单)⇒ 表单本体查不到 ⇒ 明确失败。 +_WORKFLOW_FORM_PATHS = [ + ("GET", "/api/workflow/template/{id}/FormInfo"), + ("GET", "/api/workflow/template/StartForm/{id}"), + ("GET", "/api/workflow/template/StartFormId/{id}"), + ("GET", "/api/workflow/task/ViewStartForm/{id}"), + ("GET", "/api/flowForm/Form"), + ("POST", "/api/flowForm/Form"), + ("PUT", "/api/flowForm/Form"), + ("GET", "/api/flowForm/Form/{id}"), + ("DELETE", "/api/flowForm/Form/{id}"), + ("POST", "/api/flowForm/Form/Release/{id}"), + ("GET", "/api/flowForm/Form/{id}/Actions/Copy"), + ("GET", "/api/flowForm/Form/{id}/getField"), + ("GET", "/api/flowForm/Form/select"), +] +for _m, _p in _WORKFLOW_FORM_PATHS: + PARTIAL_NOTES[(_m, _p)] = ( + "partial", "本仓无在线表单设计器(无 `visualdev_*` 表)⇒ **明确业务失败**") + +# 🔴 两条**已落地但形状有讲究**的 ⇒ 状态仍是 `implemented`,只补说明。 +PARTIAL_NOTES[("GET", "/api/workflow/template/{id}/FlowList")] = ( + "implemented", "面 B 已落地:官方路径段名是 `{formId}`(`getFlowByFormId`)," + "前端按 `/{id}/FlowList` 调(**同一条路由**)⇒ 本仓按**表单主键**" + "查 `workflow_node.f_form_id` → 版本 → 模板;`data` 是裸对象 " + "`{list,isConfig}`(官方 `FlowByFormModel`)") +PARTIAL_NOTES[("GET", "/api/flowForm/Form/getFormById/{id}")] = ( + "implemented", "面 B 已落地:官方**没有**对应 Java Controller(整个 " + "`jnpf-java-boot` 树里没人声明过 `/api/flowForm/Form`)⇒ 按官方" + "前端 `api/workFlow/formDesign.ts:49` 的契约实现;用 " + "`workflow_form_relation.f_form_id → f_flow_id` 返流程主键" + "(**不返假流程号**)") + # 🔴 **端点顺序**:按官方模块分组,组内按路径排 —— 与 `routes.rs` 的注册顺序对齐 # (⇒ 契约读起来与代码读起来同序 ⇒ 人工 review 不用来回跳)。 -MODULE_ORDER = ["core", "online_dev", "report"] +MODULE_ORDER = ["core", "online_dev", "report", "workflow"] # 🔴 **默认 note**(未在 `PARTIAL_NOTES` 里显式标注的端点)。 DEFAULT_NOTES = { @@ -391,6 +618,9 @@ DEFAULT_NOTES = { "report": "面 B 已落地:官方 `/api/Report/*` 在官方是**独立部署的第三方服务**" "(`jnpf-java-datareport-univer`,端口 32000)⇒ 本仓把报表元数据**就地落库**" "(`report_template` + `report_version`,表结构照官方 DDL 逐字导入)", + "workflow": "面 B 已落地:流程**元数据**(模板 / 版本 / 节点 / 评论 / 委托 / " + "监控 / 触发记录)**真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方);" + "**引擎动作**(发起 / 审批 / 办理 …)因本仓未接入 Flowable ⇒ **明确业务失败**", } @@ -470,6 +700,19 @@ def official_entry(mod, key, path): status, note = PARTIAL_NOTES.get(key, ("implemented", DEFAULT_NOTES["core"])) return src, status, note raise SystemExit("core 族没有官方出处可登记:%s %s" % (method, path)) + if mod == "workflow": + # 🔴 流程族(批次 19):官方 `jnpf-flowable` 的 Controller 优先, + # 官方 Java **没有**映射的 13 条 ⇒ 落到官方前端 `api/workFlow/**`。 + for ctrl, table in _WORKFLOW_CONTROLLERS.items(): + if k in table: + src = "%s:%d" % (ctrl, table[k]) + status, note = PARTIAL_NOTES.get(key, ("implemented", DEFAULT_NOTES["workflow"])) + return src, status, note + src = _WORKFLOW_FRONTEND_ONLY.get(k) + if src: + status, note = PARTIAL_NOTES.get(key, ("implemented", DEFAULT_NOTES["workflow"])) + return src, status, note + raise SystemExit("workflow 族没有官方出处可登记:%s %s" % (method, path)) # onlineDev for ctrl, table in _VISUALDEV_CONTROLLERS.items(): if k in table: diff --git a/src/backend/db/schema.sql b/src/backend/db/schema.sql index 88c9863..699c27d 100644 --- a/src/backend/db/schema.sql +++ b/src/backend/db/schema.sql @@ -3066,3 +3066,564 @@ CREATE TABLE report_version ( f_fence_list TEXT, PRIMARY KEY (f_id, f_tenant_id) ); + +-- ============================================================ +-- 流程(workflow)元数据表 —— 官方 `jnpf-database` 的 `workflow_*` 24 张 +-- 真源:`PostgreSQL/JNPF-PostgreSQL.sql` 的 workflow_* 段(逐字导入)。 +-- 用途:官方 `/api/workflow/**` 契约面的**流程定义 / 任务 / 经办 / 委托 / +-- 评论 / 触发器** 元数据落库载体(与 `report_template` 同性质: +-- 契约面的固定装置,不是业务表)。 +-- 🔴 Flowable 引擎表(`act_*`)**不导入** ⇒ 引擎相关动作一律「诚实失败」。 +-- ============================================================ + +CREATE TABLE workflow_candidates ( + f_id VARCHAR(50) NOT NULL, + f_node_code VARCHAR(50), + f_task_id VARCHAR(50), + f_handle_id VARCHAR(50), + f_account VARCHAR(50), + f_candidates TEXT, + f_operator_id VARCHAR(50), + f_type INTEGER, + f_sort_code BIGINT, + f_creator_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_creator_user_id VARCHAR(50), + f_last_modify_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_last_modify_user_id VARCHAR(50), + f_delete_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_delete_user_id VARCHAR(50), + f_delete_mark INTEGER, + f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL, + PRIMARY KEY (f_id, f_tenant_id) +); + +CREATE TABLE workflow_circulate ( + f_id VARCHAR(50) NOT NULL, + f_user_id VARCHAR(50), + f_task_id VARCHAR(50), + f_node_code VARCHAR(50), + f_node_name VARCHAR(50), + f_node_id VARCHAR(50), + f_operator_id VARCHAR(50), + f_read INTEGER, + f_sort_code BIGINT, + f_creator_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_creator_user_id VARCHAR(50), + f_last_modify_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_last_modify_user_id VARCHAR(50), + f_delete_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_delete_user_id VARCHAR(50), + f_delete_mark INTEGER, + f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL, + PRIMARY KEY (f_id, f_tenant_id) +); + +CREATE TABLE workflow_comment ( + f_id VARCHAR(50) NOT NULL, + f_task_id VARCHAR(50), + f_reply_id VARCHAR(50), + f_text TEXT, + f_image TEXT, + f_file TEXT, + f_delete_show INTEGER, + f_enabled_mark INTEGER, + f_sort_code BIGINT, + f_creator_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_creator_user_id VARCHAR(50), + f_last_modify_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_last_modify_user_id VARCHAR(50), + f_delete_mark INTEGER, + f_delete_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_delete_user_id VARCHAR(50), + f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL, + PRIMARY KEY (f_id, f_tenant_id) +); + +CREATE TABLE workflow_common ( + f_id VARCHAR(50) NOT NULL, + f_type VARCHAR(50), + f_flow_id VARCHAR(50), + f_creator_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_creator_user_id VARCHAR(50), + f_last_modify_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_last_modify_user_id VARCHAR(50), + f_delete_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_delete_user_id VARCHAR(50), + f_delete_mark INTEGER, + f_sort_code BIGINT, + f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL, + PRIMARY KEY (f_id, f_tenant_id) +); + +CREATE TABLE workflow_delegate ( + f_id VARCHAR(50) NOT NULL, + f_flow_id VARCHAR(4000), + f_flow_name VARCHAR(4000), + f_start_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_end_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_user_id VARCHAR(50), + f_user_name VARCHAR(50), + f_type INTEGER, + f_description VARCHAR(500), + f_enabled_mark INTEGER, + f_sort_code BIGINT, + f_creator_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_creator_user_id VARCHAR(50), + f_last_modify_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_last_modify_user_id VARCHAR(50), + f_delete_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_delete_user_id VARCHAR(50), + f_delete_mark INTEGER, + f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL, + PRIMARY KEY (f_id, f_tenant_id) +); + +CREATE TABLE workflow_delegate_info ( + f_id VARCHAR(50) NOT NULL, + f_delegate_id VARCHAR(50) NOT NULL, + f_to_user_id VARCHAR(50), + f_to_user_name VARCHAR(50), + f_status INTEGER, + f_sort_code BIGINT, + f_creator_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_creator_user_id VARCHAR(50), + f_last_modify_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_last_modify_user_id VARCHAR(50), + f_delete_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_delete_user_id VARCHAR(50), + f_delete_mark INTEGER, + f_tenant_id VARCHAR(50) NOT NULL, + PRIMARY KEY (f_id, f_tenant_id) +); + +CREATE TABLE workflow_event_log ( + f_id VARCHAR(50) NOT NULL, + f_task_id VARCHAR(50), + f_node_id VARCHAR(50), + f_node_name VARCHAR(50), + f_node_code VARCHAR(50), + f_type VARCHAR(50), + f_up_node VARCHAR(50), + f_interface_id VARCHAR(50), + f_data TEXT, + f_result TEXT, + f_status INTEGER, + f_sort_code BIGINT, + f_creator_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_creator_user_id VARCHAR(50), + f_last_modify_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_last_modify_user_id VARCHAR(50), + f_delete_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_delete_user_id VARCHAR(50), + f_delete_mark INTEGER, + f_tenant_id VARCHAR(50), + PRIMARY KEY (f_id) +); + +CREATE TABLE workflow_form_relation ( + f_id VARCHAR(50) NOT NULL, + f_flow_id VARCHAR(50), + f_form_id VARCHAR(50), + f_sort_code BIGINT, + f_creator_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_creator_user_id VARCHAR(50), + f_last_modify_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_last_modify_user_id VARCHAR(50), + f_delete_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_delete_user_id VARCHAR(50), + f_delete_mark INTEGER, + f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL, + PRIMARY KEY (f_id, f_tenant_id) +); + +CREATE TABLE workflow_launch_user ( + f_id VARCHAR(50) NOT NULL, + f_organize_id TEXT, + f_position_id TEXT, + f_manager_id TEXT, + f_superior VARCHAR(50), + f_subordinate TEXT, + f_task_id VARCHAR(50), + f_department TEXT, + f_sort_code BIGINT, + f_creator_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_creator_user_id VARCHAR(50), + f_last_modify_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_last_modify_user_id VARCHAR(50), + f_delete_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_delete_user_id VARCHAR(50), + f_delete_mark INTEGER, + f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL, + f_node_code VARCHAR(50), + f_type INTEGER, + PRIMARY KEY (f_id, f_tenant_id) +); + +CREATE TABLE workflow_node ( + f_id VARCHAR(50) NOT NULL, + f_flow_id VARCHAR(50), + f_form_id VARCHAR(50), + f_node_type VARCHAR(50), + f_node_code VARCHAR(50), + f_node_json TEXT, + f_sort_code BIGINT, + f_creator_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_creator_user_id VARCHAR(50), + f_last_modify_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_last_modify_user_id VARCHAR(50), + f_delete_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_delete_user_id VARCHAR(50), + f_delete_mark INTEGER, + f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL, + PRIMARY KEY (f_id, f_tenant_id) +); + +CREATE TABLE workflow_node_record ( + f_id VARCHAR(50) NOT NULL, + f_task_id VARCHAR(50), + f_node_id VARCHAR(50), + f_node_code VARCHAR(50), + f_node_name VARCHAR(50), + f_node_status INTEGER, + f_creator_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_creator_user_id VARCHAR(50), + f_last_modify_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_last_modify_user_id VARCHAR(50), + f_delete_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_delete_user_id VARCHAR(50), + f_delete_mark INTEGER, + f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL, + f_sort_code BIGINT, + PRIMARY KEY (f_id, f_tenant_id) +); + +CREATE TABLE workflow_operator ( + f_id VARCHAR(50) NOT NULL, + f_node_name VARCHAR(50), + f_node_code VARCHAR(50), + f_task_id VARCHAR(50), + f_node_id VARCHAR(50), + f_parent_id VARCHAR(50), + f_handle_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_handle_id VARCHAR(50), + f_handle_all TEXT, + f_handle_status INTEGER, + f_handle_parameter TEXT, + f_start_handle_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_duedate TIMESTAMP(0) WITHOUT TIME ZONE, + f_sign_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_status INTEGER, + f_instance_id VARCHAR(50), + f_engine_type INTEGER, + f_sort_code BIGINT, + f_creator_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_creator_user_id VARCHAR(50), + f_last_modify_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_last_modify_user_id VARCHAR(50), + f_delete_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_delete_user_id VARCHAR(50), + f_delete_mark INTEGER, + f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL, + f_draft_data TEXT, + f_completion INTEGER, + f_is_processing INTEGER, + PRIMARY KEY (f_id, f_tenant_id) +); + +CREATE TABLE workflow_record ( + f_id VARCHAR(50) NOT NULL, + f_task_id VARCHAR(50), + f_operator_id VARCHAR(50), + f_node_id VARCHAR(2000), + f_node_code VARCHAR(2000), + f_node_name VARCHAR(2000), + f_handle_type INTEGER, + f_handle_id VARCHAR(50), + f_handle_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_handle_opinion VARCHAR(500), + f_handle_user_id VARCHAR(4000), + f_sign_img TEXT, + f_file_list TEXT, + f_status INTEGER, + f_expand_field TEXT, + f_sort_code BIGINT, + f_creator_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_creator_user_id VARCHAR(50), + f_last_modify_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_last_modify_user_id VARCHAR(50), + f_delete_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_delete_user_id VARCHAR(50), + f_delete_mark INTEGER, + f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL, + PRIMARY KEY (f_id, f_tenant_id) +); + +CREATE TABLE workflow_reject_data ( + f_id VARCHAR(50) NOT NULL, + f_task_json TEXT, + f_operator_json TEXT, + f_node_code VARCHAR(50), + f_sort_code BIGINT, + f_creator_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_creator_user_id VARCHAR(50), + f_last_modify_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_last_modify_user_id VARCHAR(50), + f_delete_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_delete_user_id VARCHAR(50), + f_delete_mark INTEGER, + f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL, + f_event_log_json TEXT, + PRIMARY KEY (f_id, f_tenant_id) +); + +CREATE TABLE workflow_revoke ( + f_id VARCHAR(50) NOT NULL, + f_task_id VARCHAR(50), + f_revoke_task_id VARCHAR(50), + f_form_data TEXT, + f_sort_code BIGINT, + f_creator_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_creator_user_id VARCHAR(50), + f_last_modify_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_last_modify_user_id VARCHAR(50), + f_delete_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_delete_user_id VARCHAR(50), + f_delete_mark INTEGER, + f_tenant_id VARCHAR(50) NOT NULL, + PRIMARY KEY (f_id, f_tenant_id) +); + +CREATE TABLE workflow_subtask_data ( + f_id VARCHAR(50) NOT NULL, + f_subtask_json TEXT, + f_parent_id VARCHAR(50), + f_node_code VARCHAR(50), + f_sort_code BIGINT, + f_creator_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_creator_user_id VARCHAR(50), + f_last_modify_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_last_modify_user_id VARCHAR(50), + f_delete_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_delete_user_id VARCHAR(50), + f_delete_mark INTEGER, + f_tenant_id VARCHAR(50) NOT NULL, + PRIMARY KEY (f_id, f_tenant_id) +); + +CREATE TABLE workflow_task ( + f_id VARCHAR(50) NOT NULL, + f_en_code VARCHAR(200), + f_full_name VARCHAR(200), + f_flow_name VARCHAR(200), + f_flow_code VARCHAR(200), + f_flow_category VARCHAR(50), + f_status INTEGER, + f_flow_type INTEGER, + f_flow_version VARCHAR(50), + f_is_async INTEGER, + f_sub_parameter VARCHAR(2000), + f_parent_id VARCHAR(50), + f_urgent INTEGER, + f_template_id VARCHAR(50), + f_flow_id VARCHAR(50), + f_instance_id VARCHAR(255), + f_engine_type INTEGER, + f_delegate_user_id VARCHAR(50), + f_start_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_end_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_current_node_name VARCHAR(2000), + f_sort_code BIGINT, + f_creator_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_creator_user_id VARCHAR(50), + f_last_modify_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_last_modify_user_id VARCHAR(50), + f_delete_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_delete_user_id VARCHAR(50), + f_delete_mark INTEGER, + f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL, + f_engine_id VARCHAR(50), + f_current_node_code VARCHAR(2000), + f_reject_data_id VARCHAR(50), + f_sub_code VARCHAR(50), + f_global_parameter TEXT, + f_his_status INTEGER, + f_restore INTEGER, + f_is_file INTEGER, + f_type INTEGER, + f_free_code VARCHAR(255), + PRIMARY KEY (f_id, f_tenant_id) +); + +CREATE TABLE workflow_task_line ( + f_id VARCHAR(50) NOT NULL, + f_task_id VARCHAR(50), + f_line_key VARCHAR(50), + f_line_value VARCHAR(50), + f_sort_code BIGINT, + f_creator_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_creator_user_id VARCHAR(50), + f_last_modify_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_last_modify_user_id VARCHAR(50), + f_delete_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_delete_user_id VARCHAR(50), + f_delete_mark INTEGER, + f_tenant_id VARCHAR(50) NOT NULL, + PRIMARY KEY (f_id, f_tenant_id) +); + +CREATE TABLE workflow_template ( + f_id VARCHAR(50) NOT NULL, + f_flow_id VARCHAR(50), + f_version VARCHAR(50), + f_en_code VARCHAR(200), + f_full_name VARCHAR(200), + f_type INTEGER, + f_category VARCHAR(50), + f_icon VARCHAR(250), + f_icon_background VARCHAR(50), + f_configuration TEXT, + f_activiti_id VARCHAR(50), + f_flowable_id VARCHAR(50), + f_camunda_id VARCHAR(50), + f_description VARCHAR(500), + f_enabled_mark INTEGER, + f_sort_code BIGINT, + f_creator_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_creator_user_id VARCHAR(50), + f_last_modify_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_last_modify_user_id VARCHAR(50), + f_delete_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_delete_user_id VARCHAR(50), + f_delete_mark INTEGER, + f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL, + f_visible_type INTEGER, + f_flow_config TEXT, + f_show_type INTEGER, + f_status INTEGER, + f_system_id VARCHAR(50), + f_decision_type INTEGER, + PRIMARY KEY (f_id, f_tenant_id) +); + +CREATE TABLE workflow_template_use_num ( + f_id VARCHAR(50) NOT NULL, + f_template_id VARCHAR(50) NOT NULL, + f_user_id VARCHAR(50) NOT NULL, + f_use_num INTEGER, + f_description VARCHAR(500), + f_enabled_mark INTEGER, + f_sort_code BIGINT, + f_creator_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_creator_user_id VARCHAR(50), + f_last_modify_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_last_modify_user_id VARCHAR(50), + f_delete_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_delete_user_id VARCHAR(50), + f_delete_mark INTEGER, + f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL, + PRIMARY KEY (f_id, f_tenant_id) +); + +CREATE TABLE workflow_trigger_launchflow ( + f_id VARCHAR(50) NOT NULL, + f_trigger_id VARCHAR(50), + f_task_id VARCHAR(50), + f_node_id VARCHAR(50), + f_record_id VARCHAR(50), + f_node_code VARCHAR(50), + f_node_name VARCHAR(50), + f_event_model TEXT, + f_extra_data TEXT, + f_task_ids TEXT, + f_group_id VARCHAR(500), + f_ratio INTEGER, + f_sort_code BIGINT, + f_creator_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_creator_user_id VARCHAR(50), + f_last_modify_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_last_modify_user_id VARCHAR(50), + f_delete_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_delete_user_id VARCHAR(50), + f_delete_mark INTEGER, + f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL, + PRIMARY KEY (f_id, f_tenant_id) +); + +CREATE TABLE workflow_trigger_record ( + f_id VARCHAR(50) NOT NULL, + f_trigger_id VARCHAR(50), + f_task_id VARCHAR(50), + f_node_id VARCHAR(50), + f_node_code VARCHAR(50), + f_node_name VARCHAR(50), + f_start_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_end_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_status INTEGER, + f_error_tip VARCHAR(500), + f_error_data TEXT, + f_sort_code BIGINT, + f_creator_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_creator_user_id VARCHAR(50), + f_last_modify_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_last_modify_user_id VARCHAR(50), + f_delete_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_delete_user_id VARCHAR(50), + f_delete_mark INTEGER, + f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL, + f_result_data TEXT, + PRIMARY KEY (f_id, f_tenant_id) +); + +CREATE TABLE workflow_trigger_task ( + f_id VARCHAR(50) NOT NULL, + f_full_name VARCHAR(50), + f_parent_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_parent_id VARCHAR(50), + f_task_id VARCHAR(50), + f_node_code VARCHAR(50), + f_node_id VARCHAR(50), + f_is_async INTEGER, + f_start_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_flow_id VARCHAR(50), + f_data TEXT, + f_data_id VARCHAR(50), + f_instance_id VARCHAR(50), + f_engine_type INTEGER, + f_status INTEGER, + f_sort_code BIGINT, + f_creator_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_creator_user_id VARCHAR(50), + f_last_modify_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_last_modify_user_id VARCHAR(50), + f_delete_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_delete_user_id VARCHAR(50), + f_delete_mark INTEGER, + f_tenant_id VARCHAR(50) NOT NULL, + PRIMARY KEY (f_id, f_tenant_id) +); + +CREATE TABLE workflow_version ( + f_id VARCHAR(50) NOT NULL, + f_template_id VARCHAR(50), + f_flowable_id VARCHAR(50), + f_activiti_id VARCHAR(50), + f_camunda_id VARCHAR(50), + f_version VARCHAR(50), + f_xml TEXT, + f_status INTEGER, + f_sort_code BIGINT, + f_send_config_ids TEXT, + f_creator_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_creator_user_id VARCHAR(50), + f_last_modify_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_last_modify_user_id VARCHAR(50), + f_delete_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_delete_user_id VARCHAR(50), + f_delete_mark INTEGER, + f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL, + PRIMARY KEY (f_id, f_tenant_id) +); + +CREATE INDEX IF NOT EXISTS i_wlu_ftid ON workflow_launch_user(f_task_id); +CREATE INDEX IF NOT EXISTS i_wo_fni ON workflow_operator(f_node_id); +CREATE INDEX IF NOT EXISTS i_wr_fti ON workflow_record(f_task_id); diff --git a/src/backend/src/main.rs b/src/backend/src/main.rs index f1508a0..2112bd4 100644 --- a/src/backend/src/main.rs +++ b/src/backend/src/main.rs @@ -844,6 +844,17 @@ fn whitelist_self_check() -> Result<(), String> { } } + // 🔴 契约面的固定装置表(报表元数据 / 流程元数据)同样要过白名单 —— + // 它们的表名会被拼进 SQL 文本(`platform/compat/{report,workflow}.rs`)。 + for table in ssw_platform::platform::db::REPORT_TABLES + .iter() + .chain(ssw_platform::platform::db::WORKFLOW_TABLES.iter()) + { + if ssw_platform::platform::db::valid_table(table).is_none() { + return Err(format!("表名 {table} 未过标识符白名单")); + } + } + for spec in modules::all_specs() { if ssw_platform::platform::db::valid_table(spec.table).is_none() { return Err(format!("spec 表名 {} 未过标识符白名单", spec.table)); @@ -883,11 +894,17 @@ fn whitelist_self_check() -> Result<(), String> { // 清单真源在 `sspf_store::db::REPORT_TABLES`(与存储层的表数断言同一处)。 let report_tables = ssw_platform::platform::db::REPORT_TABLES; + // 🔴 **流程元数据表**(`workflow_*` 24 张)同理:官方 `/api/workflow/**` 的 + // 元数据载体(逐字照官方 DDL 导入),既不是 `base_*` 平台表也不是业务 spec 表。 + // 清单真源在 `sspf_store::db::WORKFLOW_TABLES`。 + let workflow_tables = ssw_platform::platform::db::WORKFLOW_TABLES; + for table in &ddl_tables { if !BASE_TABLES.contains(&table.as_str()) && !spec_tables.contains(&table.as_str()) && !pack_tables.contains(&table.as_str()) && !report_tables.contains(&table.as_str()) + && !workflow_tables.contains(&table.as_str()) { return Err(format!( "schema.sql 里的表 {table} 既不是 base_* 表、也没有对应的业务 spec(孤儿 DDL?)" diff --git a/src/backend/src/platform/compat/mod.rs b/src/backend/src/platform/compat/mod.rs index 19064e8..43faa4c 100644 --- a/src/backend/src/platform/compat/mod.rs +++ b/src/backend/src/platform/compat/mod.rs @@ -24,3 +24,4 @@ pub mod scheduletask; pub mod core; pub mod online_dev; pub mod report; +pub mod workflow; diff --git a/src/backend/src/platform/compat/report.rs b/src/backend/src/platform/compat/report.rs index b9cf9c5..5f8aa19 100644 --- a/src/backend/src/platform/compat/report.rs +++ b/src/backend/src/platform/compat/report.rs @@ -614,7 +614,7 @@ pub async fn report_copy( f_description, f_enabled_mark, f_sort_code, f_delete_mark, \ f_creator_user_id, f_creator_time) \ VALUES ($1::text, $2::text, $3::text, $4::text, $5::text, $6::text, \ - $7::text, $8::integer, $9::bigint, 0, $10::text, now())"; + $7::text, $8::text::integer, $9::text::bigint, 0, $10::text, now())"; let values = vec![ Some(new_id.clone()), Some(tenant_id.to_string()), @@ -928,7 +928,7 @@ pub async fn report_version_copy( (f_id, f_tenant_id, f_template_id, f_state, f_version, f_cells, f_snapshot, \ f_query_list, f_sort_list, f_column_list, f_fence_list, f_convert_config, \ f_description, f_enabled_mark, f_delete_mark, f_creator_user_id, f_creator_time) \ - VALUES ($1::text, $2::text, $3::text, 0, $4::integer, $5::text, $6::text, \ + VALUES ($1::text, $2::text, $3::text, 0, $4::text::integer, $5::text, $6::text, \ $7::text, $8::text, $9::text, $10::text, $11::text, $12::text, 1, 0, \ $13::text, now())"; let values = vec![ diff --git a/src/backend/src/platform/compat/workflow.rs b/src/backend/src/platform/compat/workflow.rs new file mode 100644 index 0000000..d321370 --- /dev/null +++ b/src/backend/src/platform/compat/workflow.rs @@ -0,0 +1,4377 @@ +//! workflow —— 官方 **流程**(`/api/workflow/*` + `/api/flowForm/*`)端点集(104 条)。 +//! +//! 🔴 **官方这块是「独立模块 + 独立引擎」**: +//! 官方 `jnpf-flowable`(本仓称「官方流程模块」)里的流程**执行**依赖 **Flowable +//! 工作流引擎**——官方把引擎当**另一个 HTTP 服务**(`FlowAbleUrl` = `/api/Flow/*`), +//! 本仓**没有**这个服务,也**不打算**在本仓里内嵌一个流程引擎。 +//! +//! 🔴 **本仓的处理口径(三分法,逐条落到代码里)**: +//! | 类别 | 落法 | 典型端点 | +//! |---|---|---| +//! | **① 流程元数据** | **真落库**(官方 24 张 `workflow_*` 表已逐字导入)⇒ 列表 / 详情 / +//! 增删改 / 版本 / 节点 / 候选人 / 抄送 / 事件日志 / 委托 / 触发记录 **都能真跑** | +//! (库空 ⇒ 返**形状正确**的空列表) | 模板列表、任务列表、经办列表、委托 CRUD、评论 CRUD | +//! | **② 引擎动作** | **明确业务失败**(`code=400` +「本仓未接入流程引擎(Flowable),不支持…」)—— +//! **绝不返假状态、假流程图、假坐标** | 发起 / 审批 / 转审 / 撤回 / 撤销 / 暂停 / 终止 / 复活 | +//! | **③ 文件与表单设计器** | **明确业务失败**(本仓无文件服务、无在线表单设计器) | 导出、在线表单 CRUD | +//! +//! 🔴 **为什么不「假装成功」**:官方前端在这些端点上会直接读 `res.data.xxx` +//! (如 `res.data.url` / `res.data.id`)⇒ 返空对象/空数组会让页面显示「没有数据」 +//! 而不是「不支持」⇒ **那是撒谎**。本仓一律返**可读的失败原因**。 +//! +//! 🔴 **权限口径**(照官方 `@SaCheckPermission` 逐条抄): +//! - 流程模板的写操作 ⇒ `onlineDev.flowEngine`(官方 `TemplateController` 的 +//! `@SaCheckPermission({"onlineDev.flowEngine"})`); +//! - 流程监控的写操作 + 触发任务的重试/删除 ⇒ `workFlow.flowMonitor` +//! (官方 `WorkflowMonitorController` / `TriggerTaskController`); +//! - **其余全部只要求登录**(官方这几个 Controller **一个 `@SaCheckPermission` 都没有**)。 +//! +//! 🔴 **`data` 的形状逐条照官方前端的消费点定**(最容易做错的地方): +//! | 形状 | 端点 | +//! |---|---| +//! | `PageListVO {pagination,list}` | 模板列表 / 任务列表 / 经办列表 / 委托列表 / 评论列表 / 监控列表 | +//! | `ListVO {list}` | 模板树 / 常用流程 / 退回节点 / 委托人 | +//! | **裸数组** | 版本列表 / 子流程信息 / 事件日志 / 节点记录 / 抄送列表 / 批量选择器 | +//! | **裸对象** | 模板详情 / 版本详情 / 决策参数 / 任务详情 / 触发记录模型 | +//! | **裸 id 字符串** | 新建模板 / 复制版本 | +//! +//! 🔴 **官方枚举语义**(本仓 SQL 里逐条照抄,别自己发明): +//! - `CategoryEnum`:0 待签 / 1 待办 / 2 在办 / 3 已办 / 4 抄送 / 5 批量在办; +//! - `TaskStatusEnum`:0 待提交 / 1 运行中 / 2 通过 / 3 拒绝 / 4 已终止 / 5 暂停 / 6 撤销中 / +//! 7 已撤销 / 8 已退回 / 9 已撤回 / 10 异常; +//! - `OperatorStateEnum`:0 待签收 / 1 流转中 / 2 加签 / 3 转审 / 4 已指派 / 5 退回 / +//! 6 撤回 / 7 协办 / 8 撤销 / 9 转审中 / -1 无用 / -2 未激活; +//! - `TemplateStatueEnum`:0 未上架 / 1 上架 / 2 下架(继续审批)/ 3 下架(隐藏)。 +//! +//! 🔴 **写路径的三条硬律**(与契约面其余模块同一套): +//! 1. 列名只来自常量白名单(请求里的键**永不**进 SQL 文本); +//! 2. 只 SET body 里真出现的键; +//! 3. 审计列用 SQL 自己的 `now()`,**不占参数位**。 + +use axum::body::Bytes; +use axum::extract::{Path, RawQuery, State}; +use axum::http::HeaderMap; +use axum::Json; +use serde_json::{json, Map, Value}; + +use aes::cipher::{block_padding::Pkcs7, BlockDecryptMut, KeyInit}; + +use crate::platform::auth::require_login_face_b; +use crate::platform::crud::value_to_text; +use crate::platform::envelope::{code, fail, ok, ActionResult}; +use crate::platform::ids::new_uuid; +use crate::platform::state::AppState; + +use super::helper::{ + db_error, guard, id_list, id_list_of, list_vo, page_list, params_of, parse_body, placeholder, + qv, text_field, Paging, +}; + +// ---------------------------------------------------------------- 点权限编码 + +/// 🔴 官方 `TemplateController` 的 `@SaCheckPermission({"onlineDev.flowEngine"})`。 +pub(super) const EN_FLOW_ENGINE: &str = "onlineDev.flowEngine"; + +/// 🔴 官方 `WorkflowMonitorController` / `TriggerTaskController` 的 +/// `@SaCheckPermission({"workFlow.flowMonitor"})`。 +pub(super) const EN_FLOW_MONITOR: &str = "workFlow.flowMonitor"; + +// ---------------------------------------------------------------- 官方枚举(照抄,不自创) + +/// `CategoryEnum` —— 待签 / 待办 / 在办 / 已办 / 抄送 / 批量在办。 +const CAT_SIGN: i64 = 0; +const CAT_TODO: i64 = 1; +const CAT_DOING: i64 = 2; +const CAT_DONE: i64 = 3; +const CAT_CIRCULATE: i64 = 4; +const CAT_BATCH_DOING: i64 = 5; + +/// `TemplateStatueEnum` —— 未上架 / 上架 / 下架(继续审批)/ 下架(隐藏)。 +const SHELF_NONE: i64 = 0; +const SHELF_UP: i64 = 1; +const SHELF_DOWN_CONTINUE: i64 = 2; +const SHELF_DOWN_HIDDEN: i64 = 3; + +// ---------------------------------------------------------------- 前端 AES(官方前端专用) + +/// 官方 `EncryptKeyManager.getFrontAesKey()` 对应的密钥(官方 `application.yml:155` +/// 的 `front-aes-key`)—— **16 个 ASCII 字节** ⇒ AES-128。 +/// +/// 🔴 与 [`crate::platform::cipher`] 的**口令 cipher 不是同一把**: +/// 口令 cipher 的 key = `md5_hex("EY8WePvjM5GGwQzn")`(32 字节 ⇒ AES-256), +/// 而官方前端 `new AesEncryption({useHex:true})` 用的是**原始 16 字节串**(AES-128)。 +const FRONT_AES_KEY: &str = "EY8WePvjM5GGwQzn"; + +/// AES-128-ECB 解密器(官方 `EncryptUtil.decryptByAes` 同款:AES-128-ECB-PKCS7 + hex)。 +type Aes128EcbDec = ecb::Decryptor; + +// ---------------------------------------------------------------- 「能力不存在」的统一口径 + +/// 🔴 **流程引擎类动作** —— 明确业务失败,不返假状态。 +fn unsupported_engine(what: &str) -> Json { + fail( + code::FAIL, + format!("本仓未接入流程引擎(Flowable),不支持{what}"), + ) +} + +/// 🔴 **文件类动作** —— 明确业务失败(不返假 URL)。 +fn unsupported_file(what: &str) -> Json { + fail(code::FAIL, format!("本仓无文件服务,不支持{what}")) +} + +/// 🔴 **在线表单设计器类动作** —— 明确业务失败(本仓**没有** `visualdev_*` 表)。 +fn unsupported_form(what: &str) -> Json { + fail( + code::FAIL, + format!("本仓无在线表单设计器,不支持{what}"), + ) +} + +// ---------------------------------------------------------------- 通用小工具 + +/// 当前系统 id(`base_system.f_id`)—— 流程元数据按系统隔离。 +async fn current_system_id(state: &AppState, headers: &HeaderMap) -> String { + crate::platform::registry::resolve_system_id( + &state.db, + crate::platform::registry::app_code_of(headers).as_deref(), + ) + .await +} + +/// body ⇒ 白名单内的 `(列, CAST, 值)`;**只收 body 里真出现的键**。 +fn write_fields( + obj: &Map, + whitelist: &[(&'static str, &'static str, &'static str)], +) -> Vec<(&'static str, &'static str, Option)> { + let mut out = Vec::new(); + for (json_key, column, cast) in whitelist { + if obj.contains_key(*json_key) { + out.push((*column, *cast, value_to_text(obj.get(*json_key)))); + } + } + out +} + +/// 解析 JSON body ⇒ 对象(**不是对象 ⇒ 400**)。 +fn body_obj(body: &Bytes) -> Result, Json> { + match parse_body(body) { + Ok(Value::Object(o)) => Ok(o), + Ok(_) => Err(fail(code::FAIL, "请求参数格式错误")), + Err(resp) => Err(resp), + } +} + +/// 分页跑批:count 与 list **共用同一组前缀参数**(分页参数追加在末尾)。 +/// +/// 🔴 `where_body` 必须是**完整的 WHERE 条件体**(不含 `WHERE` 关键字), +/// `select_cols` / `from_sql` / `order_by` 都由调用方给 ⇒ 两段 SQL 天然一致。 +async fn paged_query( + state: &AppState, + select_cols: &str, + from_sql: &str, + where_body: &str, + order_by: &str, + mut values: Vec>, + page: &Paging, + ctx: &str, +) -> Result<(i64, Vec), Json> { + let count_sql = format!("SELECT count(*)::bigint AS \"c\" FROM {from_sql} WHERE {where_body}"); + let total = match state.db.query_json_params(&count_sql, ¶ms_of(&values)).await { + Ok(rows) => rows + .into_iter() + .next() + .and_then(|r| r["c"].as_i64()) + .unwrap_or(0), + Err(e) => return Err(db_error(e, &format!("{ctx}总数查询"))), + }; + + values.push(Some(page.page_size.to_string())); + values.push(Some(page.offset.to_string())); + let p_limit = values.len() - 1; + let p_offset = values.len(); + let sql = format!( + "SELECT {select_cols} FROM {from_sql} WHERE {where_body} {order_by} \ + LIMIT ${p_limit}::text::integer OFFSET ${p_offset}::text::integer" + ); + let rows = match state.db.query_json_params(&sql, ¶ms_of(&values)).await { + Ok(rows) => rows, + Err(e) => return Err(db_error(e, &format!("{ctx}查询"))), + }; + Ok((total, rows)) +} + +/// 官方前端 AES 解密(`AES-128-ECB-PKCS7` + hex ⇒ UTF-8 明文)。 +/// +/// 🔴 **best-effort**:不是 hex / 长度不是 16 的整数倍 / PKCS7 填充不合法 ⇒ `None` +/// (**绝不 panic**,也不「猜」)。 +fn decrypt_front_aes(raw: &str) -> Option { + let mut ct = hex::decode(raw.trim()).ok()?; + if ct.is_empty() || ct.len() % 16 != 0 { + return None; + } + let key = FRONT_AES_KEY.as_bytes(); + let dec = Aes128EcbDec::new_from_slice(key).ok()?; + let pt = dec.decrypt_padded_mut::(&mut ct).ok()?; + String::from_utf8(pt.to_vec()).ok() +} + +/// 解开官方前端的任务标识:`AES("taskId,userId,uuid")` ⇒ `(taskId, userId)`。 +/// +/// 🔴 官方前端 `api/workFlow/task.ts:22` 加密的是 `${id},${userInfo.userId},${uuid}`, +/// 官方 `TaskController.getInfo` 取**第一段**当任务 id、**第二段**当用户 id。 +/// +/// 🔴 **官方用的是「登录时协商出来的动态 AES 密钥」**(走 `K1` 头 RSA 加密), +/// 本仓没有协商机制 ⇒ **尽力而为**: +/// ① 先试静态 `front-aes-key` 解密; +/// ② 解不开但**明文里带逗号** ⇒ 当成没加密的 `taskId,userId,uuid`; +/// ③ 都不行 ⇒ 整段当**明文任务 id**。 +/// —— **绝不因为解不开就拒掉合法 id**。 +fn decode_task_id(raw: &str) -> (String, String) { + let raw = raw.trim(); + if raw.is_empty() { + return (String::new(), String::new()); + } + let plain = decrypt_front_aes(raw).unwrap_or_else(|| raw.to_string()); + let mut parts = plain.split(','); + let task_id = parts.next().unwrap_or_default().trim().to_string(); + let user_id = parts.next().unwrap_or_default().trim().to_string(); + if task_id.is_empty() { + return (String::new(), String::new()); + } + (task_id, user_id) +} + +/// 「这个人是不是这条流程的归属人」—— 🔴 **账号与 id 双判**(本仓写 `f_creator_user_id` +/// 用的是**账号**,官方历史数据里是 **id** ⇒ 两种都收)。 +fn owned_by(row: &Value, user_id: &str, account: &str) -> bool { + let creator = row["creatorUserId"].as_str().unwrap_or_default(); + creator == user_id || creator == account +} + +// ---------------------------------------------------------------- 写白名单 + +/// `workflow_template` 的写白名单:`(JSON 键, 列名, CAST)`。 +const TEMPLATE_WRITE_FIELDS: &[(&str, &str, &str)] = &[ + ("enCode", "f_en_code", ""), + ("fullName", "f_full_name", ""), + ("type", "f_type", "::integer"), + ("category", "f_category", ""), + ("icon", "f_icon", ""), + ("iconBackground", "f_icon_background", ""), + ("description", "f_description", ""), + ("sortCode", "f_sort_code", "::bigint"), + ("configuration", "f_configuration", ""), + ("flowConfig", "f_flow_config", ""), + ("showType", "f_show_type", "::integer"), + ("status", "f_status", "::integer"), + ("decisionType", "f_decision_type", "::integer"), + ("visibleType", "f_visible_type", "::integer"), + ("enabledMark", "f_enabled_mark", "::integer"), +]; + +/// `workflow_delegate` 的写白名单。 +/// 🔴 `startTime` / `endTime` **不在白名单里**:官方传的是 **epoch 毫秒**, +/// 必须走 `ms_to_ts()` 转时间戳,不能原样塞进 `::timestamp`。 +const DELEGATE_WRITE_FIELDS: &[(&str, &str, &str)] = &[ + ("flowId", "f_flow_id", ""), + ("flowName", "f_flow_name", ""), + ("type", "f_type", "::integer"), + ("description", "f_description", ""), + ("enabledMark", "f_enabled_mark", "::integer"), + ("sortCode", "f_sort_code", "::bigint"), +]; + +/// `workflow_comment` 的写白名单。 +const COMMENT_WRITE_FIELDS: &[(&str, &str, &str)] = &[ + ("taskId", "f_task_id", ""), + ("replyId", "f_reply_id", ""), + ("text", "f_text", ""), + ("image", "f_image", ""), + ("file", "f_file", ""), + ("deleteShow", "f_delete_show", "::integer"), + ("enabledMark", "f_enabled_mark", "::integer"), +]; + +// ---------------------------------------------------------------- 投影 + +/// 流程模板列表投影(官方 `TemplatePageLisVO`)。 +const TEMPLATE_LIST_COLUMNS: &str = "t.f_id AS \"id\", t.f_full_name AS \"fullName\", \ + t.f_en_code AS \"enCode\", t.f_category AS \"category\", COALESCE(t.f_type, 0) AS \"type\", \ + COALESCE(t.f_sort_code, 0) AS \"sortCode\", t.f_icon AS \"icon\", \ + t.f_icon_background AS \"iconBackground\", t.f_flow_id AS \"flowId\", \ + COALESCE(t.f_visible_type, 0) AS \"visibleType\", COALESCE(t.f_show_type, 0) AS \"showType\", \ + COALESCE(t.f_status, 0) AS \"status\", COALESCE(t.f_enabled_mark, 0) AS \"enabledMark\", \ + (EXTRACT(EPOCH FROM t.f_creator_time) * 1000)::bigint AS \"creatorTime\", \ + t.f_creator_user_id AS \"creatorUserId\", \ + COALESCE(u.f_real_name, '') || '/' || COALESCE(u.f_account, '') AS \"creatorUser\""; + +/// 流程模板详情投影(官方 `TemplateInfoVO`)。 +const TEMPLATE_DETAIL_COLUMNS: &str = "t.f_id AS \"id\", t.f_full_name AS \"fullName\", \ + t.f_en_code AS \"enCode\", t.f_flow_id AS \"flowId\", t.f_version AS \"version\", \ + COALESCE(t.f_type, 0) AS \"type\", t.f_category AS \"category\", t.f_icon AS \"icon\", \ + t.f_icon_background AS \"iconBackground\", t.f_configuration AS \"configuration\", \ + t.f_description AS \"description\", COALESCE(t.f_enabled_mark, 0) AS \"enabledMark\", \ + COALESCE(t.f_sort_code, 0) AS \"sortCode\", t.f_flow_config AS \"flowConfig\", \ + COALESCE(t.f_show_type, 0) AS \"showType\", COALESCE(t.f_status, 0) AS \"status\", \ + COALESCE(t.f_visible_type, 0) AS \"visibleType\", \ + COALESCE(t.f_decision_type, 0) AS \"decisionType\", \ + t.f_system_id AS \"systemId\", t.f_creator_user_id AS \"creatorUserId\", \ + (EXTRACT(EPOCH FROM t.f_creator_time) * 1000)::bigint AS \"creatorTime\", \ + t.f_last_modify_user_id AS \"lastModifyUserId\", \ + (EXTRACT(EPOCH FROM t.f_last_modify_time) * 1000)::bigint AS \"lastModifyTime\""; + +/// 流程版本详情投影(官方 `TemplateJsonInfoVO`)。 +const VERSION_DETAIL_COLUMNS: &str = "v.f_id AS \"id\", v.f_template_id AS \"templateId\", \ + v.f_version AS \"version\", v.f_xml AS \"xml\", COALESCE(v.f_status, 0) AS \"state\", \ + COALESCE(v.f_sort_code, 0) AS \"sortCode\", v.f_send_config_ids AS \"sendConfigIds\", \ + v.f_creator_user_id AS \"creatorUserId\", \ + (EXTRACT(EPOCH FROM v.f_creator_time) * 1000)::bigint AS \"creatorTime\""; + +/// 流程任务列表投影(官方 `TaskVo`)。 +const TASK_LIST_COLUMNS: &str = "t.f_id AS \"id\", t.f_en_code AS \"enCode\", \ + t.f_full_name AS \"fullName\", t.f_flow_name AS \"flowName\", t.f_flow_code AS \"flowCode\", \ + COALESCE(t.f_status, 0) AS \"status\", t.f_flow_category AS \"flowCategory\", \ + COALESCE(t.f_flow_type, 0) AS \"flowType\", t.f_flow_version AS \"flowVersion\", \ + COALESCE(t.f_is_async, 0) AS \"isAsync\", t.f_parent_id AS \"parentId\", \ + COALESCE(t.f_urgent, 0) AS \"flowUrgent\", t.f_template_id AS \"templateId\", \ + t.f_flow_id AS \"flowId\", t.f_instance_id AS \"instanceId\", \ + COALESCE(t.f_engine_type, 0) AS \"engineType\", t.f_delegate_user_id AS \"delegateUser\", \ + (EXTRACT(EPOCH FROM t.f_start_time) * 1000)::bigint AS \"startTime\", \ + (EXTRACT(EPOCH FROM t.f_end_time) * 1000)::bigint AS \"endTime\", \ + t.f_current_node_name AS \"currentNodeName\", t.f_creator_user_id AS \"creatorUserId\", \ + (EXTRACT(EPOCH FROM t.f_creator_time) * 1000)::bigint AS \"creatorTime\", \ + COALESCE(u.f_real_name, '') || '/' || COALESCE(u.f_account, '') AS \"creatorUser\""; + +/// 经办列表投影(官方 `OperatorVo`)。 +const OPERATOR_LIST_COLUMNS: &str = "o.f_id AS \"id\", o.f_node_name AS \"nodeName\", \ + o.f_node_code AS \"nodeCode\", o.f_task_id AS \"taskId\", o.f_node_id AS \"nodeId\", \ + o.f_parent_id AS \"parentId\", \ + (EXTRACT(EPOCH FROM o.f_handle_time) * 1000)::bigint AS \"handleTime\", \ + o.f_handle_id AS \"handleId\", COALESCE(o.f_handle_status, 0) AS \"handleStatus\", \ + o.f_handle_parameter AS \"handleParameter\", \ + (EXTRACT(EPOCH FROM o.f_start_handle_time) * 1000)::bigint AS \"startHandleTime\", \ + (EXTRACT(EPOCH FROM o.f_sign_time) * 1000)::bigint AS \"signTime\", \ + (EXTRACT(EPOCH FROM o.f_duedate) * 1000)::bigint AS \"duedate\", \ + COALESCE(o.f_status, 0) AS \"status\", o.f_instance_id AS \"instanceId\", \ + COALESCE(o.f_engine_type, 0) AS \"engineType\", o.f_draft_data AS \"draftData\", \ + COALESCE(o.f_is_processing, 0) AS \"isProcessing\", o.f_creator_user_id AS \"creatorUserId\", \ + (EXTRACT(EPOCH FROM o.f_creator_time) * 1000)::bigint AS \"creatorTime\", \ + COALESCE(u.f_real_name, '') || '/' || COALESCE(u.f_account, '') AS \"creatorUser\", \ + t.f_full_name AS \"fullName\", t.f_flow_name AS \"flowName\", \ + COALESCE(t.f_urgent, 0) AS \"flowUrgent\", t.f_current_node_name AS \"currentNodeName\", \ + t.f_flow_id AS \"flowId\", t.f_flow_version AS \"flowVersion\", \ + (EXTRACT(EPOCH FROM t.f_start_time) * 1000)::bigint AS \"startTime\", \ + t.f_flow_category AS \"flowCategory\", t.f_delegate_user_id AS \"delegateUser\""; + +/// 流程评论投影(官方 `CommentListVO`)。 +const COMMENT_LIST_COLUMNS: &str = "c.f_id AS \"id\", c.f_task_id AS \"taskId\", \ + c.f_reply_id AS \"replyId\", c.f_text AS \"text\", c.f_image AS \"image\", \ + c.f_file AS \"file\", COALESCE(c.f_delete_show, 0) AS \"deleteShow\", \ + c.f_creator_user_id AS \"creatorUserId\", \ + (EXTRACT(EPOCH FROM c.f_creator_time) * 1000)::bigint AS \"creatorTime\", \ + COALESCE(u.f_real_name, '') || '/' || COALESCE(u.f_account, '') AS \"creatorUser\""; + +/// 流程委托投影(官方 `DelegateListVO`)。 +const DELEGATE_LIST_COLUMNS: &str = "d.f_id AS \"id\", COALESCE(d.f_type, 0) AS \"type\", \ + d.f_user_id AS \"userId\", d.f_user_name AS \"userName\", \ + d.f_flow_id AS \"flowId\", d.f_flow_name AS \"flowName\", d.f_description AS \"description\", \ + (EXTRACT(EPOCH FROM d.f_start_time) * 1000)::bigint AS \"startTime\", \ + (EXTRACT(EPOCH FROM d.f_end_time) * 1000)::bigint AS \"endTime\", \ + COALESCE(d.f_enabled_mark, 0) AS \"enabledMark\", \ + COALESCE(i.f_status, 0) AS \"status\", \ + COALESCE(i.f_to_user_id, '') AS \"toUserId\", \ + COALESCE(i.f_to_user_name, '') AS \"toUserName\""; + +/// 流程监控投影(官方 `MonitorVo` —— 与任务同源,只是多几个监控字段)。 +const MONITOR_LIST_COLUMNS: &str = "t.f_id AS \"id\", t.f_en_code AS \"enCode\", \ + t.f_full_name AS \"fullName\", t.f_flow_name AS \"flowName\", t.f_flow_code AS \"flowCode\", \ + COALESCE(t.f_status, 0) AS \"status\", t.f_flow_category AS \"flowCategory\", \ + COALESCE(t.f_flow_type, 0) AS \"flowType\", t.f_flow_version AS \"flowVersion\", \ + COALESCE(t.f_is_async, 0) AS \"isAsync\", t.f_parent_id AS \"parentCode\", \ + t.f_parent_id AS \"parentId\", COALESCE(t.f_urgent, 0) AS \"flowUrgent\", \ + t.f_template_id AS \"templateId\", t.f_flow_id AS \"flowId\", \ + COALESCE(t.f_is_async, 0) AS \"isBatch\", t.f_delegate_user_id AS \"delegateUserId\", \ + (EXTRACT(EPOCH FROM t.f_start_time) * 1000)::bigint AS \"startTime\", \ + (EXTRACT(EPOCH FROM t.f_end_time) * 1000)::bigint AS \"endTime\", \ + t.f_current_node_name AS \"currentNodeName\", t.f_current_node_code AS \"assignNode\", \ + COALESCE(t.f_is_file, 0) AS \"isFile\", t.f_creator_user_id AS \"creatorUserId\", \ + (EXTRACT(EPOCH FROM t.f_creator_time) * 1000)::bigint AS \"creatorTime\", \ + COALESCE(u.f_real_name, '') || '/' || COALESCE(u.f_account, '') AS \"creatorUser\""; + +/// 触发任务投影(官方 `TriggerTaskModel`)。 +const TRIGGER_LIST_COLUMNS: &str = "g.f_id AS \"id\", g.f_full_name AS \"fullName\", \ + (EXTRACT(EPOCH FROM g.f_parent_time) * 1000)::bigint AS \"parentTime\", \ + g.f_parent_id AS \"parentId\", g.f_task_id AS \"taskId\", g.f_node_code AS \"nodeCode\", \ + g.f_node_id AS \"nodeId\", COALESCE(g.f_is_async, 0) AS \"isAsync\", \ + (EXTRACT(EPOCH FROM g.f_start_time) * 1000)::bigint AS \"startTime\", \ + g.f_flow_id AS \"flowId\", COALESCE(g.f_status, 0) AS \"status\", \ + g.f_creator_user_id AS \"creatorUserId\", \ + (EXTRACT(EPOCH FROM g.f_creator_time) * 1000)::bigint AS \"creatorTime\""; + +/// 事件日志投影(官方 `EventLogEntity` 列表项)。 +const EVENT_LOG_COLUMNS: &str = "e.f_id AS \"id\", e.f_task_id AS \"taskId\", \ + e.f_node_id AS \"nodeId\", e.f_node_name AS \"nodeName\", e.f_node_code AS \"nodeCode\", \ + e.f_type AS \"type\", e.f_up_node AS \"upNode\", e.f_interface_id AS \"interfaceId\", \ + e.f_data AS \"data\", e.f_result AS \"result\", COALESCE(e.f_status, 0) AS \"status\", \ + (EXTRACT(EPOCH FROM e.f_creator_time) * 1000)::bigint AS \"creatorTime\""; + +// ================================================================ 流程模板(Template) + +/// `GET /api/workflow/template` —— 流程列表(分页)。 +/// +/// 官方 `api/workFlow/template.ts:11`(`getList`)⇒ 官方 `TemplateController.java:117`。 +/// +/// 🔴 **`data` 是 `PageListVO`**(官方前端 `useVxeTable` 读 `data.list` + `data.pagination.total`)。 +pub async fn workflow_template_list( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let page = Paging::of(&raw); + let keyword = qv(&raw, "keyword"); + let category = qv(&raw, "category"); + let system_id = current_system_id(&state, &headers).await; + + let mut filters: Vec = Vec::new(); + let mut values: Vec> = vec![Some(system_id.clone())]; + let mut next = 2usize; + + if !keyword.is_empty() { + filters.push(format!( + "AND (t.f_full_name ILIKE ${next}::text OR t.f_en_code ILIKE ${next}::text)" + )); + values.push(Some(format!("%{keyword}%"))); + next += 1; + } + if !category.is_empty() { + filters.push(format!("AND t.f_category = ${next}::text")); + values.push(Some(category)); + } + let where_body = format!( + "COALESCE(t.f_delete_mark, 0) = 0 AND t.f_system_id = $1::text{}", + if filters.is_empty() { + String::new() + } else { + format!(" {}", filters.join(" ")) + } + ); + let from_sql = "workflow_template t LEFT JOIN base_user u ON u.f_id = t.f_creator_user_id"; + match paged_query( + &state, + TEMPLATE_LIST_COLUMNS, + from_sql, + &where_body, + "ORDER BY COALESCE(t.f_sort_code, 0) ASC, t.f_creator_time DESC", + values, + &page, + "流程模板列表", + ) + .await + { + Ok((total, rows)) => ok(page_list(page.current_page, page.page_size, total, rows)), + Err(resp) => resp, + } +} + +/// `POST /api/workflow/template` —— 新建流程。 +/// +/// 官方 `api/workFlow/template.ts:19` ⇒ 官方 `TemplateController.java:265` +/// (`@SaCheckPermission({"onlineDev.flowEngine"})` @267)。 +/// +/// 🔴 **本仓落的是「流程元数据」**:模板行(`workflow_template`)+ 版本行 +/// (`workflow_version`,存 `flowXml`)+ 节点行(`workflow_node`,存 `flowNodes`)。 +/// **流程引擎不接** ⇒ 建出来的流程**跑不起来**(那是官方引擎的活)。 +/// +/// 🔴 **`data` 是裸 id 字符串**(官方 `ActionResult.success(msg, entity.getId())`)。 +pub async fn workflow_template_create( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + let user = match guard(&state, &headers, EN_FLOW_ENGINE).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let obj = match body_obj(&body) { + Ok(o) => o, + Err(resp) => return resp, + }; + let full_name = text_field(&obj, "fullName").unwrap_or_default(); + if full_name.is_empty() { + return fail(code::FAIL, "流程名称不能为空"); + } + let system_id = current_system_id(&state, &headers).await; + + let new_id = new_uuid(); + let mut columns: Vec<&str> = vec!["f_id", "f_tenant_id", "f_system_id"]; + let mut casts: Vec<&str> = vec!["", "", ""]; + let mut values: Vec> = vec![ + Some(new_id.clone()), + Some("0".to_string()), + Some(system_id), + ]; + for (column, cast, value) in write_fields(&obj, TEMPLATE_WRITE_FIELDS) { + columns.push(column); + casts.push(cast); + values.push(value); + } + // 🔴 `f_type` 在白名单里(JSON 键 `type`)⇒ 请求没带时要补默认值 0 + // (列可空,但官方语义「模板类型」缺省就是 0)。 + if !obj.contains_key("type") { + columns.push("f_type"); + casts.push("::integer"); + values.push(Some("0".to_string())); + } + columns.push("f_delete_mark"); + casts.push("::integer"); + values.push(Some("0".to_string())); + columns.push("f_creator_user_id"); + casts.push(""); + values.push(Some(user.account.clone())); + columns.push("f_creator_time"); + + let mut marks: Vec = (0..values.len()) + .map(|i| placeholder(i + 1, casts[i])) + .collect(); + marks.push("now()".to_string()); + let sql = format!( + "INSERT INTO workflow_template ({}) VALUES ({})", + columns.join(", "), + marks.join(", ") + ); + if let Err(e) = state.db.exec_params(&sql, ¶ms_of(&values)).await { + return db_error(e, "新建流程模板"); + } + + // 🔴 **版本 + 节点是可选的**(官方 `flowXml` / `flowNodes` 缺了也能建模板)。 + let flow_xml = text_field(&obj, "flowXml"); + let version_id = new_uuid(); + if let Err(resp) = insert_version(&state, &new_id, &version_id, flow_xml.as_deref(), &user.account) + .await + { + return resp; + } + if let Some(Value::Object(nodes)) = obj.get("flowNodes") { + if let Err(resp) = insert_flow_nodes(&state, &version_id, nodes, &user.account).await { + return resp; + } + } + ok(Value::String(new_id)) +} + +/// 写入一条流程版本(`workflow_version`)。 +async fn insert_version( + state: &AppState, + template_id: &str, + version_id: &str, + xml: Option<&str>, + creator: &str, +) -> Result<(), Json> { + let sql = "INSERT INTO workflow_version \ + (f_id, f_tenant_id, f_template_id, f_version, f_xml, f_status, f_sort_code, \ + f_creator_user_id, f_creator_time, f_delete_mark) \ + VALUES ($1::text, $2::text, $3::text, $4::text, $5::text, $6::text::integer, \ + $7::text::bigint, $8::text, now(), 0)"; + let version = text_or( + state, + "SELECT COALESCE(max(CAST(f_version AS integer)), 0) + 1 AS \"v\" FROM workflow_version \ + WHERE f_template_id = $1::text AND COALESCE(f_delete_mark, 0) = 0", + template_id, + ) + .await + .unwrap_or_else(|| "1".to_string()); + let values = vec![ + Some(version_id.to_string()), + Some("0".to_string()), + Some(template_id.to_string()), + Some(version.to_string()), + Some(xml.unwrap_or_default().to_string()), + Some("0".to_string()), + Some("0".to_string()), + Some(creator.to_string()), + ]; + if let Err(e) = state.db.exec_params(sql, ¶ms_of(&values)).await { + return Err(db_error(e, "流程版本写入")); + } + Ok(()) +} + +/// 取一个单值(`{"v": …}` 形状的行)。 +async fn text_or(state: &AppState, sql: &str, arg: &str) -> Option { + let rows = state.db.query_json_params(sql, &[&arg]).await.ok()?; + rows.first()?.get("v").map(|v| match v { + Value::Number(n) => n.to_string(), + Value::String(s) => s.clone(), + _ => String::new(), + }) +} + +/// 把 `flowNodes`(`Map`)写进 `workflow_node`。 +async fn insert_flow_nodes( + state: &AppState, + flow_id: &str, + nodes: &Map, + creator: &str, +) -> Result<(), Json> { + for (node_code, node_json) in nodes { + let payload = serde_json::to_string(node_json).unwrap_or_default(); + // 🔴 官方 `NodeEnum` 是**字符串枚举**(`start` / `end` / `approver` …), + // 而 `f_node_type` 是 `VARCHAR(50)` ⇒ 直接存节点 JSON 里的 `type`。 + let node_type = node_json + .get("type") + .and_then(|v| v.as_str()) + .unwrap_or("0") + .to_string(); + let form_id = node_json + .get("formId") + .and_then(|v| v.as_str()) + .unwrap_or_default() + .to_string(); + let sql = "INSERT INTO workflow_node \ + (f_id, f_tenant_id, f_flow_id, f_form_id, f_node_type, f_node_code, \ + f_node_json, f_sort_code, f_creator_user_id, f_creator_time, f_delete_mark) \ + VALUES ($1::text, $2::text, $3::text, $4::text, $5::text, $6::text, \ + $7::text, $8::text::bigint, $9::text, now(), 0)"; + let values = vec![ + Some(new_uuid()), + Some("0".to_string()), + Some(flow_id.to_string()), + Some(form_id), + Some(node_type), + Some(node_code.clone()), + Some(payload), + Some("0".to_string()), + Some(creator.to_string()), + ]; + if let Err(e) = state.db.exec_params(sql, ¶ms_of(&values)).await { + return Err(db_error(e, "流程节点写入")); + } + } + Ok(()) +} + +/// `PUT /api/workflow/template/{id}` —— 更新流程。 +/// +/// 官方 `api/workFlow/template.ts:23` ⇒ 官方 `TemplateController.java:285` +/// (`@SaCheckPermission({"onlineDev.flowEngine"})` @288)。 +pub async fn workflow_template_update( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + let user = match guard(&state, &headers, EN_FLOW_ENGINE).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let id = id.trim().to_string(); + let obj = match body_obj(&body) { + Ok(o) => o, + Err(resp) => return resp, + }; + let exists = match state + .db + .query_json_params( + "SELECT f_id AS \"id\" FROM workflow_template \ + WHERE f_id = $1::text AND COALESCE(f_delete_mark, 0) = 0 LIMIT 1", + &[&id], + ) + .await + { + Ok(rows) => !rows.is_empty(), + Err(e) => return db_error(e, "流程模板存在性查询"), + }; + if !exists { + return fail(code::FAIL, "流程不存在"); + } + + let fields = write_fields(&obj, TEMPLATE_WRITE_FIELDS); + if !fields.is_empty() { + let mut set_parts: Vec = Vec::new(); + let mut values: Vec> = Vec::new(); + for (column, cast, value) in fields { + values.push(value); + set_parts.push(format!("{} = {}", column, placeholder(values.len(), cast))); + } + values.push(Some(id.clone())); + let p_id = values.len(); + values.push(Some(user.account.clone())); + let p_user = values.len(); + set_parts.push("f_last_modify_time = now()".to_string()); + set_parts.push(format!("f_last_modify_user_id = ${p_user}::text")); + let sql = format!( + "UPDATE workflow_template SET {} WHERE f_id = ${p_id}::text", + set_parts.join(", ") + ); + if let Err(e) = state.db.exec_params(&sql, ¶ms_of(&values)).await { + return db_error(e, "更新流程模板"); + } + } + + // 🔴 官方 `PUT /{id}` 是「更新流程」(含流程图)⇒ 本仓把 `flowXml` 落成**新版本**。 + if let Some(xml) = text_field(&obj, "flowXml") { + let version_id = new_uuid(); + if let Err(resp) = insert_version(&state, &id, &version_id, Some(&xml), &user.account).await { + return resp; + } + if let Some(Value::Object(nodes)) = obj.get("flowNodes") { + if let Err(resp) = insert_flow_nodes(&state, &version_id, nodes, &user.account).await { + return resp; + } + } + } + ok(Value::String(id)) +} + +/// `GET /api/workflow/template/{id}` —— 流程基础信息。 +/// +/// 官方 `api/workFlow/template.ts:27` ⇒ 官方 `TemplateController.java:216`。 +/// +/// 🔴 **`data` 是裸对象**(官方 `state.dataForm = res.data`)。 +pub async fn workflow_template_info( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let id = id.trim().to_string(); + let sql = format!( + "SELECT {} FROM workflow_template t \ + WHERE t.f_id = $1::text AND COALESCE(t.f_delete_mark, 0) = 0 LIMIT 1", + TEMPLATE_DETAIL_COLUMNS + ); + let rows = match state.db.query_json_params(&sql, &[&id]).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "流程详情查询"), + }; + match rows.into_iter().next() { + Some(row) => ok(row), + None => fail(code::FAIL, "流程不存在"), + } +} + +/// `DELETE /api/workflow/template/{id}` —— 删除流程(软删)。 +/// +/// 官方 `api/workFlow/template.ts:31` ⇒ 官方 `TemplateController.java:323` +/// (`@SaCheckPermission({"onlineDev.flowEngine"})` @325)。 +pub async fn workflow_template_delete( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + let user = match guard(&state, &headers, EN_FLOW_ENGINE).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let id = id.trim().to_string(); + let sql = "UPDATE workflow_template \ + SET f_delete_mark = 1, f_delete_time = now(), f_delete_user_id = $1::text \ + WHERE f_id = $2::text AND COALESCE(f_delete_mark, 0) = 0"; + if let Err(e) = state + .db + .exec_params(sql, ¶ms_of(&[Some(user.account.clone()), Some(id)])) + .await + { + return db_error(e, "删除流程模板"); + } + ok(Value::Null) +} + +/// `POST /api/workflow/template/{id}/Actions/Copy` —— 复制流程。 +/// +/// 官方 `api/workFlow/template.ts:35` ⇒ 官方 `TemplateController.java:385` +/// (`@SaCheckPermission({"onlineDev.flowEngine"})` @387)。 +/// +/// 🔴 官方返的是**消息**(`data` 为 null)⇒ 本仓同口径。 +pub async fn workflow_template_copy( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + let user = match guard(&state, &headers, EN_FLOW_ENGINE).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let id = id.trim().to_string(); + let source = match state + .db + .query_json_params( + "SELECT f_id AS \"id\", f_full_name AS \"fullName\", f_en_code AS \"enCode\", \ + f_flow_id AS \"flowId\", f_type AS \"type\", f_category AS \"category\", \ + f_icon AS \"icon\", f_icon_background AS \"iconBackground\", \ + f_description AS \"description\", f_enabled_mark AS \"enabledMark\", \ + f_sort_code AS \"sortCode\", f_configuration AS \"configuration\", \ + f_flow_config AS \"flowConfig\", f_show_type AS \"showType\", \ + f_visible_type AS \"visibleType\", f_decision_type AS \"decisionType\", \ + f_system_id AS \"systemId\" \ + FROM workflow_template \ + WHERE f_id = $1::text AND COALESCE(f_delete_mark, 0) = 0 LIMIT 1", + &[&id], + ) + .await + { + Ok(rows) => rows.into_iter().next(), + Err(e) => return db_error(e, "复制流程(源查询)"), + }; + let Some(src) = source else { + return fail(code::FAIL, "流程不存在"); + }; + + let new_id = new_uuid(); + let sql = "INSERT INTO workflow_template \ + (f_id, f_tenant_id, f_system_id, f_full_name, f_en_code, f_flow_id, f_type, \ + f_category, f_icon, f_icon_background, f_description, f_enabled_mark, \ + f_sort_code, f_configuration, f_flow_config, f_show_type, f_visible_type, \ + f_decision_type, f_status, f_delete_mark, f_creator_user_id, f_creator_time) \ + VALUES ($1::text, $2::text, $3::text, $4::text, $5::text, $6::text, $7::text::integer, \ + $8::text, $9::text, $10::text, $11::text, $12::text::integer, $13::text::bigint, $14::text, \ + $15::text, $16::text::integer, $17::text::integer, $18::text::integer, $19::text::integer, 0, \ + $20::text, now())"; + let text_of = |key: &str| src[key].as_str().unwrap_or_default().to_string(); + let num_of = |key: &str| src[key].as_i64().unwrap_or(0).to_string(); + let values = vec![ + Some(new_id.clone()), + Some("0".to_string()), + Some(text_of("systemId")), + Some(format!("{}-副本", text_of("fullName"))), + Some(format!("{}_copy", text_of("enCode"))), + Some(text_of("flowId")), + Some(num_of("type")), + Some(text_of("category")), + Some(text_of("icon")), + Some(text_of("iconBackground")), + Some(text_of("description")), + Some(num_of("enabledMark")), + Some(num_of("sortCode")), + Some(text_of("configuration")), + Some(text_of("flowConfig")), + Some(num_of("showType")), + Some(num_of("visibleType")), + Some(num_of("decisionType")), + Some(SHELF_NONE.to_string()), + Some(user.account.clone()), + ]; + if let Err(e) = state.db.exec_params(sql, ¶ms_of(&values)).await { + return db_error(e, "复制流程模板"); + } + + // 🔴 版本与节点一起复制(官方 `templateService.copy` 同款:版本复制 + 节点复制)。 + let versions = match state + .db + .query_json_params( + "SELECT f_id AS \"id\", f_version AS \"version\", f_xml AS \"xml\", \ + f_send_config_ids AS \"sendConfigIds\" \ + FROM workflow_version \ + WHERE f_template_id = $1::text AND COALESCE(f_delete_mark, 0) = 0 \ + ORDER BY COALESCE(f_sort_code, 0) ASC", + &[&id], + ) + .await + { + Ok(rows) => rows, + Err(e) => return db_error(e, "复制流程(版本查询)"), + }; + for v in &versions { + let new_version_id = new_uuid(); + let copy_sql = "INSERT INTO workflow_version \ + (f_id, f_tenant_id, f_template_id, f_version, f_xml, f_status, \ + f_sort_code, f_send_config_ids, f_creator_user_id, \ + f_creator_time, f_delete_mark) \ + VALUES ($1::text, $2::text, $3::text, $4::text, $5::text, $6::text::integer, \ + $7::text::bigint, $8::text, $9::text, now(), 0)"; + let copy_values = vec![ + Some(new_version_id.clone()), + Some("0".to_string()), + Some(new_id.clone()), + Some(v["version"].as_str().unwrap_or_default().to_string()), + Some(v["xml"].as_str().unwrap_or_default().to_string()), + Some("0".to_string()), + Some("0".to_string()), + Some(v["sendConfigIds"].as_str().unwrap_or_default().to_string()), + Some(user.account.clone()), + ]; + if let Err(e) = state.db.exec_params(copy_sql, ¶ms_of(©_values)).await { + return db_error(e, "复制流程版本"); + } + let nodes = match state + .db + .query_json_params( + "SELECT f_node_code AS \"nodeCode\", f_node_json AS \"nodeJson\", \ + f_node_type AS \"nodeType\", f_form_id AS \"formId\" \ + FROM workflow_node \ + WHERE f_flow_id = $1::text AND COALESCE(f_delete_mark, 0) = 0", + &[&v["id"].as_str().unwrap_or_default()], + ) + .await + { + Ok(rows) => rows, + Err(e) => return db_error(e, "复制流程(节点查询)"), + }; + for n in &nodes { + let node_sql = "INSERT INTO workflow_node \ + (f_id, f_tenant_id, f_flow_id, f_form_id, f_node_type, f_node_code, \ + f_node_json, f_sort_code, f_creator_user_id, f_creator_time, \ + f_delete_mark) \ + VALUES ($1::text, $2::text, $3::text, $4::text, $5::text, $6::text, \ + $7::text, $8::text::bigint, $9::text, now(), 0)"; + let node_values = vec![ + Some(new_uuid()), + Some("0".to_string()), + Some(new_version_id.clone()), + Some(n["formId"].as_str().unwrap_or_default().to_string()), + Some(n["nodeType"].as_str().unwrap_or("0").to_string()), + Some(n["nodeCode"].as_str().unwrap_or_default().to_string()), + Some(n["nodeJson"].as_str().unwrap_or_default().to_string()), + Some("0".to_string()), + Some(user.account.clone()), + ]; + if let Err(e) = state.db.exec_params(node_sql, ¶ms_of(&node_values)).await { + return db_error(e, "复制流程节点"); + } + } + } + ok(Value::Null) +} + +/// `GET /api/workflow/template/{id}/Actions/Export` —— 导出流程。 +/// +/// 官方 `api/workFlow/template.ts:39` ⇒ 官方 `TemplateController.java:428`。 +/// +/// 🔴 本仓无文件服务 ⇒ **明确业务失败**(不返假下载链接)。 +pub async fn workflow_template_export( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = id; + unsupported_file("流程导出") +} + +/// `PUT /api/workflow/template/{id}/UpdateType` —— 简单流程切换为标准流程。 +/// +/// 官方 `api/workFlow/template.ts:43` ⇒ 官方 `TemplateController.java:308` +/// (`@SaCheckPermission({"onlineDev.flowEngine"})` @309)。 +pub async fn workflow_template_update_type( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + let user = match guard(&state, &headers, EN_FLOW_ENGINE).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let id = id.trim().to_string(); + let sql = "UPDATE workflow_template \ + SET f_type = $1::text::integer, f_last_modify_time = now(), \ + f_last_modify_user_id = $2::text \ + WHERE f_id = $3::text AND COALESCE(f_delete_mark, 0) = 0"; + // 🔴 官方 `FlowNature.STANDARD = 0`(`SIMPLE = 1`)。 + let values = vec![ + Some("0".to_string()), + Some(user.account.clone()), + Some(id), + ]; + if let Err(e) = state.db.exec_params(sql, ¶ms_of(&values)).await { + return db_error(e, "更新流程类型"); + } + ok(Value::Null) +} + +/// `POST /api/workflow/template/Save` —— 流程保存或发布。 +/// +/// 官方 `api/workFlow/template.ts:47` ⇒ 官方 `TemplateController.java:415` +/// (`@SaCheckPermission({"onlineDev.flowEngine"})` @416)。 +/// +/// 🔴 本仓把 `flowXml` 落成**新版本**行、`flowNodes` 落成节点行 —— **引擎不接** ⇒ +/// 「发布」这一步(把版本挂到引擎)本仓**做不到**。 +pub async fn workflow_template_save( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + let user = match guard(&state, &headers, EN_FLOW_ENGINE).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let obj = match body_obj(&body) { + Ok(o) => o, + Err(resp) => return resp, + }; + let template_id = text_field(&obj, "id").unwrap_or_default(); + if template_id.is_empty() { + return fail(code::FAIL, "流程主键不能为空"); + } + let exists = match state + .db + .query_json_params( + "SELECT f_id AS \"id\" FROM workflow_template \ + WHERE f_id = $1::text AND COALESCE(f_delete_mark, 0) = 0 LIMIT 1", + &[&template_id], + ) + .await + { + Ok(rows) => !rows.is_empty(), + Err(e) => return db_error(e, "流程模板存在性查询"), + }; + if !exists { + return fail(code::FAIL, "流程不存在"); + } + let version_id = new_uuid(); + if let Err(resp) = + insert_version(&state, &template_id, &version_id, text_field(&obj, "flowXml").as_deref(), &user.account) + .await + { + return resp; + } + if let Some(Value::Object(nodes)) = obj.get("flowNodes") { + if let Err(resp) = insert_flow_nodes(&state, &version_id, nodes, &user.account).await { + return resp; + } + } + ok(Value::Null) +} + +/// `GET /api/workflow/template/Info/{id}` —— 流程版本信息。 +/// +/// 官方 `api/workFlow/template.ts:51` ⇒ 官方 `TemplateController.java:253`。 +/// +/// 🔴 **`data` 是裸对象**(官方 `TemplateJsonInfoVO`)。 +pub async fn workflow_template_json_info( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let id = id.trim().to_string(); + let sql = format!( + "SELECT {} FROM workflow_version v \ + WHERE v.f_id = $1::text AND COALESCE(v.f_delete_mark, 0) = 0 LIMIT 1", + VERSION_DETAIL_COLUMNS + ); + let rows = match state.db.query_json_params(&sql, &[&id]).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "流程版本详情查询"), + }; + match rows.into_iter().next() { + Some(row) => ok(row), + None => fail(code::FAIL, "流程版本不存在"), + } +} + +/// `GET /api/workflow/template/Version/{id}` —— 流程版本列表。 +/// +/// 官方 `api/workFlow/template.ts:55` ⇒ 官方 `TemplateController.java:230`。 +/// +/// 🔴 **`data` 是裸数组**(官方 `ActionResult.success(List)`)。 +pub async fn workflow_template_version_list( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let id = id.trim().to_string(); + let sql = "SELECT v.f_id AS \"id\", v.f_version AS \"flowVersion\", \ + '流程版本V' || COALESCE(v.f_version, '0') AS \"fullName\", \ + COALESCE(v.f_status, 0) AS \"state\" \ + FROM workflow_version v \ + WHERE v.f_template_id = $1::text AND COALESCE(v.f_delete_mark, 0) = 0 \ + AND v.f_version IS NOT NULL AND v.f_version <> '' \ + ORDER BY COALESCE(v.f_sort_code, 0) ASC, v.f_creator_time ASC"; + let rows = match state.db.query_json_params(sql, &[&id]).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "流程版本列表查询"), + }; + ok(Value::Array(rows)) +} + +/// `DELETE /api/workflow/template/Info/{id}` —— 删除流程版本。 +/// +/// 官方 `api/workFlow/template.ts:59` ⇒ 官方 `TemplateController.java:338` +/// (`@SaCheckPermission({"onlineDev.flowEngine"})` @340)。 +/// +/// 🔴 官方的三条前置检查本仓**照抄**:只剩一个版本 ⇒ 不许删;`state=1`(启用中) +/// ⇒ 不许删;`state=2`(历史)⇒ 不许删。 +pub async fn workflow_template_version_delete( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + let user = match guard(&state, &headers, EN_FLOW_ENGINE).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let id = id.trim().to_string(); + let version = match state + .db + .query_json_params( + "SELECT f_id AS \"id\", f_template_id AS \"templateId\", \ + COALESCE(f_status, 0) AS \"state\" \ + FROM workflow_version \ + WHERE f_id = $1::text AND COALESCE(f_delete_mark, 0) = 0 LIMIT 1", + &[&id], + ) + .await + { + Ok(rows) => rows.into_iter().next(), + Err(e) => return db_error(e, "流程版本查询"), + }; + let Some(version) = version else { + return fail(code::FAIL, "流程版本不存在"); + }; + let template_id = version["templateId"].as_str().unwrap_or_default().to_string(); + let count = text_or( + &state, + "SELECT count(*)::bigint AS \"v\" FROM workflow_version \ + WHERE f_template_id = $1::text AND COALESCE(f_delete_mark, 0) = 0", + &template_id, + ) + .await + .and_then(|s| s.parse::().ok()) + .unwrap_or(0); + if count <= 1 { + return fail(code::FAIL, "至少保留一个流程版本"); + } + let status = version["state"].as_i64().unwrap_or(0); + if status == 1 { + return fail(code::FAIL, "启用中的流程版本不允许删除"); + } + if status == 2 { + return fail(code::FAIL, "历史流程版本不允许删除"); + } + let sql = "UPDATE workflow_version \ + SET f_delete_mark = 1, f_delete_time = now(), f_delete_user_id = $1::text \ + WHERE f_id = $2::text AND COALESCE(f_delete_mark, 0) = 0"; + if let Err(e) = state + .db + .exec_params(sql, ¶ms_of(&[Some(user.account.clone()), Some(id)])) + .await + { + return db_error(e, "删除流程版本"); + } + ok(Value::Null) +} + +/// `POST /api/workflow/template/Info/{id}` —— 复制流程版本。 +/// +/// 官方 `api/workFlow/template.ts:63` ⇒ 官方 `TemplateController.java:400` +/// (`@SaCheckPermission({"onlineDev.flowEngine"})` @402)。 +/// +/// 🔴 **`data` 是裸 id 字符串**(官方 `ActionResult.success(msg, templateJsonId)`)。 +pub async fn workflow_template_version_copy( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + let user = match guard(&state, &headers, EN_FLOW_ENGINE).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let id = id.trim().to_string(); + let source = match state + .db + .query_json_params( + "SELECT f_id AS \"id\", f_template_id AS \"templateId\", f_version AS \"version\", \ + f_xml AS \"xml\", f_send_config_ids AS \"sendConfigIds\" \ + FROM workflow_version \ + WHERE f_id = $1::text AND COALESCE(f_delete_mark, 0) = 0 LIMIT 1", + &[&id], + ) + .await + { + Ok(rows) => rows.into_iter().next(), + Err(e) => return db_error(e, "复制流程版本(源查询)"), + }; + let Some(src) = source else { + return fail(code::FAIL, "流程版本不存在"); + }; + let template_id = src["templateId"].as_str().unwrap_or_default().to_string(); + let new_version_id = new_uuid(); + let next_version = text_or( + &state, + "SELECT COALESCE(max(CAST(f_version AS integer)), 0) + 1 AS \"v\" FROM workflow_version \ + WHERE f_template_id = $1::text AND COALESCE(f_delete_mark, 0) = 0", + &template_id, + ) + .await + .unwrap_or_else(|| "1".to_string()); + let sql = "INSERT INTO workflow_version \ + (f_id, f_tenant_id, f_template_id, f_version, f_xml, f_status, f_sort_code, \ + f_send_config_ids, f_creator_user_id, f_creator_time, f_delete_mark) \ + VALUES ($1::text, $2::text, $3::text, $4::text, $5::text, $6::text::integer, \ + $7::text::bigint, $8::text, $9::text, now(), 0)"; + let values = vec![ + Some(new_version_id.clone()), + Some("0".to_string()), + Some(template_id), + Some(next_version), + Some(src["xml"].as_str().unwrap_or_default().to_string()), + Some("0".to_string()), + Some("0".to_string()), + Some(src["sendConfigIds"].as_str().unwrap_or_default().to_string()), + Some(user.account.clone()), + ]; + if let Err(e) = state.db.exec_params(sql, ¶ms_of(&values)).await { + return db_error(e, "复制流程版本"); + } + ok(Value::String(new_version_id)) +} + +/// `GET /api/workflow/template/Selector` —— 流程选择器。 +/// +/// 官方 `api/workFlow/template.ts:67` ⇒ 官方 `TemplateController.java:150`。 +/// +/// 🔴 **`data` 是 `PageListVO`**(官方前端 `useVxeTable` 读 `data.list`)。 +pub async fn workflow_template_selector( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let page = Paging::of(&raw); + let keyword = qv(&raw, "keyword"); + let system_id = current_system_id(&state, &headers).await; + let mut filters: Vec = Vec::new(); + let mut values: Vec> = vec![Some(system_id)]; + let next = 2usize; + if !keyword.is_empty() { + filters.push(format!( + "AND (t.f_full_name ILIKE ${next}::text OR t.f_en_code ILIKE ${next}::text)" + )); + values.push(Some(format!("%{keyword}%"))); + } + let where_body = format!( + "COALESCE(t.f_delete_mark, 0) = 0 AND t.f_system_id = $1::text{}", + if filters.is_empty() { + String::new() + } else { + format!(" {}", filters.join(" ")) + } + ); + let from_sql = "workflow_template t LEFT JOIN base_user u ON u.f_id = t.f_creator_user_id"; + match paged_query( + &state, + TEMPLATE_LIST_COLUMNS, + from_sql, + &where_body, + "ORDER BY COALESCE(t.f_sort_code, 0) ASC, t.f_creator_time DESC", + values, + &page, + "流程选择器", + ) + .await + { + Ok((total, rows)) => ok(page_list(page.current_page, page.page_size, total, rows)), + Err(resp) => resp, + } +} + +/// `GET /api/workflow/template/{id}/FormInfo` —— 流程绑定的表单。 +/// +/// 官方 `api/workFlow/template.ts:71` ⇒ 官方 `TemplateController.java:487`。 +/// +/// 🔴 官方返 `VisualdevEntity`(**在线表单设计器**的实体)⇒ 本仓无 `visualdev_*` 表 ⇒ 明确失败。 +pub async fn workflow_template_form_info( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = id; + unsupported_form("查询流程绑定表单") +} + +/// `GET /api/workflow/template/StartForm/{id}` —— 流程发起页表单。 +/// +/// 官方 `api/workFlow/template.ts:75` ⇒ 官方 `TemplateController.java:566`。 +/// +/// 🔴 官方返 `VisualdevEntity` ⇒ 本仓无在线表单设计器 ⇒ 明确失败。 +pub async fn workflow_template_start_form( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = id; + unsupported_form("查询流程发起页表单") +} + +/// `GET /api/workflow/template/StartFormId/{id}` —— 流程发起页表单主键。 +/// +/// 官方 `api/workFlow/template.ts:79` ⇒ 官方 `TemplateController.java:578`。 +/// +/// 🔴 官方返 `FlowFormModel`(**在线表单实体**:id/enCode/fullName/propertyJson…)⇒ +/// 本仓无表单设计器 ⇒ 明确失败。 +pub async fn workflow_template_start_form_id( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = id; + unsupported_form("查询流程发起页表单主键") +} + +/// `GET /api/workflow/template/TreeList` —— 流程分类树。 +/// +/// 官方 `api/workFlow/template.ts:83` ⇒ 官方 `TemplateController.java:202`。 +/// +/// 🔴 **`data` 是 `ListVO`**(官方 `ActionResult.success(ListVO)`)。 +pub async fn workflow_template_tree_list( + State(state): State, + headers: HeaderMap, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let system_id = current_system_id(&state, &headers).await; + let sql = "SELECT t.f_id AS \"id\", t.f_full_name AS \"fullName\", t.f_en_code AS \"enCode\", \ + t.f_category AS \"category\", COALESCE(t.f_sort_code, 0) AS \"sortCode\", \ + t.f_icon AS \"icon\", t.f_icon_background AS \"iconBackground\", \ + COALESCE(t.f_enabled_mark, 0) AS \"enabledMark\", \ + COALESCE(t.f_status, 0) AS \"status\" \ + FROM workflow_template t \ + WHERE COALESCE(t.f_delete_mark, 0) = 0 AND t.f_system_id = $1::text \ + ORDER BY COALESCE(t.f_sort_code, 0) ASC, t.f_full_name ASC"; + let rows = match state.db.query_json_params(sql, &[&system_id]).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "流程分类树查询"), + }; + let mut roots: Vec = Vec::new(); + let mut index: Vec<(String, usize)> = Vec::new(); + for row in &rows { + let category = row["category"].as_str().unwrap_or_default().to_string(); + if category.is_empty() { + continue; + } + let pos = match index.iter().find(|(c, _)| *c == category) { + Some((_, p)) => *p, + None => { + roots.push(json!({ + "id": category, + "fullName": category, + "enCode": Value::Null, + "category": category, + "sortCode": 0, + "icon": Value::Null, + "iconBackground": Value::Null, + "enabledMark": 1, + "disabled": false, + "num": 0, + "children": Vec::::new(), + })); + index.push((category.clone(), roots.len() - 1)); + roots.len() - 1 + } + }; + let status = row["status"].as_i64().unwrap_or(SHELF_NONE); + let child = json!({ + "id": row["id"].as_str().unwrap_or_default(), + "fullName": row["fullName"].as_str().unwrap_or_default(), + "enCode": row["enCode"].as_str().unwrap_or_default(), + "category": category, + "sortCode": row["sortCode"].as_i64().unwrap_or(0), + "icon": row["icon"].as_str().unwrap_or_default(), + "iconBackground": row["iconBackground"].as_str().unwrap_or_default(), + "enabledMark": row["enabledMark"].as_i64().unwrap_or(1), + "disabled": status == SHELF_DOWN_HIDDEN, + "num": 0, + "children": Vec::::new(), + }); + if let Some(arr) = roots[pos]["children"].as_array_mut() { + arr.push(child); + } + } + ok(list_vo(roots)) +} + +/// `POST /api/workflow/template/GetFlowList` —— 按主键批量取流程。 +/// +/// 官方 `api/workFlow/template.ts:87` ⇒ 官方 `TemplateController.java:467`。 +/// +/// 🔴 **请求体是裸 JSON 数组**(官方前端 `post(url, ids)`)⇒ 本仓同口径。 +/// 🔴 **`data` 是裸数组**(官方 `ActionResult.success(List)`)。 +pub async fn workflow_template_get_flow_list( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let ids: Vec = match serde_json::from_slice::(&body) { + Ok(Value::Array(items)) => items + .iter() + .filter_map(|v| v.as_str().map(|s| s.to_string())) + .filter(|s| !s.is_empty()) + .collect(), + _ => Vec::new(), + }; + if ids.is_empty() { + ok(Value::Array(Vec::new())) + } else { + let mut filters: Vec = Vec::new(); + let mut values: Vec> = Vec::new(); + for id in &ids { + values.push(Some(id.clone())); + filters.push(format!( + "t.f_id = ${}::text", + values.len() + )); + } + let where_body = format!( + "COALESCE(t.f_delete_mark, 0) = 0 AND ({})", + filters.join(" OR ") + ); + let sql = format!( + "SELECT t.f_id AS \"id\", t.f_full_name AS \"fullName\", t.f_en_code AS \"enCode\", \ + t.f_type AS \"type\", t.f_category AS \"category\", \ + COALESCE(t.f_sort_code, 0) AS \"sortCode\", t.f_icon AS \"icon\", \ + t.f_icon_background AS \"iconBackground\", \ + COALESCE(t.f_enabled_mark, 0) AS \"enabledMark\" \ + FROM workflow_template t WHERE {where_body} \ + ORDER BY COALESCE(t.f_sort_code, 0) ASC" + ); + match state.db.query_json_params(&sql, ¶ms_of(&values)).await { + Ok(rows) => ok(Value::Array(rows)), + Err(e) => db_error(e, "批量取流程"), + } + } +} + +/// `GET /api/workflow/template/getCommonFlowList` —— 常用流程。 +/// +/// 官方 `api/workFlow/template.ts:91` ⇒ 官方 `TemplateController.java:553`。 +/// +/// 🔴 **`data` 是 `ListVO`**(官方 `ActionResult.success(ListVO)`)。 +pub async fn workflow_template_common_flow_list( + State(state): State, + headers: HeaderMap, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let system_id = current_system_id(&state, &headers).await; + let sql = "SELECT t.f_id AS \"id\", t.f_full_name AS \"fullName\", t.f_en_code AS \"enCode\", \ + t.f_type AS \"type\", t.f_category AS \"category\", \ + COALESCE(t.f_sort_code, 0) AS \"sortCode\", t.f_icon AS \"icon\", \ + t.f_icon_background AS \"iconBackground\", \ + COALESCE(t.f_enabled_mark, 0) AS \"enabledMark\", \ + t.f_system_id AS \"systemId\", TRUE AS \"isCommonFlow\" \ + FROM workflow_template t \ + WHERE COALESCE(t.f_delete_mark, 0) = 0 AND t.f_system_id = $1::text \ + AND (t.f_id IN (SELECT f_flow_id FROM workflow_common WHERE COALESCE(f_delete_mark, 0) = 0) \ + OR t.f_flow_id IN (SELECT f_flow_id FROM workflow_common WHERE COALESCE(f_delete_mark, 0) = 0)) \ + ORDER BY COALESCE(t.f_sort_code, 0) ASC"; + let rows = match state.db.query_json_params(sql, &[&system_id]).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "常用流程查询"), + }; + ok(list_vo(rows)) +} + +/// `POST /api/workflow/template/SetCommonFlow/{id}` —— 设为/取消常用流程。 +/// +/// 官方 `api/workFlow/template.ts:95` ⇒ 官方 `TemplateController.java:540`。 +pub async fn workflow_template_set_common_flow( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let id = id.trim().to_string(); + if id.is_empty() { + return fail(code::FAIL, "流程主键不能为空"); + } + let exists = match state + .db + .query_json_params( + "SELECT f_id AS \"id\" FROM workflow_common \ + WHERE f_flow_id = $1::text AND COALESCE(f_delete_mark, 0) = 0 LIMIT 1", + &[&id], + ) + .await + { + Ok(rows) => !rows.is_empty(), + Err(e) => return db_error(e, "常用流程存在性查询"), + }; + if exists { + let sql = "UPDATE workflow_common SET f_delete_mark = 1 WHERE f_flow_id = $1::text"; + if let Err(e) = state + .db + .exec_params(sql, ¶ms_of(&[Some(id)])) + .await + { + return db_error(e, "取消常用流程"); + } + } else { + let sql = "INSERT INTO workflow_common \ + (f_id, f_tenant_id, f_type, f_flow_id, f_sort_code, f_delete_mark) \ + VALUES ($1::text, $2::text, $3::text, $4::text, $5::text::bigint, 0)"; + let values = vec![ + Some(new_uuid()), + Some("0".to_string()), + Some("1".to_string()), + Some(id), + Some("0".to_string()), + ]; + if let Err(e) = state.db.exec_params(sql, ¶ms_of(&values)).await { + return db_error(e, "设置常用流程"); + } + } + ok(Value::Null) +} + +/// `GET /api/workflow/template/{id}/SubFlowUserList` —— 子流程候选人。 +/// +/// 官方 `api/workFlow/template.ts:99` ⇒ 官方 `TemplateController.java:524`。 +/// +/// 🔴 **`data` 是 `PageListVO`**(官方 `PageListVO`)。 +pub async fn workflow_template_sub_flow_user_list( + State(state): State, + headers: HeaderMap, + Path(id): Path, + raw: RawQuery, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let id = id.trim().to_string(); + let page = Paging::of(&raw); + let ids_sql = "SELECT DISTINCT c.f_handle_id AS \"id\" FROM workflow_candidates c \ + WHERE c.f_handle_id IS NOT NULL AND c.f_handle_id <> '' \ + AND (c.f_task_id = $1::text \ + OR c.f_task_id IN (SELECT v.f_id FROM workflow_version v \ + WHERE v.f_template_id = $1::text))"; + let ids = match state.db.query_json_params(ids_sql, &[&id]).await { + Ok(rows) => rows + .iter() + .filter_map(|r| r["id"].as_str().map(|s| s.to_string())) + .collect::>(), + Err(e) => return db_error(e, "子流程候选人查询"), + }; + let joined = ids.join(","); + let where_body = "u.f_id = ANY(string_to_array($1::text, ',')) AND COALESCE(u.f_delete_mark, 0) = 0"; + let from_sql = "base_user u"; + match paged_query( + &state, + "u.f_id AS \"id\", COALESCE(u.f_real_name, '') AS \"fullName\", \ + COALESCE(u.f_head_icon, '') AS \"headIcon\", COALESCE(u.f_organize_id, '') AS \"organize\"", + from_sql, + where_body, + "ORDER BY u.f_real_name ASC", + vec![Some(joined)], + &page, + "子流程候选人", + ) + .await + { + Ok((total, rows)) => ok(page_list(page.current_page, page.page_size, total, rows)), + Err(resp) => resp, + } +} + +/// `PUT /api/workflow/template/{id}/UpDownShelf` —— 流程上下架。 +/// +/// 官方 `api/workFlow/template.ts:103` ⇒ 官方 `TemplateController.java:364` +/// (`@SaCheckPermission({"onlineDev.flowEngine"})` @365)。 +/// +/// 🔴 官方 `TemplateStatueEnum`:NONE(0) / UP(1 上架) / DOWN_CONTINUE(2 下架继续) +/// / DOWN_HIDDEN(3 下架隐藏)。 +pub async fn workflow_template_up_down_shelf( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + let user = match guard(&state, &headers, EN_FLOW_ENGINE).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let id = id.trim().to_string(); + let obj = match body_obj(&body) { + Ok(o) => o, + Err(resp) => return resp, + }; + let is_up = obj + .get("isUp") + .and_then(|v| v.as_bool()) + .unwrap_or(false); + let is_hidden = obj + .get("isHidden") + .and_then(|v| v.as_bool()) + .unwrap_or(false); + let status = if is_up { + SHELF_UP + } else if is_hidden { + SHELF_DOWN_HIDDEN + } else { + SHELF_DOWN_CONTINUE + }; + let sql = "UPDATE workflow_template \ + SET f_status = $1::text::integer, f_last_modify_time = now(), \ + f_last_modify_user_id = $2::text \ + WHERE f_id = $3::text AND COALESCE(f_delete_mark, 0) = 0"; + let values = vec![ + Some(status.to_string()), + Some(user.account.clone()), + Some(id), + ]; + if let Err(e) = state.db.exec_params(sql, ¶ms_of(&values)).await { + return db_error(e, "流程上下架"); + } + ok(Value::Null) +} + +/// `GET /api/workflow/template/{id}/DecisionParameter` —— 决策参数。 +/// +/// 官方 `api/workFlow/template.ts:106` ⇒ 官方 `TemplateController.java:499`。 +/// +/// 🔴 **`data` 是裸对象**(官方 `FlowConfigModel`:visibleType/startParameterList/endParameterList)。 +pub async fn workflow_template_decision_parameter( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let id = id.trim().to_string(); + let sql = "SELECT f_flow_config AS \"flowConfig\", COALESCE(f_visible_type, 1) AS \"visibleType\" \ + FROM workflow_template \ + WHERE f_id = $1::text AND COALESCE(f_delete_mark, 0) = 0 LIMIT 1"; + let rows = match state.db.query_json_params(sql, &[&id]).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "决策参数查询"), + }; + let Some(row) = rows.into_iter().next() else { + return fail(code::FAIL, "流程不存在"); + }; + let visible_type = row["visibleType"].as_i64().unwrap_or(1); + let start_list = Value::Array(Vec::new()); + let end_list = Value::Array(Vec::new()); + let config = row["flowConfig"].as_str().unwrap_or_default(); + let mut payload = serde_json::from_str::(config).unwrap_or(Value::Null); + if let Value::Object(map) = &mut payload { + map.entry("visibleType".to_string()) + .or_insert(Value::Number(visible_type.into())); + map.entry("startParameterList".to_string()) + .or_insert(start_list); + map.entry("endParameterList".to_string()) + .or_insert(end_list); + ok(Value::Object(map.clone())) + } else { + ok(json!({ + "visibleType": visible_type, + "startParameterList": Value::Array(Vec::new()), + "endParameterList": Value::Array(Vec::new()), + })) + } +} + +/// `GET /api/workflow/template/{id}/FlowList` —— 根据**表单主键**取绑定的流程。 +/// +/// 官方 `api/workFlow/template.ts:15` ⇒ 官方 `TemplateController.java:511` +/// (官方路径段名是 `{formId}`,前端按 `/{id}/FlowList` 调 —— 同一条路由)。 +/// +/// 🔴 **路径段是「表单主键」不是「模板主键」**(官方 `getFlowByFormId(formId, start)`): +/// 查 `workflow_node.f_form_id` ⇒ 版本 ⇒ 模板。 +/// 🔴 **`data` 是裸对象**(官方 `FlowByFormModel`:`{list:[{id,fullName}], isConfig}`)。 +/// `id` 是**版本主键**(官方 `TemplateByFormModel.id = jsonEntity.getId()`)。 +pub async fn workflow_template_flow_list( + State(state): State, + headers: HeaderMap, + Path(id): Path, + raw: RawQuery, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let form_id = id.trim().to_string(); + // 🔴 `start` 缺省为 true(官方 `null == start || start`)⇒ 只看**发起节点**。 + let start = match qv(&raw, "start") { + s if s.is_empty() => true, + s => s == "true" || s == "1", + }; + let node_type = if start { "start" } else { "" }; + let sql = "SELECT v.f_id AS \"id\", t.f_full_name AS \"fullName\" \ + FROM workflow_node n \ + JOIN workflow_version v ON v.f_id = n.f_flow_id \ + JOIN workflow_template t ON t.f_id = v.f_template_id \ + WHERE n.f_form_id = $1::text AND COALESCE(n.f_delete_mark, 0) = 0 \ + AND ($2::text = '' OR n.f_node_type = $2::text) \ + AND COALESCE(v.f_delete_mark, 0) = 0 AND COALESCE(v.f_status, 0) = 1 \ + AND COALESCE(t.f_delete_mark, 0) = 0 AND COALESCE(t.f_status, 0) = 1 \ + ORDER BY v.f_creator_time DESC"; + let rows = match state.db.query_json_params(sql, &[&form_id, &node_type]).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "表单绑定流程查询"), + }; + // 🔴 官方:查得到节点/版本就算「已配置」(`isConfig = true`);列表为空时同样为 true。 + ok(json!({ + "list": rows, + "isConfig": true, + })) +} + +// ================================================================ 流程评论(Comment) + +/// `GET /api/workflow/comment` —— 评论列表。 +/// +/// 官方 `api/workFlow/template.ts:110` ⇒ 官方 `CommentController.java:76`。 +/// +/// 🔴 **`data` 是 `PageListVO`**(官方 `PageListVO`)。 +pub async fn workflow_comment_list( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let page = Paging::of(&raw); + let task_id = qv(&raw, "taskId"); + let system_id = current_system_id(&state, &headers).await; + let mut filters: Vec = Vec::new(); + let mut values: Vec> = vec![Some(system_id)]; + let next = 2usize; + if !task_id.is_empty() { + filters.push(format!("c.f_task_id = ${next}::text")); + values.push(Some(task_id)); + } + let where_body = format!( + "COALESCE(c.f_delete_mark, 0) = 0 \ + AND EXISTS (SELECT 1 FROM workflow_task t \ + JOIN workflow_template tpl ON tpl.f_id = t.f_template_id \ + WHERE t.f_id = c.f_task_id AND tpl.f_system_id = $1::text){}", + if filters.is_empty() { + String::new() + } else { + format!(" {}", filters.join(" ")) + } + ); + let from_sql = "workflow_comment c LEFT JOIN base_user u ON u.f_id = c.f_creator_user_id"; + match paged_query( + &state, + COMMENT_LIST_COLUMNS, + from_sql, + &where_body, + "ORDER BY c.f_creator_time DESC", + values, + &page, + "流程评论列表", + ) + .await + { + Ok((total, rows)) => ok(page_list(page.current_page, page.page_size, total, rows)), + Err(resp) => resp, + } +} + +/// `POST /api/workflow/comment` —— 新增评论。 +/// +/// 官方 `api/workFlow/template.ts:114` ⇒ 官方 `CommentController.java:150`。 +pub async fn workflow_comment_create( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + let user = match require_login_face_b(&state, &headers).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let obj = match body_obj(&body) { + Ok(o) => o, + Err(resp) => return resp, + }; + let task_id = text_field(&obj, "taskId").unwrap_or_default(); + if task_id.is_empty() { + return fail(code::FAIL, "任务主键不能为空"); + } + let new_id = new_uuid(); + let mut columns: Vec<&str> = vec!["f_id", "f_tenant_id"]; + let mut casts: Vec<&str> = vec!["", ""]; + let mut values: Vec> = + vec![Some(new_id.clone()), Some("0".to_string())]; + for (column, cast, value) in write_fields(&obj, COMMENT_WRITE_FIELDS) { + columns.push(column); + casts.push(cast); + values.push(value); + } + // 🔴 官方默认值:`deleteShow` = 0(允许删除)、`enabledMark` = 1(有效)。 + for (key, column, cast, default) in [ + ("deleteShow", "f_delete_show", "::integer", "0"), + ("enabledMark", "f_enabled_mark", "::integer", "1"), + ] { + if !obj.contains_key(key) { + columns.push(column); + casts.push(cast); + values.push(Some(default.to_string())); + } + } + columns.push("f_sort_code"); + casts.push("::bigint"); + values.push(Some("0".to_string())); + columns.push("f_delete_mark"); + casts.push("::integer"); + values.push(Some("0".to_string())); + columns.push("f_creator_user_id"); + casts.push(""); + values.push(Some(user.account.clone())); + columns.push("f_creator_time"); + + let mut marks: Vec = (0..values.len()) + .map(|i| placeholder(i + 1, casts[i])) + .collect(); + marks.push("now()".to_string()); + let sql = format!( + "INSERT INTO workflow_comment ({}) VALUES ({})", + columns.join(", "), + marks.join(", ") + ); + if let Err(e) = state.db.exec_params(&sql, ¶ms_of(&values)).await { + return db_error(e, "新增流程评论"); + } + ok(Value::String(new_id)) +} + +/// `DELETE /api/workflow/comment/{id}` —— 删除评论(软删)。 +/// +/// 官方 `api/workFlow/template.ts:118` ⇒ 官方 `CommentController.java:166`。 +pub async fn workflow_comment_delete( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + let user = match require_login_face_b(&state, &headers).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let id = id.trim().to_string(); + let sql = "UPDATE workflow_comment \ + SET f_delete_mark = 1, f_delete_time = now(), f_delete_user_id = $1::text \ + WHERE f_id = $2::text AND COALESCE(f_delete_mark, 0) = 0"; + if let Err(e) = state + .db + .exec_params(sql, ¶ms_of(&[Some(user.account.clone()), Some(id)])) + .await + { + return db_error(e, "删除流程评论"); + } + ok(Value::Null) +} + +// ================================================================ 流程触发器(Hooks) + +/// `GET /api/workflow/Hooks/getUrl` —— 触发器地址。 +/// +/// 官方 `api/workFlow/template.ts:123` ⇒ 官方 `TriggerWebHookController.java:92`。 +/// +/// 🔴 官方返 `TriggerWebHookInfoVo{webhookUrl,requestUrl,enCodeStr,randomStr}`, +/// 地址来自**引擎的触发器配置** ⇒ 本仓无引擎 ⇒ 明确失败(不返假 URL)。 +pub async fn workflow_hook_url( + State(state): State, + headers: HeaderMap, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + unsupported_engine("查询流程触发器地址") +} + +/// `GET /api/workflow/Hooks/getParams/{randomStr}` —— 触发器参数。 +/// +/// 官方 `api/workFlow/template.ts:127` ⇒ 官方 `TriggerWebHookController.java:180`。 +pub async fn workflow_hook_params( + State(state): State, + headers: HeaderMap, + Path(random_str): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = random_str; + unsupported_engine("查询流程触发器参数") +} + +/// `GET /api/workflow/Hooks/{id}/start/{randomStr}` —— 触发流程。 +/// +/// 官方 `api/workFlow/template.ts:131` ⇒ 官方 `TriggerWebHookController.java:170`。 +pub async fn workflow_hook_start( + State(state): State, + headers: HeaderMap, + Path((id, random_str)): Path<(String, String)>, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = (id, random_str); + unsupported_engine("触发流程") +} + +// ================================================================ 流程任务(Task) + +/// `GET /api/workflow/task` —— 流程任务列表。 +/// +/// 官方 `api/workFlow/task.ts:16` ⇒ 官方 `TaskController.java:193`。 +/// +/// 🔴 **`data` 是 `PageListVO`**(官方 `PageListVO`)。 +pub async fn workflow_task_list( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let page = Paging::of(&raw); + let keyword = qv(&raw, "keyword"); + let system_id = current_system_id(&state, &headers).await; + let mut filters: Vec = Vec::new(); + let mut values: Vec> = vec![Some(system_id)]; + if !keyword.is_empty() { + filters.push("AND (t.f_full_name ILIKE $2::text OR t.f_en_code ILIKE $2::text)".to_string()); + values.push(Some(format!("%{keyword}%"))); + } + let where_body = format!( + "COALESCE(t.f_delete_mark, 0) = 0 \ + AND EXISTS (SELECT 1 FROM workflow_template tpl \ + WHERE tpl.f_id = t.f_template_id AND tpl.f_system_id = $1::text){}", + if filters.is_empty() { + String::new() + } else { + format!(" {}", filters.join(" ")) + } + ); + let from_sql = "workflow_task t LEFT JOIN base_user u ON u.f_id = t.f_creator_user_id"; + match paged_query( + &state, + TASK_LIST_COLUMNS, + from_sql, + &where_body, + "ORDER BY t.f_creator_time DESC", + values, + &page, + "流程任务列表", + ) + .await + { + Ok((total, rows)) => ok(page_list(page.current_page, page.page_size, total, rows)), + Err(resp) => resp, + } +} + +/// `GET /api/workflow/task/{id}` —— 待我审批详情。 +/// +/// 官方 `api/workFlow/task.ts:23` ⇒ 官方 `TaskController.java:103`。 +/// +/// 🔴 **官方路径里的 id 是密文**:前端把 `${taskId},${userId},${uuid}` 用 AES 加密后 +/// 拼进路径;官方后端用 `EncryptKeyManager.getRequestAes()` 解密 —— 那个密钥是 +/// **前端登录时协商出来的动态密钥**(走 `K1` 头 RSA 加密),本仓**没有**协商机制 +/// ⇒ 本仓**尽力解密**:能用静态 `front-aes-key` 解开就用,解不开就把整段当明文主键。 +/// +/// 🔴 **`data` 是裸对象**(官方 `ActionResult.success(taskService.getInfo(taskId, fo))`)。 +pub async fn workflow_task_info( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + let user = match require_login_face_b(&state, &headers).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let raw = id.trim().to_string(); + let (task_id, embedded_user) = decode_task_id(&raw); + // 🔴 官方 `TaskController.getInfo`:密文里带的用户必须等于当前登录人。 + if !embedded_user.is_empty() + && embedded_user != user.user_id + && embedded_user != user.account + { + return fail(code::FAIL, "无权查看他人的流程任务"); + } + let sql = format!( + "SELECT {} FROM workflow_task t \ + LEFT JOIN base_user u ON u.f_id = t.f_creator_user_id \ + WHERE t.f_id = $1::text AND COALESCE(t.f_delete_mark, 0) = 0 LIMIT 1", + TASK_LIST_COLUMNS + ); + let rows = match state.db.query_json_params(&sql, &[&task_id]).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "流程任务详情查询"), + }; + match rows.into_iter().next() { + Some(row) => { + if !owned_by(&row, &user.user_id, &user.account) { + // 🔴 不是归属人也不是审批人 ⇒ 官方同样会拦(`checkOperatorPermission`)。 + let is_handler = match state + .db + .query_json_params( + "SELECT o.f_id AS \"id\" FROM workflow_operator o \ + WHERE o.f_task_id = $1::text \ + AND (o.f_handle_id = $2::text OR o.f_handle_id = $3::text) \ + LIMIT 1", + &[&task_id, &user.user_id, &user.account], + ) + .await + { + Ok(rows) => !rows.is_empty(), + Err(e) => return db_error(e, "流程任务权限校验"), + }; + if !is_handler { + return fail(code::FAIL, "无权查看他人的流程任务"); + } + } + ok(row) + } + None => fail(code::FAIL, "流程任务不存在"), + } +} + +/// `POST /api/workflow/task` —— 暂存或提交(发起流程)。 +/// +/// 官方 `api/workFlow/task.ts:27` ⇒ 官方 `TaskController.java:127`。 +/// +/// 🔴 **发起流程必须落到流程引擎**(引擎生成实例、节点、经办)⇒ 本仓**明确业务失败**。 +pub async fn workflow_task_create( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = body; + unsupported_engine("发起流程") +} + +/// `PUT /api/workflow/task/{id}` —— 更新流程任务。 +/// +/// 官方 `api/workFlow/task.ts:31` ⇒ 官方 `TaskController.java:147`。 +pub async fn workflow_task_update( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = (id, body); + unsupported_engine("更新流程任务") +} + +/// `DELETE /api/workflow/task/{id}` —— 删除流程发起。 +/// +/// 官方 `api/workFlow/task.ts:35` ⇒ 官方 `TaskController.java:181`。 +/// +/// 🔴 官方是**逻辑删**(`f_delete_mark`)⇒ 本仓同款软删(不改引擎侧状态)。 +pub async fn workflow_task_delete( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + let user = match require_login_face_b(&state, &headers).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let raw = id.trim().to_string(); + let (task_id, _) = decode_task_id(&raw); + let sql = "UPDATE workflow_task \ + SET f_delete_mark = 1, f_delete_time = now(), f_delete_user_id = $1::text \ + WHERE f_id = $2::text AND COALESCE(f_delete_mark, 0) = 0"; + if let Err(e) = state + .db + .exec_params(sql, ¶ms_of(&[Some(user.account.clone()), Some(task_id)])) + .await + { + return db_error(e, "删除流程任务"); + } + ok(Value::Null) +} + +/// `PUT /api/workflow/task/Recall/{id}` —— 流程发起撤回。 +/// +/// 官方 `api/workFlow/task.ts:39` ⇒ 官方 `TaskController.java:218`。 +pub async fn workflow_task_recall( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = (id, body); + unsupported_engine("流程发起撤回") +} + +/// `PUT /api/workflow/task/Revoke/{id}` —— 流程发起撤销。 +/// +/// 官方 `api/workFlow/task.ts:43` ⇒ 官方 `TaskController.java:247`。 +pub async fn workflow_task_revoke( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = (id, body); + unsupported_engine("流程发起撤销") +} + +/// `POST /api/workflow/task/Press/{id}` —— 流程催办。 +/// +/// 官方 `api/workFlow/task.ts:47` ⇒ 官方 `TaskController.java:233`。 +pub async fn workflow_task_press( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = id; + unsupported_engine("流程催办") +} + +/// `GET /api/workflow/task/{id}/EventLog` —— 事件日志。 +/// +/// 官方前端 `api/workFlow/task.ts:51`(`getLogList`)。 +/// +/// 🔴 官方 Java **没有**这个映射(`TaskController` 无 `{id}/EventLog`)⇒ 官方是 +/// 前端直连的官方端点;本仓从 `workflow_event_log` 落数据后如实返。 +/// +/// 🔴 **`data` 是裸数组**。 +pub async fn workflow_task_event_log( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let raw = id.trim().to_string(); + let (task_id, _) = decode_task_id(&raw); + let sql = format!( + "SELECT {} FROM workflow_event_log e \ + WHERE e.f_task_id = $1::text AND COALESCE(e.f_delete_mark, 0) = 0 \ + ORDER BY e.f_creator_time ASC", + EVENT_LOG_COLUMNS + ); + let rows = match state.db.query_json_params(&sql, &[&task_id]).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "流程事件日志查询"), + }; + ok(Value::Array(rows)) +} + +/// `GET /api/workflow/task/TaskUserList/{id}` —— 流程实例相关人员。 +/// +/// 官方 `api/workFlow/task.ts:55` ⇒ 官方 `TaskController.java:261`。 +/// +/// 🔴 **`data` 是 `PageListVO`**(官方 `PageListVO`)。 +pub async fn workflow_task_user_list( + State(state): State, + headers: HeaderMap, + Path(id): Path, + raw: RawQuery, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let raw_id = id.trim().to_string(); + let (task_id, _) = decode_task_id(&raw_id); + let page = Paging::of(&raw); + let ids_sql = "SELECT DISTINCT c.f_handle_id AS \"id\" FROM workflow_candidates c \ + WHERE c.f_handle_id IS NOT NULL AND c.f_handle_id <> '' \ + AND (c.f_task_id = $1::text \ + OR c.f_task_id IN (SELECT o.f_task_id FROM workflow_operator o \ + WHERE o.f_id = $1::text))"; + let ids = match state.db.query_json_params(ids_sql, &[&task_id]).await { + Ok(rows) => rows + .iter() + .filter_map(|r| r["id"].as_str().map(|s| s.to_string())) + .collect::>(), + Err(e) => return db_error(e, "流程实例人员查询"), + }; + let joined = ids.join(","); + let where_body = "u.f_id = ANY(string_to_array($1::text, ',')) AND COALESCE(u.f_delete_mark, 0) = 0"; + match paged_query( + &state, + "u.f_id AS \"id\", COALESCE(u.f_real_name, '') AS \"fullName\", \ + COALESCE(u.f_head_icon, '') AS \"headIcon\", COALESCE(u.f_organize_id, '') AS \"organize\"", + "base_user u", + where_body, + "ORDER BY u.f_real_name ASC", + vec![Some(joined)], + &page, + "流程实例相关人员", + ) + .await + { + Ok((total, rows)) => ok(page_list(page.current_page, page.page_size, total, rows)), + Err(resp) => resp, + } +} + +/// `GET /api/workflow/task/SubFlowInfo` —— 子流程详情。 +/// +/// 官方 `api/workFlow/task.ts:59`(`?taskId=…&nodeCode=…`)⇒ 官方 `TaskController.java:279`。 +/// +/// 🔴 **`data` 是裸数组**(官方 `ActionResult.success(List)`)。 +pub async fn workflow_task_sub_flow_info( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let task_id = qv(&raw, "taskId"); + let (task_id, _) = decode_task_id(&task_id); + if task_id.is_empty() { + ok(Value::Array(Vec::new())) + } else { + let sql = "SELECT t.f_id AS \"id\", t.f_full_name AS \"fullName\", \ + t.f_flow_name AS \"flowName\", t.f_flow_code AS \"flowCode\", \ + t.f_instance_id AS \"instanceId\", t.f_parent_id AS \"parentId\", \ + COALESCE(t.f_status, 0) AS \"status\", \ + (EXTRACT(EPOCH FROM t.f_start_time) * 1000)::bigint AS \"startTime\" \ + FROM workflow_task t \ + WHERE t.f_parent_id = $1::text AND COALESCE(t.f_delete_mark, 0) = 0 \ + ORDER BY t.f_creator_time ASC"; + match state.db.query_json_params(sql, &[&task_id]).await { + Ok(rows) => ok(Value::Array(rows)), + Err(e) => db_error(e, "子流程详情查询"), + } + } +} + +/// `GET /api/workflow/task/ViewStartForm/{id}` —— 查看发起表单。 +/// +/// 官方 `api/workFlow/task.ts:172` ⇒ 官方 `TaskController.java:291`。 +/// +/// 🔴 官方返 `ViewFormModel`(**在线表单设计器**的产物)⇒ 本仓无表单设计器 ⇒ 明确失败。 +pub async fn workflow_task_view_start_form( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = id; + unsupported_form("查看流程发起表单") +} + +/// `GET /api/workflow/task/Hooks/Retry/{id}` —— 外部重试。 +/// +/// 官方 `api/workFlow/task.ts:176` ⇒ 官方 `TaskController.java:301`。 +pub async fn workflow_task_hooks_retry( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = id; + unsupported_engine("流程外部重试") +} + +// ================================================================ 流程经办(Operator) + +/// `POST /api/workflow/operator/CandidateUser/{id}` —— 获取候选人。 +/// +/// 官方 `api/workFlow/task.ts:64` ⇒ 官方 `OperatorController.java:115`。 +/// +/// 🔴 **`data` 是 `PageListVO`**(官方 `PageListVO`)。 +pub async fn workflow_operator_candidate_user( + State(state): State, + headers: HeaderMap, + Path(id): Path, + raw: RawQuery, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = id; + let obj = match body_obj(&body) { + Ok(o) => o, + Err(resp) => return resp, + }; + let page = Paging::of_body(&obj); + let keyword = text_field(&obj, "text") + .or_else(|| text_field(&obj, "keyword")) + .unwrap_or_else(|| qv(&raw, "text")); + let where_body = if keyword.is_empty() { + "COALESCE(u.f_delete_mark, 0) = 0".to_string() + } else { + "COALESCE(u.f_delete_mark, 0) = 0 \ + AND (u.f_real_name ILIKE $1::text OR u.f_account ILIKE $1::text)" + .to_string() + }; + let values = if keyword.is_empty() { + vec![] + } else { + vec![Some(format!("%{keyword}%"))] + }; + match paged_query( + &state, + "u.f_id AS \"id\", COALESCE(u.f_real_name, '') AS \"fullName\", \ + COALESCE(u.f_head_icon, '') AS \"headIcon\", COALESCE(u.f_organize_id, '') AS \"organize\"", + "base_user u", + &where_body, + "ORDER BY u.f_real_name ASC", + values, + &page, + "候选人列表", + ) + .await + { + Ok((total, rows)) => ok(page_list(page.current_page, page.page_size, total, rows)), + Err(resp) => resp, + } +} + +/// `POST /api/workflow/operator/CandidateNode/{id}` —— 判断候选人。 +/// +/// 官方 `api/workFlow/task.ts:68` ⇒ 官方 `OperatorController.java:99`。 +/// +/// 🔴 **官方返 `Object`**(`taskService.checkCandidates` 的布尔结果)⇒ 本仓返**裸布尔**: +/// 「这条经办是不是我(或我是不是该节点的候选人)」。 +pub async fn workflow_operator_candidate_node( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + let user = match require_login_face_b(&state, &headers).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let _ = body; + let id = id.trim().to_string(); + let sql = "SELECT o.f_id AS \"id\" FROM workflow_operator o \ + WHERE o.f_id = $1::text AND COALESCE(o.f_delete_mark, 0) = 0 \ + AND (o.f_handle_id = $2::text OR o.f_handle_id = $3::text) \ + LIMIT 1"; + let is_handler = match state + .db + .query_json_params(sql, &[&id, &user.user_id, &user.account]) + .await + { + Ok(rows) => !rows.is_empty(), + Err(e) => return db_error(e, "候选人判断"), + }; + if is_handler { + return ok(Value::Bool(true)); + } + // 🔴 退一步看「我是不是这个节点的候选人之一」。 + let cand_sql = "SELECT c.f_id AS \"id\" FROM workflow_candidates c \ + WHERE c.f_task_id IN (SELECT o.f_task_id FROM workflow_operator o WHERE o.f_id = $1::text) \ + AND (c.f_handle_id = $2::text OR c.f_account = $3::text) \ + LIMIT 1"; + let is_candidate = match state + .db + .query_json_params(cand_sql, &[&id, &user.user_id, &user.account]) + .await + { + Ok(rows) => !rows.is_empty(), + Err(e) => return db_error(e, "候选人判断"), + }; + ok(Value::Bool(is_candidate)) +} + +/// `GET /api/workflow/operator/List/{category}` —— 经办列表。 +/// +/// 官方 `api/workFlow/task.ts:72` ⇒ 官方 `OperatorController.java:134`。 +/// +/// 🔴 **`category` 是官方 `CategoryEnum` 的数字串**(`-1` 无 / `0` 待签 / `1` 待办 / +/// `2` 在办 / `3` 已办 / `4` 抄送 / `5` 批量在办)。 +/// 🔴 **官方按类别查三张不同的表**:待签/待办/在办/批量在办 ⇒ `workflow_operator`; +/// 已办 ⇒ `workflow_record`;抄送 ⇒ `workflow_circulate`。本仓**照抄这个分流**。 +/// +/// 🔴 **`data` 是 `PageListVO`**(官方 `PageListVO`)。 +pub async fn workflow_operator_list( + State(state): State, + headers: HeaderMap, + Path(category): Path, + raw: RawQuery, +) -> Json { + let user = match require_login_face_b(&state, &headers).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let page = Paging::of(&raw); + let keyword = qv(&raw, "keyword"); + let category = category.trim().parse::().unwrap_or(-1); + + // 🔴 已办(`workflow_record`):官方 `RecordMapper.getList` —— 只看审批/退回/加签等 + // 「已处理过」的记录,按(任务, 节点, 处理人)归并,取最近一条。 + if category == CAT_DONE { + let mut filters: Vec = Vec::new(); + let mut values: Vec> = + vec![Some(user.user_id.clone()), Some(user.account.clone())]; + let next = 3usize; + if !keyword.is_empty() { + filters.push(format!( + "AND (t.f_full_name ILIKE ${next}::text OR t.f_en_code ILIKE ${next}::text)" + )); + values.push(Some(format!("%{keyword}%"))); + } + let where_body = format!( + "r.f_handle_type IN (0, 1, 3, 5, 7, 18) AND r.f_operator_id IS NOT NULL \ + AND (r.f_handle_id = $1::text OR r.f_handle_id = $2::text) \ + AND COALESCE(r.f_delete_mark, 0) = 0{}", + if filters.is_empty() { + String::new() + } else { + format!(" {}", filters.join(" ")) + } + ); + let from_sql = "workflow_record r LEFT JOIN workflow_task t ON t.f_id = r.f_task_id"; + let select_cols = "DISTINCT ON (r.f_task_id, r.f_node_code, r.f_handle_id) \ + r.f_id AS \"id\", r.f_task_id AS \"taskId\", r.f_node_id AS \"nodeId\", \ + r.f_node_code AS \"nodeCode\", r.f_node_name AS \"nodeName\", \ + COALESCE(r.f_handle_type, 0) AS \"handleType\", r.f_handle_id AS \"handleId\", \ + r.f_handle_opinion AS \"handleOpinion\", \ + (EXTRACT(EPOCH FROM r.f_handle_time) * 1000)::bigint AS \"handleTime\", \ + COALESCE(r.f_status, 0) AS \"status\", r.f_operator_id AS \"operatorId\", \ + r.f_creator_user_id AS \"creatorUserId\", \ + (EXTRACT(EPOCH FROM r.f_creator_time) * 1000)::bigint AS \"creatorTime\", \ + t.f_full_name AS \"fullName\", t.f_flow_name AS \"flowName\""; + return match paged_query( + &state, + select_cols, + from_sql, + &where_body, + "ORDER BY r.f_task_id, r.f_node_code, r.f_handle_id, r.f_handle_time DESC", + values, + &page, + "已办列表", + ) + .await + { + Ok((total, rows)) => ok(page_list(page.current_page, page.page_size, total, rows)), + Err(resp) => resp, + }; + } + + // 🔴 抄送(`workflow_circulate`):官方 `CirculateMapper.getList`。 + if category == CAT_CIRCULATE { + let mut filters: Vec = Vec::new(); + let mut values: Vec> = + vec![Some(user.user_id.clone()), Some(user.account.clone())]; + if !keyword.is_empty() { + filters.push("AND (t.f_full_name ILIKE $3::text OR t.f_en_code ILIKE $3::text)".to_string()); + values.push(Some(format!("%{keyword}%"))); + } + let where_body = format!( + "(c.f_user_id = $1::text OR c.f_user_id = $2::text) AND t.f_status <> 4 \ + AND COALESCE(c.f_delete_mark, 0) = 0{}", + if filters.is_empty() { + String::new() + } else { + format!(" {}", filters.join(" ")) + } + ); + let from_sql = "workflow_circulate c LEFT JOIN workflow_task t ON t.f_id = c.f_task_id"; + let select_cols = "c.f_id AS \"id\", c.f_task_id AS \"taskId\", c.f_node_id AS \"nodeId\", \ + c.f_node_code AS \"nodeCode\", c.f_node_name AS \"nodeName\", \ + c.f_operator_id AS \"operatorId\", c.f_user_id AS \"userId\", \ + COALESCE(c.f_read, 0) AS \"isRead\", t.f_full_name AS \"fullName\", \ + t.f_flow_name AS \"flowName\""; + return match paged_query( + &state, + select_cols, + from_sql, + &where_body, + "ORDER BY c.f_creator_time DESC", + values, + &page, + "抄送列表", + ) + .await + { + Ok((total, rows)) => ok(page_list(page.current_page, page.page_size, total, rows)), + Err(resp) => resp, + }; + } + + // 🔴 其余四类(待签 / 待办 / 在办 / 批量在办)⇒ `workflow_operator`。 + let mut filters: Vec = Vec::new(); + let mut values: Vec> = + vec![Some(user.user_id.clone()), Some(user.account.clone())]; + let next = 3usize; + match category { + CAT_SIGN => filters.push( + "AND o.f_sign_time IS NULL AND o.f_start_handle_time IS NULL \ + AND o.f_handle_status IS NULL" + .to_string(), + ), + CAT_TODO => filters.push( + "AND o.f_sign_time IS NOT NULL AND o.f_start_handle_time IS NULL \ + AND o.f_handle_status IS NULL" + .to_string(), + ), + CAT_DOING => filters.push( + "AND o.f_sign_time IS NOT NULL AND o.f_start_handle_time IS NOT NULL \ + AND o.f_handle_status IS NULL" + .to_string(), + ), + CAT_BATCH_DOING => { + filters.push( + "AND o.f_sign_time IS NOT NULL AND o.f_start_handle_time IS NOT NULL \ + AND o.f_handle_status IS NULL AND o.f_status <> 7 AND o.f_status <> 2" + .to_string(), + ) + } + _ => filters.push("AND o.f_handle_status IS NULL".to_string()), + } + if !keyword.is_empty() { + filters.push(format!( + "AND (t.f_full_name ILIKE ${next}::text OR t.f_en_code ILIKE ${next}::text)" + )); + values.push(Some(format!("%{keyword}%"))); + } + let where_body = format!( + "(o.f_handle_id = $1::text OR o.f_handle_id = $2::text) AND o.f_completion = 0 \ + AND o.f_status <> -1 AND o.f_status <> -2 AND t.f_status <> 4 AND t.f_status <> 7 \ + AND tp.f_status IN (1, 2) AND COALESCE(o.f_delete_mark, 0) = 0{}", + if filters.is_empty() { + String::new() + } else { + format!(" {}", filters.join(" ")) + } + ); + let from_sql = "workflow_operator o \ + LEFT JOIN workflow_task t ON t.f_id = o.f_task_id \ + LEFT JOIN workflow_template tp ON tp.f_id = t.f_template_id \ + LEFT JOIN base_user u ON u.f_id = o.f_creator_user_id"; + match paged_query( + &state, + OPERATOR_LIST_COLUMNS, + from_sql, + &where_body, + "ORDER BY o.f_creator_time DESC", + values, + &page, + "经办列表", + ) + .await + { + Ok((total, rows)) => ok(page_list(page.current_page, page.page_size, total, rows)), + Err(resp) => resp, + } +} + +/// `POST /api/workflow/operator/Sign` —— 签收。 +/// +/// 官方 `api/workFlow/task.ts:76` ⇒ 官方 `OperatorController.java:184`。 +pub async fn workflow_operator_sign( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = body; + unsupported_engine("签收流程") +} + +/// `POST /api/workflow/operator/Transact` —— 办理。 +/// +/// 官方 `api/workFlow/task.ts:88` ⇒ 官方 `OperatorController.java:196`。 +pub async fn workflow_operator_transact( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = body; + unsupported_engine("办理流程") +} + +/// `POST /api/workflow/operator/Audit/{id}` —— 审批。 +/// +/// 官方 `api/workFlow/task.ts:96` ⇒ 官方 `OperatorController.java:224`。 +pub async fn workflow_operator_audit( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = (id, body); + unsupported_engine("审批流程") +} + +/// `POST /api/workflow/operator/AddSignUserIdList/{id}` —— 加签候选人列表。 +/// +/// 官方 `api/workFlow/task.ts:100` ⇒ 官方 `OperatorController.java:293`。 +/// +/// 🔴 **`data` 是 `PageListVO`**(官方 `PageListVO`)。 +pub async fn workflow_operator_add_sign_user_list( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let id = id.trim().to_string(); + let obj = match body_obj(&body) { + Ok(o) => o, + Err(resp) => return resp, + }; + let page = Paging::of_body(&obj); + let ids_sql = "SELECT DISTINCT c.f_handle_id AS \"id\" FROM workflow_candidates c \ + WHERE c.f_handle_id IS NOT NULL AND c.f_handle_id <> '' \ + AND (c.f_task_id = $1::text \ + OR c.f_task_id IN (SELECT o.f_task_id FROM workflow_operator o \ + WHERE o.f_id = $1::text))"; + let ids = match state.db.query_json_params(ids_sql, &[&id]).await { + Ok(rows) => rows + .iter() + .filter_map(|r| r["id"].as_str().map(|s| s.to_string())) + .collect::>(), + Err(e) => return db_error(e, "加签候选人查询"), + }; + let joined = ids.join(","); + let where_body = "u.f_id = ANY(string_to_array($1::text, ',')) AND COALESCE(u.f_delete_mark, 0) = 0"; + match paged_query( + &state, + "u.f_id AS \"id\", COALESCE(u.f_real_name, '') AS \"fullName\", \ + COALESCE(u.f_head_icon, '') AS \"headIcon\", COALESCE(u.f_organize_id, '') AS \"organize\"", + "base_user u", + where_body, + "ORDER BY u.f_real_name ASC", + vec![Some(joined)], + &page, + "加签候选人", + ) + .await + { + Ok((total, rows)) => ok(page_list(page.current_page, page.page_size, total, rows)), + Err(resp) => resp, + } +} + +/// `POST /api/workflow/operator/ReduceApprover/{id}` —— 减签。 +/// +/// 官方 `api/workFlow/task.ts:104` ⇒ 官方 `OperatorController.java:308`。 +pub async fn workflow_operator_reduce_approver( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = (id, body); + unsupported_engine("减签流程") +} + +/// `POST /api/workflow/operator/SaveAudit/{id}` —— 保存审批意见(暂存)。 +/// +/// 官方 `api/workFlow/task.ts:108` ⇒ 官方 `OperatorController.java:209`。 +pub async fn workflow_operator_save_audit( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = (id, body); + unsupported_engine("暂存审批意见") +} + +/// `POST /api/workflow/operator/AssistSave/{id}` —— 协办保存。 +/// +/// 官方 `api/workFlow/task.ts:112` ⇒ 官方 `OperatorController.java:443`。 +pub async fn workflow_operator_assist_save( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = (id, body); + unsupported_engine("保存协办") +} + +/// `POST /api/workflow/operator/Recall/{id}` —— 撤回。 +/// +/// 官方 `api/workFlow/task.ts:116` ⇒ 官方 `OperatorController.java:367`。 +pub async fn workflow_operator_recall( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = (id, body); + unsupported_engine("撤回流程") +} + +/// `POST /api/workflow/operator/Transfer/{id}` —— 转审。 +/// +/// 官方 `api/workFlow/task.ts:120` ⇒ 官方 `OperatorController.java:406`。 +pub async fn workflow_operator_transfer( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = (id, body); + unsupported_engine("转审流程") +} + +/// `POST /api/workflow/operator/Assist/{id}` —— 协办。 +/// +/// 官方 `api/workFlow/task.ts:124` ⇒ 官方 `OperatorController.java:428`。 +pub async fn workflow_operator_assist( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = (id, body); + unsupported_engine("协办流程") +} + +/// `POST /api/workflow/operator/BatchOperation` —— 批量审批。 +/// +/// 官方 `api/workFlow/task.ts:128` ⇒ 官方 `OperatorController.java:518`。 +pub async fn workflow_operator_batch_operation( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = body; + unsupported_engine("批量审批流程") +} + +/// `GET /api/workflow/operator/BatchCandidate` —— 批量获取候选人。 +/// +/// 官方 `api/workFlow/task.ts:132` ⇒ 官方 `OperatorController.java:505`。 +/// +/// 🔴 **官方返 `CandidateCheckVo{list, type, oneSelfEndApproval, isFreeCode}`** ⇒ +/// 本仓返**裸对象**:`list` 来自 `workflow_candidates`,`type` 按官方枚举 +/// (`2` = 没有分支有候选人 / `3` = 没有分支也没有候选人)。 +pub async fn workflow_operator_batch_candidate( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let flow_id = qv(&raw, "flowId"); + let operator_id = qv(&raw, "operatorId"); + let sql = "SELECT c.f_id AS \"id\", c.f_node_code AS \"nodeCode\", \ + c.f_handle_id AS \"handleId\", c.f_candidates AS \"candidates\", \ + COALESCE(c.f_type, 0) AS \"type\" \ + FROM workflow_candidates c \ + WHERE COALESCE(c.f_delete_mark, 0) = 0 \ + AND ($1::text = '' OR c.f_task_id = $1::text) \ + AND ($2::text = '' OR c.f_task_id IN \ + (SELECT o.f_task_id FROM workflow_operator o WHERE o.f_id = $2::text)) \ + ORDER BY c.f_node_code ASC"; + let rows = match state + .db + .query_json_params(sql, &[&flow_id, &operator_id]) + .await + { + Ok(rows) => rows, + Err(e) => return db_error(e, "批量候选人查询"), + }; + let list: Vec = rows + .iter() + .map(|r| { + json!({ + "id": r["id"].as_str().unwrap_or_default(), + "nodeCode": r["nodeCode"].as_str().unwrap_or_default(), + "handleId": r["handleId"].as_str().unwrap_or_default(), + "candidates": r["candidates"].as_str().unwrap_or_default(), + "type": r["type"].as_i64().unwrap_or(0), + }) + }) + .collect(); + let kind = if list.is_empty() { 3 } else { 2 }; + ok(json!({ + "list": list, + "type": kind, + "oneSelfEndApproval": false, + "isFreeCode": false, + })) +} + +/// `GET /api/workflow/operator/BatchFlowSelector` —— 批量审批流程分类列表。 +/// +/// 官方 `api/workFlow/task.ts:136` ⇒ 官方 `OperatorController.java:455`。 +/// +/// 🔴 **`data` 是裸数组**(官方 `List{fullName,id,num}`)。 +pub async fn workflow_operator_batch_flow_selector( + State(state): State, + headers: HeaderMap, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let sql = "SELECT t.f_flow_category AS \"id\", t.f_flow_category AS \"fullName\", \ + count(*)::bigint AS \"num\" \ + FROM workflow_task t \ + WHERE COALESCE(t.f_delete_mark, 0) = 0 AND t.f_flow_category IS NOT NULL \ + AND t.f_flow_category <> '' \ + GROUP BY t.f_flow_category ORDER BY t.f_flow_category ASC"; + match state.db.query_json_params(sql, &[]).await { + Ok(rows) => ok(Value::Array(rows)), + Err(e) => db_error(e, "批量审批流程分类"), + } +} + +/// `GET /api/workflow/operator/BatchVersionSelector/{id}` —— 批量审批版本列表。 +/// +/// 官方 `api/workFlow/task.ts:140` ⇒ 官方 `OperatorController.java:467`。 +/// +/// 🔴 **`data` 是裸数组**(官方 `List`)。 +pub async fn workflow_operator_batch_version_selector( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let id = id.trim().to_string(); + let sql = "SELECT v.f_id AS \"id\", '流程版本V' || COALESCE(v.f_version, '0') AS \"fullName\", \ + count(n.f_id)::bigint AS \"num\" \ + FROM workflow_version v \ + LEFT JOIN workflow_node n ON n.f_flow_id = v.f_id \ + WHERE v.f_template_id = $1::text AND COALESCE(v.f_delete_mark, 0) = 0 \ + GROUP BY v.f_id, v.f_version ORDER BY v.f_version ASC"; + match state.db.query_json_params(sql, &[&id]).await { + Ok(rows) => ok(Value::Array(rows)), + Err(e) => db_error(e, "批量审批流程版本"), + } +} + +/// `GET /api/workflow/operator/BatchNodeSelector/{id}` —— 批量审批节点列表。 +/// +/// 官方 `api/workFlow/task.ts:144` ⇒ 官方 `OperatorController.java:479`。 +/// +/// 🔴 **`data` 是裸数组**(官方 `List`)。 +pub async fn workflow_operator_batch_node_selector( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let id = id.trim().to_string(); + let sql = "SELECT n.f_node_code AS \"id\", COALESCE(n.f_node_json, '') AS \"fullName\", \ + 0::bigint AS \"num\" \ + FROM workflow_node n \ + WHERE n.f_flow_id = $1::text AND COALESCE(n.f_delete_mark, 0) = 0 \ + ORDER BY COALESCE(n.f_sort_code, 0) ASC, n.f_node_code ASC"; + match state.db.query_json_params(sql, &[&id]).await { + Ok(rows) => ok(Value::Array(rows)), + Err(e) => db_error(e, "批量审批节点"), + } +} + +/// `GET /api/workflow/operator/BatchNode` —— 批量审批节点属性。 +/// +/// 官方 `api/workFlow/task.ts:148` ⇒ 官方 `OperatorController.java:491`。 +/// +/// 🔴 **官方返 `Map`** ⇒ 本仓返**裸对象**(节点代码 → 节点属性)。 +pub async fn workflow_operator_batch_node( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let flow_id = qv(&raw, "flowId"); + let sql = "SELECT n.f_node_code AS \"nodeCode\", n.f_node_json AS \"nodeJson\", \ + n.f_node_type AS \"nodeType\", n.f_form_id AS \"formId\" \ + FROM workflow_node n \ + WHERE COALESCE(n.f_delete_mark, 0) = 0 \ + AND ($1::text = '' OR n.f_flow_id = $1::text) \ + ORDER BY COALESCE(n.f_sort_code, 0) ASC"; + let rows = match state.db.query_json_params(sql, &[&flow_id]).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "批量审批节点属性"), + }; + let mut map = Map::new(); + for row in &rows { + let code = row["nodeCode"].as_str().unwrap_or_default().to_string(); + if code.is_empty() { + continue; + } + let attrs = serde_json::from_str::( + row["nodeJson"].as_str().unwrap_or_default(), + ) + .unwrap_or(Value::Null); + map.insert( + code, + json!({ + "nodeJson": attrs, + "nodeType": row["nodeType"].as_str().unwrap_or_default(), + "formId": row["formId"].as_str().unwrap_or_default(), + }), + ); + } + ok(Value::Object(map)) +} + +/// `GET /api/workflow/operator/{id}/Info` —— 消息跳转工作流。 +/// +/// 官方 `api/workFlow/task.ts:152` ⇒ 官方 `OperatorController.java:549`。 +/// +/// 🔴 **官方返 `ContModel{flowId,taskId,operatorId,opType}`** ⇒ 本仓返**裸对象**。 +pub async fn workflow_operator_info( + State(state): State, + headers: HeaderMap, + Path(id): Path, + raw: RawQuery, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let id = id.trim().to_string(); + let sql = "SELECT o.f_id AS \"operatorId\", o.f_task_id AS \"taskId\", o.f_node_id AS \"nodeId\", \ + t.f_flow_id AS \"flowId\", t.f_template_id AS \"templateId\" \ + FROM workflow_operator o \ + LEFT JOIN workflow_task t ON t.f_id = o.f_task_id \ + WHERE o.f_id = $1::text AND COALESCE(o.f_delete_mark, 0) = 0 LIMIT 1"; + let rows = match state.db.query_json_params(sql, &[&id]).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "经办跳转信息查询"), + }; + let Some(row) = rows.into_iter().next() else { + return fail(code::FAIL, "经办不存在"); + }; + ok(json!({ + "flowId": row["flowId"].as_str().unwrap_or_default(), + "taskId": row["taskId"].as_str().unwrap_or_default(), + "operatorId": row["operatorId"].as_str().unwrap_or_default(), + "opType": qv(&raw, "opType"), + })) +} + +/// `POST /api/workflow/operator/SendBack/{id}` —— 退回。 +/// +/// 官方 `api/workFlow/task.ts:156` ⇒ 官方 `OperatorController.java:339`。 +pub async fn workflow_operator_send_back( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = (id, body); + unsupported_engine("退回流程") +} + +/// `GET /api/workflow/operator/SendBackNodeList/{id}` —— 可退回的节点。 +/// +/// 官方 `api/workFlow/task.ts:160` ⇒ 官方 `OperatorController.java:325`。 +/// +/// 🔴 **官方返 `ListVO`** ⇒ 本仓返 `{"list":[{nodeCode,nodeName}]}`。 +pub async fn workflow_operator_send_back_node_list( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let id = id.trim().to_string(); + let sql = "SELECT DISTINCT n.f_node_code AS \"nodeCode\", \ + COALESCE(o.f_node_name, '') AS \"nodeName\" \ + FROM workflow_node n \ + LEFT JOIN workflow_operator o \ + ON o.f_node_code = n.f_node_code AND COALESCE(o.f_delete_mark, 0) = 0 \ + WHERE COALESCE(n.f_delete_mark, 0) = 0 \ + AND n.f_flow_id IN ( \ + SELECT v.f_id FROM workflow_version v \ + JOIN workflow_task t ON t.f_template_id = v.f_template_id \ + WHERE t.f_id = (SELECT o2.f_task_id FROM workflow_operator o2 \ + WHERE o2.f_id = $1::text)) \ + ORDER BY n.f_node_code ASC"; + let rows = match state.db.query_json_params(sql, &[&id]).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "可退回节点查询"), + }; + ok(list_vo(rows)) +} + +/// `POST /api/workflow/operator/AddSign/{id}` —— 加签。 +/// +/// 官方 `api/workFlow/task.ts:164` ⇒ 官方 `OperatorController.java:274`。 +pub async fn workflow_operator_add_sign( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = (id, body); + unsupported_engine("加签流程") +} + +/// `GET /api/workflow/operator/RecordList` —— 节点记录列表。 +/// +/// 官方 `api/workFlow/task.ts:168`(`?taskId=…&nodeId=…`)⇒ 官方 `OperatorController.java:579`。 +/// +/// 🔴 **`data` 是裸数组**。 +pub async fn workflow_operator_record_list( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let task_id = qv(&raw, "taskId"); + let node_id = qv(&raw, "nodeId"); + let sql = "SELECT r.f_id AS \"id\", r.f_task_id AS \"taskId\", r.f_node_id AS \"nodeId\", \ + r.f_node_code AS \"nodeCode\", r.f_node_name AS \"nodeName\", \ + COALESCE(r.f_handle_type, 0) AS \"handleType\", r.f_handle_id AS \"handleId\", \ + r.f_handle_opinion AS \"handleOpinion\", \ + (EXTRACT(EPOCH FROM r.f_handle_time) * 1000)::bigint AS \"handleTime\", \ + COALESCE(r.f_status, 0) AS \"status\", r.f_operator_id AS \"operatorId\", \ + r.f_creator_user_id AS \"creatorUserId\", \ + (EXTRACT(EPOCH FROM r.f_creator_time) * 1000)::bigint AS \"creatorTime\" \ + FROM workflow_record r \ + WHERE r.f_task_id = $1::text AND r.f_node_id = $2::text \ + AND COALESCE(r.f_delete_mark, 0) = 0 \ + ORDER BY r.f_handle_time DESC"; + match state.db.query_json_params(sql, &[&task_id, &node_id]).await { + Ok(rows) => ok(Value::Array(rows)), + Err(e) => db_error(e, "节点记录列表"), + } +} + +/// `GET /api/workflow/operator/CirculateList` —— 节点抄送列表。 +/// +/// 官方 `api/workFlow/task.ts:180`(`?taskId=…&nodeId=…`)⇒ 官方 `OperatorController.java:592`。 +/// +/// 🔴 **`data` 是裸数组**。 +pub async fn workflow_operator_circulate_list( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let task_id = qv(&raw, "taskId"); + let node_id = qv(&raw, "nodeId"); + let sql = "SELECT c.f_id AS \"id\", c.f_task_id AS \"taskId\", c.f_node_id AS \"nodeId\", \ + c.f_node_code AS \"nodeCode\", c.f_node_name AS \"nodeName\", \ + c.f_operator_id AS \"operatorId\", c.f_user_id AS \"userId\", \ + COALESCE(c.f_read, 0) AS \"isRead\" \ + FROM workflow_circulate c \ + WHERE c.f_task_id = $1::text AND c.f_node_id = $2::text \ + AND COALESCE(c.f_delete_mark, 0) = 0 \ + ORDER BY c.f_creator_time DESC"; + match state.db.query_json_params(sql, &[&task_id, &node_id]).await { + Ok(rows) => ok(Value::Array(rows)), + Err(e) => db_error(e, "节点抄送列表"), + } +} + +// ================================================================ 流程委托(Delegate) + +/// 毫秒时间戳 ⇒ `timestamp` 字面量(官方 `DelegateCrForm.startTime/endTime` 是 **毫秒**)。 +fn ms_to_ts(ms: i64) -> String { + chrono::DateTime::from_timestamp_millis(ms) + .map(|dt| dt.naive_utc().format("%Y-%m-%d %H:%M:%S").to_string()) + .unwrap_or_else(|| "1970-01-01 00:00:00".to_string()) +} + +/// `GET /api/workflow/delegate` —— 流程委托列表。 +/// +/// 官方 `api/workFlow/flowDelegate.ts:9` ⇒ 官方 `DelegateController.java:76`。 +/// +/// 🔴 **官方只列「我委托出去的」**(`f_user_id = 我`)⇒ 本仓同款。 +/// 🔴 **`data` 是 `PageListVO`**(官方 `PageListVO`)。 +pub async fn workflow_delegate_list( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + let user = match require_login_face_b(&state, &headers).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let page = Paging::of(&raw); + let keyword = qv(&raw, "keyword"); + let mut filters: Vec = Vec::new(); + let mut values: Vec> = + vec![Some(user.user_id.clone()), Some(user.account.clone())]; + if !keyword.is_empty() { + filters.push("AND (d.f_flow_name ILIKE $3::text OR d.f_user_name ILIKE $3::text)".to_string()); + values.push(Some(format!("%{keyword}%"))); + } + let where_body = format!( + "COALESCE(d.f_delete_mark, 0) = 0 \ + AND (d.f_user_id = $1::text OR d.f_user_id = $2::text){}", + if filters.is_empty() { + String::new() + } else { + format!(" {}", filters.join(" ")) + } + ); + let from_sql = "workflow_delegate d \ + LEFT JOIN workflow_delegate_info i \ + ON i.f_delegate_id = d.f_id AND COALESCE(i.f_delete_mark, 0) = 0"; + match paged_query( + &state, + DELEGATE_LIST_COLUMNS, + from_sql, + &where_body, + "ORDER BY d.f_creator_time DESC", + values, + &page, + "流程委托列表", + ) + .await + { + Ok((total, rows)) => ok(page_list(page.current_page, page.page_size, total, rows)), + Err(resp) => resp, + } +} + +/// `POST /api/workflow/delegate` —— 新建流程委托。 +/// +/// 官方 `api/workFlow/flowDelegate.ts:13` ⇒ 官方 `DelegateController.java:118`。 +/// +/// 🔴 官方写两处:`workflow_delegate`(委托主行)+ `workflow_delegate_info`(每个受托人一行)。 +pub async fn workflow_delegate_create( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + let user = match require_login_face_b(&state, &headers).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let obj = match body_obj(&body) { + Ok(o) => o, + Err(resp) => return resp, + }; + let flow_name = text_field(&obj, "flowName").unwrap_or_default(); + if flow_name.is_empty() { + return fail(code::FAIL, "委托流程名称不能为空"); + } + let to_user_ids = id_list_of(&obj, "toUserId"); + if to_user_ids.is_empty() { + return fail(code::FAIL, "被委托人不能为空"); + } + let user_id = text_field(&obj, "userId").unwrap_or_else(|| user.user_id.clone()); + let user_name = text_field(&obj, "userName").unwrap_or_else(|| user.account.clone()); + let start_ms = obj.get("startTime").and_then(|v| v.as_i64()).unwrap_or(0); + let end_ms = obj.get("endTime").and_then(|v| v.as_i64()).unwrap_or(0); + + let delegate_id = new_uuid(); + let mut columns: Vec<&str> = vec!["f_id", "f_tenant_id"]; + let mut casts: Vec<&str> = vec!["", ""]; + let mut values: Vec> = + vec![Some(delegate_id.clone()), Some("0".to_string())]; + for (column, cast, value) in write_fields(&obj, DELEGATE_WRITE_FIELDS) { + columns.push(column); + casts.push(cast); + values.push(value); + } + columns.push("f_user_id"); + casts.push(""); + values.push(Some(user_id)); + columns.push("f_user_name"); + casts.push(""); + values.push(Some(user_name)); + columns.push("f_start_time"); + casts.push("::timestamp"); + values.push(Some(ms_to_ts(start_ms))); + columns.push("f_end_time"); + casts.push("::timestamp"); + values.push(Some(ms_to_ts(end_ms))); + columns.push("f_creator_user_id"); + casts.push(""); + values.push(Some(user.account.clone())); + columns.push("f_creator_time"); + + let mut marks: Vec = (0..values.len()) + .map(|i| placeholder(i + 1, casts[i])) + .collect(); + marks.push("now()".to_string()); + let sql = format!( + "INSERT INTO workflow_delegate ({}) VALUES ({})", + columns.join(", "), + marks.join(", ") + ); + if let Err(e) = state.db.exec_params(&sql, ¶ms_of(&values)).await { + return db_error(e, "新建流程委托"); + } + + // 🔴 受托人一行一条(官方 `delegateInfoService` 同款)。 + let to_user_name = text_field(&obj, "toUserName").unwrap_or_default(); + for to_user_id in &to_user_ids { + let info_sql = "INSERT INTO workflow_delegate_info \ + (f_id, f_tenant_id, f_delegate_id, f_to_user_id, f_to_user_name, \ + f_status, f_sort_code, f_creator_user_id, f_creator_time, f_delete_mark) \ + VALUES ($1::text, $2::text, $3::text, $4::text, $5::text, \ + $6::text::integer, $7::text::bigint, $8::text, now(), 0)"; + let info_values = vec![ + Some(new_uuid()), + Some("0".to_string()), + Some(delegate_id.clone()), + Some(to_user_id.clone()), + Some(to_user_name.clone()), + Some("0".to_string()), + Some("0".to_string()), + Some(user.account.clone()), + ]; + if let Err(e) = state.db.exec_params(info_sql, ¶ms_of(&info_values)).await { + return db_error(e, "新建流程委托(受托人)"); + } + } + ok(Value::String(delegate_id)) +} + +/// `PUT /api/workflow/delegate/{id}` —— 修改流程委托。 +/// +/// 官方 `api/workFlow/flowDelegate.ts:17` ⇒ 官方 `DelegateController.java:133`。 +pub async fn workflow_delegate_update( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + let user = match require_login_face_b(&state, &headers).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let id = id.trim().to_string(); + let obj = match body_obj(&body) { + Ok(o) => o, + Err(resp) => return resp, + }; + let mut set_parts: Vec = Vec::new(); + let mut values: Vec> = Vec::new(); + for (column, cast, value) in write_fields(&obj, DELEGATE_WRITE_FIELDS) { + values.push(value); + set_parts.push(format!("{} = {}", column, placeholder(values.len(), cast))); + } + if let Some(ms) = obj.get("startTime").and_then(|v| v.as_i64()) { + values.push(Some(ms_to_ts(ms))); + set_parts.push(format!("f_start_time = {}::timestamp", placeholder(values.len(), ""))); + } + if let Some(ms) = obj.get("endTime").and_then(|v| v.as_i64()) { + values.push(Some(ms_to_ts(ms))); + set_parts.push(format!("f_end_time = {}::timestamp", placeholder(values.len(), ""))); + } + values.push(Some(id.clone())); + let p_id = values.len(); + values.push(Some(user.account.clone())); + let p_user = values.len(); + set_parts.push("f_last_modify_time = now()".to_string()); + set_parts.push(format!("f_last_modify_user_id = ${p_user}::text")); + let sql = format!( + "UPDATE workflow_delegate SET {} WHERE f_id = ${p_id}::text", + set_parts.join(", ") + ); + if let Err(e) = state.db.exec_params(&sql, ¶ms_of(&values)).await { + return db_error(e, "修改流程委托"); + } + ok(Value::Null) +} + +/// `GET /api/workflow/delegate/{id}` —— 流程委托详情。 +/// +/// 官方 `api/workFlow/flowDelegate.ts:21` ⇒ 官方 `DelegateController.java:106`。 +/// +/// 🔴 **`data` 是裸对象**(官方 `DelegateInfoVO`)。 +pub async fn workflow_delegate_info( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let id = id.trim().to_string(); + let sql = "SELECT d.f_id AS \"id\", COALESCE(d.f_type, 0) AS \"type\", \ + d.f_user_id AS \"userId\", d.f_user_name AS \"userName\", \ + d.f_flow_id AS \"flowId\", d.f_flow_name AS \"flowName\", \ + d.f_description AS \"description\", \ + (EXTRACT(EPOCH FROM d.f_start_time) * 1000)::bigint AS \"startTime\", \ + (EXTRACT(EPOCH FROM d.f_end_time) * 1000)::bigint AS \"endTime\", \ + COALESCE(d.f_enabled_mark, 0) AS \"enabledMark\" \ + FROM workflow_delegate d \ + WHERE d.f_id = $1::text AND COALESCE(d.f_delete_mark, 0) = 0 LIMIT 1"; + let rows = match state.db.query_json_params(sql, &[&id]).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "流程委托详情查询"), + }; + let Some(row) = rows.into_iter().next() else { + return fail(code::FAIL, "流程委托不存在"); + }; + // 🔴 官方把受托人拼成逗号串(`toUserName`)并把 id 列表放进 `toUserId`。 + let info_sql = "SELECT f_to_user_id AS \"toUserId\", f_to_user_name AS \"toUserName\", \ + COALESCE(f_status, 0) AS \"status\" \ + FROM workflow_delegate_info \ + WHERE f_delegate_id = $1::text AND COALESCE(f_delete_mark, 0) = 0 \ + ORDER BY f_creator_time ASC"; + let infos = match state.db.query_json_params(info_sql, &[&id]).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "流程委托受托人查询"), + }; + let to_user_names: Vec = infos + .iter() + .map(|r| r["toUserName"].as_str().unwrap_or_default().to_string()) + .collect(); + let to_user_ids: Vec = infos + .iter() + .map(|r| r["toUserId"].as_str().unwrap_or_default().to_string()) + .collect(); + let mut payload = match row { + Value::Object(map) => map, + _ => Map::new(), + }; + payload.insert("toUserName".to_string(), json!(to_user_names.join(","))); + payload.insert("toUserId".to_string(), json!(to_user_ids)); + ok(Value::Object(payload)) +} + +/// `DELETE /api/workflow/delegate/{id}` —— 删除流程委托。 +/// +/// 官方 `api/workFlow/flowDelegate.ts:25` ⇒ 官方 `DelegateController.java:285`。 +/// +/// 🔴 官方连 `workflow_delegate_info` 一起删 ⇒ 本仓同款(软删)。 +pub async fn workflow_delegate_delete( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + let user = match require_login_face_b(&state, &headers).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let id = id.trim().to_string(); + let sql = "UPDATE workflow_delegate \ + SET f_delete_mark = 1, f_delete_time = now(), f_delete_user_id = $1::text \ + WHERE f_id = $2::text AND COALESCE(f_delete_mark, 0) = 0"; + if let Err(e) = state + .db + .exec_params(sql, ¶ms_of(&[Some(user.account.clone()), Some(id.clone())])) + .await + { + return db_error(e, "删除流程委托"); + } + let info_sql = "UPDATE workflow_delegate_info \ + SET f_delete_mark = 1 WHERE f_delegate_id = $1::text"; + if let Err(e) = state + .db + .exec_params(info_sql, ¶ms_of(&[Some(id)])) + .await + { + return db_error(e, "删除流程委托(受托人)"); + } + ok(Value::Null) +} + +/// `GET /api/workflow/delegate/UserList` —— 可委托人列表。 +/// +/// 官方 `api/workFlow/flowDelegate.ts:29`(`?templateId=…`)⇒ 官方 `DelegateController.java:300`。 +/// +/// 🔴 **官方返 `ListVO`** ⇒ 本仓返 `{"list":[…]}`。 +pub async fn workflow_delegate_user_list( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let template_id = qv(&raw, "templateId"); + let ids_sql = "SELECT DISTINCT c.f_handle_id AS \"id\" FROM workflow_candidates c \ + WHERE c.f_handle_id IS NOT NULL AND c.f_handle_id <> '' \ + AND c.f_task_id IN (SELECT v.f_id FROM workflow_version v \ + WHERE v.f_template_id = $1::text)"; + let ids = match state.db.query_json_params(ids_sql, &[&template_id]).await { + Ok(rows) => rows + .iter() + .filter_map(|r| r["id"].as_str().map(|s| s.to_string())) + .collect::>(), + Err(e) => return db_error(e, "可委托人查询"), + }; + let joined = ids.join(","); + let sql = "SELECT u.f_id AS \"id\", COALESCE(u.f_real_name, '') AS \"fullName\", \ + COALESCE(u.f_head_icon, '') AS \"headIcon\", \ + COALESCE(u.f_organize_id, '') AS \"organize\" \ + FROM base_user u \ + WHERE u.f_id = ANY(string_to_array($1::text, ',')) \ + AND COALESCE(u.f_delete_mark, 0) = 0 \ + ORDER BY u.f_real_name ASC"; + match state.db.query_json_params(sql, &[&joined]).await { + Ok(rows) => ok(list_vo(rows)), + Err(e) => db_error(e, "可委托人列表"), + } +} + +/// `PUT /api/workflow/delegate/Stop/{id}` —— 结束委托。 +/// +/// 官方 `api/workFlow/flowDelegate.ts:33` ⇒ 官方 `DelegateController.java:263`。 +/// +/// 🔴 官方把 `startTime` / `endTime` **都设成当前时间**(结束即刻失效)⇒ 本仓照抄。 +pub async fn workflow_delegate_stop( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + let user = match require_login_face_b(&state, &headers).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let id = id.trim().to_string(); + let exists = match state + .db + .query_json_params( + "SELECT f_id AS \"id\" FROM workflow_delegate \ + WHERE f_id = $1::text AND COALESCE(f_delete_mark, 0) = 0 LIMIT 1", + &[&id], + ) + .await + { + Ok(rows) => !rows.is_empty(), + Err(e) => return db_error(e, "流程委托存在性查询"), + }; + if !exists { + return fail(code::FAIL, "流程委托不存在"); + } + let sql = "UPDATE workflow_delegate \ + SET f_start_time = now(), f_end_time = now(), \ + f_last_modify_time = now(), f_last_modify_user_id = $1::text \ + WHERE f_id = $2::text"; + if let Err(e) = state + .db + .exec_params(sql, ¶ms_of(&[Some(user.account.clone()), Some(id)])) + .await + { + return db_error(e, "结束流程委托"); + } + ok(Value::Null) +} + +/// `GET /api/workflow/delegate/Info/{id}` —— 委托的受托人明细。 +/// +/// 官方 `api/workFlow/flowDelegate.ts:37` ⇒ 官方 `DelegateController.java:94`。 +/// +/// 🔴 **官方返 `List`** ⇒ 本仓返**裸数组**。 +pub async fn workflow_delegate_info_list( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let id = id.trim().to_string(); + let sql = "SELECT i.f_id AS \"id\", i.f_delegate_id AS \"delegateId\", \ + i.f_to_user_id AS \"toUserId\", i.f_to_user_name AS \"toUserName\", \ + COALESCE(i.f_status, 0) AS \"status\", \ + (EXTRACT(EPOCH FROM i.f_creator_time) * 1000)::bigint AS \"creatorTime\" \ + FROM workflow_delegate_info i \ + WHERE i.f_delegate_id = $1::text AND COALESCE(i.f_delete_mark, 0) = 0 \ + ORDER BY i.f_creator_time ASC"; + match state.db.query_json_params(sql, &[&id]).await { + Ok(rows) => ok(Value::Array(rows)), + Err(e) => db_error(e, "委托受托人明细"), + } +} + +/// `POST /api/workflow/delegate/Notarize/{id}` —— 确认(接受 / 拒绝)。 +/// +/// 官方 `api/workFlow/flowDelegate.ts:41`(`?type=1` 接受 / `?type=2` 拒绝) +/// ⇒ 官方 `DelegateController.java:314`。 +pub async fn workflow_delegate_notarize( + State(state): State, + headers: HeaderMap, + Path(id): Path, + raw: RawQuery, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let id = id.trim().to_string(); + let kind = qv(&raw, "type"); + let status = match kind.trim() { + "1" => 1, + "2" => 2, + other => return fail(code::FAIL, format!("未知的确认类型:{other}")), + }; + let sql = "UPDATE workflow_delegate_info \ + SET f_status = $1::text::integer, f_last_modify_time = now() \ + WHERE f_id = $2::text AND COALESCE(f_delete_mark, 0) = 0"; + if let Err(e) = state + .db + .exec_params(sql, ¶ms_of(&[Some(status.to_string()), Some(id)])) + .await + { + return db_error(e, "确认流程委托"); + } + ok(Value::Null) +} + +// ================================================================ 流程监控(Monitor) + +/// `GET /api/workflow/monitor` —— 流程监控列表。 +/// +/// 官方 `api/workFlow/flowMonitor.ts:9` ⇒ 官方 `WorkflowMonitorController.java:64`。 +/// +/// 🔴 **`data` 是 `PageListVO`**(官方 `PageListVO`)。 +pub async fn workflow_monitor_list( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let page = Paging::of(&raw); + let keyword = qv(&raw, "keyword"); + let system_id = current_system_id(&state, &headers).await; + let mut filters: Vec = Vec::new(); + let mut values: Vec> = vec![Some(system_id)]; + if !keyword.is_empty() { + filters.push("AND (t.f_full_name ILIKE $2::text OR t.f_en_code ILIKE $2::text)".to_string()); + values.push(Some(format!("%{keyword}%"))); + } + let where_body = format!( + "COALESCE(t.f_delete_mark, 0) = 0 \ + AND EXISTS (SELECT 1 FROM workflow_template tpl \ + WHERE tpl.f_id = t.f_template_id AND tpl.f_system_id = $1::text){}", + if filters.is_empty() { + String::new() + } else { + format!(" {}", filters.join(" ")) + } + ); + let from_sql = "workflow_task t LEFT JOIN base_user u ON u.f_id = t.f_creator_user_id"; + match paged_query( + &state, + MONITOR_LIST_COLUMNS, + from_sql, + &where_body, + "ORDER BY t.f_creator_time DESC", + values, + &page, + "流程监控列表", + ) + .await + { + Ok((total, rows)) => ok(page_list(page.current_page, page.page_size, total, rows)), + Err(resp) => resp, + } +} + +/// `DELETE /api/workflow/monitor` —— 批量删除流程监控。 +/// +/// 官方 `api/workFlow/flowMonitor.ts:13` ⇒ 官方 `WorkflowMonitorController.java:102` +/// (`@SaCheckPermission({"workFlow.flowMonitor"})` @103)。 +/// +/// 🔴 官方收**请求体**(`MonitorModel`)里的 id 列表 ⇒ 本仓同口径。 +pub async fn workflow_monitor_delete( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + let user = match guard(&state, &headers, EN_FLOW_MONITOR).await { + Ok(u) => u, + Err(resp) => return resp, + }; + // 🔴 官方 `MonitorModel` 的 id 列表有两种形状:对象 `{"ids":[…]}` 或裸数组。 + let parsed = match serde_json::from_slice::(&body) { + Ok(v) => v, + Err(e) => return fail(code::FAIL, format!("请求体不是合法 JSON:{e}")), + }; + let ids: Vec = match &parsed { + Value::Array(items) => items + .iter() + .filter_map(|v| v.as_str().map(|s| s.to_string())) + .filter(|s| !s.is_empty()) + .collect(), + Value::Object(map) => id_list(map), + _ => Vec::new(), + }; + if ids.is_empty() { + return ok(Value::Null); + } + let mut filters: Vec = Vec::new(); + let mut values: Vec> = Vec::new(); + for id in &ids { + values.push(Some(id.clone())); + filters.push(format!("f_id = ${}::text", values.len())); + } + values.push(Some(user.account.clone())); + let p_user = values.len(); + let sql = format!( + "UPDATE workflow_task SET f_delete_mark = 1, f_delete_time = now(), \ + f_delete_user_id = ${p_user}::text WHERE ({}) AND COALESCE(f_delete_mark, 0) = 0", + filters.join(" OR ") + ); + if let Err(e) = state.db.exec_params(&sql, ¶ms_of(&values)).await { + return db_error(e, "删除流程监控"); + } + ok(Value::Null) +} + +/// `GET /api/workflow/monitor/{id}/EventLog` —— 流程监控事件日志。 +/// +/// 官方 `api/workFlow/flowMonitor.ts:17` ⇒ 官方 `WorkflowMonitorController.java:115` 之后的 +/// 事件日志端点。 +/// +/// 🔴 **`data` 是裸数组**。 +pub async fn workflow_monitor_event_log( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let id = id.trim().to_string(); + let sql = format!( + "SELECT {} FROM workflow_event_log e \ + WHERE e.f_task_id = $1::text AND COALESCE(e.f_delete_mark, 0) = 0 \ + ORDER BY e.f_creator_time ASC", + EVENT_LOG_COLUMNS + ); + match state.db.query_json_params(&sql, &[&id]).await { + Ok(rows) => ok(Value::Array(rows)), + Err(e) => db_error(e, "流程监控事件日志"), + } +} + +/// `POST /api/workflow/monitor/Cancel/{id}` —— 终止审核。 +/// +/// 官方 `api/workFlow/flowMonitor.ts:21` ⇒ 官方 `WorkflowMonitorController.java:159` +/// (`@SaCheckPermission({"workFlow.flowMonitor"})` @160)。 +pub async fn workflow_monitor_cancel( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_FLOW_MONITOR).await { + return resp; + } + let _ = (id, body); + unsupported_engine("终止流程审核") +} + +/// `POST /api/workflow/monitor/Assign/{id}` —— 流程监控指派。 +/// +/// 官方 `api/workFlow/flowMonitor.ts:25` ⇒ 官方 `WorkflowMonitorController.java:191` +/// (`@SaCheckPermission({"workFlow.flowMonitor"})` @192)。 +pub async fn workflow_monitor_assign( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_FLOW_MONITOR).await { + return resp; + } + let _ = (id, body); + unsupported_engine("流程监控指派") +} + +/// `POST /api/workflow/monitor/Activate/{id}` —— 流程复活。 +/// +/// 官方 `api/workFlow/flowMonitor.ts:29` ⇒ 官方 `WorkflowMonitorController.java:175` +/// (`@SaCheckPermission({"workFlow.flowMonitor"})` @176)。 +pub async fn workflow_monitor_activate( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_FLOW_MONITOR).await { + return resp; + } + let _ = (id, body); + unsupported_engine("流程复活") +} + +/// `GET /api/workflow/monitor/AnySubFlow/{id}` —— 是否含子流程(暂停类型)。 +/// +/// 官方 `api/workFlow/flowMonitor.ts:33` ⇒ 官方 `WorkflowMonitorController.java:115`。 +/// +/// 🔴 **官方返 `Boolean`** ⇒ 本仓返**裸布尔**。 +pub async fn workflow_monitor_any_sub_flow( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let id = id.trim().to_string(); + let sql = "SELECT count(*)::bigint AS \"c\" FROM workflow_task \ + WHERE f_parent_id = $1::text AND COALESCE(f_delete_mark, 0) = 0"; + let rows = match state.db.query_json_params(sql, &[&id]).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "子流程数量查询"), + }; + let count = rows.first().and_then(|r| r["c"].as_i64()).unwrap_or(0); + ok(Value::Bool(count > 0)) +} + +/// `POST /api/workflow/monitor/Pause/{id}` —— 暂停流程。 +/// +/// 官方 `api/workFlow/flowMonitor.ts:37` ⇒ 官方 `WorkflowMonitorController.java:127` +/// (`@SaCheckPermission({"workFlow.flowMonitor"})` @128)。 +pub async fn workflow_monitor_pause( + State(state): State, + headers: HeaderMap, + Path(id): Path, + body: Bytes, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_FLOW_MONITOR).await { + return resp; + } + let _ = (id, body); + unsupported_engine("暂停流程") +} + +/// `POST /api/workflow/monitor/Reboot/{id}` —— 恢复流程。 +/// +/// 官方 `api/workFlow/flowMonitor.ts:41` ⇒ 官方 `WorkflowMonitorController.java:143` +/// (`@SaCheckPermission({"workFlow.flowMonitor"})` @144)。 +pub async fn workflow_monitor_reboot( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_FLOW_MONITOR).await { + return resp; + } + let _ = id; + unsupported_engine("恢复流程") +} + +/// `POST /api/workflow/monitor/FlowTodoCount` —— 我的待办统计(门户)。 +/// +/// 官方 `api/workFlow/flowMonitor.ts:45` ⇒ 官方 `WorkflowMonitorController.java:205`。 +/// +/// 🔴 **官方返 `TaskTo`** ⇒ 本仓返**裸对象**(各分类计数 + `is*` 布尔)。 +pub async fn workflow_monitor_flow_todo_count( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + let user = match require_login_face_b(&state, &headers).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let _ = body; + let count_of = |sql: String, values: Vec>| { + let db = state.db.clone(); + async move { + match db.query_json_params(&sql, ¶ms_of(&values)).await { + Ok(rows) => rows.first().and_then(|r| r["c"].as_i64()).unwrap_or(0), + Err(_) => 0, + } + } + }; + let base = "COALESCE(o.f_delete_mark, 0) = 0 AND o.f_completion = 0 \ + AND o.f_status <> -1 AND o.f_status <> -2 \ + AND (o.f_handle_id = $1::text OR o.f_handle_id = $2::text)"; + let to_sign = count_of( + format!("SELECT count(*)::bigint AS \"c\" FROM workflow_operator o WHERE {base} \ + AND o.f_sign_time IS NULL AND o.f_start_handle_time IS NULL \ + AND o.f_handle_status IS NULL"), + vec![Some(user.user_id.clone()), Some(user.account.clone())], + ) + .await; + let todo = count_of( + format!("SELECT count(*)::bigint AS \"c\" FROM workflow_operator o WHERE {base} \ + AND o.f_sign_time IS NOT NULL AND o.f_start_handle_time IS NULL \ + AND o.f_handle_status IS NULL"), + vec![Some(user.user_id.clone()), Some(user.account.clone())], + ) + .await; + let doing = count_of( + format!("SELECT count(*)::bigint AS \"c\" FROM workflow_operator o WHERE {base} \ + AND o.f_sign_time IS NOT NULL AND o.f_start_handle_time IS NOT NULL \ + AND o.f_handle_status IS NULL"), + vec![Some(user.user_id.clone()), Some(user.account.clone())], + ) + .await; + let done = count_of( + String::from("SELECT count(*)::bigint AS \"c\" FROM workflow_record r \ + WHERE COALESCE(r.f_delete_mark, 0) = 0 \ + AND r.f_handle_type IN (0, 1, 3, 5, 7, 18) AND r.f_operator_id IS NOT NULL \ + AND (r.f_handle_id = $1::text OR r.f_handle_id = $2::text)"), + vec![Some(user.user_id.clone()), Some(user.account.clone())], + ) + .await; + let circulate = count_of( + String::from("SELECT count(*)::bigint AS \"c\" FROM workflow_circulate c \ + WHERE COALESCE(c.f_delete_mark, 0) = 0 \ + AND (c.f_user_id = $1::text OR c.f_user_id = $2::text)"), + vec![Some(user.user_id.clone()), Some(user.account.clone())], + ) + .await; + let launch = count_of( + String::from("SELECT count(*)::bigint AS \"c\" FROM workflow_task t \ + WHERE COALESCE(t.f_delete_mark, 0) = 0 \ + AND (t.f_creator_user_id = $1::text OR t.f_creator_user_id = $2::text)"), + vec![Some(user.user_id.clone()), Some(user.account.clone())], + ) + .await; + ok(json!({ + "flowToSignType": 0, + "flowTodoType": 1, + "flowDoingType": 2, + "flowDoneType": 3, + "flowCirculateType": 4, + "flowToSign": to_sign, + "flowTodo": todo, + "flowDoing": doing, + "flowDone": done, + "flowCirculate": circulate, + "flowLaunch": launch, + "isToSign": to_sign > 0, + "isTodo": todo > 0, + "isDoing": doing > 0, + "isDone": done > 0, + "isCirculate": circulate > 0, + "isLaunch": launch > 0, + "moduleList": Value::Array(Vec::new()), + })) +} + +/// `GET /api/workflow/monitor/FlowTodo?type=…` —— 待办事项(门户)。 +/// +/// 官方 `api/workFlow/flowMonitor.ts:49` ⇒ 官方 `WorkflowMonitorController.java:218`。 +/// +/// 🔴 **官方返 `FlowTodoVO{isAuthorize:false, list}`** ⇒ 本仓返**裸对象**。 +pub async fn workflow_monitor_flow_todo( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + let user = match require_login_face_b(&state, &headers).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let kind = qv(&raw, "type"); + let category = match kind.trim() { + "0" => CAT_SIGN, + "1" => CAT_TODO, + "2" => CAT_DOING, + "3" => CAT_DONE, + "4" => CAT_CIRCULATE, + _ => CAT_TODO, + }; + let rows = match category { + CAT_DONE => { + let sql = "SELECT r.f_id AS \"id\", r.f_task_id AS \"taskId\", \ + r.f_node_id AS \"nodeId\", r.f_node_code AS \"nodeCode\", \ + r.f_node_name AS \"nodeName\", \ + COALESCE(r.f_handle_type, 0) AS \"handleType\", \ + r.f_handle_id AS \"handleId\", r.f_handle_opinion AS \"handleOpinion\", \ + (EXTRACT(EPOCH FROM r.f_handle_time) * 1000)::bigint AS \"handleTime\", \ + COALESCE(r.f_status, 0) AS \"status\", \ + r.f_operator_id AS \"operatorId\" \ + FROM workflow_record r \ + WHERE COALESCE(r.f_delete_mark, 0) = 0 \ + AND r.f_handle_type IN (0, 1, 3, 5, 7, 18) \ + AND r.f_operator_id IS NOT NULL \ + AND (r.f_handle_id = $1::text OR r.f_handle_id = $2::text) \ + ORDER BY r.f_handle_time DESC"; + state + .db + .query_json_params( + sql, + ¶ms_of(&[Some(user.user_id.clone()), Some(user.account.clone())]), + ) + .await + } + CAT_CIRCULATE => { + let sql = "SELECT c.f_id AS \"id\", c.f_task_id AS \"taskId\", \ + c.f_node_id AS \"nodeId\", c.f_node_code AS \"nodeCode\", \ + c.f_node_name AS \"nodeName\", c.f_operator_id AS \"operatorId\", \ + c.f_user_id AS \"userId\", COALESCE(c.f_read, 0) AS \"isRead\" \ + FROM workflow_circulate c \ + WHERE COALESCE(c.f_delete_mark, 0) = 0 \ + AND (c.f_user_id = $1::text OR c.f_user_id = $2::text) \ + ORDER BY c.f_creator_time DESC"; + state + .db + .query_json_params( + sql, + ¶ms_of(&[Some(user.user_id.clone()), Some(user.account.clone())]), + ) + .await + } + _ => { + let sign_clause = match category { + CAT_SIGN => { + "AND o.f_sign_time IS NULL AND o.f_start_handle_time IS NULL \ + AND o.f_handle_status IS NULL" + } + CAT_DOING => { + "AND o.f_sign_time IS NOT NULL AND o.f_start_handle_time IS NOT NULL \ + AND o.f_handle_status IS NULL" + } + _ => { + "AND o.f_sign_time IS NOT NULL AND o.f_start_handle_time IS NULL \ + AND o.f_handle_status IS NULL" + } + }; + let sql = format!( + "SELECT o.f_id AS \"id\", o.f_task_id AS \"taskId\", o.f_node_id AS \"nodeId\", \ + o.f_node_code AS \"nodeCode\", o.f_node_name AS \"nodeName\", \ + o.f_handle_id AS \"handleId\", o.f_instance_id AS \"instanceId\", \ + COALESCE(o.f_status, 0) AS \"status\" \ + FROM workflow_operator o \ + WHERE COALESCE(o.f_delete_mark, 0) = 0 AND o.f_completion = 0 \ + AND o.f_status <> -1 AND o.f_status <> -2 \ + AND (o.f_handle_id = $1::text OR o.f_handle_id = $2::text) \ + {sign_clause} \ + ORDER BY o.f_creator_time DESC" + ); + state + .db + .query_json_params( + &sql, + ¶ms_of(&[Some(user.user_id.clone()), Some(user.account.clone())]), + ) + .await + } + }; + match rows { + Ok(rows) => ok(json!({ "isAuthorize": false, "list": rows })), + Err(e) => db_error(e, "待办事项"), + } +} + +// ================================================================ 在线表单(flowForm) +// +// 🔴 官方 `/api/flowForm/Form/**` 属于 **onlineDev / visualdev** 模块(不是 flowable), +// 官方控制器**不在本仓 clone 的源码里**(`jnpf-visualdev` 只有 `VisualdevForFlowController` +// 的服务实现,没有 REST 映射)⇒ 本仓只能按**前端语义**实现。 +// +// 🔴 本仓**没有 `visualdev_*` 表**(在线表单设计器整体不迁)⇒ 除「表单↔流程关系」 +// (`workflow_form_relation`,官方同名字段 `f_form_id` / `f_flow_id`)外, +// 其余端点一律**明确业务失败**(不返假表单)。 + +/// `GET /api/flowForm/Form` —— 表单列表(分页)。 +/// +/// 官方 `api/workFlow/formDesign.ts:9`。 +pub async fn workflow_form_list( + State(state): State, + headers: HeaderMap, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + unsupported_form("查询在线表单列表") +} + +/// `POST /api/flowForm/Form` —— 新建表单。 +/// +/// 官方 `api/workFlow/formDesign.ts:13`。 +pub async fn workflow_form_create( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = body; + unsupported_form("新建在线表单") +} + +/// `PUT /api/flowForm/Form` —— 修改表单。 +/// +/// 官方 `api/workFlow/formDesign.ts:17`。 +pub async fn workflow_form_update( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = body; + unsupported_form("修改在线表单") +} + +/// `GET /api/flowForm/Form/{id}` —— 获取表单。 +/// +/// 官方 `api/workFlow/formDesign.ts:21`。 +pub async fn workflow_form_info( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = id; + unsupported_form("查询在线表单") +} + +/// `DELETE /api/flowForm/Form/{id}` —— 删除表单。 +/// +/// 官方 `api/workFlow/formDesign.ts:25`。 +pub async fn workflow_form_delete( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = id; + unsupported_form("删除在线表单") +} + +/// `POST /api/flowForm/Form/Release/{id}` —— 发布 / 回滚表单。 +/// +/// 官方 `api/workFlow/formDesign.ts:29`(`?isRelease=1`)。 +pub async fn workflow_form_release( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = id; + unsupported_form("发布在线表单") +} + +/// `GET /api/flowForm/Form/{id}/Actions/Copy` —— 复制表单。 +/// +/// 官方 `api/workFlow/formDesign.ts:33`。 +pub async fn workflow_form_copy( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = id; + unsupported_form("复制在线表单") +} + +/// `GET /api/flowForm/Form/{id}/Actions/Export` —— 导出表单。 +/// +/// 官方 `api/workFlow/formDesign.ts:37`。 +pub async fn workflow_form_export( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = id; + unsupported_file("导出在线表单") +} + +/// `GET /api/flowForm/Form/{id}/getField` —— 按表单 id 取表单字段。 +/// +/// 官方 `api/workFlow/formDesign.ts:41`。 +pub async fn workflow_form_field( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let _ = id; + unsupported_form("查询在线表单字段") +} + +/// `GET /api/flowForm/Form/select` —— 表单下拉列表。 +/// +/// 官方 `api/workFlow/formDesign.ts:45`。 +pub async fn workflow_form_select( + State(state): State, + headers: HeaderMap, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + unsupported_form("查询在线表单下拉列表") +} + +/// `GET /api/flowForm/Form/getFormById/{id}` —— 由表单 id 反查流程 id。 +/// +/// 官方 `api/workFlow/formDesign.ts:49`。 +/// +/// 🔴 **这个本仓答得出来**:官方 24 张 `workflow_*` 表里有 `workflow_form_relation` +/// (`f_form_id` / `f_flow_id`)⇒ 这是**流程侧**的关联表,不是表单设计器的东西。 +/// +/// 🔴 **`data` 是裸对象**(`{formId, flowId}`;官方控制器不在 clone 内 ⇒ 形状按 +/// 前端语义「通过表单id获取流程id」推断)。 +pub async fn workflow_form_by_id( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let id = id.trim().to_string(); + let sql = "SELECT r.f_form_id AS \"formId\", r.f_flow_id AS \"flowId\" \ + FROM workflow_form_relation r \ + WHERE r.f_form_id = $1::text AND COALESCE(r.f_delete_mark, 0) = 0 \ + LIMIT 1"; + let rows = match state.db.query_json_params(sql, &[&id]).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "表单反查流程"), + }; + match rows.into_iter().next() { + Some(row) => ok(row), + None => ok(json!({ "formId": id, "flowId": Value::Null })), + } +} + +// ================================================================ 流程触发任务(Trigger) + +/// `GET /api/workflow/trigger/task/List` —— 触发任务列表(含记录)。 +/// +/// 官方 `api/workFlow/trigger.ts:9` ⇒ 官方 `TriggerTaskController.java:59`。 +/// +/// 🔴 **官方返 `List`** ⇒ 本仓返**裸数组**。 +pub async fn workflow_trigger_list( + State(state): State, + headers: HeaderMap, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let sql = "SELECT g.f_id AS \"id\", \ + (EXTRACT(EPOCH FROM g.f_start_time) * 1000)::bigint AS \"startTime\", \ + COALESCE(g.f_is_async, 0) AS \"isAsync\", g.f_task_id AS \"taskId\", \ + g.f_node_code AS \"nodeCode\", g.f_node_id AS \"nodeId\", \ + g.f_flow_id AS \"flowId\", g.f_full_name AS \"fullName\" \ + FROM workflow_trigger_task g \ + WHERE COALESCE(g.f_delete_mark, 0) = 0 \ + ORDER BY g.f_creator_time DESC"; + let tasks = match state.db.query_json_params(sql, &[]).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "触发任务列表"), + }; + let record_sql = "SELECT r.f_id AS \"id\", r.f_trigger_id AS \"triggerId\", \ + r.f_task_id AS \"taskId\", r.f_node_id AS \"nodeId\", \ + r.f_node_code AS \"nodeCode\", r.f_node_name AS \"nodeName\", \ + (EXTRACT(EPOCH FROM r.f_start_time) * 1000)::bigint AS \"startTime\", \ + (EXTRACT(EPOCH FROM r.f_end_time) * 1000)::bigint AS \"endTime\", \ + COALESCE(r.f_status, 0) AS \"status\", \ + r.f_error_tip AS \"errorTip\", r.f_error_data AS \"errorData\", \ + r.f_result_data AS \"resultData\" \ + FROM workflow_trigger_record r \ + WHERE COALESCE(r.f_delete_mark, 0) = 0 \ + ORDER BY r.f_creator_time ASC"; + let records = match state.db.query_json_params(record_sql, &[]).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "触发任务记录"), + }; + let list: Vec = tasks + .iter() + .map(|t| { + let tid = t["id"].as_str().unwrap_or_default(); + let own: Vec = records + .iter() + .filter(|r| r["triggerId"].as_str().unwrap_or_default() == tid) + .cloned() + .collect(); + let mut map = match t { + Value::Object(m) => m.clone(), + _ => Map::new(), + }; + map.insert("recordList".to_string(), json!(own)); + Value::Object(map) + }) + .collect(); + ok(Value::Array(list)) +} + +/// `GET /api/workflow/trigger/task` —— 触发任务分页列表。 +/// +/// 官方 `api/workFlow/trigger.ts:13` ⇒ 官方 `TriggerTaskController.java:72`。 +/// +/// 🔴 **`data` 是 `PageListVO`**(官方 `PageListVO`)。 +pub async fn workflow_trigger_task_list( + State(state): State, + headers: HeaderMap, + raw: RawQuery, +) -> Json { + if let Err(resp) = require_login_face_b(&state, &headers).await { + return resp; + } + let page = Paging::of(&raw); + let keyword = qv(&raw, "keyword"); + let mut filters: Vec = Vec::new(); + let mut values: Vec> = Vec::new(); + if !keyword.is_empty() { + filters.push("AND g.f_full_name ILIKE $1::text".to_string()); + values.push(Some(format!("%{keyword}%"))); + } + let where_body = format!( + "COALESCE(g.f_delete_mark, 0) = 0{}", + if filters.is_empty() { + String::new() + } else { + format!(" {}", filters.join(" ")) + } + ); + match paged_query( + &state, + TRIGGER_LIST_COLUMNS, + "workflow_trigger_task g", + &where_body, + "ORDER BY g.f_creator_time DESC", + values, + &page, + "触发任务分页", + ) + .await + { + Ok((total, rows)) => ok(page_list(page.current_page, page.page_size, total, rows)), + Err(resp) => resp, + } +} + +/// `DELETE /api/workflow/trigger/task` —— 删除触发任务。 +/// +/// 官方 `api/workFlow/trigger.ts:17` ⇒ 官方 `TriggerTaskController.java:110` +/// (`@SaCheckPermission({"workFlow.flowMonitor"})` @111)。 +pub async fn workflow_trigger_delete( + State(state): State, + headers: HeaderMap, + body: Bytes, +) -> Json { + let user = match guard(&state, &headers, EN_FLOW_MONITOR).await { + Ok(u) => u, + Err(resp) => return resp, + }; + let parsed = match serde_json::from_slice::(&body) { + Ok(v) => v, + Err(e) => return fail(code::FAIL, format!("请求体不是合法 JSON:{e}")), + }; + let ids: Vec = match &parsed { + Value::Array(items) => items + .iter() + .filter_map(|v| v.as_str().map(|s| s.to_string())) + .filter(|s| !s.is_empty()) + .collect(), + Value::Object(map) => id_list(map), + _ => Vec::new(), + }; + if ids.is_empty() { + return ok(Value::Null); + } + let mut filters: Vec = Vec::new(); + let mut values: Vec> = Vec::new(); + for id in &ids { + values.push(Some(id.clone())); + filters.push(format!("f_id = ${}::text", values.len())); + } + values.push(Some(user.account.clone())); + let p_user = values.len(); + let sql = format!( + "UPDATE workflow_trigger_task SET f_delete_mark = 1, f_delete_time = now(), \ + f_delete_user_id = ${p_user}::text WHERE ({}) AND COALESCE(f_delete_mark, 0) = 0", + filters.join(" OR ") + ); + if let Err(e) = state.db.exec_params(&sql, ¶ms_of(&values)).await { + return db_error(e, "删除触发任务"); + } + ok(Value::Null) +} + +/// `POST /api/workflow/trigger/task/Retry/{id}` —— 触发任务重试。 +/// +/// 官方 `api/workFlow/trigger.ts:21` ⇒ 官方 `TriggerTaskController.java:97` +/// (`@SaCheckPermission({"workFlow.flowMonitor"})` @98)。 +pub async fn workflow_trigger_retry( + State(state): State, + headers: HeaderMap, + Path(id): Path, +) -> Json { + if let Err(resp) = guard(&state, &headers, EN_FLOW_MONITOR).await { + return resp; + } + let _ = id; + unsupported_engine("重试流程触发任务") +} diff --git a/src/backend/src/routes.rs b/src/backend/src/routes.rs index 3b135e9..5b0cb52 100644 --- a/src/backend/src/routes.rs +++ b/src/backend/src/routes.rs @@ -1571,7 +1571,133 @@ pub fn build_router(state: AppState) -> axum::Router { .route("/api/Report/{id}/Actions/Export", get(compat::report::report_export_data)) .route("/api/Report/{id}/Actions/Module", post(compat::report::report_create_menu)) .route("/api/Report/{id}/getReleaseMenu", get(compat::report::report_release_menu)) - .merge(crate::bootstrap::pack_router_or_empty()); + // ---- 流程引擎(官方 `api/workFlow/**`,前缀 `/api/workflow/*` + `/api/flowForm/Form/*`)---- + // + // 🔴 **官方流程模块是独立 Maven 模块 `jnpf-flowable`**,官方部署时**引擎本体是另一个 + // HTTP 服务**(`FlowAbleUrl = /api/Flow/*`)—— 本仓**没有**该服务。 + // ⇒ 端点按三类分账(详见 `compat/workflow.rs` 文件头): + // ① **流程元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录) + // ⇒ **真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方)。 + // ② **引擎动作**(发起 / 审批 / 办理 / 转审 / 撤回 / 撤销 / 退回 / 加签 / 减签 / + // 协办 / 批量审批 / 暂停 / 终止 / 复活 / 重试 / 催办 / 签收) + // ⇒ **明确业务失败**(`code=FAIL` + 「本仓未接入流程引擎(Flowable)」), + // **绝不返假结果**。 + // ③ **文件与在线表单设计器**(`Export` / `/api/flowForm/Form/**`) + // ⇒ **明确业务失败**(本仓无文件服务、无 `visualdev_*` 表)。 + // + // 🔴 **权限守卫**(照官方 `@SaCheckPermission` 抄): + // - `onlineDev.flowEngine` ⇒ 模板写操作(新建 / 更新 / 删除 / 上下架 / 复制 …) + // - `workFlow.flowMonitor` ⇒ 监控与触发写操作(终止 / 指派 / 复活 / 重试 …) + // - 其余(Task / Operator / Comment / Delegate / Hooks)官方**没有**权限注解 + // ⇒ 只要求登录。 + // + // 🔴 **多应用隔离**:`workflow_*` 里只有 `workflow_template` 有 `f_system_id` + // (官方 DDL 如此)⇒ 任务 / 评论按「任务 → 模板」链路回溯系统归属。 + .route("/api/workflow/template", get(compat::workflow::workflow_template_list)) + .route("/api/workflow/template", post(compat::workflow::workflow_template_create)) + .route("/api/workflow/template/{id}", put(compat::workflow::workflow_template_update)) + .route("/api/workflow/template/{id}", get(compat::workflow::workflow_template_info)) + .route("/api/workflow/template/{id}", delete(compat::workflow::workflow_template_delete)) + .route("/api/workflow/template/{id}/Actions/Copy", post(compat::workflow::workflow_template_copy)) + .route("/api/workflow/template/{id}/Actions/Export", get(compat::workflow::workflow_template_export)) + .route("/api/workflow/template/{id}/UpdateType", put(compat::workflow::workflow_template_update_type)) + .route("/api/workflow/template/Save", post(compat::workflow::workflow_template_save)) + .route("/api/workflow/template/Info/{id}", get(compat::workflow::workflow_template_json_info)) + .route("/api/workflow/template/Version/{id}", get(compat::workflow::workflow_template_version_list)) + .route("/api/workflow/template/Info/{id}", delete(compat::workflow::workflow_template_version_delete)) + .route("/api/workflow/template/Info/{id}", post(compat::workflow::workflow_template_version_copy)) + .route("/api/workflow/template/Selector", get(compat::workflow::workflow_template_selector)) + .route("/api/workflow/template/{id}/FormInfo", get(compat::workflow::workflow_template_form_info)) + .route("/api/workflow/template/StartForm/{id}", get(compat::workflow::workflow_template_start_form)) + .route("/api/workflow/template/StartFormId/{id}", get(compat::workflow::workflow_template_start_form_id)) + .route("/api/workflow/template/TreeList", get(compat::workflow::workflow_template_tree_list)) + .route("/api/workflow/template/GetFlowList", post(compat::workflow::workflow_template_get_flow_list)) + .route("/api/workflow/template/getCommonFlowList", get(compat::workflow::workflow_template_common_flow_list)) + .route("/api/workflow/template/SetCommonFlow/{id}", post(compat::workflow::workflow_template_set_common_flow)) + .route("/api/workflow/template/{id}/SubFlowUserList", get(compat::workflow::workflow_template_sub_flow_user_list)) + .route("/api/workflow/template/{id}/UpDownShelf", put(compat::workflow::workflow_template_up_down_shelf)) + .route("/api/workflow/template/{id}/DecisionParameter", get(compat::workflow::workflow_template_decision_parameter)) + .route("/api/workflow/template/{id}/FlowList", get(compat::workflow::workflow_template_flow_list)) + .route("/api/workflow/comment", get(compat::workflow::workflow_comment_list)) + .route("/api/workflow/comment", post(compat::workflow::workflow_comment_create)) + .route("/api/workflow/comment/{id}", delete(compat::workflow::workflow_comment_delete)) + .route("/api/workflow/Hooks/getUrl", get(compat::workflow::workflow_hook_url)) + .route("/api/workflow/Hooks/getParams/{randomStr}", get(compat::workflow::workflow_hook_params)) + .route("/api/workflow/Hooks/{id}/start/{randomStr}", get(compat::workflow::workflow_hook_start)) + .route("/api/workflow/task", get(compat::workflow::workflow_task_list)) + .route("/api/workflow/task/{id}", get(compat::workflow::workflow_task_info)) + .route("/api/workflow/task", post(compat::workflow::workflow_task_create)) + .route("/api/workflow/task/{id}", put(compat::workflow::workflow_task_update)) + .route("/api/workflow/task/{id}", delete(compat::workflow::workflow_task_delete)) + .route("/api/workflow/task/Recall/{id}", put(compat::workflow::workflow_task_recall)) + .route("/api/workflow/task/Revoke/{id}", put(compat::workflow::workflow_task_revoke)) + .route("/api/workflow/task/Press/{id}", post(compat::workflow::workflow_task_press)) + .route("/api/workflow/task/{id}/EventLog", get(compat::workflow::workflow_task_event_log)) + .route("/api/workflow/task/TaskUserList/{id}", get(compat::workflow::workflow_task_user_list)) + .route("/api/workflow/task/SubFlowInfo", get(compat::workflow::workflow_task_sub_flow_info)) + .route("/api/workflow/task/ViewStartForm/{id}", get(compat::workflow::workflow_task_view_start_form)) + .route("/api/workflow/task/Hooks/Retry/{id}", get(compat::workflow::workflow_task_hooks_retry)) + .route("/api/workflow/operator/CandidateUser/{id}", post(compat::workflow::workflow_operator_candidate_user)) + .route("/api/workflow/operator/CandidateNode/{id}", post(compat::workflow::workflow_operator_candidate_node)) + .route("/api/workflow/operator/List/{category}", get(compat::workflow::workflow_operator_list)) + .route("/api/workflow/operator/Sign", post(compat::workflow::workflow_operator_sign)) + .route("/api/workflow/operator/Transact", post(compat::workflow::workflow_operator_transact)) + .route("/api/workflow/operator/Audit/{id}", post(compat::workflow::workflow_operator_audit)) + .route("/api/workflow/operator/AddSignUserIdList/{id}", post(compat::workflow::workflow_operator_add_sign_user_list)) + .route("/api/workflow/operator/ReduceApprover/{id}", post(compat::workflow::workflow_operator_reduce_approver)) + .route("/api/workflow/operator/SaveAudit/{id}", post(compat::workflow::workflow_operator_save_audit)) + .route("/api/workflow/operator/AssistSave/{id}", post(compat::workflow::workflow_operator_assist_save)) + .route("/api/workflow/operator/Recall/{id}", post(compat::workflow::workflow_operator_recall)) + .route("/api/workflow/operator/Transfer/{id}", post(compat::workflow::workflow_operator_transfer)) + .route("/api/workflow/operator/Assist/{id}", post(compat::workflow::workflow_operator_assist)) + .route("/api/workflow/operator/BatchOperation", post(compat::workflow::workflow_operator_batch_operation)) + .route("/api/workflow/operator/BatchCandidate", get(compat::workflow::workflow_operator_batch_candidate)) + .route("/api/workflow/operator/BatchFlowSelector", get(compat::workflow::workflow_operator_batch_flow_selector)) + .route("/api/workflow/operator/BatchVersionSelector/{id}", get(compat::workflow::workflow_operator_batch_version_selector)) + .route("/api/workflow/operator/BatchNodeSelector/{id}", get(compat::workflow::workflow_operator_batch_node_selector)) + .route("/api/workflow/operator/BatchNode", get(compat::workflow::workflow_operator_batch_node)) + .route("/api/workflow/operator/{id}/Info", get(compat::workflow::workflow_operator_info)) + .route("/api/workflow/operator/SendBack/{id}", post(compat::workflow::workflow_operator_send_back)) + .route("/api/workflow/operator/SendBackNodeList/{id}", get(compat::workflow::workflow_operator_send_back_node_list)) + .route("/api/workflow/operator/AddSign/{id}", post(compat::workflow::workflow_operator_add_sign)) + .route("/api/workflow/operator/RecordList", get(compat::workflow::workflow_operator_record_list)) + .route("/api/workflow/operator/CirculateList", get(compat::workflow::workflow_operator_circulate_list)) + .route("/api/workflow/delegate", get(compat::workflow::workflow_delegate_list)) + .route("/api/workflow/delegate", post(compat::workflow::workflow_delegate_create)) + .route("/api/workflow/delegate/{id}", put(compat::workflow::workflow_delegate_update)) + .route("/api/workflow/delegate/{id}", get(compat::workflow::workflow_delegate_info)) + .route("/api/workflow/delegate/{id}", delete(compat::workflow::workflow_delegate_delete)) + .route("/api/workflow/delegate/UserList", get(compat::workflow::workflow_delegate_user_list)) + .route("/api/workflow/delegate/Stop/{id}", put(compat::workflow::workflow_delegate_stop)) + .route("/api/workflow/delegate/Info/{id}", get(compat::workflow::workflow_delegate_info_list)) + .route("/api/workflow/delegate/Notarize/{id}", post(compat::workflow::workflow_delegate_notarize)) + .route("/api/workflow/monitor", get(compat::workflow::workflow_monitor_list)) + .route("/api/workflow/monitor", delete(compat::workflow::workflow_monitor_delete)) + .route("/api/workflow/monitor/{id}/EventLog", get(compat::workflow::workflow_monitor_event_log)) + .route("/api/workflow/monitor/Cancel/{id}", post(compat::workflow::workflow_monitor_cancel)) + .route("/api/workflow/monitor/Assign/{id}", post(compat::workflow::workflow_monitor_assign)) + .route("/api/workflow/monitor/Activate/{id}", post(compat::workflow::workflow_monitor_activate)) + .route("/api/workflow/monitor/AnySubFlow/{id}", get(compat::workflow::workflow_monitor_any_sub_flow)) + .route("/api/workflow/monitor/Pause/{id}", post(compat::workflow::workflow_monitor_pause)) + .route("/api/workflow/monitor/Reboot/{id}", post(compat::workflow::workflow_monitor_reboot)) + .route("/api/workflow/monitor/FlowTodoCount", post(compat::workflow::workflow_monitor_flow_todo_count)) + .route("/api/workflow/monitor/FlowTodo", get(compat::workflow::workflow_monitor_flow_todo)) + .route("/api/flowForm/Form", get(compat::workflow::workflow_form_list)) + .route("/api/flowForm/Form", post(compat::workflow::workflow_form_create)) + .route("/api/flowForm/Form", put(compat::workflow::workflow_form_update)) + .route("/api/flowForm/Form/{id}", get(compat::workflow::workflow_form_info)) + .route("/api/flowForm/Form/{id}", delete(compat::workflow::workflow_form_delete)) + .route("/api/flowForm/Form/Release/{id}", post(compat::workflow::workflow_form_release)) + .route("/api/flowForm/Form/{id}/Actions/Copy", get(compat::workflow::workflow_form_copy)) + .route("/api/flowForm/Form/{id}/Actions/Export", get(compat::workflow::workflow_form_export)) + .route("/api/flowForm/Form/{id}/getField", get(compat::workflow::workflow_form_field)) + .route("/api/flowForm/Form/select", get(compat::workflow::workflow_form_select)) + .route("/api/flowForm/Form/getFormById/{id}", get(compat::workflow::workflow_form_by_id)) + .route("/api/workflow/trigger/task/List", get(compat::workflow::workflow_trigger_list)) + .route("/api/workflow/trigger/task", get(compat::workflow::workflow_trigger_task_list)) + .route("/api/workflow/trigger/task", delete(compat::workflow::workflow_trigger_delete)) + .route("/api/workflow/trigger/task/Retry/{id}", post(compat::workflow::workflow_trigger_retry)) + .merge(crate::bootstrap::pack_router_or_empty()); // 🔴 **仅测试构建**存在的「故意 panic」端点 —— 用来钉住 catch-all 中间件 // (契约 §6.5:panic ⇒ HTTP 200 + `code=400`)。 diff --git a/src/backend/tests/batch19_it.rs b/src/backend/tests/batch19_it.rs new file mode 100644 index 0000000..a5a9b23 --- /dev/null +++ b/src/backend/tests/batch19_it.rs @@ -0,0 +1,804 @@ +//! 批次 19 —— **workFlow 族 104 条**的集成测试。 +//! +//! 🔴 **本批的形状分三类**(与 `platform/compat/workflow.rs` 的口径一致): +//! ① **流程元数据**(模板 / 版本 / 节点 / 评论 / 委托 / 监控 / 触发记录) +//! ⇒ **真落库**到官方 24 张 `workflow_*` 表(DDL 逐字照官方); +//! ② **引擎动作**(发起 / 审批 / 办理 / 转审 / 撤回 / 撤销 / 退回 / 加签 / +//! 减签 / 协办 / 批量审批 / 暂停 / 终止 / 复活 / 重试 / 催办 / 签收 / 触发器) +//! ⇒ **明确业务失败**(本仓未接入 Flowable,官方是独立 HTTP 服务 +//! `FlowAbleUrl`)—— **绝不返假结果、假流程号**; +//! ③ **文件 / 在线表单设计器** ⇒ **明确业务失败**(本仓无文件服务、 +//! 无 `visualdev_*` 表)。 +//! +//! 🔴 **三类断言**: +//! ① **路由存在**(104 条逐条打一遍)—— 防 axum 的 `matchit` 参数名冲突 +//! (同位置不能有两个参数名 ⇒ **启动即 panic**,静态闸门看不出来、编译也过); +//! ② **真实现**的**精确形状**(模板 CRUD 闭环、评论 / 委托落库、版本列表); +//! ③ **能力缺失**端点的**诚实失败**(`code=400` + `data:null` + 人话)。 + +use std::path::PathBuf; +use std::sync::Arc; + +use serde_json::{json, Value}; +use ssw_platform::platform::db::Db; +use ssw_platform::platform::seed::first_seed; +use ssw_platform::platform::session::{SessionStore, TicketStore}; +use ssw_platform::platform::state::AppState; +use ssw_platform::routes::build_app; +use tokio::io::{AsyncReadExt, AsyncWriteExt}; +use tokio::net::TcpStream; +use tokio::sync::{Mutex, OnceCell}; + +static DB: OnceCell = OnceCell::const_new(); +static LOCK: Mutex<()> = Mutex::const_new(()); + +async fn db() -> &'static Db { + DB.get_or_init(|| async { + let db = Db::open_temp().await.expect("打开 pglite 临时库失败"); + ssw_platform::bootstrap::ensure_schema_all(&db) + .await + .expect("ensure_schema_all 失败"); + ssw_platform::bootstrap::ensure_base(&db) + .await + .expect("ensure_base 失败"); + first_seed(&db, "123456").await.expect("first_seed 失败"); + db + }) + .await +} + +async fn serve(state: AppState) -> u16 { + let listener = tokio::net::TcpListener::bind("127.0.0.1:0") + .await + .expect("绑定失败"); + let port = listener.local_addr().expect("取本地地址失败").port(); + let server = tokio::spawn(async move { + let _ = axum::serve(listener, build_app(state)).await; + }); + tokio::task::yield_now().await; + std::mem::forget(server); + port +} + +fn new_state(db: &Db) -> AppState { + AppState { + config: Arc::new(ssw_platform::platform::config::Config::from_env(PathBuf::from( + "/tmp/ssw-platform-batch19-it", + ))), + db: Arc::new(db.clone()), + sessions: Arc::new(SessionStore::default()), + tickets: Arc::new(TicketStore::default()), + } +} + +/// 🔴 `app_code` 可切 —— 多应用隔离测试要用(`app-b` 是官方的「故意无菜单」应用)。 +async fn call_app( + port: u16, + method: &str, + path: &str, + token: &str, + body: Option<&str>, + app_code: &str, +) -> Value { + let mut stream = TcpStream::connect(("127.0.0.1", port)) + .await + .expect("连接失败"); + let payload = body.unwrap_or(""); + let req = format!( + "{method} {path} HTTP/1.1\r\n\ + Host: 127.0.0.1\r\n\ + Vue-Version: 3\r\n\ + App-Code: {app_code}\r\n\ + Authorization: {token}\r\n\ + Content-Type: application/json\r\n\ + Content-Length: {}\r\n\ + Connection: close\r\n\r\n{payload}", + payload.len() + ); + stream + .write_all(req.as_bytes()) + .await + .expect("写请求失败"); + let mut buf = Vec::new(); + tokio::time::timeout( + std::time::Duration::from_secs(15), + stream.read_to_end(&mut buf), + ) + .await + .expect("读响应超时") + .expect("读响应失败"); + let text = String::from_utf8_lossy(&buf).to_string(); + let (_, body) = text.split_once("\r\n\r\n").expect("响应必须有头体分隔"); + serde_json::from_str(body.trim()).unwrap_or(Value::Null) +} + +async fn call(port: u16, method: &str, path: &str, token: &str, body: Option<&str>) -> Value { + call_app(port, method, path, token, body, "mainSystem").await +} + +async fn login(port: u16) -> String { + let enc = ssw_platform::platform::cipher::encrypt_password("123456"); + let payload = format!("account=admin&password={enc}"); + let mut stream = TcpStream::connect(("127.0.0.1", port)) + .await + .expect("连接失败"); + let req = format!( + "POST /api/oauth/Login HTTP/1.1\r\n\ + Host: 127.0.0.1\r\n\ + Vue-Version: 3\r\n\ + App-Code: mainSystem\r\n\ + Content-Type: application/x-www-form-urlencoded\r\n\ + Content-Length: {}\r\n\ + Connection: close\r\n\r\n{payload}", + payload.len() + ); + stream + .write_all(req.as_bytes()) + .await + .expect("写请求失败"); + let mut buf = Vec::new(); + tokio::time::timeout( + std::time::Duration::from_secs(15), + stream.read_to_end(&mut buf), + ) + .await + .expect("读响应超时") + .expect("读响应失败"); + let text = String::from_utf8_lossy(&buf).to_string(); + let (_, body) = text.split_once("\r\n\r\n").expect("响应必须有头体分隔"); + let v: Value = serde_json::from_str(body.trim()).unwrap_or(Value::Null); + v["data"]["token"] + .as_str() + .expect("登录必须返 token") + .to_string() +} + +async fn boot() -> (u16, String) { + let state = new_state(db().await); + let port = serve(state).await; + let token = login(port).await; + (port, token) +} + +/// 🔴 **104 条端点逐条打一遍** —— 判据「不是 404 / 405」。 +/// +/// 🔴 **为什么必须有这条测试**:axum 的 `matchit` 在**同一位置有两个参数名** +/// (如 `/api/workflow/task/{id}` 与 `/api/workflow/task/{taskId}`)时会 +/// **启动即 panic** —— 静态闸门看不出来、编译也过,只有真把 router 建起来才炸。 +#[tokio::test] +async fn workflow_all_104_endpoints_are_registered_without_matchit_conflict() { + let _g = LOCK.lock().await; + let (port, token) = boot().await; + + // 🔴 建一条真流程(后面几条要用它的主键)。 + let created = call( + port, + "POST", + "/api/workflow/template", + &token, + Some(&json!({"fullName":"路由探测流程","enCode":"probe"}).to_string()), + ) + .await; + let tid = created["data"].as_str().unwrap_or("no-such-id").to_string(); + + let cases: Vec<(&str, &str)> = vec![ + // ---- 模板(25 条)---- + ("GET", "/api/workflow/template"), + ("POST", "/api/workflow/template"), + ("PUT", "/api/workflow/template/{id}"), + ("GET", "/api/workflow/template/{id}"), + ("DELETE", "/api/workflow/template/{id}"), + ("POST", "/api/workflow/template/{id}/Actions/Copy"), + ("GET", "/api/workflow/template/{id}/Actions/Export"), + ("PUT", "/api/workflow/template/{id}/UpdateType"), + ("POST", "/api/workflow/template/Save"), + ("GET", "/api/workflow/template/Info/{id}"), + ("GET", "/api/workflow/template/Version/{id}"), + ("DELETE", "/api/workflow/template/Info/{id}"), + ("POST", "/api/workflow/template/Info/{id}"), + ("GET", "/api/workflow/template/Selector"), + ("GET", "/api/workflow/template/{id}/FormInfo"), + ("GET", "/api/workflow/template/StartForm/{id}"), + ("GET", "/api/workflow/template/StartFormId/{id}"), + ("GET", "/api/workflow/template/TreeList"), + ("POST", "/api/workflow/template/GetFlowList"), + ("GET", "/api/workflow/template/getCommonFlowList"), + ("POST", "/api/workflow/template/SetCommonFlow/{id}"), + ("GET", "/api/workflow/template/{id}/SubFlowUserList"), + ("PUT", "/api/workflow/template/{id}/UpDownShelf"), + ("GET", "/api/workflow/template/{id}/DecisionParameter"), + ("GET", "/api/workflow/template/{id}/FlowList"), + // ---- 评论(3 条)---- + ("GET", "/api/workflow/comment"), + ("POST", "/api/workflow/comment"), + ("DELETE", "/api/workflow/comment/{id}"), + // ---- 触发器 Hooks(3 条)---- + ("GET", "/api/workflow/Hooks/getUrl"), + ("GET", "/api/workflow/Hooks/getParams/{randomStr}"), + ("GET", "/api/workflow/Hooks/{id}/start/{randomStr}"), + // ---- 任务(13 条)---- + ("GET", "/api/workflow/task"), + ("GET", "/api/workflow/task/{id}"), + ("POST", "/api/workflow/task"), + ("PUT", "/api/workflow/task/{id}"), + ("DELETE", "/api/workflow/task/{id}"), + ("PUT", "/api/workflow/task/Recall/{id}"), + ("PUT", "/api/workflow/task/Revoke/{id}"), + ("POST", "/api/workflow/task/Press/{id}"), + ("GET", "/api/workflow/task/{id}/EventLog"), + ("GET", "/api/workflow/task/TaskUserList/{id}"), + ("GET", "/api/workflow/task/SubFlowInfo"), + ("GET", "/api/workflow/task/ViewStartForm/{id}"), + ("GET", "/api/workflow/task/Hooks/Retry/{id}"), + // ---- 办理(25 条)---- + ("POST", "/api/workflow/operator/CandidateUser/{id}"), + ("POST", "/api/workflow/operator/CandidateNode/{id}"), + ("GET", "/api/workflow/operator/List/{category}"), + ("POST", "/api/workflow/operator/Sign"), + ("POST", "/api/workflow/operator/Transact"), + ("POST", "/api/workflow/operator/Audit/{id}"), + ("POST", "/api/workflow/operator/AddSignUserIdList/{id}"), + ("POST", "/api/workflow/operator/ReduceApprover/{id}"), + ("POST", "/api/workflow/operator/SaveAudit/{id}"), + ("POST", "/api/workflow/operator/AssistSave/{id}"), + ("POST", "/api/workflow/operator/Recall/{id}"), + ("POST", "/api/workflow/operator/Transfer/{id}"), + ("POST", "/api/workflow/operator/Assist/{id}"), + ("POST", "/api/workflow/operator/BatchOperation"), + ("GET", "/api/workflow/operator/BatchCandidate"), + ("GET", "/api/workflow/operator/BatchFlowSelector"), + ("GET", "/api/workflow/operator/BatchVersionSelector/{id}"), + ("GET", "/api/workflow/operator/BatchNodeSelector/{id}"), + ("GET", "/api/workflow/operator/BatchNode"), + ("GET", "/api/workflow/operator/{id}/Info"), + ("POST", "/api/workflow/operator/SendBack/{id}"), + ("GET", "/api/workflow/operator/SendBackNodeList/{id}"), + ("POST", "/api/workflow/operator/AddSign/{id}"), + ("GET", "/api/workflow/operator/RecordList"), + ("GET", "/api/workflow/operator/CirculateList"), + // ---- 委托(9 条)---- + ("GET", "/api/workflow/delegate"), + ("POST", "/api/workflow/delegate"), + ("PUT", "/api/workflow/delegate/{id}"), + ("GET", "/api/workflow/delegate/{id}"), + ("DELETE", "/api/workflow/delegate/{id}"), + ("GET", "/api/workflow/delegate/UserList"), + ("PUT", "/api/workflow/delegate/Stop/{id}"), + ("GET", "/api/workflow/delegate/Info/{id}"), + ("POST", "/api/workflow/delegate/Notarize/{id}"), + // ---- 监控(10 条)---- + ("GET", "/api/workflow/monitor"), + ("DELETE", "/api/workflow/monitor"), + ("GET", "/api/workflow/monitor/{id}/EventLog"), + ("POST", "/api/workflow/monitor/Cancel/{id}"), + ("POST", "/api/workflow/monitor/Assign/{id}"), + ("POST", "/api/workflow/monitor/Activate/{id}"), + ("GET", "/api/workflow/monitor/AnySubFlow/{id}"), + ("POST", "/api/workflow/monitor/Pause/{id}"), + ("POST", "/api/workflow/monitor/Reboot/{id}"), + ("POST", "/api/workflow/monitor/FlowTodoCount"), + ("GET", "/api/workflow/monitor/FlowTodo"), + // ---- 在线表单设计器(11 条)---- + ("GET", "/api/flowForm/Form"), + ("POST", "/api/flowForm/Form"), + ("PUT", "/api/flowForm/Form"), + ("GET", "/api/flowForm/Form/{id}"), + ("DELETE", "/api/flowForm/Form/{id}"), + ("POST", "/api/flowForm/Form/Release/{id}"), + ("GET", "/api/flowForm/Form/{id}/Actions/Copy"), + ("GET", "/api/flowForm/Form/{id}/Actions/Export"), + ("GET", "/api/flowForm/Form/{id}/getField"), + ("GET", "/api/flowForm/Form/select"), + ("GET", "/api/flowForm/Form/getFormById/{id}"), + // ---- 触发任务(4 条)---- + ("GET", "/api/workflow/trigger/task/List"), + ("GET", "/api/workflow/trigger/task"), + ("DELETE", "/api/workflow/trigger/task"), + ("POST", "/api/workflow/trigger/task/Retry/{id}"), + ]; + assert_eq!(cases.len(), 104, "本批就是 104 条"); + + for (method, raw_path) in cases { + let path = raw_path + .replace("{id}", &tid) + .replace("{randomStr}", "rs") + .replace("{category}", "1"); + let res = call(port, method, &path, &token, Some("{}")).await; + let code = res["code"].as_i64().unwrap_or(-1); + assert!( + code != 404 && code != 405, + "`{method} {raw_path}` 必须已注册(404/405 说明路由没接上),实际 code={code}:{:?}", + res + ); + } +} + +/// 🔴 **模板 CRUD 闭环**(真落库)—— 官方 `TemplateController` 的元数据部分。 +/// +/// 断言形状: +/// - `POST /api/workflow/template` ⇒ `data` 是**裸 id 字符串**(官方 +/// `ActionResult.success(msg, entity.getId())`); +/// - `GET /api/workflow/template` ⇒ `data` 是 `PageListVO`(`{pagination,list}`); +/// - `GET /api/workflow/template/{id}` ⇒ `data` 是**裸对象**(官方 +/// `TemplateVO`),含 `id` / `fullName` / `enCode`。 +#[tokio::test] +async fn template_crud_round_trip_lands_in_official_tables() { + let _g = LOCK.lock().await; + let (port, token) = boot().await; + + // ---- 新建 ---- + let created = call( + port, + "POST", + "/api/workflow/template", + &token, + Some( + &json!({ + "fullName": "报销流程", + "enCode": "expense-flow", + "category": "OA", + "type": 0, + "flowXml": "", + "flowNodes": [{"nodeCode":"node-1","nodeName":"发起","type":"start","formId":"form-1"}] + }) + .to_string(), + ), + ) + .await; + assert_eq!(created["code"], 200, "新建流程应成功:{:?}", created); + let tid = created["data"] + .as_str() + .expect("data 必须是裸 id 字符串(官方口径)") + .to_string(); + assert_eq!(tid.len(), 36, "主键必须是 36 位 UUID"); + + // ---- 列表(PageListVO)---- + let list = call(port, "GET", "/api/workflow/template", &token, None).await; + assert_eq!(list["code"], 200, "流程列表应成功:{:?}", list); + assert!( + list["data"]["pagination"].is_object(), + "列表 data 必须是 PageListVO(带 pagination),实际:{:?}", + list["data"] + ); + let rows = list["data"]["list"].as_array().expect("list 必须是数组"); + assert!( + rows.iter().any(|r| r["id"] == tid.as_str()), + "新建的流程必须出现在列表里:{:?}", + rows + ); + let row = rows + .iter() + .find(|r| r["id"] == tid.as_str()) + .expect("必须找到刚建的流程"); + assert_eq!(row["fullName"], "报销流程"); + assert_eq!(row["enCode"], "expense-flow"); + + // ---- 详情(裸对象)---- + let info = call(port, "GET", &format!("/api/workflow/template/{tid}"), &token, None).await; + assert_eq!(info["code"], 200, "流程详情应成功:{:?}", info); + assert_eq!(info["data"]["id"], tid.as_str(), "详情 data 必须是裸对象"); + assert_eq!(info["data"]["fullName"], "报销流程"); + + // ---- 改(PUT 合并语义)---- + let updated = call( + port, + "PUT", + &format!("/api/workflow/template/{tid}"), + &token, + Some(&json!({"fullName":"报销流程(改)"}).to_string()), + ) + .await; + assert_eq!(updated["code"], 200, "改流程应成功:{:?}", updated); + let info2 = call(port, "GET", &format!("/api/workflow/template/{tid}"), &token, None).await; + assert_eq!(info2["data"]["fullName"], "报销流程(改)"); + assert_eq!( + info2["data"]["enCode"], "expense-flow", + "PUT 是**合并**语义 ⇒ 未传的字段必须保留" + ); + + // ---- 版本列表(新建流程时自动落了一条版本)---- + // 🔴 官方 `TemplateController.java:230` 返的是 `ActionResult.success(listVO)` + // ⇒ `data` 是**裸数组**(不是 PageListVO)。 + let versions = call( + port, + "GET", + &format!("/api/workflow/template/Version/{tid}"), + &token, + None, + ) + .await; + assert_eq!(versions["code"], 200, "版本列表应成功:{:?}", versions); + let vlist = versions["data"].as_array().expect("版本列表 data 必须是裸数组"); + assert!(!vlist.is_empty(), "新建流程必须自动落一条版本:{:?}", versions); + assert!( + vlist[0]["fullName"] + .as_str() + .unwrap_or_default() + .starts_with("流程版本V"), + "版本 fullName 必须是官方口径「流程版本V<版本号>」,实际:{:?}", + vlist[0] + ); + + // ---- 流程引擎信息(`Info/{versionId}` —— 官方传的是**版本主键**)---- + let version_id = vlist[0]["id"].as_str().expect("版本必须有 id").to_string(); + let json_info = call( + port, + "GET", + &format!("/api/workflow/template/Info/{version_id}"), + &token, + None, + ) + .await; + assert_eq!(json_info["code"], 200, "流程 JSON 应成功:{:?}", json_info); + assert!( + json_info["data"].is_object() || json_info["data"].is_string(), + "流程 JSON 的 data 必须是裸对象 / 串,实际:{:?}", + json_info["data"] + ); + + // ---- 上下架 ---- + let shelf = call( + port, + "PUT", + &format!("/api/workflow/template/{tid}/UpDownShelf"), + &token, + Some(&json!({"status":1}).to_string()), + ) + .await; + assert_eq!(shelf["code"], 200, "上下架应成功:{:?}", shelf); + + // ---- 复制 ---- + let copied = call( + port, + "POST", + &format!("/api/workflow/template/{tid}/Actions/Copy"), + &token, + Some("{}"), + ) + .await; + assert_eq!(copied["code"], 200, "复制流程应成功:{:?}", copied); + + // ---- 删(软删)⇒ 列表里不再出现,详情报「流程不存在」---- + let deleted = call( + port, + "DELETE", + &format!("/api/workflow/template/{tid}"), + &token, + Some("{}"), + ) + .await; + assert_eq!(deleted["code"], 200, "删流程应成功:{:?}", deleted); + let after = call(port, "GET", &format!("/api/workflow/template/{tid}"), &token, None).await; + assert_eq!( + after["code"], 400, + "删掉后详情必须业务失败(软删),实际:{:?}", + after + ); + assert!(after["data"].is_null(), "失败信封的 data 必须是 null"); +} + +/// 🔴 **评论 / 委托**:真落库 + 必填校验。 +/// +/// 🔴 **评论的可见范围**:官方 `CommentController.list` 是**按任务**列的 +/// (`taskService.getTaskUserList(taskId)` ⇒ 不在任务参与人里就返空)。 +/// 本仓对应口径 = 「任务 → 模板 → 系统」链路(`workflow_comment` / `workflow_task` +/// **都没有** `f_system_id`)⇒ 评论**挂在一个真实存在的任务上**才可见。 +/// ⇒ 本测试**先直接种一条任务行**(引擎在官方才会造,本仓无引擎)。 +#[tokio::test] +async fn comment_and_delegate_land_in_official_tables() { + let _g = LOCK.lock().await; + let (port, token) = boot().await; + + // ---- 先建模板 + 直接种一条任务行(相当于引擎造的数据)---- + let tpl = call( + port, + "POST", + "/api/workflow/template", + &token, + Some(&json!({"fullName":"评论宿主流程","enCode":"comment-host"}).to_string()), + ) + .await; + assert_eq!(tpl["code"], 200, "新建宿主流程应成功:{:?}", tpl); + let tid = tpl["data"].as_str().expect("data 是裸 id 串").to_string(); + let task_id = "task-seeded-batch19"; + db() + .await + .exec_params( + "INSERT INTO workflow_task \ + (f_id, f_tenant_id, f_template_id, f_full_name, f_creator_user_id, f_delete_mark) \ + VALUES ($1::text, '0', $2::text, '种子任务', 'admin', 0)", + &[&task_id, &tid.as_str()], + ) + .await + .expect("种任务行失败"); + + // ---- 评论:缺 `taskId` 必须业务失败(不 500)---- + let bad = call( + port, + "POST", + "/api/workflow/comment", + &token, + Some(&json!({"text":"少了 taskId"}).to_string()), + ) + .await; + assert_eq!(bad["code"], 400, "缺 taskId 必须业务失败:{:?}", bad); + assert!(bad["data"].is_null(), "失败信封 data 必须 null"); + + // ---- 评论:正常写入 ---- + let okc = call( + port, + "POST", + "/api/workflow/comment", + &token, + Some(&json!({"taskId":task_id,"text":"同意"}).to_string()), + ) + .await; + assert_eq!(okc["code"], 200, "新增评论应成功:{:?}", okc); + let cid = okc["data"].as_str().expect("data 是裸 id 串").to_string(); + + let clist = call(port, "GET", "/api/workflow/comment", &token, None).await; + assert_eq!(clist["code"], 200, "评论列表应成功:{:?}", clist); + let crows = clist["data"]["list"].as_array().expect("评论列表是 PageListVO"); + assert!( + crows.iter().any(|r| r["id"] == cid.as_str()), + "刚建的评论必须出现在列表里:{:?}", + crows + ); + + // 🔴 **多应用隔离**:评论没有 `f_system_id` ⇒ 靠「任务 → 模板」回溯系统。 + let b_list = call_app( + port, + "GET", + "/api/workflow/comment", + &token, + None, + "app-b", + ) + .await; + let b_rows = b_list["data"]["list"].as_array().expect("评论列表是 PageListVO"); + assert!( + !b_rows.iter().any(|r| r["id"] == cid.as_str()), + "app-b **不许**看到主系统的评论(任务 → 模板 → 系统链路),实际:{:?}", + b_rows + ); + + let cdel = call( + port, + "DELETE", + &format!("/api/workflow/comment/{cid}"), + &token, + Some("{}"), + ) + .await; + assert_eq!(cdel["code"], 200, "删评论应成功:{:?}", cdel); + + // ---- 委托:缺必填 ⇒ 业务失败;齐了 ⇒ 落库 ---- + let dbad = call( + port, + "POST", + "/api/workflow/delegate", + &token, + Some(&json!({"flowName":"委托"}).to_string()), + ) + .await; + assert_eq!(dbad["code"], 400, "缺被委托人必须业务失败:{:?}", dbad); + + let dok = call( + port, + "POST", + "/api/workflow/delegate", + &token, + Some( + &json!({ + "flowName":"出差委托", + "userId":"admin", + "toUserId":["admin"], + "type":0, + "startTime": 1767225600000i64, + "endTime": 1767312000000i64 + }) + .to_string(), + ), + ) + .await; + assert_eq!(dok["code"], 200, "新建委托应成功:{:?}", dok); + let did = dok["data"].as_str().expect("data 是裸 id 串").to_string(); + + let dlist = call(port, "GET", "/api/workflow/delegate", &token, None).await; + assert_eq!(dlist["code"], 200, "委托列表应成功:{:?}", dlist); + let drows = dlist["data"]["list"].as_array().expect("委托列表是 PageListVO"); + assert!( + drows.iter().any(|r| r["id"] == did.as_str()), + "刚建的委托必须出现在列表里:{:?}", + drows + ); + + // 🔴 **epoch 毫秒不能原样进 `::timestamp` 列** —— 落库成功即证明转换过, + // 且回读仍按官方口径返 **epoch 毫秒数字**。 + let ddetail = call( + port, + "GET", + &format!("/api/workflow/delegate/{did}"), + &token, + None, + ) + .await; + assert_eq!(ddetail["code"], 200, "委托详情应成功:{:?}", ddetail); + assert_eq!( + ddetail["data"]["startTime"].as_i64(), + Some(1767225600000), + "委托起止时间必须按官方口径返 epoch 毫秒,实际:{:?}", + ddetail["data"] + ); + assert_eq!( + ddetail["data"]["endTime"].as_i64(), + Some(1767312000000), + "委托结束时间必须按官方口径返 epoch 毫秒,实际:{:?}", + ddetail["data"] + ); +} + +/// 🔴 **引擎动作必须诚实失败** —— 本仓未接入 Flowable。 +/// +/// 🔴 判据:`code=400` + `data:null` + `msg` 里点明「流程引擎」。 +/// **绝不**返 `code=200` + 假状态、假流程号。 +#[tokio::test] +async fn engine_actions_fail_honestly_instead_of_faking_results() { + let _g = LOCK.lock().await; + let (port, token) = boot().await; + + let cases: Vec<(&str, &str)> = vec![ + ("POST", "/api/workflow/task"), + ("PUT", "/api/workflow/task/task-1"), + ("PUT", "/api/workflow/task/Recall/task-1"), + ("PUT", "/api/workflow/task/Revoke/task-1"), + ("POST", "/api/workflow/task/Press/task-1"), + ("GET", "/api/workflow/task/Hooks/Retry/task-1"), + ("GET", "/api/workflow/Hooks/getUrl"), + ("GET", "/api/workflow/Hooks/getParams/rs"), + ("GET", "/api/workflow/Hooks/hook-1/start/rs"), + ("POST", "/api/workflow/operator/Sign"), + ("POST", "/api/workflow/operator/Transact"), + ("POST", "/api/workflow/operator/Audit/op-1"), + ("POST", "/api/workflow/operator/ReduceApprover/op-1"), + ("POST", "/api/workflow/operator/SaveAudit/op-1"), + ("POST", "/api/workflow/operator/AssistSave/op-1"), + ("POST", "/api/workflow/operator/Recall/op-1"), + ("POST", "/api/workflow/operator/Transfer/op-1"), + ("POST", "/api/workflow/operator/Assist/op-1"), + ("POST", "/api/workflow/operator/BatchOperation"), + ("POST", "/api/workflow/operator/SendBack/op-1"), + ("POST", "/api/workflow/operator/AddSign/op-1"), + ("POST", "/api/workflow/monitor/Cancel/m-1"), + ("POST", "/api/workflow/monitor/Assign/m-1"), + ("POST", "/api/workflow/monitor/Activate/m-1"), + ("POST", "/api/workflow/monitor/Pause/m-1"), + ("POST", "/api/workflow/monitor/Reboot/m-1"), + ("POST", "/api/workflow/trigger/task/Retry/tr-1"), + ]; + + for (method, path) in cases { + let res = call(port, method, path, &token, Some("{}")).await; + assert_eq!( + res["code"], 400, + "`{method} {path}` 必须**明确业务失败**(本仓无流程引擎),实际:{:?}", + res + ); + assert!( + res["data"].is_null(), + "`{method} {path}` 失败信封的 data 必须是 null(不能返假结果),实际:{:?}", + res + ); + let msg = res["msg"].as_str().unwrap_or_default(); + assert!( + msg.contains("流程引擎"), + "`{method} {path}` 的 msg 必须点明「流程引擎」,实际:{msg:?}" + ); + } +} + +/// 🔴 **文件类 / 在线表单设计器类必须诚实失败**。 +#[tokio::test] +async fn file_and_form_actions_fail_honestly() { + let _g = LOCK.lock().await; + let (port, token) = boot().await; + + // ---- 文件类 ---- + for path in [ + "/api/workflow/template/t-1/Actions/Export", + "/api/flowForm/Form/f-1/Actions/Export", + ] { + let res = call(port, "GET", path, &token, None).await; + assert_eq!(res["code"], 400, "`{path}` 必须业务失败:{:?}", res); + assert!(res["data"].is_null(), "`{path}` 的 data 必须是 null"); + let msg = res["msg"].as_str().unwrap_or_default(); + assert!( + msg.contains("文件服务"), + "`{path}` 的 msg 必须点明「文件服务」,实际:{msg:?}" + ); + } + + // ---- 在线表单设计器类 ---- + for (method, path) in [ + ("GET", "/api/flowForm/Form"), + ("POST", "/api/flowForm/Form"), + ("PUT", "/api/flowForm/Form"), + ("GET", "/api/flowForm/Form/f-1"), + ("DELETE", "/api/flowForm/Form/f-1"), + ("POST", "/api/flowForm/Form/Release/f-1"), + ("GET", "/api/flowForm/Form/f-1/Actions/Copy"), + ("GET", "/api/flowForm/Form/f-1/getField"), + ("GET", "/api/flowForm/Form/select"), + ] { + let res = call(port, method, path, &token, Some("{}")).await; + assert_eq!( + res["code"], 400, + "`{method} {path}` 必须业务失败(本仓无在线表单设计器),实际:{:?}", + res + ); + assert!( + res["data"].is_null(), + "`{method} {path}` 的 data 必须是 null,实际:{:?}", + res + ); + } +} + +/// 🔴 **多应用隔离**:`workflow_template.f_system_id` 是官方 DDL 里流程表 +/// **唯一**的系统列 ⇒ `App-Code: app-b` 看到的必须是**另一个系统**的流程。 +#[tokio::test] +async fn workflow_metadata_is_isolated_by_app_code() { + let _g = LOCK.lock().await; + let (port, token) = boot().await; + + let created = call( + port, + "POST", + "/api/workflow/template", + &token, + Some(&json!({"fullName":"主系统专属流程","enCode":"main-only"}).to_string()), + ) + .await; + assert_eq!(created["code"], 200, "新建流程应成功:{:?}", created); + let tid = created["data"].as_str().expect("data 是裸 id 串").to_string(); + + // 主系统能看到 + let main_list = call(port, "GET", "/api/workflow/template", &token, None).await; + let main_rows = main_list["data"]["list"].as_array().expect("list 是数组"); + assert!( + main_rows.iter().any(|r| r["id"] == tid.as_str()), + "主系统必须看得到自己建的流程" + ); + + // app-b 看不到 + let b_list = call_app( + port, + "GET", + "/api/workflow/template", + &token, + None, + "app-b", + ) + .await; + assert_eq!(b_list["code"], 200, "app-b 看列表应成功:{:?}", b_list); + let b_rows = b_list["data"]["list"].as_array().expect("list 是数组"); + assert!( + !b_rows.iter().any(|r| r["id"] == tid.as_str()), + "app-b **不许**看到主系统的流程(`f_system_id` 隔离),实际:{:?}", + b_rows + ); +} + +/// 🔴 **未登录返 602**(面 B 未登录是 `602`,不是面 A 的 `600`)。 +#[tokio::test] +async fn workflow_unauthenticated_returns_602() { + let _g = LOCK.lock().await; + let (port, _token) = boot().await; + + let res = call(port, "GET", "/api/workflow/template", "", None).await; + assert_eq!( + res["code"], 602, + "面 B 未登录必须是 602(官方前端只对 601/602 清 token),实际:{:?}", + res + ); +}