@steedos-labs/plugin-workflow 3.0.46 → 3.0.48

package/main/default/test/FORMULA_SCAN_GUIDE.md

@@ -0,0 +1,258 @@
+# 生产公式扫描操作指南
+
+本指南介绍如何使用 `scan_production_formulas.js` 扫描生产数据库中的工作流表单公式，主动发现 `mapFormula` 未兼容的公式语法，并完成后续 AI 辅助评估与修复。
+
+---
+
+## 前置条件
+
+- 本地已安装 Node.js（>=14）
+- 本地 MongoDB 可用（`mongod` 正在运行）
+- 已将生产 `forms` 集合数据还原到本地数据库：
+  ```bash
+  mongorestore --db <dbname> --collection forms <bson文件路径>
+  # 示例
+  mongorestore --db prod_backup_20260323 --collection forms ./dump/steedos/forms.bson
+  ```
+- 本地已安装 `mongodb` npm 包（若未安装）：
+  ```bash
+  cd steedos-packages/plugin-workflow
+  npm install mongodb --no-save
+  ```
+
+---
+
+## 完整操作流程
+
+### 步骤 0：执行审批意见字段升级（前置步骤）
+
+备份还原的 forms 库中可能包含老版本的审批意见公式字段（如 `{yijianlan:{step:'部门经理审核',default:'已阅'}}`）。这些字段需要先执行升级转换为 `steedos-field` 类型，否则会被公式扫描误报为 E3 错误。
+
+> **说明**：如果目标库来自已执行过"审批意见字段升级"的生产环境，可跳过此步骤。
+
+```bash
+cd steedos-packages/plugin-workflow
+
+# 先 dry run 查看影响范围（不修改数据库）
+FORMULA_SCAN_MONGO_URL=mongodb://127.0.0.1:27017/<dbname> \
+  DRY_RUN=true \
+  node main/default/test/run_approval_comments_upgrade.js
+
+# 确认无误后正式执行
+FORMULA_SCAN_MONGO_URL=mongodb://127.0.0.1:27017/<dbname> \
+  node main/default/test/run_approval_comments_upgrade.js
+```
+
+输出示例：
+```
+审批意见字段升级完成
+扫描表单数: 1595
+升级表单数: 29
+升级字段数: 1157
+```
+
+升级脚本复用了 `src/rests/migrateApprovalCommentsField.js` 中的转换逻辑（与"审批意见字段升级控制台"UI 一致），会将 3 种审批意见公式字段转换为 `steedos-field` 类型并清除原有 formula 属性：
+
+| 模式 | 示例 |
+|------|------|
+| `{yijianlan:{...}}` | `{yijianlan:{step:'部门经理审核',default:'已阅'}}` |
+| `{signature.traces.步骤名}` | `{signature.traces.部门经理审核}` |
+| `{traces.步骤名}` | `{traces.总经理审批}` |
+
+### 步骤 1：运行扫描脚本
+
+```bash
+cd steedos-packages/plugin-workflow
+
+# 基本用法
+FORMULA_SCAN_MONGO_URL=mongodb://127.0.0.1:27017/<dbname> \
+  node main/default/test/scan_production_formulas.js
+
+# 带标识标签（推荐，便于区分多次扫描结果）
+FORMULA_SCAN_MONGO_URL=mongodb://127.0.0.1:27017/<dbname> \
+  SCAN_LABEL=v1 \
+  node main/default/test/scan_production_formulas.js
+
+# 也可使用 MONGO_URL 回退（若已设置）
+MONGO_URL=mongodb://127.0.0.1:27017/<dbname> \
+  node main/default/test/scan_production_formulas.js
+```
+
+扫描完成后，控制台显示如下统计：
+
+```
+扫描完成
+总表单数: 1595
+含公式字段的表单: 706
+公式字段总数: 2157
+  - formula 字段: 2043
+  - default_value 公式字段: 114
+  - 来自 current 版本: 1655
+  - 来自 history 版本: 502
+
+检测结果:
+  ERROR: 4 条（涉及 4 个表单，current: 0，history: 4）
+  WARN: 206 条（涉及 114 个表单）
+  PASS: 1949 条
+
+报告已输出到: main/default/test/reports/formula-scan/scan-result-v1-20260324.json
+```
+
+报告文件保存在：
+```
+main/default/test/reports/formula-scan/scan-result-{SCAN_LABEL}-{YYYYMMDD}.json
+```
+
+---
+
+### 步骤 2：AI 辅助评估（分类问题根因）
+
+1. 打开生成的 JSON 报告，复制 `errors` 数组内容
+2. 打开 `main/default/test/prompt-formula-analyze.md`，按其中说明将 errors 填入占位符
+3. 将拼好的提示词发送给 AI（如 GitHub Copilot Chat / Claude / GPT-4o）
+4. AI 将对 issues 按根因分组，给出修复策略和优先级
+
+---
+
+### 步骤 3：AI 辅助修复
+
+1. 根据 AI 评估结果，确认需要修复的分组
+2. 打开 `main/default/test/prompt-formula-fix.md`，按其中说明将需修复的分组填入占位符
+3. 将拼好的提示词发送给 AI
+4. AI 将生成：先写测试 → 改代码 → 三处同步 → 运行测试 的完整修复方案
+
+---
+
+### 步骤 4：执行修复并验证
+
+按 AI 给出的方案完成修复后，运行两套测试验证：
+
+```bash
+# plugins 侧回归测试
+cd steedos-packages/plugin-workflow
+node main/default/test/test_formula_compat.js
+
+# 重新扫描（使用新版本号），确认 ERROR 数量归零
+FORMULA_SCAN_MONGO_URL=mongodb://127.0.0.1:27017/<dbname> \
+  SCAN_LABEL=v<N+1> \
+  node main/default/test/scan_production_formulas.js
+```
+
+> widgets 侧单元测试需在 `steedos-widgets` 仓库执行：
+> ```bash
+> cd packages/@steedos-widgets/amis-lib
+> npx jest --verbose
+> ```
+
+### 步骤 5：记录修正过程
+
+每次修复完成后，需要留下完整的修正记录：
+
+#### 5.1 给修正前的扫描报告添加 `processedResult`
+
+在修正前的 JSON 报告（如 `scan-result-v6-*.json`）的每个 `errors` 条目中，添加 `processedResult` 字段：
+
+```json
+{
+  "level": "ERROR",
+  "ruleId": "E1",
+  "formId": "...",
+  "originalFormula": "sum{金额}",
+  "processedResult": {
+    "action": "CODE_FIX",
+    "bugId": "Bug-8",
+    "bugTitle": "聚合函数缺失括号预处理",
+    "fixDescription": "sum{金额} 缺少括号，预处理补全为 sum({金额}) 后可正常转换",
+    "fixedInVersion": "v7",
+    "fixCommit": "3abea58",
+    "fixedFiles": ["formula-compat.js", "formula-utils.js"]
+  }
+}
+```
+
+`processedResult.action` 取值：
+- `CODE_FIX` — 通过修改公式转换代码解决
+- `KNOWN_ISSUE` — 经分析确认不需要代码修正（附 `category` 和 `resolution`）
+
+#### 5.2 更新 SCAN_HISTORY.md
+
+在 `reports/formula-scan/SCAN_HISTORY.md` 中追加本次修正记录，包括：
+- 修正前/后的报告文件名
+- Bug ID 和修改的文件列表
+- 修复的每个 ERROR 的表单名称、formId、字段、原始公式
+- 归类为 knownIssues 的记录及原因
+- 扫描统计对比表
+
+#### 5.3 提交产物
+
+每次扫描修正周期应提交到 git 的文件：
+
+```
+reports/formula-scan/
+  scan-result-v<N>-YYYYMMDD.json    # 修正前（errors 带 processedResult）
+  scan-result-v<N+1>-YYYYMMDD.json  # 修正后（errors 为空）
+  SCAN_HISTORY.md                    # 追加修正记录
+```
+
+---
+
+## 检测规则说明
+
+| 规则 | 级别 | 触发条件 |
+|------|------|----------|
+| E1   | ERROR | mapFormula 返回 null 但公式含 `{字段名}` 引用 |
+| E2   | ERROR | 转换结果中仍含 `[` 或 `]` |
+| E3   | ERROR | 转换结果中含裸 `{`（非合法 `${...}` 表达式） |
+| E4   | ERROR | mapFormula 抛出异常 |
+| W1   | WARN  | 公式含除法且除数是字段引用（除零风险） |
+| W2   | WARN  | 同表单内不同字段 getSafeCode 后结果相同（字段名冲突） |
+
+---
+
+## 报告结构说明
+
+JSON 报告包含以下顶层字段：
+
+| 字段 | 说明 |
+|------|------|
+| `scanDate` | 扫描日期（YYYY-MM-DD） |
+| `mongoUrl` | 已脱敏的连接串 |
+| `summary` | 统计汇总（含 bySource、byVersion、byStatus、errorsByVersion、knownIssueCount） |
+| `errors` | 所有 ERROR 级别问题详情（需要代码修正的公式问题） |
+| `knownIssues` | 经人工审核确认不需要代码修正的问题（附 category 和 resolution） |
+| `warnings` | 所有 WARN 级别问题详情（公式能工作但有风险） |
+| `allFormulas` | 所有含公式字段的完整清单（含 PASS/ERROR/WARN） |
+
+**`errors` vs `knownIssues` vs `warnings` 的区别：**
+
+| | ERROR | KNOWN_ISSUE | WARN |
+|--|--|--|--|
+| 含义 | 公式**无法正常工作**，需代码修正 | 公式无法转换但**无需代码修正** | 公式**能工作但有风险** |
+| 分类 | — | KNOWN_LIMITATION / BAD_SOURCE_DATA | — |
+| 处理 | AI 辅助分析和修复 | 记录原因后归档 | 通常可批量忽略 |
+| 典型规则 | E1、E2、E3、E4 | E1、E3（经审核） | W1、W2 |
+
+`allFormulas` 可用于基线对比：两次扫描结果 diff，快速定位新增问题。
+
+`summary.errorsByVersion` 标识 ERROR 来自 current 还是 history 版本，帮助判断优先级——current 版本的 ERROR 影响新审批单，history 版本的 ERROR 只影响已有旧审批单。
+
+---
+
+## 常见问题
+
+**Q：脚本报错 `未找到 mongodb 模块`**
+```bash
+npm install mongodb --no-save
+```
+
+**Q：连接失败 `Authentication failed`**
+在连接串中加入用户名密码：
+```
+mongodb://username:password@127.0.0.1:27017/<dbname>
+```
+
+**Q：forms 集合为空**
+确认 mongorestore 时指定了正确的 `--db` 和 `--collection` 参数，以及 bson 文件路径正确。
+
+**Q：WARN 数量很多，是否需要全部修复？**
+W1（除零风险）是运行时风险，建议优先修复；W2（字段名冲突）通常无实际影响，可按业务判断。

