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
+36
View File
@@ -0,0 +1,36 @@
# Admin 统一订单模块指引
## 路径基准与读取顺序
- 本文件适用于 `src/modules/unified-orders/`,代码路径相对本目录;应用公共规则见 `../../../AGENTS.md`,状态与申报细则见 `../../../docs/business-index.md`。
- 三个路由(`orders`、`orders/inbound/:inboundCode`、`orders/:orderId`)共用 `pages/UnifiedOrdersView.vue`;列表、详情、弹框的区别靠路由与内部状态,不在页面外再拆。
- 后端只查 `order/`(状态、申报、批量审核)、`firstleg/`(扣货、合柜、入库费用、智能装柜)与 `file/`;纯展示与文案不读后端。
## 页面与入口
| 目标 | 页面/入口 | API 与后端 |
|---|---|---|
| 订单列表、筛选、详情与商品图片 | `pages/UnifiedOrdersView.vue`;`orders`、`orders/:orderId`、`orders/inbound/:inboundCode` | `api/unifiedOrders.ts`;`order/` 的 `UnifiedOrderQueryService.java`;图片归 `file/` |
| 批量审核预览 | 列表内批量审核弹框 | `api/unifiedOrders.ts` 的 `/orders/first-leg/batch-review-preview`;`order/service/BatchOrderReviewPreviewService.java` |
| 客户原始申报编辑与渠道变更 | `components/OrderDeclarationEditorDialog.vue` | `api/unifiedOrders.ts`;`order/service/OrderDeclarationUpdateService.java` → `firstleg/service/OrderDeclarationSyncService.java` |
| 履约进度与明细树 | `components/OrderFulfillmentTreePanel.vue` | `api/orderFulfillment.ts`;`firstleg/` 履约投影 |
| 入库扣货、解除与凭证历史 | 列表与详情动作 | `../inbounds/core/api.ts`;`firstleg/service/InboundHoldService.java`、`firstleg/service/InboundHoldGuard.java`、`firstleg/service/InboundHoldEvidenceService.java`;凭证归 `file/` |
| 合柜报关、同柜不可拆组 | `api/coLoadGroups.ts`;装柜消费 `../container-loading/` | `firstleg/loading/coload/service/ColoadGroupService.java`;整组原子分配/移除/取消 |
| 入库费用明细与人工调整 | `components/InboundFeeDetailManager.vue` | `api/inboundFeeDetails.ts`;`firstleg/service/InboundFeeDetailService.java` |
| 一件代发托盘打印 | 详情“托盘打印”页签 | `../inbounds/core/DropshipPalletPrintPanel.vue`;`print/` |
`workflows/` 存放统一订单工作流页与面板(`workflows/pages/UnifiedOrderWorkflowView.vue`、`workflows/components/UnifiedOrderWorkflowPanel.vue`、`SmartLoadingWorkbench.vue`),路由装配以 `routes.ts` 与 `../../app/router/index.ts` 为准,改前先确认是否已注册。
## 关键边界
- 申报编辑按订单版本与货物 `itemNo` 整体提交,不允许增删货物行;只改客户申报快照,不覆盖仓库/PDA 实测、测量审核或计费事实;渠道变化需二次确认。
- Order 状态为 `SUBMITTED` 时列表必须保持 `PENDING_REVIEW/APPROVE_ORDER`,不得被已存在的 Firstleg 准备中入库投影覆盖。
- 批量审核弹框一次取回全部预览,按服务端 `canApprove/blockReason` 展示,不逐票请求详情,不用内部 ID 作标题。
- 扣货与解除只消费服务端 `holdFlag/currentHoldReason/canHold/canRelease/actionBlockReason/history`,提交当前版本、幂等键与必填原因;凭证下载只走授权入口。
- 同柜成员数是入仓片段数,不等于订单票数;只要求同国内仓、同渠道,允许跨客户与不同目的仓港。
- 入库费用实际、冻结与调整只显示服务端结果;计费量调整不得超出服务端允许区间。
## 验证
- 定向:`pnpm test src/modules/unified-orders/<目标测试>`;申报、合柜、扣货变更同时核对 `order`/`firstleg` 对应合同。
- 本文件或索引变更后,从后端根运行 `./scripts/agents-index-contract.ps1`。