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

apps/etl/connectors/feiqiu/docs/database/DWS/main/BD_manual_dws_finance_recharge_summary.md

@@ -83,11 +83,17 @@ WHERE scd2_is_current = 1;
 
 **储值卡ID**
 - 储值卡 card_type_id = 2793249295533893
-**赠送卡ID**
+**赠送卡ID**（归入 `gift_card_balance`）
 - 台费卡 2791990152417157
 - 酒水卡 2794699703437125
 - 活动抵用券 2793266846533445
 
+**其他卡类型**（当前未计入 `cash_card_balance` 或 `gift_card_balance`）
+- 年卡 2791987095408517
+- 月卡 2793306611533637
+
+> ⚠️ 年卡和月卡的余额目前未被 `_extract_card_balances()` 统计，不包含在 `total_card_balance` 中。详见 P12 PRD（`docs/prd/specs/P12-gift-card-breakdown.md`）。
+
 ## 可回溯性
 
 | 项目 | 说明 |
@@ -95,3 +101,12 @@ WHERE scd2_is_current = 1;
 | 可回溯 | ✅ 完全可回溯 |
 | 数据范围 | 2025-07-21 ~ 至今 |
 | 依赖表 | dwd_recharge_order, dim_member_card_account |
+
+<!--
+AI_CHANGELOG:
+- 日期: 2026-03-19
+- Prompt: card_type_id 年卡/月卡映射同步
+- 直接原因: 用户确认 2791987095408517=年卡、2793306611533637=月卡，同步到所有涉及 card_type_id 的文档
+- 变更摘要: 赠送卡ID 部分添加归入说明，新增"其他卡类型"段落标注年卡/月卡未被统计的遗漏
+- 风险与验证: 纯文档变更，无运行时影响
+-->