admin-web/src/modules/inbounds/AGENTS.md

Admin 入库模块指引

路径基准与读取顺序

• 本文件适用于 src/modules/inbounds/，代码路径相对本目录；应用公共规则见 ../../../AGENTS.md，字段与计费细则见 ../../../docs/business-index.md。
• 模块按子域分目录：measurement/（测量）、review/（测量审核）、weight/（称重与 OCR）、fee/（费用与人工定价）、core/（入库单公共）。先定子域再进文件。
• 后端入口为 firstleg/（测量、审核、计价、扣货、称重库位）与 warehouse/（库位）；仅涉及展示、文案且不涉及接口、权限、状态、金额或数据归属时，默认不读后端；涉及上述边界时沿实际 API 进入对应服务。

页面与入口

目标	页面/子域入口	API 与后端
订单测量列表与工作区	pages/InboundMeasurementsView.vue、components/InboundWorkflowWorkspace.vue；inbounds/measurements	measurement/api.ts；firstleg/service/InboundMeasurementService.java
测量弹框、测量面板、尺寸策略与证据图	measurement/InboundMeasurementDialog.vue（组合壳）、measurement/InboundMeasurementPanel.vue（数据与操作）、measurement/components/MeasurementEvidenceThumbnail.vue	实际请求在 measurement/InboundMeasurementPanel.vue → measurement/api.ts → 平台链路 firstleg/controller/PlatformInboundMeasurementController.java → firstleg/service/InboundMeasurementService.java、MeasurementSubmissionService.java；设备上报是另一条链路（MojiaMeasurementOpenApiService），不要混；弹框只组合面板与 OCR 面板，不直接调接口
测量数据审核	pages/MeasurementReviewsView.vue、review/MeasurementReviewPanel.vue；inbounds/measurement-reviews	review/api.ts；firstleg/service/MeasurementReviewService.java、firstleg/service/InitialInboundPricingService.java
称重图片、OCR 与库位槽状态	weight/components/WeightOcrPanel.vue、weight/components/WeightImageThumbnail.vue	weight/api/weightOcr.ts；firstleg/service/MeasurementLocationOccupationService.java、firstleg/service/MeasurementSubmissionService.java
入库单列表、摘要与历史	pages/InboundOrdersView.vue、core/InboundSummaryPanel.vue、core/InboundHistoryPanel.vue；inbounds	core/api.ts、core/types.ts；firstleg/service/InboundOrderQueryService.java
FBA 人工定价（无匹配价格）	fee/InboundFeePanel.vue	fee/api.ts 的 /manual-quote；firstleg/service/FbaPricingService.java
一件代发托盘打印	core/DropshipPalletPrintPanel.vue	core/api.ts；print/；仅一件代发订单展示

关键边界

• 客户四档箱规与默认算法（ADD/MULTIPLY）的规则正文在详细索引维护；本模块只按 ../dimension-config/ 消费，保存后以外箱尺寸、体积重和计费基数只认服务端返回值，页面不独立重算。
• 费用确认的实际箱数、毛重和体积取值口径以详细索引“入库、测量”节（actualMeasurementRows）为准，本文件不复制该规则。
• 称重卡片只展示服务端 locationCode/slotStatus/sharedOverflow，不渲染或推导整票预留引导；删除图片须提示该槽位仍归本票保留，不按图片下标推导托盘或库位。
• 人工定价仅 FBA、已有实际测量且价格未命中时开放，客户已确认费用禁止改价；MANUAL_QUOTE 不伪造价格簿关联。
• 扣货与解除、凭证下载走 ../unified-orders/ 与 ../inbounds/ 的正式入口，本模块不另建凭证链路。

验证

• 定向：pnpm test src/modules/inbounds/<目标测试>；计费或库位相关变更同时核对 firstleg 对应合同测试。
• 本文件或索引变更后，从后端根运行 ./scripts/agents-index-contract.ps1。