docs: align application scope and merge contracts

src/modules/overseas-business/PROTOTYPE_MATRIX.md

@@ -1,4 +1,4 @@
-# 四期海外业务原型核对矩阵
+# 海外业务原型核对矩阵
 
 原型来源：`docs/悦/货代SAAS平台后台/prototype-src/modules/07-overseas-business.html`；按钮函数来源：同原型目录 `prototype-src/app.js`。
 

src/modules/overseas-master-data/PROTOTYPE_MATRIX.md

@@ -1,4 +1,4 @@
-# 四期海外通用资料原型核对矩阵
+# 海外通用资料原型核对矩阵
 
 事实来源：`docs/悦/货代SAAS平台后台/prototype-src/modules/10-general.html`、`prototype-src/overlays.html`、`prototype-src/app.js`。
 

src/modules/overseas-warehouse/API_INTEGRATION_MATRIX.md

@@ -30,5 +30,5 @@
 
 - 页面 ID：尾程 `fba-last-mile-order*`、入库 `fba-inbound-order*`、换标 `fba-relabel-order*`、托盘 `fba-pallet*`、库存 `fba-inventory*`。排车没有独立海外仓原型页，只在入库页智能排车弹框及既有排车查询页承载。
 - 托盘原型操作列仅查看、编辑，工具栏仅新增；后端即使存在 DELETE，Admin 也不暴露。所有业务表格操作列保持第一列并固定左侧。
-- 箱号、产品库本期暂缓并从正式 routes 移除；海外出库、退货出库、海外派送、PDA、卸柜照片、内部事件以及库存离仓命令均排除。
+- 箱号和产品库不设独立正式 routes；海外出库、退货出库、海外派送、PDA、卸柜照片和库存离仓命令均按海外仓全流程的正式页面与接口归属验收，内部事件仍只作为服务端协作事实。
 - 1920×1080、浏览器 100% 的人工截图仍待验收。

src/modules/overseas-warehouse/CONTRACT_GAPS.md

@@ -1,4 +1,4 @@
-# 四期海外仓前端剩余契约与环境缺口
+# 海外仓前端剩余契约与环境缺口
 
 已接请求、权限、客户作用域和错误承载见 `API_INTEGRATION_MATRIX.md`。本文件只保留当前仍影响真实联调或原型完整度的差异，不再把 FBA 预约、换标写接口、托盘公共作用域或静态 OpenAPI 记为“未接/不存在”。
 

src/modules/overseas-warehouse/PROTOTYPE_MATRIX.md

@@ -1,17 +1,17 @@
-# 四期海外仓原型核对矩阵
+# 海外仓原型核对矩阵
 
 原型来源：`docs/悦/货代SAAS平台后台/prototype-src/modules/03-overseas-warehouse.html`。
 
-当前范围冻结：箱号管理、产品库本期暂不实施，已从模块正式路由移除；既有页面、详情、弹框、类型与原型证据保留，后续恢复时继续以本矩阵为准。其余正式范围为尾程订单、入库单、换标单、托盘和库存/进销存。
+当前范围按海外仓全流程维护。箱号管理、产品库不设独立正式路由，其数据通过入仓、箱唛、SKU 与库存页面承载；正式范围包含尾程订单、入库单、换标、转运、退货、托盘、库存、排车、出库、派送、异常退回、客户回访和一件代发。
 
 | 页面 | 操作 | 原型证据 | 原型承载方式 | 当前实现（开工前） | 冻结结论 |
 |---|---|---|---|---|---|
 | 尾程订单 | 列表/筛选 | `page-last-mile-orders`，868–897 行；`lastMileSearch()`、`lastMileReset()` | 独立列表页，状态标签、查询区、横向宽表 | `/prototype/overseas-warehouse-orders/*` 占位 | 建立正式列表路由；操作列第一列，保留原型字段顺序，接口未接时显示明确契约态 |
