19 KiB
19 KiB
业务快速索引
本文件只负责消除歧义与定位，不是启动必读清单。已知文件、组件或 API 时跳过本文件；先按终端选应用，再用 rg -n -F '组合词' docs/业务快速索引.md 读取命中行。
代码问题直接进入列出的模块并读适用指引；只有业务边界不清时才读“边界正文”的命中章节，不串读各层 README、其他应用索引或整个正文文件。表内代码入口相对工作区根，前端仍按任务终端分流；服务端入口不要求纯展示任务先读后端。
常用说法与歧义分流
取“终端＋对象＋动作”组合词；只读命中行。不同解释会改变范围且仍无法判断时再询问。
| 常用说法 | 区分依据 | 首个定位范围 |
|---|---|---|
| 没有报价、价格未命中、人工定价、手工报价 | FBA 单票费用的显式人工报价，不是价格簿上传或静默回退 | Admin apps/admin-web/src/modules/inbounds/fee/api.ts 的 createManualInboundQuote；Backend baiyue-firstleg/firstleg/src/main/java/com/baiyue/firstleg/service/FbaPricingService.java 的 manualQuote，联查 PlatformFbaPricingController、fba-pricing-v1.yaml；Client 快照类型 apps/client-web/src/modules/first-leg/types/inboundBilling.ts |
| 退货换标候选、退货单创建换标 | 客户退货库存进入换标申请，区别于平台审核与 PDA 签收 | baiyue-firstleg/lastleg-service/src/main/java/com/baiyue/lastleg/returnreceipt/controller/MerchantReturnOrderController.java 的 GET /{returnNo}/relabel-candidates、POST /{returnNo}/relabel → ReturnReceiptService.relabelCandidates/createRelabel；公共前缀 /api/merchant/v1/last-leg/return-orders，客户范围取认证身份 |
| 退货审核、退货驳回、换标审核 | 先区分退货预报准入与换标申请审核，均不是仓储转运审核 | 退货预报 apps/admin-web/src/modules/overseas-warehouse/pages/LastMileOrdersView.vue；换标申请 apps/admin-web/src/modules/overseas-warehouse/pages/RelabelOrdersView.vue；条件与 API 见该模块 AGENTS.md |
| PDA版本、安装包下载、热更新、发布版本、停发 | 平台管理版本与设备检查更新分开定位，先区分国内/海外 PDA | 管理页 apps/admin-web/src/modules/pda-releases/pages/PdaReleasesView.vue；设备更新为国内 apps/pda-uniapp/utils/app-update.js、海外 apps/pda-overseas-uniapp/src/utils/app-update.js；后端查 baiyue-firstleg/file/AGENTS.md |
| 收货、入库、测量、称重 | 国内到仓称重或测量弹框 | apps/admin-web/src/modules/inbounds/；业务路由查“到仓测量” |
| 仓储转运测量、转运打托、转运托盘标签 | 海外 PDA 逐托实测、生成新托盘号与扫码绑定，不是 Admin 转运审核或排车转派送 | apps/pda-overseas-uniapp/src/pages/warehouse-transfer/warehouse-transfer.vue → apps/pda-overseas-uniapp/src/api/warehouse-transfers.js；约束与回归见该应用 AGENTS.md |
| 接柜、卸柜、收货、签收 | 海外 PDA 柜号认领、照片、实收 | apps/pda-overseas-uniapp/src/pages/operation/operation.vue；后端查 ReceivingContainerService |
| 入仓计划、生成计划、按柜生成 | 平台尾程订单预览与确认，不是现场实收 | apps/admin-web/src/modules/overseas-warehouse/pages/LastMileOrdersView.vue；后端查 ContainerInboundPlanConversionCoordinator |
| 审核、审单、批量审核 | 客户头程订单待审核 | apps/admin-web/src/modules/unified-orders/；后端查 BatchOrderReviewPreviewService |
| 订单审核、头程订单审核、批量审单 | 平台审核客户头程订单，状态以 Order SUBMITTED 和服务端 canApprove/blockReason 为准；不要按仓储转运审核定位 |
Admin apps/admin-web/src/modules/unified-orders/；Client 只读订单状态查 apps/client-web/src/modules/first-leg/；Backend baiyue-firstleg/order/ 的 BatchOrderReviewPreviewService、PlatformFirstLegOrderController |
| 审核、测量审核、实测审核 | 仓库测量结果审核 | baiyue-firstleg/firstleg/AGENTS.md 中“审核与初始计价”；页面先查 Admin 入库模块 |
| 费用、运费、报价、计费、船期价格表、价格簿 | 单票入仓计价、客户专属报价或调价 | apps/admin-web/src/modules/inbounds/fee/、apps/admin-web/src/modules/fba-pricing/carrier-rates/pages/CarrierRatesView.vue（列表/上传）、apps/admin-web/src/modules/fba-pricing/carrier-rates/pages/CarrierRateDetailView.vue（版本详情/映射确认）；后端查 FbaPricingService |
| 柜费、公共费用、分摊 | 国内柜费来源归 Firstleg；海外柜费来源归 Lastleg；账单与结算结果归 Finance | 业务路由查“财务管理与柜级公共费用分摊”或“海外业务费用来源与客户财务”，按实际请求区分 |
| 钱包、充值、余额、授信、账单、核销 | 客户自助与平台管理先按终端区分 | Client apps/client-web/src/modules/finance/；Admin apps/admin-web/src/modules/finance/ |
| 客户账单、客户对账单、账单确认 | 客户查看和确认本企业账单，不是平台柜费分摊或充值审核 | Client apps/client-web/src/modules/finance/views/FinanceBillsView.vue；Admin 平台账单查 apps/admin-web/src/modules/finance/；Backend baiyue-firstleg/finance/ 的 Client Finance Controller |
| 自动生成托盘、托盘码没生成、计划齐全、重试生成托盘码 | 海外入库计划保存后资源生成，不是国内托盘标签打印 | Admin apps/admin-web/src/modules/overseas-warehouse/pages/LastMileOrdersView.vue；Backend baiyue-firstleg/lastleg-service/docs/business-index.md 的“人工计划自动生成托盘与资源重试”，执行规则先读该服务 AGENTS.md |
| 托盘码、托盘标签、补打 | 先区分散货装柜、一件代发和海外实体托盘 | 散货 apps/admin-web/src/modules/loading-lists/components/PalletLabelPrintDialog.vue；一件代发 apps/admin-web/src/modules/inbounds/core/DropshipPalletPrintPanel.vue，从订单“托盘打印”页签进入；海外单张打印 apps/admin-web/src/modules/overseas-warehouse/pages/PalletsView.vue，详见各应用/模块指引 |
| 箱码、箱唛、箱标、单箱扫码 | 单箱身份与测量，不是托盘或库位 | 业务路由查“箱唛、箱码与单箱测量”；后端查 InboundCartonLabelService |
| 库位、托盘、占位、释放 | 国内资源归 Warehouse；海外资源归 Warehouse Overseas；海外库存业务归 Lastleg | 业务路由查“称重确认”或“海外库位”；仓库名称/地址查“海外仓库主档” |
| 拖车、派车、提柜、还柜 | 国内订舱拖车与目的港码头车队是不同业务；海外配送排车另属 Lastleg | 国内 apps/admin-web/src/modules/trucking/；目的港 apps/admin-web/src/modules/container-loading/api/terminalDrayages.ts；配送查“海外出库、排车” |
| 报关资料、退税资料、完成文件 | 平台整柜操作与客户订单上传先按终端区分 | Admin apps/admin-web/src/modules/container-loading/components/ContainerCustomsPanel.vue；Client apps/client-web/src/modules/first-leg/components/CustomsDocumentsDialog.vue |
| 退货、退货预报、退货换标、退货签收、退货合箱 | 客户退货预报及签收库存，区别于派送异常退回 | Client apps/client-web/src/modules/overseas-warehouse/views/ReturnOrdersView.vue；Admin apps/admin-web/src/modules/overseas-warehouse/pages/ReturnInventoryManagementView.vue；PDA apps/pda-overseas-uniapp/AGENTS.md；Lastleg returnreceipt/，见下文“退货预报、签收、库存与合箱” |
| PDA 出库、PDA 发车、扫码出库、整托出库 | 海外 PDA 执行排车和出库，不是平台排车配置或客户派送查询 | 海外 PDA apps/pda-overseas-uniapp/src/pages/dispatch/dispatch.vue、src/api/fulfillment.js；Backend baiyue-firstleg/lastleg-service/dispatch/pda/；统一经 gateway/ |
| 异常、退回、退仓、回访 | 派送异常退回与库存退货业务不可混用 | 派送查 apps/admin-web/src/modules/overseas-warehouse/pages/ExceptionOrdersView.vue；退货预报/库存查 Lastleg returnreceipt/ |
| 仓储转运审核、转运通过 | 平台转运审核通过弹框 | apps/admin-web/src/modules/overseas-warehouse/components/WarehouseTransferReviewDialog.vue |
| 转运驳回、REJECT | API 审核结论；当前弹框无此动作 | apps/admin-web/src/modules/overseas-warehouse/api/warehouseTransfers.ts 的 reviewWarehouseTransfer；界面能力查最近指引 |
业务快速路由表
| 业务 | 首个代码入口 | 边界正文（仅需要规则时读） |
|---|---|---|
| 登录认证 | 模块指引 | 对应章节 |
| 客户与企业 | 模块指引 | 对应章节 |
| 供应商与国内整柜 | 模块指引 | 对应章节 |
| 平台收货仓 | 模块指引 | 对应章节 |
| 头程订单、批量审核预览与入仓码关系 | 模块指引 | 对应章节 |
| 客户头程订单批量导入 | 模块指引 | 对应章节 |
| 平台旧系统订单导入 | 模块指引 | 对应章节 |
| 平台修改客户原始申报与履约渠道 | 模块指引 | 对应章节 |
| 脚本管理、全量验证与测试造数 | 模块指引 | 对应章节 |
| 平台/企业 RBAC | 模块指引 | 对应章节 |
| 消息中心与站内通知 | 模块指引 | 对应章节 |
| PDA 拣货与柜级装柜证据 | 模块指引 | 对应章节 |
| 到仓测量、测量库位、箱规策略与头程计费 | 模块指引 | 对应章节 |
| 客户专属报价、柜级阶梯运费与费用调整 | 模块指引 | 对应章节 |
| 箱唛、箱码与单箱测量 | 模块指引 | 对应章节 |
| 称重确认、整票库位块与部分拣货资源结算 | 模块指引 | 对应章节 |
| 入库扣货、解除与凭证 | 模块指引 | 对应章节 |
| 财务管理与柜级公共费用分摊 | 模块指引 | 对应章节 |
| 平台资金账户、充值审核、手工充扣与授信 | Admin 财务 | 资金账户规则 |
| 客户资金账户、余额、授信与充值申请 | Client 财务 | 资金账户规则 |
| 服务端资金账户、授信、冻结、结算与业务扣费 | Finance | 资金账户规则 |
| 订单编排、分柜、同柜不可拆组与柜次 | 模块指引 | 对应章节 |
| 全局智能排柜、预装与真实集装箱号后补 | 模块指引 | 对应章节 |
| 客户入库结果与头程费用确认 | 模块指引 | 对应章节 |
| 订舱资料、放舱、出仓前船期与订舱级拖车 | 模块指引 | 对应章节 |
| 目的港码头拖车与还空预警 | 模块指引 | 对应章节 |
| 整柜报关资料与完成文件 | 模块指引 | 对应章节 |
| 国内出仓确认 | 模块指引 | 对应章节 |
| 客户统计与运营指标 | 客户模块 | 统计与日志边界 |
| 平台日志、操作日志、审计日志与操作人缺失 | 审计模块 | 统计与日志边界 |
| 客户工作台账户与设置 | 模块指引 | 对应章节 |
| 企业订单与跨境业务 | 模块指引 | 对应章节 |
| 海外接柜、入库与库内库存 | 模块指引 | 对应章节 |
| 尾程订单控制与柜级入仓计划转换 | 模块指引 | 对应章节 |
| 海外仓 PDA | 模块指引 | 对应章节 |
| 海外采购、本土卡车与散板 | 模块指引 | 对应章节 |
| 采购样品、货款、装箱清单、面单、预估快递费、国内收货寄客户 | 模块指引 | 对应章节 |
| 海外仓库主档、名称、地址与能力 | 前端 Admin；后端 Warehouse | 资源归属 |
| 海外库位、托盘与资源锁 | Warehouse Overseas | 资源归属 |
| 车辆管理、司机证照、保养加油、车辆维修/故障/救援/异常、外接货与车次 | 模块指引 | 对应章节 |
| 拼车需求池、车次余位、销售拼车意向 | 模块指引 | 对应章节 |
| 国内出仓后船节点 | 模块指引 | 对应章节 |
| 海外出库、排车、派送、异常与回访 | 模块指引 | 对应章节 |
| 海外业务费用来源与客户财务 | 模块指引 | 对应章节 |
| 自营销量与领星统计 | 模块指引 | 对应章节 |
| 预约管理与工作日历 | 模块指引 | 对应章节 |
| 退货预报、签收、库存与合箱 | 模块指引 | 对应章节 |
| 散货托盘码生成、打印与跨区传递 | 模块指引 | 对应章节 |
原型入口索引
仅在根指引的原型触发条件满足时读取。路径从工作区根起算；按终端只查命中行，不把原型当作当前部署或验收事实。
| 范围 | 首选入口 |
|---|---|
| 平台管理后台 | docs/悦/货代SAAS平台后台/AGENTS.md，按其中模块索引读取拆分原型；完整入口 docs/悦/货代SAAS平台后台/index.html |
| 企业客户端栏目与业务架构 | docs/悦/柏悦物流客户端/柏悦物流客户端-栏目架构图.html |
| 企业工作台与头程下单 | docs/悦/官网头程下单/workbench.html |
| 官网与企业入口 | docs/悦/官网头程下单/index.html、docs/悦/官网头程下单/login.html、docs/悦/官网头程下单/register.html |
| 微信小程序 | docs/悦/虫虫出海小程序/index.html |
| PDA 拣货 | docs/悦/PDA拣货/pda-picking.html |
| WMS 字段补充 | docs/悦/货代SAAS平台后台/wms_full_data.json、docs/悦/货代SAAS平台后台/柏悦WMS系统文档.md |
| 国内货柜履约原型盘点 | docs/国内货柜履约/国内货柜履约页面与原型清单.md |
| 海外仓全流程 | 海外仓页面 ID |
| 海外仓 PDA | apps/pda-overseas-uniapp/AGENTS.md、apps/pda-overseas-uniapp/src/data/overseas-workbench.js、apps/pda-overseas-uniapp/src/pages/operation/operation.vue 与海外仓页面 ID |
| Admin/Client 验收 | docs/Admin-Client前端原型还原验收规则.md |