ouyangxq
b34626bd4b
新增 29 个模块级 AGENTS.md，补齐入口表指向，使 33 个业务模块均可从入口直达页面与接口。 - 每个模块指引统一为：路径基准 / 页面与入口表 / 关键边界 / 验证入口 - 入口表 35 行改为指向 modules 下的 AGENTS.md，补齐费用项目、审计日志、尺寸配置、装柜照片等缺失词条 - 详细索引最长行从 1315 字符压缩到 699 字符，规则正文移入新增的“货柜工作台规则”小节 - 仅索引文档，未改动业务代码
3.6 KiB
3.6 KiB
Admin 海外业务模块指引
路径基准与读取顺序
- 本文件适用于
src/modules/overseas-business/，代码路径相对本目录；应用公共规则见../../../AGENTS.md，采购与本土业务细则见../../../docs/business-index.md。 - 三条业务线共用同一模块：
purchases（海外采购）、trucks（本土卡车）、looseboards（本土散板）；trucks与looseboards复用同一组页面，按路由区分模式。 - 后端只查
lastleg-service/的procurement/、trucking/、looseboard/、financefee/；纯页面与文案不读后端。
页面与入口
| 目标 | 页面/路由 | API 与后端 |
|---|---|---|
| 海外采购订单列表与库存变化 | pages/PurchaseOrdersView.vue；overseas-business/purchases |
api/platformOverseasBusiness.ts；lastleg-service/procurement/ |
| 采购订单详情（商品、库存、订单、快递、进销存） | pages/PurchaseOrderDetailView.vue；overseas-business/purchases/:purchaseId |
api/platformOverseasBusiness.ts |
| 采购订单编辑（采购商品、库存、快递） | pages/PurchaseOrderEditView.vue；overseas-business/purchases/:purchaseId/edit |
api/platformOverseasBusiness.ts（getOverseasPurchaseEditor、updateOverseasPurchase） |
| 采购订单分区字段：管控、财务、节点、实物、运输 | components/ProcurementControlFields.vue、ProcurementFinanceFields.vue、ProcurementNodeActions.vue、ProcurementPhysicalFields.vue、ProcurementTransportFields.vue |
api/procurementCommands.ts；节点动作与费用入池归 lastleg-service/financefee/ |
| 采购订单分区字段：费用（纯展示，无请求） | components/ProcurementChargeFields.vue |
只接收 props，数据由详情页 PurchaseOrderDetailView.vue 提供 |
| 本土卡车订单列表 | pages/TransportOrdersView.vue；overseas-business/trucks |
api/platformOverseasBusiness.ts；lastleg-service/trucking/ |
| 本土卡车新增/编辑 | pages/TransportOrderFormView.vue；overseas-business/trucks/new、overseas-business/trucks/:orderId/edit |
api/platformOverseasBusiness.ts；components/TransportDemandForm.vue |
| 本土散板订单列表与新增/编辑 | pages/TransportOrdersView.vue、pages/TransportOrderFormView.vue；overseas-business/looseboards、.../new、.../:orderId/edit |
api/platformOverseasBusiness.ts；lastleg-service/looseboard/ |
| 车次安排摘要 | components/FleetArrangementSummary.vue |
无直接请求；数据由 fleetArrangement.ts 与父页面传入 |
关键边界
- 采购样品履约是一条独立链路：下单、包装、面单、交寄、国内核费、寄客户；改节点或费用前先读
docs/海外仓业务/采购订单样品履约流程变更需求.md，不套用普通头程或尾程流程。 - 本土卡车与散板是海外本地运输业务，区别于国内订舱拖车与客户排车；车型、司机与车队主数据归
overseas-master-data，本模块只消费。 - 采购费用入海外费用池后由
finance/记账，本模块不判定收付状态，不重复写入费用行。 - 列表与表单的客户、仓库、供应商候选一律取服务端结果，不从本地或名称推算；长整型 ID 按字符串透传。
- 同一路由组件的两种模式（卡车/散板）变更时，两侧都要回归，避免只改一侧。
验证
- 定向：
pnpm test src/modules/overseas-business/<目标测试>；采购命令或费用变更同时核对lastleg-service合同。 - 本文件或索引变更后，从后端根运行
./scripts/agents-index-contract.ps1。