Files

T

ouyangxq b34626bd4b docs(admin): add module-level AGENTS indexes for all 33 modules

新增 29 个模块级 AGENTS.md，补齐入口表指向，使 33 个业务模块均可从入口直达页面与接口。

- 每个模块指引统一为：路径基准 / 页面与入口表 / 关键边界 / 验证入口
- 入口表 35 行改为指向 modules 下的 AGENTS.md，补齐费用项目、审计日志、尺寸配置、装柜照片等缺失词条
- 详细索引最长行从 1315 字符压缩到 699 字符，规则正文移入新增的“货柜工作台规则”小节
- 仅索引文档，未改动业务代码

2026-10-20 12:45:00 +08:00

1.7 KiB

Raw Blame History

Admin 国内出仓模块指引

路径基准与读取顺序

本文件适用于 src/modules/outbound-dispatch/，代码路径相对本目录；应用公共规则见 ../../../AGENTS.md。
只有 pages/OutboundDispatchesView.vue、api/platformOutboundDispatch.ts、statusLabels.ts：维护国内出仓状态（确认出仓 / 撤销出仓）。
后端归 firstleg/outbound/dispatch/（OutboundDispatchService.java）。

页面与入口

目标	页面/入口	API 与后端
国内出仓列表、状态与筛选	`pages/OutboundDispatchesView.vue`	`api/platformOutboundDispatch.ts`；`firstleg/outbound/dispatch/`
确认国内出仓	行操作 `confirm-dispatch`	`changeOutboundDispatch`，提交 `inboundId`、`containerBookingId`、`expectedVersion`、`remark`
撤销国内出仓	行操作 `reverse-dispatch`	同上，需二次确认
状态中文文案	`statusLabels.ts`	服务端状态机

关键边界

确认出仓前系统校验全部装柜门禁；前端不得逐入仓确认，也不得把拖车状态当阻断门禁。
提交必须携带当前 version，冲突时重新读取，不覆盖他人操作。
出仓以真实货柜为原子边界；成功后由服务端同事务推进技术行并幂等创建船节点查询，前端不重复追加实际船节点。
与货柜详情里的“确认离仓”是同一能力的两个入口，改规则时同步检查 ../container-loading/。

验证

定向：pnpm test src/modules/outbound-dispatch/<目标测试>；状态或门禁变化同时核对 firstleg/ 出仓合同。
本文件或索引变更后，从后端根运行 ./scripts/agents-index-contract.ps1。

1.7 KiB Raw Blame History Unescape Escape

Admin 国内出仓模块指引

路径基准与读取顺序

页面与入口

关键边界

验证

1.7 KiB

Raw Blame History