# 审计记录：API vs ODS 逐表比对 v3

- 日期：2026-02-14 (Asia/Shanghai)
- Prompt-ID：P20260214-000000
- 原始原因：用户 Prompt — "还是不准。现在拆解任务，所有表，每个表当作一个任务进行比对。"（v2 比对结果不准确，要求逐表重做）
- 直接原因：前次 v2 比对脚本存在字段提取不准确的问题（嵌套结构处理、大小写匹配等），需要从 JSON 样本直接提取字段并与数据库实际列精确比对

## Changed

- `scripts/run_compare_v3.py` — 新建 v3 比对脚本，从 JSON 样本提取字段 + 读取 ODS 列 JSON，逐表比对
- `scripts/compare_api_ods_v3.py` — 新建 v3 比对脚本（备用，支持 stdin 输入）
- `scripts/ods_columns.json` — ODS 列信息快照（来自 information_schema 查询）
- `docs/reports/api_ods_comparison_v3.json` — v3 比对结果（JSON 格式）
- `docs/reports/api_ods_comparison_v3.md` — v3 比对报告（Markdown 格式，含逐表详情）

## Risk/Verify

- 风险：纯分析脚本和报告，不修改数据库或 ETL 逻辑，无运行时风险
- 验证：运行 `python scripts/run_compare_v3.py` 确认输出与报告一致
- 结论：22 张 ODS 表的所有 API 业务字段均已覆盖，无需 ALTER TABLE