优化
This commit is contained in:
@@ -18,9 +18,9 @@
|
||||
|
||||
| 数据代号 | 必备状态/形态 | 生成前置 | 自动化断言 | 人工可点击入口 | 当前状态 |
|
||||
|---|---|---|---|---|---|
|
||||
| CT-D01 | 已确认订单 `CONFIRMED`，尚无柜次 | 可创建并确认订单 | 确认后自动产生唯一柜次；重复事件不重复建柜 | 订单详情可进入关联柜次 | 待契约 |
|
||||
| CT-D01 | 线下已确认真实订舱登记为 `CONFIRMED`，尚未关联内部柜 | 创建请求必须携带提单号、船名、航次、预计开船/到港五项运输快照 | 登记直接产生 `CONFIRMED` 真实订舱事实，不自动创建内部柜；DRAFT/SUBMITTED 不进入正式列表 | 订舱列表只显示已确认及后续状态 | 已冻结，待环境验收 |
|
||||
| CT-D02 | 不同渠道各一单 | 渠道主数据可用 | 柜次/清单/任务不得跨渠道混装或串查 | 排柜候选可按渠道辨识 | 待契约 |
|
||||
| CT-D03 | 已排柜但无真实柜号 | 临时柜身份可生成 | 不要求真实柜号即可排柜，内部身份稳定 | 预装清单可查看“待补号”柜次 | 待契约 |
|
||||
| CT-D03 | 内部模拟柜已排货但无真实柜号/订舱 | 正式装柜仓库、ACTIVE 物流渠道、箱型和容量可用 | 服务端生成稳定 `containerBookingId/cabinetNo`；同仓同渠道 WAIT_SPLIT 可排，不要求真实柜号或订舱 | 货柜列表可新增模拟柜，预装清单显示待关联/待补号 | 已冻结，待环境验收 |
|
||||
| CT-D04 | 已补真实柜号、PDA 可领取 | CT-D03 | 补号后 PDA 入口开放且关联原内部柜身份 | PDA 任务列表可进入 | 待契约 |
|
||||
| CT-D05 | 作业中更换真实柜号 | CT-D04，PDA 已开始 | 柜号变化但柜次 ID、任务、清单、证据归属不漂移 | 详情与 PDA 同步显示新柜号 | 待契约 |
|
||||
| CT-D06 | 预装清单已生成/确认 | CT-D03 | 清单版本、订单明细、数量及确认历史可追溯 | 预装清单列表/详情可点击 | 待契约 |
|
||||
@@ -36,7 +36,7 @@
|
||||
|
||||
| 用例 | 场景 | 服务端/契约断言 | UI/设备断言 | 证据要求 | 状态 |
|
||||
|---|---|---|---|---|---|
|
||||
| CT-E01 | `CONFIRMED` 自动建柜 | 状态事件自动建一个柜次；重放幂等；失败可观测 | 订单详情无需手工建柜即可看到柜次 | 前后资源 ID、事件/日志 | 待契约 |
|
||||
| CT-E01 | 模拟柜显式关联真实订舱柜 | `CONFIRMED` 不自动建柜；模拟柜排货后首次 link 成功且内部身份/明细稳定 | 货柜详情可从正式订舱候选显式关联 | link 前后柜次、计划、明细及订舱分配快照 | 已冻结，待环境验收 |
|
||||
| CT-E02 | 渠道隔离 | 不同渠道不能进入同一排柜结果；交叉 ID 请求失败 | 候选、清单和详情不串渠道 | 双渠道正向及交叉负向响应 | 待契约 |
|
||||
| CT-E03 | 无真实柜号排柜 | 临时身份可完成排柜/预装；真实柜号字段可空 | 页面明确展示待补号，不伪造柜号 | 柜次 ID、预装版本 | 待契约 |
|
||||
| CT-E04 | 补号开放 PDA | 合法补号后任务可领取；未补号时领取被稳定阻止 | 补号前后 PDA 入口状态同步 | 补号审计、领取响应 | 待契约 |
|
||||
@@ -59,7 +59,7 @@
|
||||
|
||||
| 能力标识 | 冻结边界 | 事实来源 | 状态 |
|
||||
|---|---|---|---|
|
||||
| `confirmed-auto-container` | `CONFIRMED` 自动建柜、幂等和唯一性 | 三期产品确认版及既有订单/货柜契约 | 既有冻结，待环境验收 |
|
||||
| `simulation-container-link` | `CONFIRMED` 只形成真实订舱事实；内部模拟柜由货柜入口创建并显式关联，旧自动建柜语义已移除 | `PlatformContainerController`、`ContainerService`、`OceanBookingService`、`firstleg-v1.yaml`、`ocean-bookings-v1.yaml` | 本轮目标冻结，待环境验收 |
|
||||
| `channel-isolation` | 渠道隔离与禁止跨渠道混装 | 三期产品确认版及既有排柜契约 | 既有冻结，待环境验收 |
|
||||
| `container-number-lifecycle` | 无真实柜号排柜、补号开放 PDA、作业中换号身份稳定 | 既有预装/货柜/PDA 契约 | 既有冻结，待环境验收 |
|
||||
| `preload-and-loading-list` | 预装与装柜清单状态、版本、明细和历史 | 既有 Loading List OpenAPI/Controller/DTO | 既有冻结，待环境验收 |
|
||||
@@ -140,7 +140,23 @@
|
||||
| 可选客户 | 原型第 527 行“客户/公司名称”无必填标记；当前产品确认允许平台先建订舱后关联客户 | Admin 可清空选择；前端类型、Java DTO 与 OpenAPI 均允许 `customerId/customerName` 同时为空，单边填写必须拒绝 | `LANDED` |
|
||||
| 无客户 HTTP fixture | 不以历史客户或占位 ID/名称替代可空契约 | `ocean-bookings` 使用本轮 marker、正式渠道和仓库创建无客户订舱，详情回读真实 `bookingNo` 后按订舱号查询列表，断言空客户快照、`CONFIRMED` 及稳定柜次；发布 `createdResources.oceanBookingUnassignedCustomer` | 已准备，待部署后 HTTP 验收 |
|
||||
| 指定客户隔离链 | 保留来自本轮入库单的正式客户范围 | `phase3-container-loading` 与既有订舱主链继续断言客户、仓库、渠道一致和跨渠道拒绝，不借历史资源 | 已准备，待部署后 HTTP 验收 |
|
||||
| 提单号、船名、航次、ETD、ETA | 原型存在相关展示/录入字段，但 P3-Q14 明确真实运输数据在 `RELEASE` 补录，阶段时序覆盖草稿直接编辑方式 | 草稿页面仅只读展示，`OceanBookingDraftData` 和保存 payload 不含五字段；确认放舱弹框与 `ReleaseRequest` 必须完整携带五字段 | `LANDED` |
|
||||
| 提单号、船名、航次、ETD、ETA | 原型存在相关展示/录入字段；最新 P3-Q14 确认线下已订妥资料在创建订舱时完整登记，创建直接进入 `CONFIRMED`；`RELEASED` 仅作为后续放舱/PDA 门禁，不覆盖首次快照 | 创建 payload、持久化详情和列表必须完整携带五字段并返回 `CONFIRMED`；正常路径不得再调用订舱 `/submit`、`/confirm`；后续 `ReleaseRequest` 仍须携带五字段且不得改变首次快照 | `LANDED` |
|
||||
| 单证号 | 原型第 529 行存在“单证号”，但当前阶段 DTO/OpenAPI 未冻结对应写字段 | 不猜字段名或复用提单号；本轮不扩展写契约 | 非本轮能力，不标记接口阻断 |
|
||||
|
||||
离线合同：`ocean-booking-prototype-contract.test.mjs` 锁定原型证据、跨端可选客户、条款字段、草稿/放舱时序；`ocean-booking-fixture-contract.test.mjs` 与 `full-regression-entry-contract.test.mjs` 锁定无客户/指定客户双链和默认编排。
|
||||
离线合同：`ocean-booking-prototype-contract.test.mjs` 锁定原型证据、跨端可选客户、条款字段、创建即确认和放舱门禁时序；`ocean-booking-fixture-contract.test.mjs` 与 `full-regression-entry-contract.test.mjs` 锁定无客户/指定客户双链和默认编排。DRAFT/SUBMITTED/FAILED 不再作为订舱人工矩阵的可稳定生成状态，仅保留正式列表负向覆盖。
|
||||
|
||||
## 内部模拟柜关联真实订舱增量
|
||||
|
||||
事实来源：`PlatformContainerController`、`ContainerDtos`、`ContainerService`、`OceanBookingService`、`OceanBookingMapper`、`firstleg-v1.yaml`、`ocean-bookings-v1.yaml`。
|
||||
|
||||
| 验收项 | 自动化断言 | 当前结论 |
|
||||
|---|---|---|
|
||||
| 正式订舱列表 | 仅允许 `CONFIRMED/CHANGE_PENDING/RELEASED/CANCELLED`；`DRAFT/SUBMITTED` 查询失败且默认列表不返回未确认记录；内部模拟柜不进入订舱列表 | 契约与 HTTP fixture 已落地，待部署后验证 |
|
||||
| 新增内部模拟柜 | `POST /api/platform/v1/containers` 只接收正式装柜仓库、当前 ACTIVE 物流渠道、箱型、容量和限重；不接收真实柜号或订舱；服务端生成稳定 `containerBookingId/cabinetNo` | 契约与 HTTP fixture 已落地，待部署后验证 |
|
||||
| 排货后首次关联 | 同仓、同渠道、箱型/容量/限重及指定客户范围一致时，允许已有预排货的 `EDITING` 模拟柜首次 `POST /containers/{id}/ocean-booking-link`；关联前后柜次、计划和明细身份不变 | 契约与 HTTP fixture 已落地，待部署后验证 |
|
||||
| 隔离与唯一占用 | 跨仓、跨渠道、箱型/容量/客户范围不匹配拒绝；同一 `requirementId` 的真实订舱容量只能关联一次；双渠道负向必须来自同仓真实 ACTIVE 渠道，否则报告 `BLOCKED_FIXTURE` | 静态合同已锁定；双渠道和主要 HTTP 负向待部署后验证 |
|
||||
| 首次关联不可逆门禁 | 存在 PDA、有效装柜证据、业务单证或已进入 `LOADING/COMPLETED` 时首次 link 拒绝 | 服务端静态门禁已锁定；需部署后以独立 marker fixture 验证 |
|
||||
| 解绑与换绑 | 完全空的 `WAIT_LOADING` 模拟柜允许 unlink 后 rebind；一旦已有排货、PDA、证据或单证事实，unlink/rebind 均拒绝 | 空柜正向和排货后负向 HTTP fixture 已落地，待部署后验证 |
|
||||
| 全量编排 | 默认入口先运行 `phase3-container-loading` 完成“模拟柜新增 -> 同仓同渠道排货 -> 首次 link -> PDA”，再由证据、finalize、出仓模块沿本轮 marker 的稳定 ID 继续；禁止历史数据和 mock 回退 | Node 入口合同已锁定，待默认全量 HTTP 验证 |
|
||||
|
||||
离线合同：`container-simulation-association-contract.test.mjs` 锁定跨层契约及全量顺序；`phase3-producer-chain-contract.test.mjs`、`phase3-order-splitting-contract.test.mjs`、`ocean-booking-channel-contract.test.mjs` 锁定现有生产者不再依赖 `CONFIRMED` 自动建柜。
|
||||
|
||||
Reference in New Issue
Block a user