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:
2026-10-20 12:45:00 +08:00
parent 7005228b52
commit b34626bd4b
32 changed files with 886 additions and 26 deletions
+28
View File
@@ -0,0 +1,28 @@
# Admin 船期节点模块指引
## 路径基准与读取顺序
- 本文件适用于 `src/modules/port-schedules/`,代码路径相对本目录;应用公共规则见 `../../../AGENTS.md`,船节点标准见 `docs/海外仓业务/船节点标准化契约.md`(工作区路径)。
- 船节点分两类:船公司船期**查询任务**与货柜**实际节点**;本模块维护两者,订舱资料归 `../ocean-bookings/`,码头拖车归 `../container-loading/`。
- 后端只查 `firstleg/portschedule/`(查询、日历与节点事实)与 `integration-service/`(船司原始状态适配)。
## 页面与入口
| 目标 | 页面/入口 | API 与后端 |
|---|---|---|
| 船期信息列表(组合下面两个面板) | `pages/PortSchedulesView.vue`;`port-schedules` | 页面本身只做壳层,接口在各面板 |
| 船公司船期查询任务 | `components/CarrierScheduleQueryPanel.vue` | `api/platformCarrierScheduleQueries.ts`、`api/platformContainerShippingNodes.ts`;`integration-service/` |
| 货柜实际节点与十节点展示 | `components/ContainerPortSchedulePanel.vue` | `api/platformPortSchedules.ts`;`firstleg/portschedule/` |
## 关键边界
- 预计节点只展示,不推进实际进度;不得用预计到港替代实际节点或计划到仓。
- 手工实际节点必须严格向后追加并防重复;已保存的人工节点不得回退柜级节点。
- 十节点标准状态与命名按 `docs/海外仓业务/船节点标准化契约.md`,新增船司先按该契约接入标准化映射。
- 装柜完成后的节点由服务端事件幂等创建;前端不重复追加实际船节点,也不把拖车状态当阻断门禁。
- 船司原始状态与标准节点分离:页面只消费标准节点,不直接展示或判断船司原始字符串。
## 验证
- 定向:`pnpm test src/modules/port-schedules/<目标测试>`;节点语义变更同时核对 `firstleg` 船节点合同与标准化契约。
- 本文件或索引变更后,从后端根运行 `./scripts/agents-index-contract.ps1`。