docs/归档/头程到尾程/头程下单到尾程出库流程易用性与数据流转优化方案.md

头程下单到尾程出库流程易用性与数据流转优化方案

目标：在现有端到端流程已经走通的基础上，降低学习成本、重复录入、跨页面查找和交接等待，让每个岗位始终知道“货在哪里、现在由谁处理、为什么不能继续、下一步做什么”。
基线流程：见《头程下单到尾程出库全流程操作手册》。
边界：本方案优先复用现有 Admin、Client、国内/海外 PDA、Gateway、Order、Firstleg、Lastleg 和 Warehouse 能力，不新建平行状态机，不引入第二套订单或跨区同步写链路。

当前状态：现状全景和六阶段基线已经完成；本文进入分阶段业务评审，暂不直接作为实施基线。AI 分析和评审记录统一遵循《头程到尾程 AI 流程优化上下文包》，逐项决定保留、合并、自动化、简化或删除。

1. 优化后的成功标准

流程是否“能走通”只代表功能闭环；易用性优化完成后还应同时达到：

1. 操作员进入一个单据后，10 秒内能回答当前阶段、下一动作、责任岗位和阻断原因。
2. 同一业务事实只录一次，后续阶段自动带出并注明来源、冻结时间和是否可修改。
3. 每次操作完成都明确展示“产生了什么结果、下一步去哪里”，并提供可点击入口。
4. 异步跨区操作不再表现为“点完没反应”，页面可见待投递、处理中、成功或失败。
5. PDA 扫错时直接说明“扫到了什么、为什么不匹配、正确应该扫什么”，而不是只返回错误码。
6. 列表默认突出需要当前岗位处理的记录，不要求用户同时理解全部内部状态。
7. 批量操作在提交前有预览，提交后有逐项结果和可重试项，不能整批静默失败。
8. 所有阶段以服务端 nextAction/allowedActions/blockers 为准，页面不自行猜测资格。
9. 数据跨服务、跨区域流转可追踪、可重放、可对账，但业务人员不需要接触内部 ID。

2. 当前主要问题

2.1 操作层问题

问题	当前表现	业务影响
页面按模块拆开，缺少一票到底视角	订单、测量、货柜、出仓、船节点、尾程、入仓、排车、出库分别查询	操作员反复复制订单号、入仓码和柜号，交接依赖群消息
状态多但不回答下一步	页面显示 WAIT_SPLIT、PENDING_ASSIGNMENT、READY_TO_DEPART 等编码映射	新员工知道状态名但不知道该去哪个菜单、找哪个岗位
阻断原因与修复入口分离	门禁面板告诉用户缺报关、缺车辆或缺计划，但需要自行找页面	处理时间长，容易重复点击同一操作
操作成功提示过轻	常见结果只有“保存成功”或“提交成功”	用户不清楚是否建了入库单、出库单、派送单或跨区任务
相同信息重复填写	车辆、司机、目的仓、箱数、费用来源、预计时间在不同阶段重复录入	容易产生快照不一致和人工抄错
异步流转不可见	国内完成后海外页面暂时没有数据，只能等待刷新	用户误判失败，重复操作或要求技术人员查库
PDA 错误反馈缺现场语义	扫错托盘/箱唛时只知道失败，不知道资源实际归属	仓库人员需要退出任务或电话询问后台
批量能力缺少统一反馈	批量导入、审核、排柜、计划转换各自反馈形式不同	错误定位和重试成本高

2.2 数据流问题

问题	风险
交易状态、履约状态、费用状态、子单状态被用户当成一个状态理解	页面互相覆盖或展示“倒退”，实际只是不同状态维度
同一字段在多个服务留有快照，但页面不显示来源	用户无法判断当前值来自客户申报、实测、计划还是实际作业
跨区事件处理结果缺少业务可见回执	事件已发送、消费失败、资源生成失败等场景只能从日志判断
单据间只有内部 ID 关联，缺少统一业务链查询	客服无法用订单号/入仓码直接查到柜、尾程计划、排车和出库
自动动作和人工动作混在同一历史里	无法快速判断是系统自动收敛、第三方回传还是人工补录
同步调用失败与业务失败提示不分	操作员不知道应补资料、刷新版本还是等待系统重试
分页列表承担跨柜/跨客户聚合	容易出现只看当前页就做整柜判断的问题

