迁移脚本的修复

scripts/migration/config/mapping.yaml.example

@@ -21,11 +21,11 @@ ownership_rules:
   # default_shop 模式的批量目标店铺。legacy_agent/none 模式可保持 null。
   default_target_shop_code: KWTX
   device:
-    # default_shop=默认店铺;legacy_agent=按旧套餐读取槽位的绑定卡 agent_id 分店铺;none=进平台库存
+    # default_shop=默认店铺;legacy_agent=按默认/行级旧套餐读取槽位的绑定卡 agent_id 分店铺;none=进平台库存
     mode: default_shop
-    # 批量默认当前槽位,用于 tb_device_sim_binding.is_current
+    # 默认当前卡槽。devices.csv 未填 current_slot 时使用这里;用于 tb_device_sim_binding.is_current
     current_slot: 2
-    # 批量默认旧套餐读取槽位。新系统套餐挂设备,这里只决定从奇成哪张绑定卡读套餐生命周期
+    # 默认旧套餐读取卡槽。devices.csv 未填 package_source_slot 时使用这里;新系统套餐仍挂设备;不填则回退 current_slot
     package_source_slot: 2
   standalone_card:
     # default_shop=默认店铺;legacy_agent=按卡 agent_id 分店铺;none=进平台库存
@@ -72,11 +72,11 @@ packages:
     target_package_id: null           # 必填:新库 tb_package.id
 
 # ============== 套餐系列快照(可选) ==============
-# 仅保留奇成套餐系列供人工参考;资产 series_id 会从 target_package_id 对应的 tb_package.series_id 反查
+# 资产 series_id 优先从 target_package_id 对应的 tb_package.series_id 反查;target_series_id 可作无套餐时的兜底
 series:
   - legacy_series_id: "95A038B9D3014F9DA1539EC092D9DBAA"
     legacy_series_name: "国内卡 无预存30天"
-    target_series_id: null            # 可选参考字段,生成 SQL 不依赖这里
+    target_series_id: null            # 可选:新库套餐系列 ID;无当前套餐时可作为资产系列兜底
 
 # ============== 代理-店铺映射(legacy_agent 归属 + 代理钱包) ==============
 # scan_legacy 会按"奇成 tbl_card.agent_id"分组写入。