This commit is contained in:
2026-08-19 09:14:33 +08:00
parent e52de2d0f6
commit b1cfae2d0f
4 changed files with 25 additions and 11 deletions
@@ -1,12 +1,13 @@
# 货柜履约原型字段验收矩阵
> 更新时间:2026-08-17
> 更新时间:2026-08-18
> 范围:货柜、预装/装柜清单、订舱、船期、拖车、报关协同与国内出仓列表。
> 口径:原型只提供字段与交互参考;当前确认契约、后端 DTO/OpenAPI 和已落地 Admin 优先。`UNKNOWN` 不生成假值、不改名借用其他字段,也不以空值通过验收。
## 跨列表统一门禁
- 操作列必须是第一业务列并固定左侧;原型中拖车、预装把操作列放在末尾的布局由当前统一表格规则覆盖。
- 平台内部业务单号统一为 `前缀-YYMMDD-NNNN`,按北京时间创建日、单据类型分别从 `0001` 递增:订舱 `OB`、派车单 `TA`、内部货柜登记 `CB`、稳定柜次 `CAB`、预装/装柜清单 `LP`。预装确认后沿用同一 `LP` 编号,不因状态变化更换身份;真实集装箱号、提单号等外部编号不适用本规则。
- `柜号/cabinetNo` 是平台稳定柜次编号,`集装箱号/containerNo` 是真实物理柜号,两者不得互换。模拟柜可以没有 `containerNo`,真实柜、完成装柜清单和国内出仓聚合必须有。
- 客户、仓库、渠道、船公司、订舱/拖车/报关供应商名称只能来自服务端冻结快照或正式主数据,不由 fixture 自造名称。
- ID 使用正整数;数量、重量和体积为非负数;关键时间必须可按 ISO-8601 解析;有供应商 ID 时名称必须非空,无 ID 时不得伪造名称。