-| 尾程订单 | 详情 | `page-last-mile-order-detail`，899–909 行；`openLastMileOrderDetail()`、`renderLastMileOrderDetail()` | 独立详情页，紧凑页头；订单信息、订单明细、计划信息、关联单据、货物信息、操作记录两列分区 | 正式参数路由与 `LastMileOrderDetailView.vue`；接口待接入时保留字段、空表与明确契约态 | 保持独立页面，不改为抽屉或弹框；原型中的出库计划和派送字段因本期边界排除，不形成操作入口 |
+| 尾程订单 | 详情 | `page-last-mile-order-detail`，899–909 行；`openLastMileOrderDetail()`、`renderLastMileOrderDetail()` | 独立详情页，紧凑页头；订单信息、订单明细、计划信息、关联单据、货物信息、操作记录两列分区 | 正式参数路由与 `LastMileOrderDetailView.vue`；接口待接入时保留字段、空表与明确契约态 | 保持独立页面，不改为抽屉或弹框；出库计划和派送通过对应子单与独立操作入口展示 |
 | 尾程订单 | 导入 | `modal-lmo-import`，933 行 | 居中弹框，约 980px | 无正式实现 | 后端导入契约未定义，本批不提供可点击成功入口 |
 | 尾程订单 | 导出字段 | `modal-lmo-field-selector`，935 行 | 居中弹框，约 760px | 无正式实现 | 后端异步导出契约未定义，本批不模拟导出 |
 | 尾程订单 | 批量转仓 | `modal-lmo-batch-transfer`，921 行 | 居中弹框，约 720px | 无正式实现 | 属库内操作，但写接口/幂等契约未定义；暂不提供写入口 |
-| 尾程订单 | 入库计划 | `modal-lmo-inbound-plan`，912 行 | 居中弹框，约 720px | 无正式实现 | 属本期入仓链路；待写接口与状态机冻结后按原型实现 |
+| 尾程订单 | 入库计划 | `modal-lmo-inbound-plan`，912 行 | 居中弹框，约 720px | 无正式实现 | 属于当前入仓链路；待写接口与状态机冻结后按原型实现 |
 | 尾程订单 | 出库计划 | `modal-lmo-outbound-plan`，927 行 | 居中弹框，约 760px | 无正式实现 | 明确属于库存离仓，排除，不实现 |
 | 入库单 | 列表/筛选 | `page-fba-inbound-order`，491–525 行；`fbioSearch()`、`fbioReset()` | 独立列表页，查询区、批量预约/排车、横向宽表 | `/prototype/fba-returns/inbound-orders` 占位 | 已接真实分页、显式客户、筛选、状态、加载/错误/空态；排车字段后端未提供，保持只读空值 |
 | 入库单 | 详情 | `page-fba-inbound-order-detail`，684–691 行；`openFbaInboundOrderDetail()` 8567–8575 行 | 独立详情页；单据信息、仓储信息、预约与排车三组字段，应收费用明细位于正文 | 正式参数路由与 `InboundOrderDetailView.vue` | 已接计划详情和 `sourceOrderId`；接口未提供的预约/排车时间、备注和费用继续显示空值 |

src/modules/unified-orders/pages/UnifiedOrdersView.test.ts

@@ -3,8 +3,8 @@ import { resolve } from 'node:path'
 import { describe, expect, it } from 'vitest'
 import { unifiedOrderStatusOptions } from '../api/unifiedOrders'
 
-const source = readFileSync(resolve(process.cwd(), 'src/modules/unified-orders/pages/UnifiedOrdersView.vue'), 'utf8')
-const routeSource = readFileSync(resolve(process.cwd(), 'src/modules/unified-orders/routes.ts'), 'utf8')
+const source = readFileSync(resolve(process.cwd(), 'src/modules/unified-orders/pages/UnifiedOrdersView.vue'), 'utf8').replace(/\r\n/g, '\n')
+const routeSource = readFileSync(resolve(process.cwd(), 'src/modules/unified-orders/routes.ts'), 'utf8').replace(/\r\n/g, '\n')
 
 describe('UnifiedOrdersView contract', () => {
   it('shows the server confirmation lock without reading a stale fee snapshot', () => {

src/shared/api/AGENTS.md

@@ -15,7 +15,7 @@
 
 ## 领域调用边界
 
-- 国内业务领域 API 使用 `http`；四期海外尾程、海外仓资源和海外本土业务使用 `overseasHttp`，不得经国内 Gateway 中转。
+- 国内业务领域 API 使用 `http`；海外尾程、海外仓资源和海外本土业务使用 `overseasHttp`，不得经国内 Gateway 中转。
 - 页面只调用所属模块的 API 封装；模块 API 负责路径、DTO 和错误适配，不把 Axios 响应或区域选择泄漏到页面。
 - 跨区域 Token、Audience、JWKS 和服务通信公共契约读取 `../../../../../docs/跨区域认证与服务通信契约.md`。