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/05-ui-specification.md

@@ -410,20 +410,49 @@ Go 的 map 是无序的，不靠它定顺序的话，同一个商品每次刷新
 [同步] [创建采购任务]   订单号 [___] [搜索]              [删除]
 ```
 
-`[待定]` MVP 阶段**同步按钮只做占位**：点击提示"同步功能待接入"，不发请求。
+`[必须]` 「同步」按工单 #46 实现：
+
+```text
+点「同步」
+  ├─ 本地缓存的会话未过期 ──→ 后台开始同步，立即跳回列表页，
+  │                          状态条显示"同步已开始，请稍后刷新页面查看结果"
+  └─ 没有缓存会话/已过期 ───→ 弹出登录弹窗（不是报错）：
+                              账号（config.yaml 带出，只读，不显示密码）
+                              验证码图片 [点图/换一张 可刷新]
+                              验证码文字输入框
+                              [登录并同步]
+```
+
+同步是长任务，不阻塞 HTTP 请求线程——点完立即跳转，结果异步写进内存态的
+"最近一次同步报告"，下次刷新页面时状态条会显示：
+
+```text
+同步完成：日期范围 2026-08-09 ~ 2026-08-09，货运单 12 张，商品明细 27 条
+（新增 20，更新 7，跳过 0）
+```
+
+有跳过/失败会在后面列出具体原因，不是只给个数字。同步中再次点「同步」会提示
+"已经有一个同步任务在跑"，不会并发跑两个。
 
 `[必须]` 搜索框宽度见 [§3.1](#31-搜索框宽度)。
 
 ### 6.2 表格列
 
-☐ / 货运单ID / 订单号 / 商品标题 / 蝦皮商品ID / 规格SKU / 数量 /
+☐ / 货运单明细ID / 订单号 / 商品标题 / 规格 / 蝦皮商品ID / 规格SKU / 数量 /
 价格（台币）/ 图片 / **匹配状态** / 更新时间
 
-- 图片显示小缩略图，点击看大图。`[必须]` 存 URL，不要把图片塞进数据库。
-- 匹配状态是**算出来的**（`sku_mappings` 里有没有记录），不是存的字段。
-- 完整货运单 JSON 不作为列显示，在详情里看。
+- 一行对应顺运宝一张货运单的**一个商品明细**，不是一张货运单——一张货运单
+  可以有多个商品，各占一行。
+- 图片显示小缩略图。`[必须]` 存 URL，不要把图片塞进数据库。
+- 匹配状态是**算出来的**（`shopee_sku_id` 是否非空），不是存的字段。
+  本工单（#46）不做规格匹配功能，待匹配的行整行标黄，但不提供匹配入口。
+- 完整货运单 JSON 不作为列显示，落在 `syb_data` 里，供后续排查用。
 
-### 6.3 规格匹配弹窗（双击行打开）
+### 6.3 规格匹配弹窗（双击行打开）—— 未实现，见下方说明
+
+`[不做]` 工单 #46（顺运宝货运单同步）明确不做这一节描述的匹配弹窗，
+`shopee_sku_id` 由同步留空，本节描述的是**规格匹配**这个后续工单要实现的目标
+界面，先记录在这里，不代表当前已经能用。
 
 ```text
 ┌──────────────────────────────────────────────────┐