优化

firstleg/AGENTS.md

@@ -4,7 +4,7 @@
 
 - 负责履约任务/分配，以及二期入库单、测量/OCR 结果、审核、FBA 计费、完成入库编排。
 - 订单主数据归 `order/`，托盘/库位归 `warehouse/`，文件对象归 `file/`，OCR 供应商归 `integration-service/`；通过客户端 DTO 和内部令牌协作。
-- 入库终点为 `WAIT_SPLIT + APPROVED + CONFIRMED`；二期不实现分柜、装柜、PDA 或完整财务。
+- 入库、分柜、装柜、PDA 和出仓能力均在本模块按对应服务端契约协作；`WAIT_SPLIT + APPROVED + CONFIRMED` 是入库链路状态节点，不是全量验收的范围终点。财务状态仍归 `finance`，本模块只生产不可变费用来源和柜次成本快照。
 
 ## 模块入口
 
@@ -50,8 +50,6 @@
 - 部分拣货资源结算必须调用 Warehouse 的 `/internal/warehouse/v1/pallet-locations/settlements` 原子接口；禁止拆成独立释放和转移调用。全部释放但子单仍有数量时，由仓库服务重新选择同仓普通库位，不足才落 A0。
 - 数据库字段变更同时维护 `src/main/resources/db/phase3-pda-release-allocation-migration.sql` 和 `../deploy/sql/头程数据库统一增量-MySQL8.sql`。
 
-## 分期导航
+## 全量验收导航
 
-- 一期：履约任务与分配；先读 `../../docs/一期/README.md`。
-- 二期：入库、测量、审核、计费闭环；先读 `../../docs/二期/README.md`、主流程和联调报告。
-- 三期：负责订单履约编排、柜次、智能排柜、订舱、拖车、PDA 作业与 `LOADED` 门禁；先读 `../../docs/三期/三期开工门禁.md`。已确认范围按 Controller、DTO、OpenAPI、迁移和调用方共同实现；PDA 按 uni-app 在线更新安排开发与验收，不另设设备型号门禁。
+本模块承载一期履约、二期入库测量计费、三期订单编排/柜次/排柜/订舱/拖车/PDA/`LOADED` 门禁等全量链路；按本次验收范围读取对应阶段文档、Controller、DTO、OpenAPI、迁移和调用方，不以历史阶段终点阻断联调。PDA 按 uni-app 在线更新安排开发与验收，不另设设备型号门禁。

firstleg/src/main/resources/db/phase3-channel-container-migration.sql

@@ -163,10 +163,15 @@ CALL assert_phase3_channel_container_migration();
 DROP PROCEDURE IF EXISTS assert_phase3_channel_container_migration;
 
 CREATE TABLE IF NOT EXISTS fl_container_transport_history (
-  id BIGINT UNSIGNED NOT NULL, container_booking_id BIGINT UNSIGNED NOT NULL,
-  before_container_no VARCHAR(64) NULL, after_container_no VARCHAR(64) NULL,
-  before_voyage_no VARCHAR(64) NULL, after_voyage_no VARCHAR(64) NULL,
-  reason VARCHAR(500) NULL, operator_id BIGINT UNSIGNED NOT NULL, operator_name VARCHAR(64) NULL,
-  created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3), PRIMARY KEY(id),
+  id BIGINT UNSIGNED NOT NULL COMMENT '运输字段变更历史ID',
+  container_booking_id BIGINT UNSIGNED NOT NULL COMMENT '稳定柜次ID',
+  before_container_no VARCHAR(64) NULL COMMENT '变更前真实集装箱号',
+  after_container_no VARCHAR(64) NULL COMMENT '变更后真实集装箱号',
+  before_voyage_no VARCHAR(64) NULL COMMENT '变更前航次号',
+  after_voyage_no VARCHAR(64) NULL COMMENT '变更后航次号',
+  reason VARCHAR(500) NULL COMMENT '运输字段变更原因',
+  operator_id BIGINT UNSIGNED NOT NULL COMMENT '变更操作人ID',
+  operator_name VARCHAR(64) NULL COMMENT '变更操作人名称快照',
+  created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) COMMENT '变更记录创建时间', PRIMARY KEY(id),
   KEY idx_container_transport_history (container_booking_id,created_at,id)
 ) ENGINE=InnoDB COMMENT='柜次真实运输字段不可变变更审计';