3. 总体产品方案

3.1 一票到底进度条

在 Client 订单详情和 Admin 统一订单详情顶部增加同一套业务阶段条：

订单提交 → 国内入库 → 测量/组托 → 待分柜 → 国内装柜 → 国内出仓
→ 海运在途 → 海外计划 → 海外入仓 → 海外排车 → 海外出库 → 派送完成

每个节点只展示四种用户可理解状态：未开始、处理中、已完成、异常。点击节点进入对应详情或只读摘要。

阶段条不能根据前端已有字段自行拼装，应由服务端聚合返回：

• currentStageCode/currentStageName：当前主阶段；
• stageStatus：阶段状态；
• nextActionCode/nextActionName：下一动作；
• ownerRole/ownerName：当前责任岗位；
• blockers[]：阻断码、中文原因、修复建议和跳转目标；
• relatedDocuments[]：相关业务单号、状态和详情入口；
• lastChangedAt：最后业务变化时间；
• asyncState：无异步任务、处理中、成功、失败待重试。

实现上优先扩展现有统一订单聚合、柜级 overview 和尾程柜级 summary，不新建另一套可写流程引擎。

3.2 “现在做什么”任务卡

列表第一列保持“操作”，并在状态旁增加任务卡：

• 当前需要我做：例如“审核订单”“补称重图片”“确认预装”“转换海外入仓计划”“维护车辆”“先转派送”。
• 为什么：显示最多两条最高优先级阻断原因。
• 去处理：直接深链到目标弹窗、页签或 PDA 作业。
• 谁负责：当前角色无权限时显示责任岗位和只读说明，不显示无效按钮。
• 完成期限：按业务 SLA 显示剩余时间或超时标记。

服务端必须返回稳定动作编码；页面只负责中文展示和路由，不根据状态组合重新推导动作。

3.3 操作完成回执

所有关键写操作采用一致的结果反馈，而不是单纯 Toast：

当前操作	回执必须告诉用户
提交订单	订单号、入仓码、当前状态、下一步由平台审核
审核通过	已生成的国内入库单/箱码、下一步国内仓测量
测量审核通过	是否进入待分柜或待组托、费用是否已生成
预装确认	PDA 任务是否已生成、缺真实柜号时的明确提醒
国内装柜完成	装柜结果、报关状态和国内出仓门禁摘要
国内出仓	船节点任务是否创建、第一条节点和海外异步建单状态
海外计划转换	计划数量、托盘数量、资源结果和 PDA 是否可接柜
海外整柜入仓完成	实收箱数、库存/托盘/库位结果和下一步排车入口
转派送	出库单号、按目的仓拆分的派送单号、发车尚缺条件
PDA 发车	已出库箱数、排车单/出库单终态和后续派送入口

回执应支持“查看结果”和“继续处理下一票”，避免保存后返回一个没有上下文的列表。

4. 分阶段易用性优化

4.1 客户下单

现状操作：一个较长表单或 XLSX 导入，保存草稿后再提交。

优化：

• 用“运输与仓库 → 货物 → 提货/目的信息 → 确认提交”四步向导组织表单。
• 顶部常驻草稿保存状态；字段失焦自动保存草稿，但最终提交仍由用户明确点击。
• 选择目的类型后只展示相关字段：FBA 显示 FBA 仓，海外仓显示公共目的仓，私人仓显示地址。
• 仓库、渠道、目的仓下拉显示业务名称、代码、地址和可用状态，不展示内部 ID。
• 提交前集中展示校验清单，点击错误可滚动到对应字段。
• 批量导入先预览“可创建、需修正、重复”三组；错误报告可按原行号下载，修正后只重试失败行。
• 提交成功回执直接展示入仓码，并提供复制、打印箱唛和查看订单进度入口。

数据优化：客户端只提交用户输入；仓库名称、地址、渠道名称和客户归属由服务端验证后冻结快照，避免客户端抄写。

