47 lines
2.9 KiB
Markdown
47 lines
2.9 KiB
Markdown
# 变更审计记录（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）
|