新增 29 个模块级 AGENTS.md,补齐入口表指向,使 33 个业务模块均可从入口直达页面与接口。 - 每个模块指引统一为:路径基准 / 页面与入口表 / 关键边界 / 验证入口 - 入口表 35 行改为指向 modules 下的 AGENTS.md,补齐费用项目、审计日志、尺寸配置、装柜照片等缺失词条 - 详细索引最长行从 1315 字符压缩到 699 字符,规则正文移入新增的“货柜工作台规则”小节 - 仅索引文档,未改动业务代码
1.4 KiB
1.4 KiB
Admin 头程订单接口模块指引
路径基准与读取顺序
- 本文件适用于
src/modules/first-leg-orders/,代码路径相对本目录;应用公共规则见../../../AGENTS.md。 - 本模块没有页面,只有
index.ts与api/platformFirstLegOrders.ts,提供旧版头程订单列表与客户订单统计接口的封装;新页面统一在../unified-orders/。 - 后端查
order/(/platform/v1/orders/first-leg、客户订单统计)。
页面与入口
| 目标 | 入口 | API 与后端 |
|---|---|---|
| 旧版头程订单分页查询 | api/platformFirstLegOrders.ts 的 listPlatformFirstLegOrders |
order/ |
| 客户维度订单统计 | api/platformFirstLegOrders.ts 的 getPlatformTenantOrderStatistics |
order/ |
| 对外导出 | index.ts |
— |
关键边界
- 新增订单页面与交互一律进
../unified-orders/,不要在本模块长页面。 - 本模块只做请求封装,不承载业务规则、状态判断或权限逻辑。
- 客户统计的客户范围由服务端认证上下文决定,前端只传客户 ID。
- 若确认无调用方,按当前无兼容原则直接删除,不保留别名或兼容分支。
验证
- 定向:
pnpm test src/modules/first-leg-orders/<目标测试>;改签名前用rg确认全部调用方。 - 本文件或索引变更后,从后端根运行
./scripts/agents-index-contract.ps1。