4.2 平台订单审核

现状操作：列表定位，打开详情或批量预览后审核。

优化：

• 默认进入“待我审核”，按提交时间和加急程度排序。
• 列表直接展示入仓码、目的类型、目的仓、渠道、箱数/体积/重量和阻断摘要。
• 批量预览用“可通过/需补资料/系统异常”分组；只允许勾选可通过项。
• 修改客户申报时做前后对比，标出会影响渠道、计价和排柜的字段。
• 审核通过后自动跳转“下一票”或进入本票进度页，不要求重新筛选。

数据优化：审核只推进 Order 权威状态；Firstleg 建单结果通过明确回执返回。Firstleg 暂时不可用时显示“审核已提交/建单待收敛”或失败原因，不能把部分成功伪装为整体成功。

4.3 国内收货、测量与费用

现状操作：按入仓码查询，测量和称重分多次录入，费用在另一工作区处理。

优化：

• 提供“扫码入仓码进入本票”入口，落地后固定显示客户、订单、目的仓和应收箱数。
• 将尺寸、称重、图片、审核和库位块放在同一作业页的连续步骤中。
• OCR 列表突出低置信度、单位异常和重复图片；批量确认高置信度结果。
• 每条实测数据展示“客户申报值 vs 当前实测值 vs 计费采用值”，差异超阈值自动提示。
• 审核不通过必须选择标准原因，可一键生成待修正任务；修正后回到原审核人队列。
• 费用卡明确标注“费用处理不阻断待分柜”，避免运营等待费用后才排柜。
• 客户收到费用后在订单进度中直接确认，无需进入独立财务菜单寻找。

数据优化：尺寸原始值、修正值、计费值分字段保存；页面必须显示来源，禁止覆盖原始数据。费用用版本号关联测量快照，不复制一套无法追溯的合计。

4.4 分柜、订舱和预装

现状操作：在模拟柜、智能装柜、订舱和预装详情之间切换。

优化：

• 建立柜级工作台，顶部固定显示柜次号、真实柜号、订舱、渠道、仓库、容量、重量和下一动作。
• 左侧候选、右侧已装计划保持筛选和滚动位置；加入后即时显示容量/重量变化。
• 候选行直接说明不可加入原因，例如“待审核占位可加入，但暂不能确认预装”。
• 同柜组、一件代发整托用不可拆分卡片展示，避免用户误以为可按行拆分。
• 订舱放舱、柜次关联、真实柜号、预装确认形成同页检查清单。
• 真实柜号未填时提供醒目待办；正式操作口径统一在预装确认前补齐。
• 确认预装前显示最终成员、箱数、托盘、容量、重量、费用重算影响和将生成的 PDA 任务。

数据优化：所有柜级动作使用稳定 containerBookingId，cabinetNo/containerNo 只作为业务展示身份。预装预览必须来自服务端完整柜级结果，不能使用当前分页数据拼装。

4.5 国内 PDA 装柜

现状操作：领取任务、逐箱或整托扫描、本地形成草稿、批量提交、上传证据并完成。

优化：

• 首页默认显示当前仓、当前任务、已扫/应扫、异常数和网络状态。
• 普通箱、一件代发托盘使用不同颜色和提示音，避免将整托按箱扫描。
• 扫描成功即时显示货物、入仓码、目标柜和累计数；错误显示扫描对象实际归属。
• 批量提交前展示新增、重复、错柜和待处理异常四类统计。
• 五类证据使用固定槽位和进度 0/5…5/5；铅封照片和铅封号在同一步完成。
• 最终完成页只展示服务端门禁，缺哪项就提供对应操作入口。
• 网络中断保留本地扫描草稿和同一幂等键；恢复后先对账服务端已接收项，再允许重试。

数据优化：箱码、托盘码、柜次和任务全部由服务端解析归属；PDA 不提交客户或猜测仓库范围。批量响应返回逐项结果及服务端最新任务版本。

4.6 报关和国内出仓

现状操作：装柜完成后在报关、柜次详情或国内出仓页处理。

优化：

