优化

AGENTS.md

@@ -31,6 +31,18 @@
 
 依赖方向保持为 `app -> modules/core/shared`、`modules -> core/shared`、`core -> shared`、`shared -> 无上层依赖`。模块间确需调用时只能引用对方根入口公开的 API 或契约，不得引用其他模块的页面、内部组件或内部目录。
 
+## 一期/二期/三期 Admin 快速索引
+
+按阶段处理需求时，先核对仓库根目录对应阶段文档，再进入下列模块；阶段范围高于原型中的全量菜单。模块代码均从 `src/` 起算。
+
+| 阶段 | Admin 范围与入口 | 当前边界 |
+|---|---|---|
+| 一期：头程订单闭环 | `modules/auth/` 登录；`customers/` 客户与企业审核；`iam/` 内部用户、角色、权限；`warehouses/` 平台收货仓；`master-data/` 快递公司、往来单位；`first-leg-orders/` 头程订单；`dashboard/` 工作台 | 功能基本完成，处于测试环境部署、样本补齐和验收收口；企业审核已合并客户列表，平台 RBAC 仅维护平台员工与平台权限资源 |
+| 二期：到仓与头程计费 | `modules/inbounds/` 入库预报、收货、测量/OCR、审核、差异与费用快照；`warehouse-resources/pallets/` 托盘；`warehouse-resources/locations/` 库位；`fba-pricing/`、`dimension-config/` 计费规则与尺寸配置；`unified-orders/` 订单工作流编排 | 技术闭环完成，验收终点为 `WAIT_SPLIT + APPROVED + CONFIRMED`（等待三期分柜）；海外仓阶梯费用仅后端契约已具备，前端联调仍需单独确认；不得把内部备注、文件或租户上下文泄露给 Client |
+| 三期：国内出仓 | 当前无正式三期模块；规划复用 `first-leg-orders/`、`unified-orders/`、`inbounds/` 的订单与入库工作流页面，新增出仓能力时按稳定契约拆分模块 | 当前 NO-GO。先解除 `../../docs/三期/三期需求确认表.md` 的 P3-Q1/Q2/Q5/Q9/Q11/Q12/Q13 等阻断项；不得把原型中的分柜、装柜、报关、港务或完整 WMS 菜单提前展示 |
+
+阶段文档入口（路径相对本文件所在目录）：一期读 `../../docs/一期/一期开发进度表.md` 与 `../../docs/一期/一期头程订单闭环设计.md`；二期读 `../../docs/二期/README.md`、`../../docs/二期/二期需求优化版-v2-测量计费入库主流程.md` 及联调报告；三期读 `../../docs/三期/README.md`、`../../docs/三期/三期开发规划.md`、`../../docs/三期/三期需求确认表.md` 和页面清单。阶段状态与代码现状冲突时，以需求确认和验收证据为准，并在改动说明中记录。
+
 ## 业务与安全约束
 
 - 当前产品层级只有平台和客户（企业）两级；Admin 不把“租户”作为用户可见概念，不新增租户选择器、目标租户文案或依赖租户上下文才能使用的页面流程。多租户产品能力后续单独设计。