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

apps/etl/connectors/feiqiu/docs/api-reference/summary/member_balance_changes.md

@@ -82,8 +82,8 @@
 | `tenant_member_id` | int | `2799212845565701` | 租户内会员主键 ID。对应会员档案表的 `id` |
 | `system_member_id` | int | `2799212844549893` | 系统级会员 ID（全局唯一） |
 | `tenant_member_card_id` | int | `2799219999295237` | 会员卡账户 ID，指明本次变更针对哪一张卡。对应储值卡列表的 `id` |
-| `card_type_id` | int | `2793249295533893` | 卡种类型 ID。枚举：`2793249295533893` = 储值卡，`2793266846533445` = 活动抵用券，`2794699703437125` = 酒水卡，`2791990152417157` = 台费卡 |
-| `memberCardTypeName` | string | `"储值卡"` | 卡种名称，与 `card_type_id` 一一对应。枚举值：`"储值卡"`、`"活动抵用券"`、`"酒水卡"`、`"台费卡"` |
+| `card_type_id` | int | `2793249295533893` | 卡种类型 ID。枚举：`2793249295533893` = 储值卡，`2793266846533445` = 活动抵用券，`2794699703437125` = 酒水卡，`2791990152417157` = 台费卡，`2791987095408517` = 年卡，`2793306611533637` = 月卡 |
+| `memberCardTypeName` | string | `"储值卡"` | 卡种名称，与 `card_type_id` 一一对应。枚举值：`"储值卡"`、`"活动抵用券"`、`"酒水卡"`、`"台费卡"`、`"年卡"`、`"月卡"` |
 | `memberName` | string | `"曾丹烨"` | 会员姓名/称呼 |
 | `memberMobile` | string | `"13922213242"` | 会员手机号 |
 
@@ -220,4 +220,10 @@ AI_CHANGELOG:
 - 直接原因: 4.8"时间"组混入 principal_after/principal_before/principal_data 三个本金字段
 - 变更摘要: 新增 4.8"本金明细"组（3 字段）；原 4.8 时间组重编号为 4.9
 - 风险与验证: 纯文档分组调整，无运行时影响；验证：统计各组字段数总和 = 25+3 = 28（含本金字段）
+
+- 日期: 2026-03-19
+- Prompt: card_type_id 年卡/月卡映射同步
+- 直接原因: 用户确认 2791987095408517=年卡、2793306611533637=月卡，同步到所有涉及 card_type_id 的文档
+- 变更摘要: card_type_id 枚举和 memberCardTypeName 枚举补充年卡/月卡
+- 风险与验证: 纯文档变更，无运行时影响
 -->