• 柜次详情新增“离仓准备度”，用 7 个门禁卡片显示已完成/阻断。
• 每个阻断卡片提供深链：去解除扣货、查看 PDA、补证据、完成订舱、处理报关。
• 明确标注拖车和独立船期“仅供参考，不阻断国内出仓”。
• 报关完成后的自动确认展示为“系统正在确认离仓”；自动失败时才开放人工处理，并显示失败原因。
• 离仓成功回执展示船节点任务号和异步海外建单状态。

数据优化：门禁由 Firstleg 整柜锁定重算。页面不缓存门禁结论；执行前后都读取最新版本。自动与人工确认复用同一命令和幂等语义。

4.7 船节点和跨区建单

现状操作：多个页面可查看船节点；跨区建单需要等待刷新。

优化：

• 柜级时间线同时展示预计节点、实际节点、异常和数据来源，预计/实际视觉区分。
• PICKUP_READY 节点旁明确显示“海外 PDA 已开放/尚未开放”。
• 增加跨区处理卡：国内事件已生成、已投递、海外已接收、尾程订单已生成、资源待转换。
• 超过预期时间仍未建单时，平台可查看业务化失败原因并触发受控重试；不能直接补数据。
• 同一柜多客户时用柜级聚合显示事件状态，再进入每票结果，避免逐票判断整柜完成。

数据优化：跨区状态使用 eventId + aggregateId + schemaVersion + payloadHash 追踪。国内只发布事实，海外只消费并幂等建单；禁止跨区同步双写数据库。

4.8 海外入仓计划转换

现状操作：按柜查看、预览、处理阻断后确认转换。

优化：

• 柜级卡片直接显示订单数、待建计划数、资源待补数、预计到仓和准备度。
• 转换弹窗用三栏对比“头程已有托数、海外补充托数、最终托数”。
• 阻断项按可操作性排序，并提供修复入口；例如缺预计到仓、目的仓异常、托盘资源失败。
• 转换后展示逐票计划结果及托盘码，支持只重试 resourcePendingPlanCount 指向的资源异常。
• 已转换柜仍可查询，但主按钮改为“查看/维护计划”，避免用户误以为要重复转换。

数据优化：预览返回 snapshotVersion/snapshotHash；提交只回传该快照标识和明确选择。服务端锁柜重算，避免页面停留期间数据变化导致错建计划。

4.9 海外 PDA 接柜入仓

现状操作：选择柜、三类照片、按两种模式实收、完成整柜。

优化：

• 待收柜按可作业、未到 PICKUP_READY、资源未齐分组；后两组只读显示原因。
• 进入柜后顶部固定显示柜号、当前操作员、开始时间、总计划/实收/待收。
• 三类照片采用顺序引导，可重拍但保留审计；完成后自动进入收货，不返回列表。
• FBA 页只显示“SKU + 本次箱数”，OVERSEAS 页只显示“箱唛逐箱”，从交互上消除模式混用。
• 扫托盘后显示托盘已含入仓码和剩余容量，合托时提示来源组成。
• 整柜完成前用入仓码列表标红未核平项，点击直接继续收货。
• 完成回执显示库存、托盘、库位和国内回写状态。

数据优化：柜级会话只绑定物理柜和实际接柜仓；每票实收、库存和托盘组成仍按客户隔离。PDA 不上传客户 ID 或仓库 ID。

4.10 海外排车、转派送和出库

现状操作：智能预排、编辑车辆、转派送、PDA 拣货、发车。

优化：

• 排车候选默认只显示可用库存，暂扣、换标未确认、已锁定的托盘直接说明不可选原因。
• 预排草稿常驻显示托数、箱数、重量、目的仓、车型容量和超限值。
• 加入/移除托盘时即时显示锁状态；离开未提交草稿时二次确认并释放锁。
• 编辑排车时从车辆主数据带出车牌、司机、电话和车队，可覆盖的字段明确标识。
• “转派送”放在排车详情主流程位置，不藏在更多菜单；未转派送时 PDA 发车页显示平台待办。
• 转派送自动带出排车、车辆、目的仓、箱数和预约资料，只要求补充缺失字段及费用。
• 提交前预览将生成的一张出库单和按目的仓拆分的派送单。
• PDA 拣货页固定显示 canDepart；未满足时将服务端阻断原因翻译为动作提示。
• 发车成功回执显示出库单已完成、库存扣减数、派送单清单和下一责任岗位。

