feat: 按允许店铺筛选顺运宝同步 (#196)

2026-08-12 18:48:31 +08:00
parent 4089033453
commit 8a8fff8480
17 changed files with 720 additions and 30 deletions
@@ -416,6 +416,16 @@ Go 侧不用跟着调。

 这几条不是抓包结论，是本项目的决定，写在这里避免每次重新讨论：

+`[必须]` **同步先校验原始全量，再做店铺准入。** 顺序固定为：按日期查询原始总数
+并执行单次容量熔断 → 拉完当天原始列表并核对分页前后总数、页长和唯一 ID → 按
+`shopName` 去除首尾空白后与启用店铺精确匹配 → 只为接受的货运单请求明细和入库。
+不能先过滤再做完整性校验，否则非目标店铺的分页漂移会被掩盖。
+
+`[必须]` 同步开始时只读取一次启用店铺，整次运行使用同一个快照。列表允许但明细
+响应中的 `shopName` 变为空或非允许店铺时再次拦截。没有启用店铺时在会话/OCR/
+验证码等任何顺运宝请求之前停止，并且不推进覆盖游标。该过滤只影响后续入库，
+不清理历史货运单。
+
 `[必须]` **会话缓存存 Admin 的 MySQL，不引入 Redis。** 示例脚本用 Redis 是因为
 它是反复启动的一次性脚本，进程间要传会话；Admin 是常驻进程，没有这个需求，
 持久化只为重启后免登录，继续复用现有数据库即可。