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

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

@@ -202,13 +202,17 @@ card_type_id
 
 2791990152417157 → “台费卡”（7 条）
 
+2791987095408517 → “年卡”（7 条）
+
+2793306611533637 → “月卡”（12 条）
+
 含义：卡种类型 ID，用于区分不同卡种。
 
 memberCardTypeName
 
 类型：string
 
-值："储值卡", "活动抵用券", "酒水卡", "台费卡"
+值："储值卡", "活动抵用券", "酒水卡", "台费卡", "年卡", "月卡"
 
 含义：卡种名称，与 card_type_id 一一对应，是一个 卡种枚举名称。
 
@@ -560,7 +564,7 @@ payment_method 决定是否有外部支付以及大致支付渠道；
 
 卡种类型在本表中已经完全可识别
 
-通过 card_type_id ↔ memberCardTypeName，本表已经给出了储值卡、酒水卡、台费卡、活动抵用券四种卡型及各自的 ID；
+通过 card_type_id ↔ memberCardTypeName，本表已经给出了储值卡、酒水卡、台费卡、活动抵用券、年卡、月卡六种卡型及各自的 ID；
 
 与“会员档案”里 member_card_grade_code / member_card_grade_name 可以配套构成更完整的“卡种维度”。
 
@@ -587,3 +591,12 @@ remark 与 from_type 的配合使用
 
 
 整体来看，余额变更记录.json 是会员卡层面的“总账/明细账表”，与“充值记录”“消费结算记录”“会员档案”“卡类型、卡实例”之间，通过一整套 ID 和枚举字段建立了清晰的结构关系，而本次你给的这家门店只是该结构在一个门店上的数据切片。
+
+<!--
+AI_CHANGELOG:
+- 日期: 2026-03-19
+- Prompt: card_type_id 年卡/月卡映射同步
+- 直接原因: 用户确认 2791987095408517=年卡、2793306611533637=月卡，同步到所有涉及 card_type_id 的文档
+- 变更摘要: card_type_id 枚举补充年卡/月卡（2 条），memberCardTypeName 枚举补充"年卡""月卡"，"四种卡型"改为"六种卡型"
+- 风险与验证: 纯文档变更，无运行时影响
+-->

apps/etl/connectors/feiqiu/docs/api-reference/endpoints/member_stored_value_cards.md

@@ -133,17 +133,9 @@
 
 有效期、最近消费时间等状态信息。
 
-根据字段值，这一页数据中主要有五类卡：
+根据字段值，这一页数据中主要有六类卡：
 
-储值卡
-
-活动抵用券
-
-台费卡
-
-酒水卡
-
-月卡
+储值卡、活动抵用券、台费卡、酒水卡、年卡、月卡
 
 因此，这个 JSON 更准确地理解为：门店下所有储值/次卡/券类会员卡的列表视图。
 
@@ -163,15 +155,14 @@ card_type_id
 
 枚举（按数据分布）：
 
-2793249295533893
-
-2793266846533445
-
-2791990152417157
-
-2794699703437125
-
-2793306611533637
+| card_type_id | 卡种名称 |
+|---|---|
+| 2793249295533893 | 储值卡 |
+| 2793266846533445 | 活动抵用券 |
+| 2791990152417157 | 台费卡 |
+| 2794699703437125 | 酒水卡 |
+| 2791987095408517 | 年卡 |
+| 2793306611533637 | 月卡 |
 
 这些 ID 对应不同的卡种配置，具体含义在系统内部的“卡种配置表”中。
 
@@ -183,15 +174,15 @@ member_card_grade_code
 
 枚举：
 
-2790683528022853 → 储值卡
+| member_card_grade_code | 卡种名称 |
+|---|---|
+| 2790683528022853 | 储值卡 |
+| 2790683528022856 | 活动抵用券 |
+| 2790683528022855 | 台费卡 |
+| 2790683528022858 | 酒水卡 |
+| 2790683528022857 | 月卡 |
 
-2790683528022856 → 活动抵用券
-
-2790683528022855 → 台费卡
-
-2790683528022858 → 酒水卡
-
-2790683528022857 → 月卡
+> 注意：年卡（card_type_id `2791987095408517`）对应的 member_card_grade_code 尚未在样本数据中出现。
 
 member_card_grade_code_name
 
@@ -201,15 +192,7 @@ member_card_grade_code_name
 
 枚举值（与上面 code 一一对应）：
 
-"储值卡"
-
-"活动抵用券"
-
-"台费卡"
-
-"酒水卡"
-
-"月卡"
+"储值卡"、"活动抵用券"、"台费卡"、"酒水卡"、"月卡"、"年卡"
 
 member_card_type_name
 
@@ -808,4 +791,10 @@ AI_CHANGELOG:
 - 直接原因: 合并 `electricityCardDeduct`/`rechargeFreezeBalance` 驼峰变体与已有小写字段去重，补充 5 个真正新字段描述
 - 变更摘要: 去除大小写重复行，补充 able_share_member_discount/electricity_deduct_radio/electricity_discount/member_grade/principal_balance 的中文描述
 - 风险与验证: 纯文档文案修正，无运行时影响；验证：grep "新发现字段" 返回 0 结果
+
+- 日期: 2026-03-19
+- Prompt: card_type_id 年卡/月卡映射同步
+- 直接原因: 用户确认 2791987095408517=年卡、2793306611533637=月卡，同步到所有涉及 card_type_id 的文档
+- 变更摘要: 补充年卡/月卡的 card_type_id 映射，将枚举列表改为表格形式并标注中文名称
+- 风险与验证: 纯文档变更，无运行时影响
 -->