admin-web/src/modules/overseas-business/AGENTS.md

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 与父页面传入

关键边界

• 采购按 baiyue-firstleg/lastleg-service/docs/procurement-workflow.md 的七状态流程执行：审核、分批收货、客户确认、分批出库及签收扣采购库存；费用复用海外费用窗口，默认余额支付，不恢复旧两段样品节点。
• 本土卡车与散板是海外本地运输业务，区别于国内订舱拖车与客户排车；车型、司机与车队主数据归 overseas-master-data，本模块只消费。
• 采购费用入海外费用池后由 finance/ 记账，本模块不判定收付状态，不重复写入费用行。
• 列表与表单的客户、仓库、供应商候选一律取服务端结果，不从本地或名称推算；长整型 ID 按字符串透传。
• 同一路由组件的两种模式（卡车/散板）变更时，两侧都要回归，避免只改一侧。

验证

• 定向：pnpm test src/modules/overseas-business/<目标测试>；采购命令或费用变更同时核对 lastleg-service 合同。
• 本文件或索引变更后，从后端根运行 ./scripts/agents-index-contract.ps1。