数据优化：排车、出库、派送是三张单据，各自状态独立；转派送只创建一次。库存扣减发生在 PDA 成功扫码事务，发车只推进排车和出库状态，防止重复扣减。

5. 数据归属与流转优化

5.1 权威数据归属

数据	权威服务	下游使用方式
客户、账号、角色、仓库绑定	IAM/Auth	Token 和服务端身份校验，不接受页面自报客户范围
头程订单、客户申报、订单交易状态	Order	Firstleg 使用版本化事件/内部 DTO，不反向覆盖客户申报
国内入库、实测、费用快照、柜次、装柜、出仓、船节点	Firstleg	Admin/PDA 读写正式 API；向海外发布最终实装事实
国内/海外公共仓库主档	Warehouse	其他服务按 warehouseId 引用并冻结必要快照
海外库位、实物托盘和资源锁	Warehouse Overseas	Lastleg 使用内部资源接口，不复制第二套仓库主档
尾程订单、海外计划、库存、排车、出库、派送	Lastleg	Admin/Client/海外 PDA 经海外 Gateway 访问
文件	File	业务服务只保存已校验文件 ID 和业务归属
国内财务主账	Finance	海外费用通过事件入池，不跨区同步改钱包

5.2 业务主键链

对用户可见的链路检索顺序统一为：

orderNo / inboundCode
  → cabinetNo / containerNo
  → tailOrderNo / planNo
  → palletNo
  → dispatchNo
  → outboundNo
  → deliveryNo

建议所有详情页提供“关联单据”侧栏，允许用任意一个业务号跳到上游和下游。内部数据库 ID 只留在接口和诊断信息中，不作为页面回退编号。

5.3 快照来源标识

页面展示容易混淆的字段时增加来源标签：

字段	可能来源	页面要求
箱数、重量、体积	客户申报、仓库实测、国内实装、海外实收	同时展示当前采用值与来源，历史值可展开
仓库/目的仓	下单选择、柜级计划、实际接柜仓	名称旁标注“国内来源仓/实际接柜仓/FBA目的仓”
托数	头程推荐、头程已有、海外补充、海外最终	转换预览分别展示，不把补充数写成最终总数
预计/实际时间	客户期望、订舱 ETA、预计到仓、实际到仓	用不同字段和标签，不用创建时间回退
状态	主流程、审核、费用、子单	分区展示，不用子单状态覆盖主状态

5.4 异步事件可观测

每个重要异步交接保留统一回执：

• 事件名称、业务单号和来源阶段；
• eventId、版本、发生时间、投递时间、接收时间；
• 当前状态：待发送、发送中、已接收、已处理、失败待重试、永久失败需人工；
• 重试次数和最近失败的业务化原因；
• 下游生成的业务单号；
• 是否允许受控重试。

业务页面只展示业务化摘要；requestId/traceId/eventId 放在“诊断信息”中供技术支持复制。

5.5 一致性规则

1. 写操作携带 expectedVersion 和幂等键；版本冲突必须刷新，不能由前端自动覆盖。
2. 同一业务操作超时后先查幂等结果；不能自动换新键重复提交。
3. 跨服务写入使用本地事务 + Outbox/Inbox，不做国内、海外数据库分布式双写。
4. 聚合页只做读模型，不成为新的权威数据源。
5. 计划、门禁和转换必须基于完整柜级/任务级查询，不能用当前分页记录判断整体完成。
6. 自动动作与人工动作使用同一服务命令，但历史记录明确 SYSTEM/USER/THIRD_PARTY 来源。
7. 下游快照只在规定时点冻结；上游主数据之后变化不静默覆盖历史单据。

6. 共性交互规范

6.1 状态展示

