ouyangxq
1e26ddad4b
新增 11 个模块级 AGENTS.md，覆盖企业工作台全部业务模块，入口表统一指向模块指引。 - 统一四段式：路径基准 / 页面与入口表 / 关键边界 / 验证入口 - 补明“页面 -> store -> API”的调用链路，避免只给目录 - 仅索引文档，未改动业务代码
31 lines
2.1 KiB
Markdown
31 lines
2.1 KiB
Markdown
# Client 订单管理模块指引
|
||
|
||
## 路径基准与读取顺序
|
||
|
||
- 本文件适用于 `src/modules/order-management/`，代码路径相对本目录；应用公共规则见 `../../../AGENTS.md`，订单与入仓计划细则见 `../../../docs/business-index.md`。
|
||
- 本模块承载客户可见的**统一订单、海外仓入仓计划与派送单**；头程下单与费用确认归 `../first-leg/`。
|
||
- 后端只查 `lastleg-service/` 的 `inboundplan/`、`delivery/`；头程订单事实由 `../first-leg/` 与 `order/` 提供。
|
||
|
||
## 页面与入口
|
||
|
||
| 目标 | 页面/路由 | API 与后端 |
|
||
|---|---|---|
|
||
| 我的订单（统一列表） | `views/MyOrdersView.vue`；`orders/my` | 复用 `../first-leg/api/unifiedOrders.ts`；`order/` |
|
||
| 海外仓入库订单列表与详情 | `views/InboundOrdersView.vue`；`orders/inbound`、`orders/inbound/:planNo/detail` | `api/inboundPlans.ts`、`inboundPlanDisplay.ts`；`lastleg-service/inboundplan/` |
|
||
| 派送单列表 | `views/DeliveryOrdersView.vue`、`views/deliveryOrders.css`；`orders/delivery` | `api/deliveryOrders.ts`；`lastleg-service/delivery/` |
|
||
| 派送单详情与签收结果 | `views/DeliveryOrderDetailView.vue`；`orders/delivery/:deliveryNo` | `api/deliveryOrders.ts` |
|
||
| 浏览器读屏验收脚本 | `receiptBrowserAcceptance.mjs` | 仅本地验收，不写业务数据 |
|
||
|
||
## 关键边界
|
||
|
||
- 入仓计划与派送单对客户只读；任何状态推进由海外仓作业侧完成，客户端不提供完成/发车类动作。
|
||
- 派送单按目的 FBA 仓拆分，列表与详情必须显示目的 FBA 仓；不得用单个出库号覆盖整批派送。
|
||
- 业务标识用计划号、入仓码、派送号等正式编号；缺失显示“—”，不用内部 ID 回退。
|
||
- 客户与仓库范围只取服务端当前租户上下文，不从前端参数推断。
|
||
- 分页、筛选与导出只消费服务端结果，不在浏览器重排或本地累计。
|
||
|
||
## 验证
|
||
|
||
- 定向：`pnpm test src/modules/order-management/<目标测试>`；接口或类型变化同时运行 `pnpm typecheck`。
|
||
- 本文件或索引变更后，从后端根运行 `./scripts/agents-index-contract.ps1`。
|