Neo-ZQYY/docs/audit/changes/2026-02-14__api-ods-comparison-v3.md

审计记录：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