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

apps/etl/pipelines/feiqiu/docs/audit/changes/2026-02-14__md-placeholder-fix-cleanup.md

@@ -0,0 +1,44 @@
+# 审计记录：MD 占位符修正 + 临时文件清理
+
+- 日期：2026-02-14 (Asia/Shanghai)
+- Prompt-ID：P20260214-103000
+
+## 原始原因
+
+上下文传递续接，继续完成 Task 1（全量 API JSON 刷新 + 字段分析 + MD 文档增强）的收尾工作：
+1. 修正 5 个 API 文档中 v2 脚本自动插入的占位符描述（"新发现字段，N/100 条记录中出现"）为正式中文说明
+2. 合并 member_stored_value_cards 中 electricityCardDeduct/rechargeFreezeBalance 大小写重复字段
+3. 去除 group_buy_packages 中重复的 type 行
+4. 清理 25 个 `_raw.json` 临时文件和 3 个临时脚本
+5. 更新比对报告
+
+## 直接原因
+
+v2 脚本自动补充新字段时使用了占位符描述，需要人工替换为有业务含义的中文说明。member_stored_value_cards 的 electricityCardDeduct/rechargeFreezeBalance 是已有小写字段的驼峰变体，需合并去重。group_buy_packages 的 type 字段已存在于原始文档，自动插入导致重复行。
+
+## Changed
+
+| 文件 | 变更类型 |
+|------|----------|
+| `docs/api-reference/endpoints/assistant_service_records.md` | 修正 2 个新字段占位符描述 |
+| `docs/api-reference/endpoints/table_fee_transactions.md` | 修正 3 个新字段占位符描述 |
+| `docs/api-reference/endpoints/store_goods_master.md` | 修正 4 个新字段占位符描述 |
+| `docs/api-reference/endpoints/member_stored_value_cards.md` | 合并去重 + 修正 5 个新字段描述 |
+| `docs/api-reference/endpoints/group_buy_packages.md` | 去除重复 type + 修正 5 个新字段描述 |
+| `docs/api-reference/assistant_service_records.md` | 修正 2 个新字段占位符描述 |
+| `docs/api-reference/table_fee_transactions.md` | 修正 3 个新字段占位符描述 |
+| `docs/api-reference/store_goods_master.md` | 修正 4 个新字段占位符描述 |
+| `docs/api-reference/member_stored_value_cards.md` | 合并去重 electricityCardDeduct/rechargeFreezeBalance |
+| `docs/api-reference/group_buy_packages.md` | 去除重复 type + 修正 5 个新字段描述 |
+| `docs/reports/api_json_vs_md_report_20260214.md` | 更新报告时间戳、修正 member_stored_value_cards 和 group_buy_packages 条目 |
+| `docs/api-reference/samples/*_raw.json` (25 个) | 删除临时原始响应文件 |
+| `scripts/full_api_refresh_20260214.py` | 删除（v1 脚本，已被 v2 取代） |
+| `scripts/_tmp_check_tp.py` | 删除临时脚本 |
+| `scripts/fix_md_cleanup.py` | 删除一次性清理脚本 |
+
+## Risk/Verify
+
+- 风险：纯文档修正，无运行时影响
+- 验证：`grep -r "新发现字段" docs/api-reference/` 应返回 0 结果
+- 验证：`ls docs/api-reference/samples/*_raw.json` 应无文件
+- 验证：`ls scripts/_tmp_check_tp.py scripts/fix_md_cleanup.py scripts/full_api_refresh_20260214.py` 应全部不存在