package/main/default/test/prompt-formula-analyze.md

@@ -0,0 +1,59 @@
+# AI 提示词：生产公式问题分类评估
+
+## 角色设定
+
+你是 Steedos 工作流公式转换专家，精通老版本工作流表单公式语法与 amis 框架表达式的转换机制。
+
+## 背景
+
+Steedos 审批流程（workflow）表单使用老版本 `{字段名}` 语法定义公式，在运行时由 `mapFormula` 函数转换为 amis 框架的 `${表达式}` 语法。
+
+转换规则摘要：
+
+| 场景 | 输入示例 | 输出示例 |
+|------|----------|----------|
+| 简单字段引用 | `{月末里程数}` | `${月末里程数}` |
+| 时间函数 | `{now}` | `${NOW()}` |
+| 运算表达式 | `{月末里程数} - {月初里程数}` | `${月末里程数 - 月初里程数}` |
+| 聚合函数 | `sum({出票金额})` | `${SUM(出票金额)}` |
+| 子表聚合 | `sum({出票金额})` (子表字段) | `${SUM(ARRAYMAP(表格, item => item['出票金额']))}` |
+| 上下文变量 | `{applicant}.name` | `${applicant.name}` |
+| 对象字段展开 | `{合同}.name` | `${合同__expand.name}` |
+| 特殊字符字段名 | `{油量（本地）}` | `${油量_本地}` |
+| 方括号分组 | `[{a}+{b}]/{c}` | `${(a+b)/c}` |
+| 大写金额 | `numToRMB({金额})` | `${UPPERMONEY(金额)}` |
+
+`getSafeCode` 替换规则（字段名特殊字符转义）：
+
+| 字符 | 替换为 |
+|------|--------|
+| `（` 全角左括号 | `_` |
+| `）` 全角右括号 | （删除） |
+| `(` 半角左括号 | `_` |
+| `)` 半角右括号 | （删除） |
+| `、` 顿号 | `_` |
+| `，` 全角逗号 | `_` |
+| `%` | `_` |
+| `=` | `_` |
+| `：` 全角冒号 | `_` |
+| `/` | `_` |
+| `-` | `_` |
+
+## 任务
+
+以下是扫描脚本发现的公式 ERROR 列表（`errors` 数组）：
+
+```json
+{在此粘贴 scan-result.json 文件中 errors 数组的内容}
+```
+
+请对上述问题执行分组分析，输出结构化评估报告，每个分组包含：
+
+1. **根因标签**（例如：方括号未转换、字段名含特殊字符、除零风险等）
+2. **影响范围**（涉及 ERROR/WARN 数量、表单数量）
+3. **代表性示例**（列出 1-3 个典型 originalFormula 和 convertedResult）
+4. **修复策略**（代码层面需要改什么）
+5. **优先级**（Critical / High / Medium / Low）
+6. **风险评估**（修复后是否可能影响现有正常公式）
+
+最后给出**总体建议**：哪些分组应优先修复，哪些可以延后，哪些是数据问题无需改代码。

