外部测试内部绑定ok

docs/商品识别与履约SKU配置.md

@@ -0,0 +1,77 @@
+# 商品识别与履约 SKU 配置
+
+当前后端已支持把外部商品先识别为内部履约 SKU，再继续匹配库存或人工履约。
+配置来源已经统一为后台管理页和后端数据文件，不再使用 `.env` 里的 `ORDER_FULFILLMENT_BINDINGS_JSON`。
+
+## 配置目标
+
+- `match` 负责识别外部商品
+- `skuCode` 代表内部履约 SKU
+- `profileKey` 决定后续走库存自动链路还是人工链路
+
+## 推荐配置格式
+
+后台保存后会写入后端数据文件：
+
+- `/app/data/order-fulfillment-bindings.json`
+
+配置结构如下：
+
+```json
+[
+  {
+    "provider": "agiso",
+    "platform": "xianyu",
+    "shopId": "2209880145223",
+    "skuCode": "sjz_hdl_test01",
+    "profileKey": "tencent_claim_redeem",
+    "priority": 10,
+    "config": {
+      "note": "三角洲行动腾讯兑换码自动领取"
+    },
+    "match": {
+      "externalSkuCode": "6228372634012",
+      "externalItemId": "1040695550204",
+      "externalSkuName": "周边",
+      "config": {
+        "resolvedSkuName": "三角洲行动-自动领取"
+      }
+    }
+  },
+  {
+    "provider": "agiso",
+    "platform": "xianyu",
+    "shopId": "2209880145223",
+    "skuCode": "danzai_manual_special",
+    "profileKey": "manual_review",
+    "priority": 20,
+    "match": {
+      "externalSkuCode": "7000000000001",
+      "externalSkuName": "需要人工发货的商品"
+    }
+  }
+]
+```
+
+## 匹配顺序
+
+系统会按下面顺序匹配外部商品：
+
+1. `externalSkuCode`
+2. `externalItemId`
+3. 归一化后的 `externalSkuName`
+4. 名称包含关系兜底
+
+其中店铺级规则优先于平台级和全局级规则。
+
+## 当前落库行为
+
+- 订单商品的 `sku_code` 会保存为内部履约 SKU
+- 原始外部商品信息会保留在 `item_snapshot_json`
+- 后续履约任务、库存预占、领取链接都会按内部履约 SKU 继续执行
+
+## 生效方式
+
+- 后台保存后会立即同步到 `sku_fulfillment_bindings`
+- 同时会同步到 `product_match_rules`
+- 未匹配到规则的商品会自动落到人工处理