主题
生产补料
提示
当前移动端代码里的真实工作空间名称是 生产补料。它不是一个“现场处理台”，而是一个围绕 新建补料单、补料历史、补料详情 展开的移动端补料申请与记录查看模块。
页面定位
移动端 生产补料 主要给现场人员或管理人员在手机上做两类事情：
- 为进行中的订单发起补料申请；
- 查看已经提交过的补料记录和当前状态。
它更适合：
- 在车间现场发现缺料、损坏补做、数量不足时快速发起申请；
- 临时查看某张补料单现在是待处理、采购中还是已完成；
- 通过手机回看某张补料单的物料明细和领取情况。
它不适合替代：
- PC 端完整的补料管理与集中处理；
- 仓库侧的补料执行操作台；
- 带搜索筛选的大范围补料数据分析页。
功能入口
打开掌上 ERP → 进入 生产补料 工作空间
当前工作空间的真实菜单结构如下：
- 模块权限：对应权限
| 菜单 | 当前状态 | 作用 |
|---|---|---|
| 新建补料单 | 可见菜单 | 选择订单、添加物料并提交补料申请 |
| 补料历史 | 可见菜单 | 查看自己提交过的补料记录 |
| 补料详情 | 隐藏页 | 查看单张补料单的基本信息与物料明细 |
这张图要帮你先看懂：当前移动端补料模块的主线是“发起申请 → 查看历史 → 查看详情状态”，不是在手机上直接处理补料执行。
建议你先看哪里
如果你是第一次使用这个模块，建议按这个顺序理解：
- 先看 新建补料单，理解移动端到底能提交什么；
- 再看 补料历史，理解提交后在手机上能跟踪到什么信息；
- 最后看 补料详情，理解状态和物料明细能展示到什么粒度。
页面整体结构
1）新建补料单
这是当前移动端补料工作空间里最核心的页面。它的重点不是“处理补料”，而是发起补料申请。
页面主要分成五块：
关联订单区
页面最上方先选 关联订单。
- 点击后会打开订单选择弹窗；
- 订单来源不是所有订单，而是“进行中的订单可选项”；
- 弹窗支持按客户名或订单号搜索；
- 弹窗会按补料场景记录最近使用的订单，方便重复选择。
已选物料区
中间主体是 已选物料 区域。
这里会显示：
| 内容 | 说明 |
|---|---|
| 物料名称 | 当前选择的物料名 |
| 规格 | 规格 |
| 库存 | 库存数量 |
| 数量步进器 | 用于调整补料数量 |
| 删除按钮 | 右滑后显示 删除 |
页面上方有 添加物料 按钮，点开后进入物料选择弹窗。
这个弹窗除了选物料外，还支持：
- 按物料名称或规格搜索；
- 查看最近使用物料；
- 分页继续加载更多物料。
已选物料空状态
如果你还没选任何物料，页面会显示提示：
点击“添加物料”选择需要补料的物料
自定义采购区
页面里还内嵌了一个自定义采购组件。
这个区域的真实定位不是普通物料明细，而是：
- 当标准物料不够表达需求时，补充自定义采购项；
- 并且它是 可选 的；
- 默认先以折叠态展示，需要展开后再填写。
组件标题来自：自定义采购 (可选)
备注区
页面底部还有一个备注输入框：
- 标签：
备注 - 占位文案：
请输入补料原因（可选）
说明当前前端里，备注不是必填项。
底部提交区
页面底部有固定提交按钮：
提交补料申请- 如果有数量，会显示
提交补料申请（共X件）
这里要注意：当前这个数字 不是纯“标准物料件数”，而是把两部分一起算进去：
- 标准物料按申请数量累加；
- 自定义采购按“条数”累加。
这张图要帮你理解：移动端补料的主任务是把“缺什么、补多少、关联哪张订单”表达清楚。
2）补料历史
这个页面用于看已经提交过的补料记录。它当前是一个简单分页历史列表，不是复杂筛选页。
页面结构比较直接：
列表区
每张卡片会展示：
| 信息 | 说明 |
|---|---|
| 补料单号 | 补料单号 |
| 状态标签 | 当前补料状态 |
| 关联订单 | 订单编号 |
| 提交时间 | 创建时间 |
列表交互
- 支持下拉刷新；
- 支持滚动加载更多；
- 底部结束文案：
没有更多了； - 点击整张卡片进入补料详情。
空状态
当没有任何记录时，页面显示：
暂无补料记录
当前没有哪些功能
本轮核对到的真实前端里，补料历史页没有看到：
- 搜索框；
- 状态筛选；
- 订单筛选；
- 顶部查询栏。
因此教程里不应该把它写成“可搜索订单号或物料的补料跟踪页”。
3）补料详情（隐藏页）
这是一个隐藏的嵌套页，不会直接出现在底部菜单里，一般从 补料历史 点击进入。
页面当前是只读详情页，主要看两块：
基本信息区
显示字段包括：
| 信息 | 说明 |
|---|---|
| 补料单号 | 当前单据编号 |
| 状态 | 当前补料状态 |
| 关联订单 | 订单编号 |
| 提交时间 | 创建时间 |
| 备注 | 有备注时才显示 |
物料明细区
当前详情页这里展示的是标准物料明细，不展示新建页里填写的自定义采购项。
显示字段包括：
| 信息 | 说明 |
|---|---|
| 类别 + 物料名 | 类别 #物料名 |
| 规格 | 规格 |
| 补料数量 | 申请数量与单位 |
| 已领数量 | 领取数量与单位，有值才显示 |
如果没有明细，页面会显示：暂无物料明细
详情页当前不做什么
当前移动端详情页没有这些操作按钮：
- 采购；
- 领取；
- 完成；
- 删除；
- 重新提交。
所以它更像“记录查看页”，不是“补料处理页”。
页面里的真实流程
场景一：现场发起一张补料申请
- 进入
生产补料→新建补料单； - 先选择关联订单；
- 点击
添加物料，加入需要补料的物料； - 调整每种物料的补料数量；
- 如有需要，补充自定义采购项；
- 可选填写备注 / 补料原因；
- 点击
提交补料申请； - 提交成功后提示
补料申请提交成功，并跳回补料历史。
场景二：查看自己提过的补料记录
- 进入
生产补料→补料历史； - 下拉刷新历史记录；
- 找到目标补料单；
- 点击卡片进入
补料详情。
场景三：查看某张补料单当前进度
- 从
补料历史进入补料详情； - 查看当前状态标签；
- 查看物料明细和已领数量；
- 如需实际处理动作，回到 PC 端对应补料管理页面继续操作。
这张图要帮你理解：当前移动端补料模块闭环到“申请与查看”为止，状态处理动作不在这个页面里完成。
关键规则
1）真实菜单名称是“生产补料”
当前移动端工作空间名称已经是：生产补料。
2）什么时候可以提交补料申请
提交按钮可用的真实条件是：
- 已选择订单；
- 且“已选物料”或“自定义采购项”至少有一项。
也就是说，只选订单不行；只填备注也不行。
3）同一物料不会重复加入
如果同一种物料已经在已选列表里，再次选择时不会重复添加。
4）数量变成 0 会直接移除
新加物料默认数量是 1。如果你把数量调成 <= 0，这条物料会直接从已选列表删除。
5）备注不是必填
当前系统输入框提示文字已明确写成：请输入补料原因（可选）。
6）补料历史里的真实状态
当前前端已枚举的状态只有这 5 种：
| 状态码 | 文案 |
|---|---|
| 待审核 | 待处理 |
| 采购中 | |
| 待发货 | 待领取 |
| 部分领取 | |
| 已完成 |
7）移动端详情只读，状态处理来自其他端
当前移动端不会主动触发补料状态流转，只展示后端或 PC 端处理后的结果状态。采购、领取、完结等动作应回到 PC 端对应补料管理页面完成。
8）详情页当前不展示自定义采购项
新建补料单时可以提交标准物料和自定义采购项，但当前移动端详情页只展示标准物料明细。如果你在新建页填写了自定义采购项，不要预期在这张移动端详情页里看到同样的自定义采购明细。
常见问题
为什么我提交按钮点不了？
先排查三件事：
- 是否已经选择了关联订单；
- 是否至少添加了一种物料；
- 如果没加标准物料，是否至少填了一条自定义采购项。
为什么历史页找不到搜索框？
因为当前移动端真实历史页就是简单分页列表，没有做关键词搜索和条件筛选。
为什么详情里只能看，不能直接处理？
因为当前移动端补料详情页定位就是只读查看页，处理动作没有接到这个页面上。
为什么我把数量调成 0 后物料不见了？
这是当前前端的真实规则：数量小于等于 0 时，会直接把该物料从已选列表移除。
使用建议与最佳实践
- 先确认关联订单再添加物料，避免补错单。
- 标准物料优先从物料选择器里选，自定义采购项只用于标准物料难以覆盖的补充场景。
- 备注虽然不是必填，但建议把补料原因写清楚，方便后续 PC 端处理人员判断。
- 提交成功后立即到
补料历史看一眼，确认单号和状态是否生成成功。 - 如果你要处理采购、领取或完结动作，应转到 PC 端补料管理，不要预期在移动端详情页完成这些操作。
相关页面
- 移动端 - 先理解移动端工作空间和隐藏页结构
- 订单管理 - 查看补料申请关联的订单入口与上游场景
- 仓库管理 / 补料申请 - 查看 PC 端补料管理与处理规则