20260915170028

2026-09-15 17:00:29 +08:00
1 parent d26afb5fec
commit 1f56cc3efb
@@ -12,6 +12,7 @@
 | `RunSqlFile.java` | 通用 | 在 FMS 库执行 `sql/` 下的建表 / 视图 / 索引脚本（按 GO 分批，单事务） |
 | `OtherDataProbe.java` | 迁移辅助（只读） | `list` 列出旧库 `b_other_bmfl` 的 65 个字典模块（启用/旧库行数/新库已建），输出 `otherdata-modules.txt`；`tables <表名...>` 导出新旧结构 + 旧库数据样例 |
 | `OtherDataMigrate.java` | **其他数据迁移** | 导入 `base_otherdata` 下 64 个字典模块的数据（雪花主键）、重建 `b_from`/`b_grade`、转换 `b_othercompany` 引用值，输出映射 `otherdata-id-map.tsv`；支持 `--dry-run` |
+| `TreePathRepair.java` | 核对 / 修复 | 按 `b_parent_id` 重建树表的 `b_depth` / `b_path`，默认只读报告，`--apply` 才写库 |

 ---

@@ -162,10 +163,10 @@ del FieldNameSync*.class
 javac -encoding UTF-8 -cp "mssql-jdbc-13.4.0.jre11.jar" SchemaDumpMarkdown.java

 # 导出新库 FMS 到指定文件
-java -Dstdout.encoding=UTF-8 -cp ".;mssql-jdbc-13.4.0.jre11.jar" SchemaDumpMarkdown "D:\path\FMS表结构.md" FMS
+java -Dstdout.encoding=UTF-8 -Dstderr.encoding=UTF-8 -cp ".;mssql-jdbc-13.4.0.jre11.jar" SchemaDumpMarkdown "D:\path\FMS表结构.md" FMS

 # 只导出表，不含视图
-java -Dstdout.encoding=UTF-8 -cp ".;mssql-jdbc-13.4.0.jre11.jar" SchemaDumpMarkdown "D:\path\FMS表结构.md" FMS --tables-only
+java -Dstdout.encoding=UTF-8 -Dstderr.encoding=UTF-8 -cp ".;mssql-jdbc-13.4.0.jre11.jar" SchemaDumpMarkdown "D:\path\FMS表结构.md" FMS --tables-only
 ```

 参数：`<输出文件绝对路径>` `[数据库名，默认 G3HY2025]` `[--tables-only]`
@@ -184,11 +185,11 @@ catalog 必须是 `FMS`；按 `GO` 把脚本拆成批次，在单个事务中依
 cd fms-api

 # 先 dry-run 看批次划分
-java -Dstdout.encoding=UTF-8 -cp "tools/migration/mssql-jdbc-13.4.0.jre11.jar" \
+java -Dstdout.encoding=UTF-8 -Dstderr.encoding=UTF-8 -cp "tools/migration/mssql-jdbc-13.4.0.jre11.jar" \
  tools/migration/RunSqlFile.java ../sql/fms_business_contact.sql --dry-run

 # 确认后执行
-java -Dstdout.encoding=UTF-8 -cp "tools/migration/mssql-jdbc-13.4.0.jre11.jar" \
+java -Dstdout.encoding=UTF-8 -Dstderr.encoding=UTF-8 -cp "tools/migration/mssql-jdbc-13.4.0.jre11.jar" \
  tools/migration/RunSqlFile.java ../sql/fms_business_contact.sql
 ```

@@ -201,6 +202,61 @@ javac -encoding UTF-8 -cp "mssql-jdbc-13.4.0.jre11.jar" RunSqlFile.java

 > 含「重建」段落（`drop ... if exists`）的脚本会删除同名表及其数据，执行前确认表中数据已不需要。

+---
+
+## TreePathRepair — 树表 b_depth / b_path 核对与修复
+
+`b_parent_id` 是树结构的权威关系，`b_depth` / `b_path` 是派生字段（见《FMS新系统核心表结构设计》1.7）。
+本工具按 `b_parent_id` 重算这两列，用于核对和修复派生字段与父子关系不一致的数据。
+
+历史背景：模块管理 / 菜单管理的拖拽排序曾有一处缺陷，会把**根节点** `b_path` 的前导 `/` 抹掉
+（`/base/` 被写成 `base/`）并整树落库。前端已修复，本工具用于核对历史数据、必要时重算。
+`b_path` 的约定格式形如 `/base/base_otherdata/`（节点编码前后均带 `/`）。
+
+### 行为
+
+- **默认只读报告，不写库**；确认无误后加 `--apply` 才在单个事务内更新 `b_depth` / `b_path`，失败整体回滚。
+- 只更新这两列，`b_parent_id` 与其余字段一律不动；父级不存在的节点按根处理（与前端 `buildTree` 一致）。
+- **成环的节点无法派生路径，只报告不修**——父子关系成环是数据问题，需人工先修 `b_parent_id`。
+- 报告会区分「只缺前导 `/`」这一缺陷典型症状，并给出变更样例。
+
+### 用法
+
+```bash
+cd fms-api
+
+# 只读报告（默认）：核对 s_module / s_menu
+java -Dstdout.encoding=UTF-8 -Dstderr.encoding=UTF-8 -cp "tools/migration/mssql-jdbc-13.4.0.jre11.jar" \
+  tools/migration/TreePathRepair.java
+
+# 核对全部四张树表
+java -Dstdout.encoding=UTF-8 -Dstderr.encoding=UTF-8 -cp "tools/migration/mssql-jdbc-13.4.0.jre11.jar" \
+  tools/migration/TreePathRepair.java --tables s_module,s_menu,b_dept,b_othercompany_category
+
+# 确认后执行修复
+java -Dstdout.encoding=UTF-8 -Dstderr.encoding=UTF-8 -cp "tools/migration/mssql-jdbc-13.4.0.jre11.jar" \
+  tools/migration/TreePathRepair.java --apply
+
+# 多机构：指向目标机构的连接配置（默认 config/dbconfigs/G3HD.properties）
+java -Dstdout.encoding=UTF-8 -Dstderr.encoding=UTF-8 -cp "tools/migration/mssql-jdbc-13.4.0.jre11.jar" \
+  tools/migration/TreePathRepair.java --config config/dbconfigs/OTHER.properties
+```
+
+参数：
+
+| 参数 | 说明 |
+| --- | --- |
+| （无） | 只读报告，不写库 |
+| `--dry-run` | 同「无参数」，显式表达只读 |
+| `--apply` | 执行修复（单事务） |
+| `--tables a,b` | 待核对表，默认 `s_module,s_menu`；可选 `s_module` / `s_menu` / `b_dept` / `b_othercompany_category` |
+| `--config <path>` | 连接配置，默认 `config/dbconfigs/G3HD.properties` |
+
+> 修复只重算派生字段，全部内容都能由 `b_parent_id` 重新推出，因此可安全重复执行；
+> 执行后重跑一次只读报告应得到「待更新 0 行」。
+
+---
+
 ## 已有同步记录

 | 模块 / 视图 | 同步日期 | 字段数 | 备注 |