优化

AGENTS.md

@@ -3,7 +3,7 @@
 ## 项目定位
 
 - 本项目是虫虫出海内部运营与管理后台，仅服务平台员工。
-- 当前范围包括工作台、客户管理、头程订单、仓储与国内出仓协同、财务管理、内部用户、角色管理和菜单权限。
+- 当前范围包括工作台、客户管理、头程订单、仓储与国内出仓协同、财务管理、四期海外接柜入库与库存管理、内部用户、角色管理和菜单权限。
 - 不在本项目承载企业客户自助流程、品牌官网、微信小程序、独立 APP 或仓库 PDA 作业。
 
 ## 技术基线
@@ -58,11 +58,15 @@
 | 财务账户、费用来源、应收统计、对账单、收付款与成本 | `modules/finance/`；应收统计从 `pages/FinanceReceivableStatisticsView.vue`、`api/finance.ts` 进入 | `finance/`；应收统计只汇总指定生成月份的 CNY 正式应收结算单，导出使用 `FINANCE_RECEIVABLE_STATISTICS` 进入 File 下载中心；费用来源与柜次成本快照联查 `firstleg/`，凭证联查 `file/` |
 | 货柜与智能排柜 | `modules/container-loading/` | `firstleg/loading/`、`firstleg/split/` |
 | 预装详情、装柜清单与柜次费用 | `modules/loading-lists/pages/PreloadPlanDetailView.vue`、`modules/loading-lists/components/LoadingListDetailDrawer.vue`、`modules/loading-lists/components/ContainerFeesPanel.vue`、`modules/loading-lists/api/containerFees.ts` | `firstleg/loading/`、`firstleg` 柜次费用、`finance/` 成本分摊、`file/`、`warehouse/` |
-| 海运订舱与船期 | `modules/ocean-bookings/`、`modules/port-schedules/`；订舱状态、柜型需求和 API 分别从 `status.ts`、`containerRequirements.ts`、`api/platformOceanBookings.ts` 进入 | `firstleg/oceanbooking/`、`firstleg/portschedule/`、`integration-service/`；订舱仅有 `DRAFT`、`RELEASED`，草稿可编辑/删除，放舱后永久只读；创建和放舱只保存订舱聚合与柜型需求，不生成真实柜号或货柜分配。渠道来自起运仓当前 ACTIVE 价格版本；订舱代理联查 `modules/suppliers/` 与 `warehouse/src/main/resources/openapi/supplier-v1.yaml`，服务端契约见 `firstleg/src/main/resources/openapi/ocean-bookings-v1.yaml` |
+| 三期海运订舱与出仓前船期资料 | `modules/ocean-bookings/`、`modules/port-schedules/`；订舱状态、柜型需求和 API 分别从 `status.ts`、`containerRequirements.ts`、`api/platformOceanBookings.ts` 进入 | `firstleg/oceanbooking/`、`firstleg/portschedule/` 的 `PlatformPortScheduleController`；订舱仅有 `DRAFT`、`RELEASED`，草稿可编辑/删除，放舱后永久只读；创建和放舱只保存订舱聚合与柜型需求，不生成真实柜号或货柜分配。渠道来自起运仓当前 ACTIVE 价格版本；订舱代理联查 `modules/suppliers/` 与 `warehouse/src/main/resources/openapi/supplier-v1.yaml`，服务端契约见 `firstleg/src/main/resources/openapi/ocean-bookings-v1.yaml`。`CarrierScheduleQuery` 及柜子出仓后的船节点查询归四期 |
 | 拖车预约 | `modules/trucking/` | `firstleg/outbound/dispatch/`、`firstleg/`；承运商联查 `modules/suppliers/` 与 `warehouse/src/main/resources/openapi/supplier-v1.yaml`，服务端契约见 `firstleg/src/main/resources/openapi/truck-appointments-v1.yaml` |
 | 报关协同 | `modules/customs/` | `firstleg/customs/`、`file/`；报关代理联查 `modules/suppliers/` 与 `warehouse/src/main/resources/openapi/supplier-v1.yaml`，服务端契约见 `firstleg/src/main/resources/openapi/customs-v1.yaml` |
 | 国内出仓确认 | `modules/outbound-dispatch/` | `firstleg/outbound/dispatch/` |
 | 主数据与下载 | `modules/master-data/`、`modules/downloads/` | `warehouse/`、`file/`；Finance 导出联查 `finance/` 内部 Export Provider 与 File 导出定义 |
+| 四期海外仓接柜、入库与库内库存 | `modules/overseas-warehouse/`；先读 `../../docs/四期/README.md`，不得以 `src/prototype/` 作为业务实现 | 海外区域 API/服务；原型定向读取 `03-overseas-warehouse.html`。包含尾程订单、入库、换标、托盘、箱号、产品和库存，不包含海外仓出库及海外派送 |
+| 四期海外业务 | `modules/overseas-business/`；先读 `../../docs/四期/README.md` | 海外区域 API/服务；原型定向读取 `07-overseas-business.html`；包含采购订单、本土卡车和本土散板 |
+| 四期仓库与通用资料扩展 | 海外仓合作仓类型进入 `modules/warehouses/`；海外仓报价、汇率和车辆进入 `modules/overseas-master-data/` | 仓库类型联查 Backend `warehouse/`；海外报价、汇率和车辆联查海外区域 API/服务；原型定向读取 `10-general.html` |
+| 四期国内出仓后船节点定时查询 | 现有 `CarrierScheduleQuery` 整体归此范围；入口为 `modules/port-schedules/`、`modules/ocean-bookings/` 及货柜详情，先读 `../../docs/四期/README.md` | `firstleg/portschedule/`、`integration-service/`；从确认离开国内仓库后查询，展示最新节点、来源、观测/更新时间和历史并衔接目的港提柜；不归三期或海外派送 |
 
 ## Admin 全量验收快速索引
 
@@ -74,7 +78,7 @@
 | 二期及三期履约 | `modules/inbounds/`、`warehouse-resources/`、`fba-pricing/`、`dimension-config/`、`fee-items/`、`unified-orders/`、`container-loading/`、`loading-lists/`、`ocean-bookings/`、`port-schedules/`、`trucking/`、`customs/`、`outbound-dispatch/` | 按真实服务端契约核对全链路状态、权限、异常和证据 |
 | 平台公共运营 | `modules/suppliers/`、`domestic-containers/`、`audit/`、`notifications/`，客户运营指标复用 `customers/` | 核对公共作用域、列表/详情只读权限、写操作独立权限、审计脱敏和统计口径 |
 
-阶段文档入口（路径相对本文件所在目录）：按验收业务选择 `../../docs/一期/`、`../../docs/二期/`、`../../docs/三期/` 或 `../../docs/财务管理/` 的需求确认、契约和验收规则；进度、排期或验收状态问题再读取相应进度表和验收报告。
+阶段文档入口（路径相对本文件所在目录）：全量验收按业务选择 `../../docs/一期/`、`../../docs/二期/`、`../../docs/三期/` 或 `../../docs/财务管理/` 的需求确认、契约和验收规则；四期开发范围单独读取 `../../docs/四期/README.md`，不因进入开发就视为已纳入全量验收。进度、排期或验收状态问题再读取相应进度表和验收报告。
 
 ## 业务与安全约束