更新一版

scripts/migration/config/mapping.yaml.example

@@ -15,6 +15,43 @@ migration_user_id: 0
 # 本次迁移批次号。线上每次迁移必须使用独立批次,用于导入后收尾、验收和回滚定位。
 migration_batch_no: "MIGRATION-QICHENG-YYYYMMDD"
 
+# ============== 资产归属与槽位规则 ==============
+# mapping.yaml 是迁移决策源。奇成 agent_id 不会默认参与归属;只有显式 legacy_agent 模式才读取 agents。
+ownership_rules:
+  # default_shop 模式的批量目标店铺。legacy_agent/none 模式可保持 null。
+  default_target_shop_code: KWTX
+  device:
+    # default_shop=默认店铺;legacy_agent=按旧套餐读取槽位的绑定卡 agent_id 分店铺;none=进平台库存
+    mode: default_shop
+    # 批量默认当前槽位,用于 tb_device_sim_binding.is_current
+    current_slot: 2
+    # 批量默认旧套餐读取槽位。新系统套餐挂设备,这里只决定从奇成哪张绑定卡读套餐生命周期
+    package_source_slot: 2
+  standalone_card:
+    # default_shop=默认店铺;legacy_agent=按卡 agent_id 分店铺;none=进平台库存
+    mode: legacy_agent
+
+# ============== 套餐迁移规则 ==============
+package_rules:
+  # active=当前生效正式套餐,pending=未生效待生效正式套餐
+  migrate_statuses:
+    - active
+    - pending
+  # 可选:也可把套餐映射写在这里;scan_legacy 仍会增量维护顶层 packages。
+  packages: []
+
+# ============== 少量资产级覆盖 ==============
+# 覆盖优先级:devices.csv 行级槽位 > overrides.devices 槽位 > ownership_rules.device 默认槽位。
+overrides:
+  devices:
+    - virtual_no: "862639073940258"
+      target_shop_code: OTHER
+      current_slot: 1
+      package_source_slot: 1
+  cards:
+    - iccid: "89861590172420360956"
+      target_shop_code: OTHER
+
 # ============== 运营商映射 ==============
 # scan_legacy 会按"奇成 tbl_card.account_id/account_name"分组写入,你只需填 target_*
 # legacy_category 只是奇成运营商大类,用于人工判断 target_carrier_type,不要把它当具体运营商。
@@ -41,10 +78,11 @@ series:
     legacy_series_name: "国内卡 无预存30天"
     target_series_id: null            # 可选参考字段,生成 SQL 不依赖这里
 
-# ============== 代理-店铺映射 ==============
-# scan_legacy 会按"奇成 tbl_card.agent_id"分组写入,你只需填 target_shop_code
-# 留空(null)的代理:其卡进平台库存(除非 cards.csv 里显式指定 target_shop_code)
+# ============== 代理-店铺映射(legacy_agent 归属 + 代理钱包) ==============
+# scan_legacy 会按"奇成 tbl_card.agent_id"分组写入。
+# standalone_card/device mode=legacy_agent 时,资产按这里的 target_shop_code 分配。
+# 不使用 legacy_agent 时,这里只影响 migrate_runtime.py 的代理钱包初始化。
 agents:
   - legacy_agent_id: "D15EC779767B412A82B8448AC2324F04"
     legacy_agent_name: "叶发伟"
-    target_shop_code: null            # 新库 tb_shop.shop_code,null=不归任何店铺
+    target_shop_code: null            # 新库 tb_shop.shop_code;legacy_agent 模式下 null=该代理资产进平台库存