feat: batch update - gift card breakdown spec, backend APIs, miniprogram pages, ETL finance recharge, docs & migrations

.kiro/steering/feiqiu-data-rules.md

@@ -0,0 +1,24 @@
+---
+inclusion: always
+---
+# 飞球数据规范（入口索引）
+
+涉及财务、结算、助教、会员、统计、指数、工资、任务调度、DWD/DWS 层开发时，必须参考以下两份权威文档（fileMatch 自动加载，也可手动引用）：
+
+- `dwd-doc-authority.md` — DWD 层 11 条强制规则（consume_money 口径、支付恒等式、会员字段断档等）
+- `dws-doc-authority.md` — DWS 层 26 条强制规则（幂等策略、课程定价、绩效档位、指数算法、配置表体系等）
+- `docs/database/BD_Manual_fdw_reverse_retention_clue.md` — FDW 反向映射手册（ETL 库通过 postgres_fdw 只读访问业务库 `member_retention_clue` 维客线索表）
+
+## 最高频硬规则速查（完整规则见上述文档）
+
+1. `consume_money` 禁止直接用于计算 → 用 `items_sum` 拆分字段
+2. 助教费用必须拆分：`assistant_pd_money`（陪打）+ `assistant_cx_money`（超休）
+3. 支付恒等式：`balance_amount = recharge_card_amount + gift_card_amount`
+4. 会员信息一律通过 `member_id` JOIN 维度表（`scd2_is_current=1`），结算单冗余字段不可靠
+5. 散客：`member_id ≤ 0`
+6. 课程类型/定价/绩效档位/奖金/指数权重 → 全部从配置表读取，禁止硬编码
+7. DWS 汇总表默认 delete-before-insert，库存表用 upsert
+
+## 参考优先级
+
+DWD-DOC > DWS 权威规范 > BD 手册 > ETL 任务文档 > 业务规则文档 > DDL 注释