ouyangxq
1e26ddad4b
新增 11 个模块级 AGENTS.md，覆盖企业工作台全部业务模块，入口表统一指向模块指引。 - 统一四段式：路径基准 / 页面与入口表 / 关键边界 / 验证入口 - 补明“页面 -> store -> API”的调用链路，避免只给目录 - 仅索引文档，未改动业务代码
2.1 KiB
2.1 KiB
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。