cmautobuy/docs/task/209-SYB同步切换全局店铺.md

209 Admin：SYB 同步切换到全局店铺渠道配置

• 类型：重构
• 父级大工单：#206
• 所属 MVP / 版本：#207
• 状态：已完成
• 日期：2026-08-13
• Gitea 工单：#209

背景与目标

SYB 同步原来直接读取专属允许列表，需要切换到全局业务店铺的 SYB 渠道配置。

最终方案

同步开始时读取“业务店铺启用且 SYB 渠道启用”的名称到店铺 ID 快照。列表和明细仍按原始名称精确复核，写入时同时保存 shop_id 和原始 shop_name；分页、游标和失败停止规则未改变。

改了哪些

• admin/service/syb.go：改用渠道映射快照并向写入链路传递店铺 ID。
• admin/repository/syb.go：订单和 SYB 蝦皮骨架写入稳定店铺关联。
• admin/service/syb_allowed_shop.go：同步前置检查改读全局配置。
• admin/service/syb_test.go：更新店铺准入和明细覆盖测试。

验收结果

验收标准	结果
迁移后允许店铺集合与旧配置一致	通过
停用 SYB 渠道后不再入库	通过
同步货运单保存 shop_id 和原始 shop_name	通过
无启用店铺时安全停止且不推进游标	通过

测试

• 执行的命令：在 admin/ 执行 go test ./...、go build ./...
• 结果：Go 1.23.0 全部通过。
• 没验证到的部分：未使用真实顺运宝账号发起生产同步。

相关提交

• 8f70772 建立全局店铺跨渠道管理