Files
ZQYY.FQ-ETL/docs/ai_audit/changes/2026-02-13__field-drift-report-update.md

1.5 KiB
Raw Blame History

2026-02-13 — API 字段漂移报告修正更新

日期

2026-02-13 (Asia/Taipei)

原始原因

上下文传递续接:前次对话中发现 settlement_records / recharge_settlements / payment_transactions 三个端点因使用 pageSize/pageNo 参数导致 HTTP 1400 失败。用户确认这些端点需要使用 limit 参数(最大 100

直接原因

需要用正确的 limit 参数重新调用这 3 个端点,提取实际 API 字段并与本地 JSON 样本比对,更新字段漂移报告。

Changed

  • docs/reports/api_field_drift_report_20260213.json — 更新 3 个实体的比对结果 + 摘要统计
  • docs/reports/api_field_drift_report_20260213.md — 同步更新 MD 格式报告,新增漂移详情、分页参数兼容性说明
  • 删除临时文件:_retry_1400.py_retry_goods.py_field_drift_retry.py_retry_results.json

比对结果

实体 本地字段 API 字段 新增 移除
settlement_records 86 91 5 0
recharge_settlements 86 91 5 0
payment_transactions 10 10 0 0

新增字段settlement_records / recharge_settlements 共同):

  • electricityAdjustMoneyelectricityMoneyrealElectricityMoney — 电费相关
  • merVouSalesAmountplCouponSaleAmount — 商户券/平台券销售额

Risk/Verify

  • 风险:纯文档更新,无代码逻辑变更
  • 验证:重新运行比对脚本可复现结果;检查 JSON 报告 summary 数值一致性