装箱编号 - 多码凑箱模式 UI 展示

状态栏颜色含义

蓝色 — 空闲/等待扫码

橙色 — 提交中/同步中

绿色 — 操作成功

红色 — 错误（无效码/提交失败）

黄色 — 网络异常

琥珀 — 警告（重复箱号）

多码凑箱模式 UI 结构

┌──────────────────────────────────────────┐ │ AppBar: "装箱编号" + [多码凑箱] 模式按钮 (P2) │ ├──────────────────────────────────────────┤ │ [提示条区域] │ │ - 橙色同步条：正在同步转运数据... │ │ - 黄色警告条：自动装箱失败的警告信息 │ │ - 蓝色通知条：排产号已切换 │ │ - 琥珀警告条：箱号已存在 │ ├──────────────────────────────────────────┤ │ 当前箱号: [ N ] ← 顶部大号输入框 │ │ ─────────────────────────────────────── │ │ W00009 已有3箱最大箱号3 [详情 →] │ │ │ │ 已装入本箱（N项） │ │ ┌──────────────────────────────────────┐ │ │ │ 26BW0011 WO-001 80/80 ✏️ 🗑 │ │ │ │ 26BW0012 WO-002 60/60 ✏️ 🗑 │ │ │ │ 26BW0013 WO-003 40/40 ✏️ 🗑 │ │ │ └──────────────────────────────────────┘ │ │ ─────────────────────────────────────── │ │ [✓ 26BW0014 WO-004 50件] ← 扫码显示区 │ │ │ │ 数量 │ │ [ 50 ] [确认] │ ├──────────────────────────────────────────┤ │ [ 完成本箱 ] ← 全宽按钮 │ ├──────────────────────────────────────────┤ │ ● 等待扫码 / 请继续扫码或完成本箱 │ └──────────────────────────────────────────┘

核心业务流程

多码凑箱流程（_buildManyToOneBody）: 1. 扫码 → 解析总排号 → 调用 fetchBoxInfo API │ ▼ 2. 判断排产号上下文（decideMultiCodePaichanContext） ├─ firstScan → 自动填入箱号 (maxBoxNo+1) ├─ samePaichan → 保持当前箱号 └─ switchedPaichan → 清空已装入列表，重置箱号 (maxBoxNo+1) │ ▼ 3. 自动填充剩余数量 → 等待用户确认 ├─ 修改箱号 → 清除编辑/删除状态 └─ 修改数量 → 实时校验是否超额 │ ▼ 4. 点击 [确认] → saveBoxRecord API ├─ 成功 → 添加到 _manyToOnePackedItems │ phase 回到 waiting │ 状态: "装箱成功，请继续扫码" └─ 失败 → 显示错误状态 │ ▼ 5. 继续扫码 / 完成本箱 ├─ 继续扫码 → 回到步骤1 └─ 完成本箱 → 清空已装入列表箱号 +1，回到初始状态

与单码装箱模式的差异

UI 布局不同：多码凑箱使用独立的 _buildManyToOneBody，将箱号提升到顶部大号输入；单码装箱使用 _buildScanArea + _buildInfoArea + _buildInputArea 传统布局。
箱号管理：多码模式下不检测重复箱号（_boxNoIsDuplicate 对 multiCode 直接返回 false），允许多个总排号装入同一箱。
底部按钮：多码模式显示"完成本箱"按钮（OutlinedButton），无已分配列表编辑功能；单码模式显示"返回"按钮和已分配箱的编辑/删除。
提交成功后行为：多码模式将结果存入 _manyToOnePackedItems 列表，phase 回到 waiting，继续扫码；单码模式保持在 scanned 阶段，箱号 +1。
排产号切换感知：多码模式通过 decideMultiCodePaichanContext 检测排产号变化，切换时清空已装入列表并弹出蓝色通知。

关键代码引用

模式枚举：BoxingMode.multiCode — boxing_page.dart:18
多码体布局：_buildManyToOneBody() — boxing_page.dart:1656
箱号面板：_buildManyToOneBoxNoPanel() — boxing_page.dart:1679
已装入列表：_buildManyToOnePackedList() — boxing_page.dart:1756
扫码区：_buildManyToOneScanArea() — boxing_page.dart:1898
提交区：_buildManyToOneSubmitArea() — boxing_page.dart:1944
排产号上下文：decideMultiCodePaichanContext() — boxing_context.dart:12
自动填充逻辑：_applyAutoFill() — boxing_page.dart:400
提交成功回调：_onSubmitSuccess() — boxing_page.dart:637
完成本箱：_finishManyToOneBox() — boxing_page.dart:821
状态栏组件：StatusBar — widgets/status_bar.dart:14

提示条（Alert Bars）触发条件