• 主标题用中文业务状态，稳定编码放在悬浮说明或诊断区。
• 每页最多突出一个主状态；审核、费用、库存和子单状态分组展示。
• “等待系统处理”和“等待人工处理”使用不同颜色和图标。
• 终态不继续显示无效主按钮。

6.2 按钮与门禁

• 主按钮文案使用业务结果，例如“确认离仓”“转换整柜入仓计划”“完成整柜入仓”“转派送并生成出库单”。
• 禁用按钮必须能查看原因；有修复入口时直接跳转。
• 危险或不可逆操作在确认框中展示影响范围、将生成/冻结的单据和是否可撤销。
• 批量操作先预览，提交后逐项回执。

6.3 搜索与定位

• 所有跨阶段列表至少支持订单号、入仓码、柜次号和真实柜号中的适用项。
• 海外阶段继续支持计划号、托盘号、排车单号、出库单号和派送单号。
• 最近搜索和筛选在返回列表时保留。
• 扫码字段自动识别业务码类型；无法识别时提示允许的码，而不是当作普通关键词无结果。

6.4 错误反馈

错误消息统一包含：发生了什么、为什么、用户现在能做什么。示例：

暂不能发车：平台尚未完成“转派送”，当前排车还没有待出库单。
请联系海外运营在排车详情完成转派送后刷新本页。

不要向业务用户直接展示内部数据库 ID、SQL 异常或只有 A0409 的提示。业务码、requestId 和 traceId 收在可复制的诊断详情中。

7. 优先级建议

P0：先解决“找不到下一步”和“数据是否流转成功”

1. 在统一订单、柜次、尾程订单、排车详情增加当前阶段、下一动作、责任岗位、阻断原因。
2. 国内出仓、跨区建单、海外计划转换、转派送和发车增加标准操作回执。
3. 所有门禁项增加修复深链。
4. 增加跨区事件业务状态卡，覆盖国内装柜到海外尾程建单、海外卸柜到国内回写。
5. 海外 PDA 发车严格展示 canDepart/departBlockReason；错误改为现场可执行文案。
6. 转派送提交前预览出库单和派送单，成功后直接展示业务单号。
7. 统一关联单据侧栏和业务编号全链搜索。

P0 不改变核心状态机，主要是聚合查询、反馈和导航，风险相对较低。

P1：减少重复输入和跨页面操作

1. 客户下单四步向导、自动保存草稿和集中校验。
2. 审核、测量、排柜、海外计划的批量预览与逐项回执统一。
3. 柜级工作台整合订舱、真实柜号、预装、PDA、报关和出仓准备度。
4. 海外收货完成后直接提供“查看库存/创建排车”动作。
5. 排车编辑从车辆主数据带出司机、电话和车队；转派送复用排车快照。
6. PDA 扫描反馈增加实际归属、错误对象和恢复动作。
7. 费用确认嵌入订单进度，不要求客户跨菜单寻找。

P2：用数据持续优化效率

1. 建立阶段耗时、等待耗时、返工率和阻断原因看板。
2. 根据历史到仓和处理耗时做 SLA 预警，但不自动改业务事实。
3. 智能推荐下一批可审核、可排柜、可计划、可排车记录。
4. 对重复出现的扫码错误、计划资源失败和跨区失败生成问题趋势。
5. 在保持服务端门禁的前提下，优化默认值和批量操作策略。

8. P0 交付拆分

交付包	前端范围	后端范围	验收重点
A. 统一进度与下一动作	Client 订单详情、Admin 统一订单详情	Order/Firstleg 聚合返回阶段、动作和阻断	同一订单两端阶段一致，权限不同但事实一致
B. 柜级离仓准备度	Admin 货柜详情、国内出仓	Firstleg 复用现有柜级 gate/overview	7 个门禁实时、可深链、自动/人工结果一致
C. 跨区回执	Admin 柜次和尾程柜级工作台	Firstleg Outbox、Event Bridge、Lastleg Inbox 只读聚合	能区分待发送、已接收、处理失败和成功建单
D. 海外计划转换体验	Admin 尾程订单	Lastleg 预览/转换响应补充业务化 blockers 和结果	不重复建计划，资源异常可定向重试
E. 排车到出库回执	Admin 排车、出库、派送详情	Lastleg 返回出库/派送拆分结果及下一门禁	转派送和发车后单号、状态、数量立即可核对
F. PDA 错误可执行化	国内/海外 PDA	Firstleg/Lastleg 错误响应补充稳定原因码和建议动作	扫错箱/托盘、版本冲突、未转派送均能现场恢复

