优化

2026-08-08 11:33:09 +08:00
parent cb0792963c
commit bc14ec7bd2
12 changed files with 59 additions and 4 deletions
@@ -13,6 +13,14 @@
 - 服务端字段变化先核对 Controller、DTO 和 OpenAPI，再更新本应用的类型、API 适配层和测试；本包不反向定义服务端行为。
 - 避免建立宽泛的万能类型或引入重量级依赖。

+## 一期/二期/三期共享模型索引
+
+- 一期消费者主要是 `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 消费者。
+
+阶段依据（路径相对本文件所在目录）：一期 `../../../docs/一期/`，二期 `../../../docs/二期/`，三期 `../../../docs/三期/`；共享包不保存阶段进度，也不承载跨应用（Client）源码复用。
+
 ## 兼容性与验证

 - 修改导出名称、字段类型、枚举值或常量语义前，搜索当前应用内全部消费者。