在准备环境前提交次全部更改。
This commit is contained in:
30
docs/audit/changes/2026-02-13__field-drift-report-update.md
Normal file
30
docs/audit/changes/2026-02-13__field-drift-report-update.md
Normal file
@@ -0,0 +1,30 @@
|
||||
# 2026-02-13 — API 字段漂移报告修正更新
|
||||
|
||||
## 日期
|
||||
2026-02-13 (Asia/Shanghai)
|
||||
|
||||
## 原始原因
|
||||
上下文传递续接:前次对话中发现 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 共同):
|
||||
- `electricityAdjustMoney`、`electricityMoney`、`realElectricityMoney` — 电费相关
|
||||
- `merVouSalesAmount`、`plCouponSaleAmount` — 商户券/平台券销售额
|
||||
|
||||
## Risk/Verify
|
||||
- 风险:纯文档更新,无代码逻辑变更
|
||||
- 验证:重新运行比对脚本可复现结果;检查 JSON 报告 summary 数值一致性
|
||||
Reference in New Issue
Block a user