CM93 MySQL importer validated baseline

codex/20_导入与审计接手.md

@@ -0,0 +1,82 @@
+# Codex：CM93JAPAN 导入与审计接手任务
+
+## 当前状态
+
+`cm93db import` 和 `cm93db audit` 已实现。
+
+不要重新设计 parser，也不要开始 PBF。
+
+## 固定环境
+
+- Windows 11
+- Python 3.12.10
+- MySQL 5.7.34-log
+- DB: cm93_chart
+- CM93: `D:\Ship\CM93V2\CM93JAPAN`
+
+## 接手顺序
+
+- [ ] 阅读 AGENTS.md
+- [ ] 阅读 README.md
+- [ ] 阅读 docs/精度规范.md
+- [ ] 阅读 docs/CM93解析与审计设计.md
+- [ ] `cm93db env-check`
+- [ ] `cm93db db-check`
+- [ ] `cm93db scan`
+- [ ] `cm93db inspect-dicts`
+- [ ] G 层 10-cell pilot import
+- [ ] 同批 audit
+- [ ] 若失败，只修真实失败原因
+- [ ] Pilot PASS 后全量 import
+- [ ] 全量 audit
+- [ ] 记录 FAILED cell，不得静默跳过
+
+## Pilot
+
+```powershell
+& ".\.venv\Scripts\cm93db.exe" import --scale G --limit 10
+& ".\.venv\Scripts\cm93db.exe" audit --scale G --limit 10 --precision-samples 32
+```
+
+## 全量
+
+```powershell
+& ".\.venv\Scripts\cm93db.exe" import
+& ".\.venv\Scripts\cm93db.exe" audit --precision-samples 256
+```
+
+## 修复边界
+
+允许修改：
+
+- src/cm93db/*
+- SQL（仅确认 MySQL 5.7.34 实际兼容问题时）
+- docs
+- scripts
+
+禁止为了“跑完”而：
+
+- 跳过无法解析 attribute
+- 降低坐标精度
+- round/simplify geometry
+- 删除 raw preservation
+- 对 Polygon 静默 make_valid
+- 把失败 cell 标记 DONE
+- 改为 MySQL 8 语法
+- 开始 PBF
+
+## 完成报告
+
+写入：`docs/报告/CM93JAPAN_导入审计完成报告_v1.md`
+
+记录：
+
+- source cell 数及 Z/A～G 分布
+- DONE / FAILED / SKIP
+- features/attributes
+- unknown IDs
+- raw preservation
+- precision audit
+- geometry validity informational issues
+- MySQL/Python 版本
+- 失败 cell 清单