每个交付包独立上线，但必须复用同一状态和动作编码，不能各页面自行定义一套中文判断。

9. 验收指标

9.1 效率指标

• 新员工在不查技术文档的情况下完成一票主链关键操作的成功率。
• 每票从提交到完成审核、测量、排柜、海外计划、排车的人工点击数。
• 订单号/入仓码在不同页面重复复制粘贴次数。
• 从看到阻断到进入正确修复页面的平均时间。
• 批量操作失败后定位具体失败记录的时间。

9.2 质量指标

• 重复提交产生重复单据数必须为 0。
• 跨区事件超过 SLA 未收敛但页面仍显示成功的次数必须为 0。
• 页面自行推导动作与服务端 allowedActions 不一致的次数必须为 0。
• 因重复录入导致的仓库、目的仓、车辆、箱数不一致数量。
• PDA 错扫后需要后台或技术人员介入才能恢复的比例。

9.3 建议目标值

首轮上线前先采集两周基线，再确认具体下降比例。若当前没有埋点，P0 同步补充：页面进入、主按钮点击、阻断码、操作结果、耗时、回退/重试、跨区收敛时间。埋点只记录业务编码和阶段，不记录密钥、Token 或客户敏感明细。

10. 关键验收场景

1. 客户提交订单后立即看到入仓码、待审核和下一责任人。
2. 审核员打开待审核列表，无需进入详情即可识别可批量通过和需补资料订单。
3. 测量审核完成后，页面明确显示已进入待分柜且费用可继续独立处理。
4. 柜次缺报关时，“确认离仓”不可执行，并能一键进入报关区域。
5. 国内离仓后，页面可见跨区事件进度；海外建单后自动出现尾程订单号。
6. 海外计划转换前清楚看到头程已有托盘和海外补充托盘，重复提交不重复建资源。
7. 海外 PDA 扫错柜外箱唛时，提示实际不属于当前柜且库存零变化。
8. 海外入仓完成后，操作员可直接查看库存或进入排车，不需要重新搜索。
9. 未转派送时 PDA 明确提示平台应做的动作；转派送完成后刷新即可发车。
10. 发车成功回执同时展示排车 DEPARTED、出库 OUTBOUNDED 和各派送单号。
11. 任一页面用入仓码搜索，都能进入关联单据侧栏查看上游和下游业务号。
12. 版本冲突、网络超时和幂等重放均不会产生重复订单、计划、托盘、出库或派送单。

11. 不建议采用的做法

• 不新建独立“全流程状态表”作为新的可写权威；使用现有权威状态聚合展示。
• 不让前端通过状态字符串组合推导写资格；服务端返回下一动作和门禁。
• 不为了页面即时显示而跨区同步写海外数据库。
• 不把所有业务状态压缩成一个字段，继续区分主流程、审核、费用、库存和子单。
• 不用内部数据库 ID 作为客户和仓库人员的定位方式。
• 不通过自动刷新和无限重试掩盖事件失败；失败必须可见并受控重试。
• 不在多个页面重复维护仓库、车辆、目的仓和客户名称，统一从权威主数据选择并冻结快照。

12. 推荐落地顺序

1. 先冻结统一阶段、动作、阻断和责任岗位字典。
2. 再补服务端聚合字段与跨区回执，不先让各前端自行拼装。
3. Admin 先落统一订单、柜次、尾程计划、排车四个核心详情页。
4. Client 接入只读进度、下一动作和费用确认。
5. 国内/海外 PDA 接入稳定错误原因、恢复动作和操作回执。
6. 完成 P0 人工验收和埋点基线后，再做表单向导、自动带出和批量体验。
7. 最后基于真实操作数据决定 P2 的智能推荐和 SLA 预警，不凭主观增加自动化。