在准备环境前提交次全部更改。
This commit is contained in:
@@ -0,0 +1,44 @@
|
||||
# 审计记录: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)
|
||||
Reference in New Issue
Block a user