33 lines
3.0 KiB
Markdown
33 lines
3.0 KiB
Markdown
# Client 跨境业务模块指引
|
||
|
||
## 路径基准与读取顺序
|
||
|
||
- 本文件适用于 `src/modules/cross-border/`，代码路径相对本目录；应用公共规则见 `../../../AGENTS.md`，业务细则见 `../../../docs/business-index.md`。
|
||
- 三条业务线共用本模块：`procurement`（海外采购）、`domestic-trucking`（本土卡车）、`pallet-shipping`（美本土散板）；每条都是独立列表 + 建单 + 详情路由。
|
||
- 后端只查 `lastleg-service/` 的 `procurement/`、`trucking/`、`looseboard/`；纯页面与文案不读后端。
|
||
|
||
## 页面与入口
|
||
|
||
| 目标 | 页面/路由 | API 与后端 |
|
||
|---|---|---|
|
||
| 海外采购列表、建单与详情 | `views/ProcurementView.vue`、`components/ProcurementDetailPanel.vue`；`cross-border/procurement`、`.../create`、`.../:orderNo/detail` | `api/procurement.ts`、`procurementSubmission.ts`、`procurementPresentation.ts`；`lastleg-service/procurement/` |
|
||
| 本土卡车列表、建单与详情 | `views/DomesticTruckingView.vue`、`components/TransportDemandForm.vue`；`cross-border/domestic-trucking`、`.../create`、`.../:orderNo/detail` | `api/businessOrders.ts`、`transportDemandForm.ts`；`lastleg-service/trucking/` |
|
||
| 美本土散板列表、建单与详情 | `views/PalletShippingView.vue`；`cross-border/pallet-shipping`、`.../create`、`.../:orderNo/detail` | `api/businessOrders.ts`；`lastleg-service/looseboard/` |
|
||
| 通用业务单展示与车次安排 | `components/BusinessOrdersView.vue`、`fleetArrangement.ts` | `api/businessOrders.ts`；`lastleg-service/fleet/trip/` |
|
||
| 采购结果确认/驳回与实收照片 | `components/ProcurementDecisionDialog.vue` | `api/procurement.ts` 的 `confirmProcurement/rejectProcurement/getProcurementWorkflow`；仅客户确认节点，不是平台审核 |
|
||
| 采购/卡车受理中、冻结失败与重试 | `components/OrderFundingStatus.vue` | `api/orderBudgets.ts` 的 `readOrderFunding/retryOrderFunding`；服务端归 `lastleg-service/procurement/funding/` |
|
||
| 柜型与规格换算 | `containerSpecifications.ts` | 本地换算，服务端复核 |
|
||
|
||
## 关键边界
|
||
|
||
- 三条线都是客户自助下单，提交后由平台审核；客户侧不提供审核、改价或内部作业动作。
|
||
- 客户与仓库范围只取服务端当前租户上下文，不从前端参数推断；跨客户查询一律拒绝。
|
||
- 提交需要幂等键、提交中状态与可恢复失败反馈；失败保留已填内容。
|
||
- 海外采购按 `baiyue-firstleg/lastleg-service/docs/procurement-workflow.md`（工作区路径）的七状态流程执行；详情展示分批收货、出库与费用，待客户确认时由当前客户确认，不恢复旧装箱与两段核费节点。
|
||
- 页面承载方式按已确认原型：列表 + 独立建单/详情路由，不改为弹框或抽屉。
|
||
|
||
## 验证
|
||
|
||
- 定向：`pnpm test src/modules/cross-border/<目标测试>`；接口或类型变化同时运行 `pnpm typecheck`。
|
||
- 本文件或索引变更后，从后端根运行 `./scripts/agents-index-contract.ps1`。
|