45 lines
3.0 KiB
Markdown
45 lines
3.0 KiB
Markdown
# 审计记录：API 文档归档至 summary/ + 字段分组修正
|
||
|
||
- 日期：2026-02-14（Asia/Shanghai）
|
||
- Prompt-ID：P20260214-130000
|
||
|
||
## 原始原因
|
||
|
||
用户 Prompt（跨多轮对话）：
|
||
> 对 docs/api-reference 下，主要的 25 个文件归档到合适的目录，区别零散的文件。这 25 个文件，逐个检查描述是否有问题，我发现响应字段详解的归类组别很乱，所属组别不科学。并逐个文件进行修正。
|
||
|
||
## 直接原因
|
||
|
||
25 个 API 参考文档中，多个文件的"四、响应字段详解"章节存在字段归类错误：非时间字段被混入"时间"组、非状态字段被混入"状态与类型"组等。需要逐文件审计并修正分组。
|
||
|
||
## Changed
|
||
|
||
### Part A：文件归档（已在前次对话完成）
|
||
- 25 个 summary MD 文件从 `docs/api-reference/` 根目录移至 `docs/api-reference/summary/`
|
||
- `docs/api-reference/README.md` 更新目录结构和链接
|
||
|
||
### Part B：字段分组修正（本次完成）
|
||
|
||
| 文件 | 问题 | 修正 |
|
||
|------|------|------|
|
||
| `group_buy_redemption_records.md` | 4.9"时间"混入 9 个分摊/折扣/ID 字段 | 新增 4.9"结算分摊金额"（9 字段），时间重编号为 4.10 |
|
||
| `group_buy_packages.md` | 4.7"状态与类型"混入排序/台区列表/关联 ID | 4.7 精简；新增 4.8"关联 ID 与台区列表"；create_time 移至 4.9"时间" |
|
||
| `member_balance_changes.md` | 4.8"时间"混入 principal_* 三个本金字段 | 新增 4.8"本金明细"（3 字段），时间重编号为 4.9 |
|
||
| `member_profiles.md` | 4.7"时间元数据"混入消费统计/组织/注册来源 | 新增 4.7"消费与充值统计"、4.8"组织归属与注册来源"，时间重编号为 4.9；字段总数 15→21 |
|
||
| `tenant_goods_master.md` | 4.8"时间与删除状态"混入 not_sale/is_delete | 拆分为 4.8"时间元数据" + 4.9"状态与删除标志" |
|
||
| `store_goods_sales_records.md` | 4.8"时间"混入 coupon_share_money | coupon_share_money 移至 4.5"积分、优惠券与抵扣" |
|
||
| `site_tables_master.md` | 4.7"时间元数据"混入 order_id | 新增 4.7"当前订单"，时间重编号为 4.8 |
|
||
|
||
### 审计通过（无需修改）的文件（18 个）
|
||
assistant_accounts_master, settlement_records, assistant_cancellation_records, payment_transactions, refund_transactions, recharge_settlements, platform_coupon_redemption_records, store_goods_master, stock_goods_category_tree, goods_stock_summary, table_fee_discount_records, tenant_member_balance_overview, table_fee_transactions（前次已修）, member_stored_value_cards（前次已修）, assistant_service_records, member_consumption_statistics, goods_stock_movements, settlement_ticket_details
|
||
|
||
### 治理文档
|
||
- `.kiro/steering/structure.md` — 新增 summary/ 子目录描述
|
||
- `docs/api-reference/README.md` — AI_CHANGELOG 追加
|
||
|
||
## Risk/Verify
|
||
|
||
- 风险：纯文档分组调整，无代码/数据库/运行时影响
|
||
- 验证：逐文件统计各分组字段数总和，确认与标题声明的字段总数一致
|
||
- 回归范围：无（文档变更不影响 ETL Connector）
|