feat(t222): add freight ingestion admin flow

docs/api.md

@@ -234,13 +234,26 @@ T-224 增加：
 
 ### `GET /api/v1/freight-orders`
 
-支持 `q`、`sync_status`、`created_from/to`、`limit/cursor`。`q` 匹配受控来源单号、
-店铺或内部 UUID，不匹配电话/地址。稳定排序为 `source_created_at DESC, id DESC`。
+T-222 首版返回当前 ADMIN creator 最近更新的货运单并支持 `limit`（1..100）。
+T-224 增加 `q`、`sync_status`、`created_from/to` 和 `cursor`；`q` 只匹配受控来源
+单号、店铺或内部 UUID，不匹配电话/地址。响应不包含收件人字段或 Connector 原文。
 
 ### `GET /api/v1/freight-orders/{id}`
 
-返回货运头、全部商品明细、revision/hash 状态、采购需求和已生成 task 引用。不存在和
-跨 creator 统一 404；响应 `Cache-Control: no-store`。
+T-222 返回货运头、全部当前商品明细和 revision/hash 状态。T-223 再增加采购需求和
+已生成 task 引用。不存在和跨 creator 统一 404；响应 `Cache-Control: no-store`。
+
+T-222 精确单号同步需要 Go 后端配置：
+
+- `CMROUBAO_ERP_CONNECTOR_URL`：默认 `http://127.0.0.1:8091`，只接受 HTTP
+  loopback origin。
+- `CMROUBAO_ERP_CONNECTOR_API_KEY`：与 Connector 的
+  `SHUNYUNBAO_SERVICE_API_KEY` 相同，至少 32 UTF-8 字节；未设置时后端可启动，
+  但同步任务稳定失败为 `ERP_CONNECTOR_NOT_CONFIGURED`。
+
+Connector 未登录、找不到货运单、响应协议错误和暂时不可用分别落为
+`ERP_SESSION_REQUIRED`、`ERP_FREIGHT_NOT_FOUND`、`ERP_RESPONSE_INVALID` 和
+`ERP_CONNECTOR_UNAVAILABLE`，不返回 ERP 原始错误 body。
 
 ### `POST /api/v1/freight-items/{item_id}/procurement-request`