docs(admin): add module-level AGENTS indexes for all 33 modules
新增 29 个模块级 AGENTS.md,补齐入口表指向,使 33 个业务模块均可从入口直达页面与接口。 - 每个模块指引统一为:路径基准 / 页面与入口表 / 关键边界 / 验证入口 - 入口表 35 行改为指向 modules 下的 AGENTS.md,补齐费用项目、审计日志、尺寸配置、装柜照片等缺失词条 - 详细索引最长行从 1315 字符压缩到 699 字符,规则正文移入新增的“货柜工作台规则”小节 - 仅索引文档,未改动业务代码
This commit is contained in:
@@ -0,0 +1,29 @@
|
||||
# Admin 拖车模块指引
|
||||
|
||||
## 路径基准与读取顺序
|
||||
|
||||
- 本文件适用于 `src/modules/trucking/`,代码路径相对本目录;应用公共规则见 `../../../AGENTS.md`,订舱级拖车细则见 `../../../docs/business-index.md`。
|
||||
- 本模块只做**订舱级拖车预约**,与目的港码头拖车(`../container-loading/api/terminalDrayages.ts`)是不同生命周期;改前先确认属于哪一类。
|
||||
- 后端只查 `firstleg/` 的 `firstleg/service/TruckAppointmentService.java` 与 `firstleg/openapi/truck-appointments-v1.yaml`;附件归 `file/`。
|
||||
|
||||
## 页面与入口
|
||||
|
||||
| 目标 | 页面/路由 | API 与后端 |
|
||||
|---|---|---|
|
||||
| 拖车预约列表、状态与筛选 | `pages/TruckAppointmentsView.vue`;`trucking` | `api/platformTrucking.ts`;`firstleg/service/TruckAppointmentService.java` |
|
||||
| 新建拖车预约、订舱候选 | `pages/TruckAppointmentCreateView.vue`、`components/TruckAppointmentForm.vue`;`trucking/new` | `api/platformTrucking.ts` 的 `/candidates` |
|
||||
| 预约详情、附件与承运商 | `pages/TruckAppointmentDetailView.vue`、`components/TruckAttachmentDialog.vue`;`trucking/:id` | `api/platformTrucking.ts`;附件 `file/` |
|
||||
| 集装箱号校验 | `iso6346.ts` | 本地格式校验,服务端仍复核 |
|
||||
|
||||
## 关键边界
|
||||
|
||||
- 表单只选择服务端返回的 `RELEASED` 订舱与 `TRUCKING + truckingScope=DOMESTIC` 国内拖车供应商;不选择或提交客户、柜次、装柜计划或真实集装箱号。
|
||||
- 一个订舱最多一张非终态拖车单;重复创建时转入现有单继续编辑,不新建第二张。
|
||||
- 提单号和仓库由订舱冻结事实带入,表单不自行拼接或改写。
|
||||
- PDA 完成装柜不自动推进拖车状态;拖车生命周期与 PDA 任务解耦。
|
||||
- 附件为平台作用域,不重复上传提单文件;清关提柜固定选择 `OVERSEAS` 海外车队,类型在供应商主档单选维护。
|
||||
|
||||
## 验证
|
||||
|
||||
- 定向:`pnpm test src/modules/trucking/<目标测试>`;表单字段或状态链变更同时核对 `truck-appointments-v1.yaml`。
|
||||
- 本文件或索引变更后,从后端根运行 `./scripts/agents-index-contract.ps1`。
|
||||
Reference in New Issue
Block a user