优化

shared/AGENTS.md

@@ -15,9 +15,11 @@
 
 ## 一期/二期/三期共享模型索引
 
-- 一期消费者主要是 `customers`、`iam`、`warehouses`、`master-data`、`first-leg-orders`；`CurrentUser`、`NavigationItem`、`ApiResponse`、平台收货仓快照及头程订单状态常量由 `src/index.ts` 统一导出。共享导出只描述前端数据形状，不替代 Java 服务端权限或状态机。
-- 二期消费者主要是 `inbounds`、`warehouse-resources`、`fba-pricing`、`dimension-config` 与 `unified-orders`。测量、费用、托盘、库位等类型若只被单一模块使用，应留在模块内；确需跨模块复用时，先核对 `baiyue-firstleg` Controller/DTO/OpenAPI，再以兼容方式新增导出。
-- 三期当前 NO-GO，暂无正式三期共享契约。不要为了复用原型中的分柜、装柜、报关或 PDA 字段提前扩展本包；待 `../../../docs/三期/三期需求确认表.md` 阻断项解除并锁定后端契约，再评估新增类型并同步全部 Admin 消费者。
+- 一期共享消费者：`customers`、`iam`、`warehouses`、`master-data`、`first-leg-orders`；稳定导出集中在 `src/index.ts`（用户、导航、响应、仓库摘要、订单状态）。
+- 二期共享消费者：`inbounds`、`warehouse-resources`、`fba-pricing`、`dimension-config`、`unified-orders`；单模块使用的测量、费用、托盘、库位类型留在模块内，只有真实跨模块复用才新增导出。
+- 三期当前 NO-GO，无正式共享契约；不得预留分柜、装柜、报关或 PDA 字段，待需求确认和服务端契约冻结后再新增。
+
+定位规则：先在 `src/index.ts` 确认公共导出，再搜索 `src/` 消费者；后端字段或状态有疑问时回到对应 Controller/DTO/OpenAPI，不在 shared 中猜测业务规则。
 
 阶段依据（路径相对本文件所在目录）：一期 `../../../docs/一期/`，二期 `../../../docs/二期/`，三期 `../../../docs/三期/`；共享包不保存阶段进度，也不承载跨应用（Client）源码复用。