docs/三期/三期开工门禁.md

三期开工门禁

本文维护三期跨端开发的稳定门禁。实时任务进度见 三期开发进度表.md；产品决策以 三期需求确认表.md 为准。

可直接开展的范围

• 已确认规则可进入契约、数据、接口、页面和测试拆分，不需要等待整期所有模块完成。
• 订单继续承载三期主状态，不新建独立出仓单；支持父订单、子订单与柜次关系，以及一单多柜和多订单拼柜。
• 智能排柜、订舱与船期、拖车预约、PDA 在线拣货、五类装柜证据、人工报关回执和 LOADED 服务端门禁按需求确认表执行。
• 三期国内终点为 LOADED；DELIVERED 只由海外仓可信回传推进。

跨端硬边界

• LOADED 前必须由服务端校验订舱完成、拖车完成、有效报关放行回执、PDA 拣货完成和五类有效证据完整；国内 Admin/PDA 不提供在线冲正或手工推进 DELIVERED。
• PDA 正式作业仅在线；单柜次只允许一名作业员，不支持多人并行、任务接管或换班释放。进入任务即由服务端标记拣货中，扫描草稿按作业员、任务和柜次隔离，提交时批量写入。
• 每类证据至少一张有效照片，允许同类型追加；错误照片只能作废并保留审计。客户不可见照片与锁码。
• 前端页面、菜单和路由只能在对应服务端契约、权限和数据模型稳定后发布；原型中的完整 WMS、海外仓及未确认能力不属于三期默认范围。

局部阻断项

• PDA 采用 uni-app 开发并支持在线更新；Android 广播扫描已接入。设备型号不构成开发、发布或验收门禁；扫描适配保持厂商无关，按既定发布安排完成常规真机验收。
• 未冻结的字段、权限码、错误码、迁移方案或跨服务调用，只阻断依赖它们的模块；不得以模拟成功或前端猜测替代服务端契约。
• 修改任一跨服务契约时，必须同步检查生产者、调用方、OpenAPI、权限、迁移脚本和实际前端消费者。

使用方式

1. 先读 README.md、三期需求确认表.md 和本文件，确认任务属于已确认范围。
2. 再进入目标应用或服务的 AGENTS.md，按本地模块入口实现。
3. 发现新的产品决策或门禁变化时，先更新确认表与本文，再更新受影响模块指引；不要将短期进度、联调故障或环境地址写回模块规则。