@steedos-labs/plugin-workflow 3.0.46 → 3.0.47

package/main/default/test/reports/formula-scan/SCAN_HISTORY.md

@@ -0,0 +1,165 @@
+# 公式扫描处理历史 (SCAN_HISTORY)
+
+本文档记录每次生产公式扫描发现的 errors 及其修正过程。
+
+> 约定：每次扫描周期产生两个 JSON 文件 —— 修正前（含 `processedResult` 注解）和修正后（干净的 `errors: []`）。
+
+---
+
+## v6 → v7：Bug 8 — 聚合函数全角括号和缺失括号预处理
+
+- **扫描日期**: 2026-03-24
+- **修正前报告**: `scan-result-v6-20260324.json`（12 ERROR, 206 WARN）
+- **修正后报告**: `scan-result-v7-20260324.json`（0 ERROR, 4 KNOWN_ISSUE, 206 WARN）
+- **修正提交**: `3abea58` (fix: Bug 8 — 同步聚合函数全角括号和缺失括号预处理 #507)
+- **修改文件**: `formula-compat.js`, `formula-utils.js`, `flow_form_design.ejs`
+
+### Bug 8 修正内容
+
+在 `mapFormula` 转换前新增预处理步骤：
+1. 将聚合函数的全角括号 `（）` 转换为半角 `()`
+2. 将 `sum{...}` / `average{...}` 等缺失括号的写法补全为 `sum({...})`
+
+### 修复了 8 个 ERROR（均为 E1 规则）
+
+| # | 表单名称 | formId | 字段 | 原始公式 | 问题原因 | 版本 |
+|---|---------|--------|------|---------|---------|------|
+| 1 | 抚顺石化公司物资编码替换申请表 | `8f4a6ce7e2dfdf423a28e306` | 合计（替换） | `sum（{金额（替换）}）` | 全角括号 | history |
+| 2 | 单一来源采购方式报审表 | `dcbqgp5ZCKLdexwpD` | 概算或预估算金额（含税，万元） | `sum{含税金额}` | 缺少括号 | history |
+| 3 | 物资临时领用票 | `gT7bSNfgG9dAd89jk` | 合计金额 | `sum{(金额)}` | 缺少外层括号 | **current** |
+| 4 | 科研项目费用指标控制审批单 | `sS9suXA63oqfot3J2` | 累计支出金额合计 | `sum{累计支出金额}` | 缺少括号 | history |
+| 5 | 质量检验中心应急物资计划审批表 | `RiHrEAqNMKBEwCmXH` | 合计 | `sum{概算总价}` | 缺少括号 | history |
+| 6 | 科研项目费用指标控制审批单 | `Q8WtCbxYb3aAX5KLv` | 项目预算金额合计 | `sum{项目预算金额}` | 缺少括号 | history |
+| 7 | 科研项目费用指标控制审批单 | `Q8WtCbxYb3aAX5KLv` | 本次支出金额合计 | `sum{项目预算金额}` | 缺少括号 | history |
+| 8 | 科研项目费用指标控制审批单 | `Q8WtCbxYb3aAX5KLv` | 累计支出金额合计 | `sum{累计支出金额}` | 缺少括号 | history |
+
+> **影响面**: 7 个 history + 1 个 **current**（物资临时领用票），current 版本的修复直接改善了在用表单的公式转换。
+
+### 归类为 knownIssues 的 4 个 ERROR
+
+以下 4 个 ERROR 经分析不需要代码修正，已在 v7 报告中归类到 `knownIssues`。**全部为 history 版本**，不影响新建审批单。
+
+| # | 表单名称 | formId | 版本 | 字段 | 原始公式 | 分类 | 原因 |
+|---|---------|--------|------|------|---------|------|------|
+| 1 | 办公桌面问题 | `451766252f8838253eab81f8` | history | 所属信息站 | `judgeIndex({所属部门})` | KNOWN_LIMITATION | 自定义函数，amis 无等价物 |
+| 2 | 工作循环分析计划表 | `9THeSusZyo9E3pe5p` | history | 表名 | `{填报单位}车间{YYYY}年度` | KNOWN_LIMITATION | 文本模板 pattern，无转换路径 |
+| 3 | 员工通勤补贴统计表 | `6d9fe8a132c96a664ca23808` | history | 发放补贴金额（元） | `{发放补贴数量}*{}` | BAD_SOURCE_DATA | 空引用 `{}`，作者漏填 |
+| 4 | 招标结果报审表 | `b9e7465f159b6640bbe49caa` | history | 概算、估算金额（元、大写） | `numToRMB(概算、估算金额{})` | BAD_SOURCE_DATA | 花括号位置写错 |
+
+> **生产排查结论**（2026-03-24）：4 项均无需处理。第 2、3 项无审批单引用；第 1 项仅 2021 年已完成审批单；第 4 项仅 1 条 draft 草稿。详见 [#511 评论](https://github.com/steedos/steedos-plugins/issues/511#issuecomment-4116293785)。
+
+#### 生产数据库排查查询
+
+以下 `mongosh` 命令可直接在终端执行，精确查找**使用了包含问题公式的那些表单版本**创建的审批单。
+
+> **查询思路**：
+> 1. 从 `forms` 的 `historys` 数组中，递归查找哪些版本的 `fields` 包含目标公式字段
+> 2. 收集这些版本的 `_id` 列表
+> 3. 用 `form_version: {$in: vids}` 精确匹配 `instances`
+>
+> 这比 `form_version != currentVersionId` 更精确 —— 只命中真正包含问题公式的版本，排除了无关的历史版本。
+
+**Issue #1 — 办公桌面问题** (`451766252f8838253eab81f8`，字段 `所属信息站`，公式 `judgeIndex({所属部门})`)
+```bash
+mongosh "mongodb://127.0.0.1:27017/<dbname>" --eval '
+  function find(fields, code, formula) {
+    if (!fields) return false;
+    for (var f of fields) {
+      if (f.code === code && f.formula === formula) return true;
+      if (f.fields && find(f.fields, code, formula)) return true;
+    }
+    return false;
+  }
+  var form = db.forms.findOne({_id: "451766252f8838253eab81f8"});
+  var vids = (form.historys || []).filter(h => find(h.fields, "所属信息站", "judgeIndex({所属部门})")).map(h => h._id);
+  print("匹配版本数:", vids.length, "IDs:", JSON.stringify(vids));
+  if (vids.length > 0) db.instances.find(
+    {form: "451766252f8838253eab81f8", form_version: {$in: vids}},
+    {name: 1, form_version: 1, submit_date: 1, state: 1}
+  ).sort({submit_date: -1}).limit(10).toArray()
+'
+```
+
+**Issue #2 — 工作循环分析计划表** (`9THeSusZyo9E3pe5p`，字段 `表名`，公式 `{填报单位}车间{YYYY}年度`)
+```bash
+mongosh "mongodb://127.0.0.1:27017/<dbname>" --eval '
+  function find(fields, code, formula) {
+    if (!fields) return false;
+    for (var f of fields) {
+      if (f.code === code && f.formula === formula) return true;
+      if (f.fields && find(f.fields, code, formula)) return true;
+    }
+    return false;
+  }
+  var form = db.forms.findOne({_id: "9THeSusZyo9E3pe5p"});
+  var vids = (form.historys || []).filter(h => find(h.fields, "表名", "{填报单位}车间{YYYY}年度")).map(h => h._id);
+  print("匹配版本数:", vids.length, "IDs:", JSON.stringify(vids));
+  if (vids.length > 0) db.instances.find(
+    {form: "9THeSusZyo9E3pe5p", form_version: {$in: vids}},
+    {name: 1, form_version: 1, submit_date: 1, state: 1}
+  ).sort({submit_date: -1}).limit(10).toArray()
+'
+```
+
+**Issue #3 — 员工通勤补贴统计表** (`6d9fe8a132c96a664ca23808`，字段 `发放补贴金额（元）`，公式 `{发放补贴数量}*{}`)
+```bash
+mongosh "mongodb://127.0.0.1:27017/<dbname>" --eval '
+  function find(fields, code, formula) {
+    if (!fields) return false;
+    for (var f of fields) {
+      if (f.code === code && f.formula === formula) return true;
+      if (f.fields && find(f.fields, code, formula)) return true;
+    }
+    return false;
+  }
+  var form = db.forms.findOne({_id: "6d9fe8a132c96a664ca23808"});
+  var vids = (form.historys || []).filter(h => find(h.fields, "发放补贴金额（元）", "{发放补贴数量}*{}")).map(h => h._id);
+  print("匹配版本数:", vids.length, "IDs:", JSON.stringify(vids));
+  if (vids.length > 0) db.instances.find(
+    {form: "6d9fe8a132c96a664ca23808", form_version: {$in: vids}},
+    {name: 1, form_version: 1, submit_date: 1, state: 1}
+  ).sort({submit_date: -1}).limit(10).toArray()
+'
+```
+
+**Issue #4 — 招标结果报审表** (`b9e7465f159b6640bbe49caa`，字段 `概算、估算金额（元、大写）`，公式 `numToRMB(概算、估算金额{})`)
+```bash
+mongosh "mongodb://127.0.0.1:27017/<dbname>" --eval '
+  function find(fields, code, formula) {
+    if (!fields) return false;
+    for (var f of fields) {
+      if (f.code === code && f.formula === formula) return true;
+      if (f.fields && find(f.fields, code, formula)) return true;
+    }
+    return false;
+  }
+  var form = db.forms.findOne({_id: "b9e7465f159b6640bbe49caa"});
+  var vids = (form.historys || []).filter(h => find(h.fields, "概算、估算金额（元、大写）", "numToRMB(概算、估算金额{})")).map(h => h._id);
+  print("匹配版本数:", vids.length, "IDs:", JSON.stringify(vids));
+  if (vids.length > 0) db.instances.find(
+    {form: "b9e7465f159b6640bbe49caa", form_version: {$in: vids}},
+    {name: 1, form_version: 1, submit_date: 1, state: 1}
+  ).sort({submit_date: -1}).limit(10).toArray()
+'
+```
+
+> **如果是 current 版本的 issue**（本次无此情况，但影响面大 — 所有新建审批单都走此版本）：
+> ```bash
+> mongosh "mongodb://127.0.0.1:27017/<dbname>" --eval '
+>   var cvid = db.forms.findOne({_id: "<formId>"}).current._id;
+>   db.instances.find(
+>     {form: "<formId>", form_version: cvid},
+>     {name: 1, submit_date: 1, state: 1}
+>   ).sort({submit_date: -1}).limit(10).toArray()
+> '
+> ```
+
+### 扫描统计变化
+
+| 指标 | v6（修正前） | v7（修正后） |
+|------|------------|------------|
+| ERROR | 12 | 0 |
+| KNOWN_ISSUE | — | 4 |
+| WARN | 206 | 206 |
+| PASS | 1941 | 1949 |
+| current ERROR | 1 | 0 |