2026-09-28 16:01:16 +08:00
1 changed files with 10 additions and 0 deletions
@@ -119,3 +119,13 @@
 | 中文状态、弹框与 390px 布局 | 列表/详情状态必须中文；release、附件、柜号动作使用正式弹框；390px 下字段、按钮、弹框不横向溢出或遮挡 | `AWAITING_REVIEW`、照片类型、确认按钮已中文化，放舱/改船/附件弹框已落地；桌面与 390px 浏览器无横向溢出；`LANDED` |

 说明：`BLOCKED_CONTRACT` 仅标记明确缺失的 DTO 字段或 Admin 承载，不把已存在的 release、拖车附件 API 路径降级为未冻结能力。
+
+## 订舱物流渠道与柜次隔离增量
+
+| 验收项 | 自动化断言 | 当前结论 |
+|---|---|---|
+| Admin 渠道选择 | 订舱新增/编辑不允许自由输入 `channelCode/channelName`；选择起运仓后使用渠道下拉，查询必须携带 `originWarehouseId` | `LANDED`：Admin 使用受控渠道下拉并调用正式平台渠道接口；Admin 与根静态合同均锁定渠道选择正向及自由输入负向 |
+| 平台渠道目录 | `GET /api/platform/v1/ocean-bookings/channels?originWarehouseId=...` 只返回当前 ACTIVE 价格簿渠道；HTTP fixture 记录本轮 marker、`originWarehouseId` 与服务端路径，不借 Merchant 身份或历史资源 | OpenAPI 已冻结；真实查询生产者已发布 `createdResources.platformLogisticsChannels` |
+| 双有效渠道 fixture | 跨渠道负向必须使用同一起运仓下两个真实有效渠道；只有一个有效渠道时输出 `BLOCKED_FIXTURE`，禁止派生 `-OTHER` 伪渠道 | 脚本门禁与正式渠道生产者已落地；待环境数据验证是否存在双渠道 |
+| 船公司与物流渠道独立 | `shippingCompanyId/shippingCompanyName` 与渠道选择分别建模，不用船公司字段代替渠道字段 | `LANDED`：Admin 与写请求模型分别承载船公司和物流渠道，静态合同已转绿 |
+| `CONFIRMED` 柜次继承渠道 | 订舱确认生成柜次后，货柜详情 `channelCode` 必须等于所选有效渠道；异渠道入库单不能分配到该柜次 | 既有 HTTP 断言保留；异渠道负向已移除伪渠道来源；写 DTO 不再发送服务端拥有的 `channelName` |