# 订单自定义店铺-快递绑定策略 设计方案 > **状态**: 📋 设计中 > **设计日期**: 2026-08-03 > **模块**: 订单快递分配策略 > **表**: 1 张 — `wms_store_express_binding_policy` --- ## 一、背景与目的 在 WMS 系统中,订单的快递分配目前依赖以下路径: 1. `store_warehouse.policy_config.auto_allocate_express` 控制是否自动分配 2. `express_interface` 表提供「仓库 + 店铺 + 平台 + 快递」的接口配置映射 3. 货主 `subject_config.default_express_code` 提供默认快递 **痛点**:无法根据业务场景灵活配置"某个仓库下,某店铺(或某货主)强制使用/优先使用某快递"的策略。例如: - 仓库 A 的拼多多店铺「旗舰店」必须走中通(ZTO),而「奥莱店」走圆通(YTO) - 同一店铺在不同条件下(如收件省份、商品类型)使用不同快递 - 多人同时管理时需要记录创建人、创建时间,方便追溯 **解决方案**:新增 `wms_store_express_binding_policy` 表,支持自定义店铺-快递绑定策略,按优先级匹配。 --- ## 二、数据库表 ### `wms_store_express_binding_policy` | 字段 | 类型 | 必填 | 默认值 | 说明 | |------|------|------|--------|------| | `id` | `BIGINT UNSIGNED` | ✅ | AUTO | 主键 | | `warehouse_id` | `BIGINT UNSIGNED` | ✅ | — | 仓库ID,策略所属仓库 | | `custom_name` | `VARCHAR(100)` | ✅ | — | 自定义店铺标签名称(自由文本,与系统店铺无关) | | `express_code` | `VARCHAR(50)` | ✅ | — | 绑定的快递编码(关联 wms_express.code) | | `priority` | `INT(11)` | ✅ | 0 | 优先级,数值越大越优先匹配 | | `is_enabled` | `TINYINT(1)` | ✅ | 1 | 是否启用:0=停用,1=启用 | | `match_condition` | `JSON` | — | NULL | 附加匹配条件(见下方说明) | | `remark` | `VARCHAR(500)` | — | NULL | 备注说明 | | `creator_id` | `BIGINT UNSIGNED` | — | NULL | 创建人账户ID(关联 accounts 表) | | `created_at` | `DATETIME` | ✅ | CURRENT_TIMESTAMP | 创建时间 | | `updated_at` | `DATETIME` | ✅ | CURRENT_TIMESTAMP ON UPDATE | 更新时间 | | `deleted_at` | `DATETIME` | — | NULL | 软删除时间 | ### 索引设计 | 索引名 | 字段 | 说明 | |--------|------|------| | `PRIMARY` | `id` | 主键 | | `idx_warehouse_enabled` | `warehouse_id`, `is_enabled`, `deleted_at` | 按仓库查询启用策略 | | `idx_warehouse_express` | `warehouse_id`, `express_code`, `deleted_at` | 按仓库+快递反查绑定 | ### `match_condition` 字段说明(JSON,可选) 用于扩展匹配条件,可进一步按以下维度过滤: ```jsonc { "platform_codes": ["PDD", "TB"], // 限定平台编码 "provinces": ["广东省", "浙江省"], // 限定收件省份 "cities": ["广州市", "杭州市"], // 限定收件城市 "item_codes": ["SKU001", "SKU002"], // 限定商品编码 "min_weight_g": 0, // 最小重量(g),NULL=不限制 "max_weight_g": 5000, // 最大重量(g),NULL=不限制 "min_amount": 0, // 最小金额(元),NULL=不限制 "max_amount": 1000 // 最大金额(元),NULL=不限制 } ``` ## 三、匹配逻辑(伪代码) ``` 1. 查询 wms_store_express_binding_policy WHERE warehouse_id = :warehouseId AND is_enabled = 1 AND deleted_at IS NULL ORDER BY priority DESC, id ASC 2. 遍历结果集,对每条策略: a. 若 match_condition 为空 → 命中,返回 express_code b. 若 match_condition 不为空 → 逐条件判断: - platform_codes:订单平台编码是否在列表中 - provinces / cities:收件地址省/市是否在列表中 - item_codes:订单商品编码是否命中 - min/max_weight_g:订单总重量是否在范围内 - min/max_amount:订单总金额是否在范围内 c. 所有条件 AND 全部满足 → 命中,返回 express_code 3. 若未命中任何策略 → 回退到原有默认逻辑 (express_interface 匹配 → subject_config.default_express_code) ``` ## 四、与现有表的关系 ``` wms_store_express_binding_policy ├─ warehouse_id → stores.id(逻辑关联,不做物理外键) ├─ express_code → wms_express.code(逻辑关联) └─ creator_id → accounts.id(逻辑关联) ``` ## 五、典型使用场景 ### 场景1:按自定义店铺标签绑定快递 ```sql INSERT INTO wms_store_express_binding_policy (warehouse_id, custom_name, express_code, priority, creator_id) VALUES (1000000, '旗舰店-中通', 'ZTO', 10, 10001); ``` ### 场景2:按自定义店铺标签+省份绑定快递(偏远地区走邮政) ```sql INSERT INTO wms_store_express_binding_policy (warehouse_id, custom_name, express_code, priority, match_condition, creator_id) VALUES (1000000, '偏远地区邮政', 'EMS', 20, '{"provinces":["新疆维吾尔自治区","西藏自治区","青海省"]}', 10001); ``` ### 场景3:全局默认快递 ```sql INSERT INTO wms_store_express_binding_policy (warehouse_id, custom_name, express_code, priority, creator_id) VALUES (1000000, '全局顺丰', 'SF', 5, 10001); ``` ## 六、后续扩展 - 策略命中日志:记录每次快递分配命中了哪条策略,便于分析调整 - 策略生效时间段:增加 `start_time` / `end_time` 支持定时策略(如大促期间切换快递) - 策略复制:支持跨仓库复制策略配置