# 变更审计记录（Change Audit Record）

- 日期/时间（Asia/Shanghai）：2026-02-15 03:30:00
- Prompt-ID：P20260215-030222 / P20260215-032839
- 原始原因（Prompt 原文或 ≤5 行摘录）：
  1. "docs\api-reference\summary 下各个文档，响应字段详解，字段归类是否科学合理？为我检查并修正。"
  2. "我想把docs下有关审计 audit的内容归总到统一目录下。"
- 直接原因（必要性 + 修改方案简介）：
  - API 参考文档字段归类不合理（门店名称独立分组、字段放错语义组等），需修正以保证文档准确性
  - 审计相关文件散落在 docs/ai_audit/ 和 docs/audit/ 两处，需统一归总到 docs/audit/

## 变更范围（Changed）

### 1. API 文档字段归类修正（纯文档，无运行时影响）
- `docs/api-reference/summary/member_balance_changes.md` — 合并独立"门店名称"分组到"主键与关联 ID"，分组数 9→8
- `docs/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）
