feat: 顺运宝货运单同步 (#46)

顺运宝模块此前是骨架，「同步」点了提示"待接入"。5195 个蝦皮商品已经
进系统，但货运单（真实订单）一条都没有，后面的规格匹配无从谈起。

按接口契约（docs/admin/08，从 4 份 HAR 还原）实现：配置、登录（界面
手工输验证码）、会话缓存到 SQLite、按日期范围增量同步、落 syb_orders。

shopee_sku_id 绝不被同步覆盖。它是规格匹配的结果，顺运宝那边根本没有
这个值（只给 11 位商品ID，蝦皮規格ID 是 12 位）。同步写进去就是写空，
把人工攒的匹配成果洗掉且不报错。它只出现在 INSERT 列清单里，不在
DO UPDATE SET 里；repository 层和 service 端到端各有一个测试守着。

增量从「上次同步日期当天」重拉，不是第二天。created 筛选粒度是日期而
last_synced_at 精确到秒，从第二天拉会漏掉当天晚些时候创建的单且不报错。
宁可重复拉（upsert 幂等）也不能漏。中途失败不更新 last_synced_at，
否则下次跳过这段区间，漏的单永远补不回来。

日期运算用 UTC+8，不是 UTC。审查时从 HAR 确认 created 是当地时间：
抓包于 2026-07-28T03:31:45Z（= 11:31 UTC+8），同一响应里 created 是
"2026-07-28 10:37:59"；若它是 UTC 则等于 18:37 UTC+8，比抓包晚 7 小时，
订单创建于未来，不成立。用 UTC 算会在本地 00:00-08:00 把"今天"算成昨天，
当天早晨的单这轮拉不到。用 time.FixedZone 写死，不用 LoadLocation——
那要读系统 tzdata，Windows 默认没有，打包成 exe 会失败。

金额一律取 detail/listByStock 的值：08 §5.1 实测同一响应里 amtOrder
在列表接口是分、escrowAmount 却不是，单位不统一，取错差 100 倍。

迁移 v5 纯追加（syb_session、syb_sync_state、syb_orders.product_spec），
v1-v4 逐字未动，CheckSchema 覆盖新表新列。

会话有效性判断把「网络故障」和「明确未登录」的分类集中在 Client.do()
一处——网络抖一下就判定登出的话，验证码会弹个不停，还会丢掉有效会话。

测试全部用 httptest 假服务端，不打真实站点。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

docs/admin/00-getting-started.md

@@ -90,6 +90,31 @@ go run .
 
 **这个命令是安全的**：Admin 只管理数据，不会连手机、不会下单。放心随便跑。
 
+### 配置顺运宝账号（同步货运单需要，其余四个模块不需要）
+
+顺运宝数据页的「同步」需要读 `admin/config.yaml`。第一次用要自己建这个文件
+（已在 `.gitignore` 里，不会被提交）：
+
+```powershell
+cd D:\chengma\cmautobuy\admin
+copy config.example.yaml config.yaml
+```
+
+用编辑器打开 `config.yaml`，把 `username` / `password` 改成真实的顺运宝账号密码。
+
+`[必须]` 密码要加引号，纯数字密码不加引号会被 YAML 解析成整数，前导 0 也会丢：
+
+```yaml
+password: "0012345"    # ✓ 正确
+password: 0012345      # ✗ 解析成整数 12345
+```
+
+没有这个文件时，点「同步」会提示"没有找到配置文件……请复制
+config.example.yaml"，不是一句读不出原因的报错。
+
+接口细节和这几个配置项各自的含义见
+[08 顺运宝接口](08-顺运宝接口.md) §8。
+
 ## 4. 你应该看到什么
 
 左边（或顶部）是五个模块的导航：
@@ -98,7 +123,7 @@ go run .
 |---|---|
 | 蝦皮数据 | 导入蝦皮商品报表，填 PDD 链接，发起采集 |
 | PDD 商品 | 维护拼多多商品档案，发起采集，查看采回来的规格价格。这个页面不依赖蝦皮和顺运宝的任何数据，单独就能跑通"建商品 → 建采集任务 → 领走执行 → 提交结果 → 显示已采集"这条闭环，见 [05 界面规范](05-ui-specification.md) §5 |
-| 顺运宝数据 | 同步货运单，匹配规格，生成采购任务 |
+| 顺运宝数据 | 同步货运单（需要先配置 `config.yaml`，见上一节）。规格匹配和生成采购任务是后续工单的范围，本页暂不提供 |
 | 采集采购 | 看采集和采购任务执行到哪一步了 |
 | 客户端列表 | 看哪些客户端在干活 |