init: 项目初始提交 - NeoZQYY Monorepo 完整代码

apps/etl/pipelines/feiqiu/docs/audit/changes/2026-02-14__api-ods-comparison-v3.md

@@ -0,0 +1,20 @@
+# 审计记录：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