package/main/default/test/prompt-formula-fix.md

@@ -0,0 +1,75 @@
+# AI 提示词：工作流公式转换代码修复
+
+## 角色设定
+
+你是 Steedos 工作流公式转换开发者，负责修复 `mapFormula` 函数中未兼容的公式语法。
+
+## 需要修复的问题分组
+
+以下是经 AI 评估确认、需要修复的问题分组列表：
+
+```
+{在此粘贴 AI 评估确认后需要修复的分组列表}
+```
+
+## 参考资料
+
+修复前请先阅读以下背景文件，了解公式转换机制和三处同步要求：
+
+- `.github/instructions/workflow-formula.instructions.md`（steedos-plugins 仓库）
+- `steedos-packages/plugin-workflow/main/default/utils/formula-compat.js`（当前实现）
+- `steedos-packages/plugin-workflow/main/default/test/test_formula_compat.js`（现有测试）
+
+## 修复要求（5 步流程）
+
+### 步骤 1：先写测试
+
+在 `steedos-packages/plugin-workflow/main/default/test/test_formula_compat.js` 中为每个问题分组添加失败测试用例，确认测试在修复前为红色（失败），修复后为绿色（通过）。
+
+### 步骤 2：改代码
+
+修改 `mapFormula`（或 `getSafeCode`）实现，使新增测试通过，同时保证原有测试不退化。
+
+### 步骤 3：三处同步
+
+公式转换逻辑存在于三个位置，**必须同时更新**：
+
+1. **steedos-widgets 仓库**（主版本，ESM）：
+   `packages/@steedos-widgets/amis-lib/src/workflow/formula-utils.js`
+
+2. **steedos-plugins 仓库**（CommonJS 镜像）：
+   `steedos-packages/plugin-workflow/main/default/utils/formula-compat.js`
+
+3. **steedos-plugins 仓库**（内联副本，EJS 模板）：
+   `steedos-packages/plugin-workflow/main/default/routes/flow_form_design.ejs`
+   （内联函数 `_getSafeCode` 和 `_mapFormula`，从第 281 行起）
+
+三处代码逻辑必须完全一致，否则设计器预览与运行时渲染会出现差异。
+
+### 步骤 4：运行测试
+
+```bash
+# plugins 侧回归测试
+cd steedos-packages/plugin-workflow
+node main/default/test/test_formula_compat.js
+
+# widgets 侧单元测试（需在 steedos-widgets 仓库执行）
+cd packages/@steedos-widgets/amis-lib
+npx jest --verbose
+```
+
+所有测试必须通过，才能提交 PR。
+
+### 步骤 5：同步 plugins 侧测试
+
+若 widgets 侧新增了 Jest 测试用例，在 `steedos-packages/plugin-workflow/main/default/test/test_formula_compat.js` 中添加等价测试用例，保持两侧测试覆盖一致。
+
+## 输出格式
+
+请输出：
+
+1. **新增测试用例代码**（`test_formula_compat.js` 中添加的内容）
+2. **formula-compat.js 的 diff**（精确的代码改动）
+3. **flow_form_design.ejs 的 diff**（对应的内联函数改动）
+4. **formula-utils.js 的 diff**（steedos-widgets 仓库）
+5. **验证说明**：如何手动验证修复效果（可用的测试公式示例）

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 |