2.9 KiB
2.9 KiB
变更审计记录（Change Audit Record）
- 日期/时间（Asia/Shanghai）：2026-02-15 03:30:00
- Prompt-ID：P20260215-030222 / P20260215-032839
- 原始原因（Prompt 原文或 ≤5 行摘录）：
- "docs\api-reference\summary 下各个文档，响应字段详解，字段归类是否科学合理？为我检查并修正。"
- "我想把docs下有关审计 audit的内容归总到统一目录下。"
- 直接原因（必要性 + 修改方案简介）：
- API 参考文档字段归类不合理（门店名称独立分组、字段放错语义组等），需修正以保证文档准确性
- 审计相关文件散落在 docs/ai_audit/ 和 docs/audit/ 两处，需统一归总到 docs/audit/
变更范围（Changed）
1. API 文档字段归类修正（纯文档，无运行时影响）
docs/api-reference/summary/member_balance_changes.md— 合并独立"门店名称"分组到"主键与关联 ID"，分组数 9→8docs/api-reference/summary/assistant_service_records.md—assistantTeamName从"订单与关联 ID"移至"助教维度"docs/api-reference/summary/table_fee_transactions.md— 修正字段数不一致（42），real_service_money移至"金额与优惠拆分"docs/api-reference/summary/member_stored_value_cards.md—member_grade移至"卡主键与卡种信息"docs/api-reference/summary/settlement_records.md—memberDiscountAmount从"会员维度"移至"优惠/折扣/活动金额"
2. 审计目录整理（文件移动/删除，无运行时影响）
- 删除
docs/ai_audit/旧目录（内容已迁移至docs/audit/） - 删除
docs/audit/cleanup_proposal.md、doc_alignment.md、file_inventory.md、flow_tree.md（历史临时文件）
3. 已有审计记录覆盖的逻辑变更（本次仅补全 AI_CHANGELOG）
tasks/base_task.py— 补 AI_CHANGELOG（时区 Asia/Taipei→Asia/Shanghai）quality/integrity_checker.py— 补 AI_CHANGELOG（时区修正 3 处）quality/integrity_service.py— 补 AI_CHANGELOG（时区修正 3 处）
风险与回滚（Risk & Rollback）
- 风险点：极低。文档字段归类修正不影响运行时；时区 AI_CHANGELOG 仅为注释补录
- 回滚要点：
git checkout HEAD -- docs/api-reference/summary/可回滚文档变更
验证（Verification）
- 文档变更：人工检查各 summary 文档字段总数与分组标题一致
- 代码注释：
grep -r "AI_CHANGELOG" tasks/base_task.py quality/确认注释已写入
文件清单（Files changed）
- docs/api-reference/summary/member_balance_changes.md
- docs/api-reference/summary/assistant_service_records.md
- docs/api-reference/summary/table_fee_transactions.md
- docs/api-reference/summary/member_stored_value_cards.md
- docs/api-reference/summary/settlement_records.md
- tasks/base_task.py（补 AI_CHANGELOG）
- quality/integrity_checker.py（补 AI_CHANGELOG）
- quality/integrity_service.py（补 AI_CHANGELOG）