docs: 归档店铺管理任务 (#208 #209 #210 #211)

2026-08-13 11:16:57 +08:00
parent 8f707722ba
commit 1abed648a5
4 changed files with 172 additions and 0 deletions
@@ -0,0 +1,42 @@
+# 209 Admin：SYB 同步切换到全局店铺渠道配置
+
+- 类型：重构
+- 父级大工单：#206
+- 所属 MVP / 版本：#207
+- 状态：已完成
+- 日期：2026-08-13
+- Gitea 工单：http://ilaer.eicp.net:8418/chengma/cmautobuy/issues/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` 建立全局店铺跨渠道管理