VIS-044-01 · Current
当前前端位置
当前 Shipment Port 输入位置https://vibe.app.tolodigitech.com/shipments，Create Shipment → Step 2让评审者看到 REQ-044 会替换或增强的现有 POL/POD 输入区域。
Ali Vibe Create Shipment 的 Step 2；右侧 General Information 中 POL/POD 当前为普通自由文本框，没有 canonical Port selector。
Ali Vibe · 4f6fff0c3a8db086223eab988233fe91e96eba85 · 2026-07-23 11:43 HKTBUSINESS REQUIREMENT
业务结果
授权用户能导入批准的版本化 Port 数据，先 dry-run 查看新增/变更/冲突，再发布；业务用户可按 code/name/country/alias 搜索，历史 shipment 保持原始 snapshot。
业务价值：消除自由文本、3-letter IATA 与 5-letter UN/LOCODE 混用，给 shipment、单证和后续 route 建立可追溯基础。
TECHNICAL IMPLEMENTATION
四仓技术边界
FrontendPort 管理、搜索、dry-run/conflict、publish/deactivate UI；shipment Port selectorBackendCanonical schema、migration、API、RBAC、audit、import apply、shipment reference/snapshotData获批 source snapshot、raw hash、normalizer、replay、staged import clientAI不存储、不验证权威性、不发布 master ACCEPTANCE
关键验收
- 合成 fixture 的 dry-run 返回总数、新增、更新、warning、conflict、reject，并逐行给出稳定原因码。
- Apply 必须绑定 dry-run hash、dataset SHA-256、schema/normalizer version、actor 和 idempotency key；相同输入重试不产生重复记录。
- 每个 published Port 可追溯 source、dataset version、source status/function 和 import run。
- 只读用户可按五字符 code、名称、country 和 alias 搜索；IATA 3-letter 不会被误认为 UN/LOCODE。
- 被 shipment 引用的 Port 停用后不可用于新选择，但历史 port_id + code/name snapshot 仍可读。
- Global publish/deactivate 与 company-private alias 权限隔离；editor 负责 dry-run/冲突处理，不同 actor 的 publisher 才能 apply/publish/deactivate；所有写操作记录 actor、reason 和 before/after。
IMPLEMENTATION DECISIONS
已确定的实现决策
- 01UN/LOCODE 使用、缓存和再分发
- 02Port 范围和 Function/override
- 03发布角色和 alias 治理
- 04Master Data Specification
- 05Work ID 和工程 owner
- 06Legal/licensing reviewer 批准 source usage、cache、derived use 和 redistribution。
ToloDRequirements