主题
生产线工作台
提示
当前 生产线工作台 不是只有“扫码报工”一个页面，而是包含三个菜单：工序上报、上报记录、工作量统计。其中扫码报工是主入口，上报记录用于回到已报过的批次，工作量统计用于看自己在一段时间内的产出汇总。
页面定位
生产线工作台 是移动端面向车间工人和生产岗位人员的现场工作空间，主要解决三类事情：
- 扫码进入某个生产批次并现场报工；
- 回看自己最近报过的批次并继续处理；
- 查看自己在今天、本周、本月或自定义周期内的工作量。
| 菜单 | 页面作用 |
|---|---|
| 工序上报 | 扫码进入生产批次并上报工位开始/完成 |
| 上报记录 | 查看自己近期报工记录并回到对应批次 |
| 工作量统计 | 查看自己在一段时间内的工序工作量汇总 |
这张图要帮你先分清三个入口：工序上报负责现场动作，上报记录负责回查批次，工作量统计负责看产出。
工序上报
页面作用
这个页面本质上是“扫码进入某个生产批次后，对自己负责的工位进行开始/完成上报”。
页面访问前提
页面先校验访问权限：
没有权限时会直接显示 403 提示，而不是展示扫码页。
扫码是怎么进入批次的
工序上报页支持两种进入方式：
- 直接点页面里的
立即扫码； - 通过链接参数直接进入。
代码里会同时兼容：
- 链接中的批次参数；
- 微信扫码返回结果里的新旧二维码格式。
这张图要帮你理解：扫码不是唯一入口，但最终都会落到同一个“批次详情 + 报工按钮”页面。
扫码后会加载什么
扫码或通过链接进入后，页面会并行加载：
- 批次详情
- 该批次的工位上报记录
批次页会展示什么
1）批次基础信息卡
页面头部会展示：
| 信息 | 说明 |
|---|---|
| 批次编号 | 批次编号 |
| 批次名称 | 名称 |
| 所属产线 | 所属产线 |
| 总面积 | 总面积 |
| 大板数量 | 系统批次和自定义批次统计方式不同 |
| 板件数量 | 系统批次和自定义批次统计方式不同 |
| 备注 | 有备注时显示 |
3）大板开料标记
当批次属于系统批次时，页面会额外展示一个"大板开料明细"卡片。这个功能用于在工序上报页面直接标记每种大板的开料进度。
卡片默认折叠，标题右侧会显示当前开料状态：
- 全部开料：所有大板已开料完毕
- 部分开料 X/Y 张：有部分大板尚未开料
展开后可以看到每种大板的材料花色、规格、数量，以及一个步进器用于调整已开料数量。操作完成后需要点击"保存"按钮提交修改。
提示
这个功能适合现场操作人员在开料工序中实时标记进度，帮助后续工位判断当前批次是否已经全部开好料。页面还提供"全部开料"快捷按钮，一键标记所有大板为已开料。
4）统计明细
如果批次带有统计明细数据，页面会显示统计明细表格。
5）详细数据表
如果批次带有自定义明细数据，还会显示自定义明细表。
6）上报记录时间线
页面中部会显示当前批次所有工位上报记录的时间线，包含：
- 工位名称；
- 上报时间；
- 完成时间；
- 上报人昵称；
- 是否已完成；
- 当前记录是否允许撤回。
工位按钮是怎么决定状态的
页面不会给所有工位都显示同一种按钮，而是根据：
- 当前登录人能操作的工位列表；
- 该批次下自己在这个工位最近一次上报记录；
- 最近一次记录是否已经完成；
动态计算按钮状态。
按钮大致分为三类：
| 状态 | 颜色 | 含义 |
|---|---|---|
| 开始 | 绿色 | 该工位当前可开始上报 |
| 完成 | 红色 | 当前人已开始但尚未结束，可补报完成 |
| 再次开始 | 黄色 | 当前人在该工位已有完成记录，可再次开始 |
这张图要帮你看懂按钮颜色背后的真实规则：按钮不是简单表示“这个工位有没有做过”，而是表示“我这个人当前还能对这个工位做什么动作”。
工位按钮从哪来
页面先加载当前用户可上报的工位列表：
这意味着：
- 页面底部按钮只会展示当前用户有权限上报的工位；
- 不是整条产线所有工位都会出现；
- 旧文档里“其他工序按钮不显示或只读”的方向是对的，但更准确的说法是：页面底部实际是当前人可上报工位按钮组。
点击工位按钮后会发生什么
点击某个工位按钮，会弹出确认框，提示：
- 是开始；
- 还是完成；
- 是否为再次开始。
确认后调用 提交上报。
这张图要帮你理解：报工动作本身只有一次按钮点击，但页面会根据当前状态自动判断这次是“开始”还是“完成”。
撤回上报
旧文档里对“撤回上报”的理解基本方向对，但真实规则更明确：
- 只能撤回自己上报的记录；
- 而且该记录必须还未完成，即未完成记录；
- 撤回后系统会自动删除这条上报记录。
这张图要帮你理解撤回边界：不是所有历史报工都能回退，只能撤回自己尚未结束的那条记录。
上报记录
页面作用
上报记录 菜单对应页面：
它用于查看自己近期的报工记录，并且可以直接回到对应生产批次继续处理。
页面能力
| 能力 | 说明 |
|---|---|
| 下拉刷新 | 重新加载第一页 |
| 分页加载 | 继续加载更多记录 |
| 打开批次 | 点击记录直接跳回工序上报页 |
| 限定范围 | 页面底部文案说明最多展示近期 60 天数据 |
每条记录显示什么
| 信息 | 说明 |
|---|---|
| 批次编号 | 批次编号 |
| 上报时间 | 上报时间 |
| 批次名称 | 批次名称 |
| 工位名称 | 工位 映射出来的工位 |
| 当前状态 | 已结束 / 进行中 |
通过记录回到批次
点击一条上报记录时，页面会跳到： 生产报工页面
这意味着旧文档里“通过上报记录快速跳转”这部分方向是成立的，但真实实现并不是切换 标签页，而是点记录卡片重新进入工序上报页并带上批次 ID。
工作量统计
页面作用
工作量统计 对应页面：
它不是单纯按工资或计件金额展示，而是按工序维度统计自己在一段时间内处理的工作量。
时间筛选怎么用
页面当前真实快捷筛选有 4 种：
- 本日
- 本周
- 本月
- 自定义日期范围
其中：
- 自定义范围最大不能超过 62 天；
- 当前选择会同步到链接参数，返回后还能恢复状态。
这张图要帮你理解工作量统计不是死表，而是一个带时间筛选和状态恢复的统计页。
页面会显示哪些汇总
页面顶部会先给出整个统计周期的总计：
| 汇总项 | 说明 |
|---|---|
| 处理订单 | 处理订单数 |
| 板件总数 | 板件总数 |
| 总面积 | 总面积 |
工序卡片怎么展示
下面会按工序维度展示卡片。
每张卡片至少包含：
- 工序名称；
- 该工序处理过多少订单；
- 当前工序对应的指标值。
这里有一个旧文档里完全没写到的真实规则：
1）如果工序没有配置指标维度
页面会用默认指标：
- 板件数量
- 面积
。：
2）如果工序配置了指标维度
页面会根据配置动态显示不同指标，并展开维度明细。
。：
3）如果存在特殊工艺数据
无论是否配置指标，都会额外显示特殊工艺统计。
。：
工作量明细
页面作用
点击某个工序卡片后，会进入隐藏嵌套页： 我的工作量详情
这个页面会按订单维度展开该工序在当前统计周期里的明细。
进入参数
页面依赖 3 个查询参数：
- 工位、开始日期、结束日期 缺少任意一个都会提示“缺少必要参数”。
页面展示什么
页面会显示：
- 当前工序名称；
- 时间范围；
- 订单数量；
- 该工序在当前时间段内的汇总指标；
- 每张订单的指标明细。
如果该工序配置了指标维度，就按配置展示； 如果没有配置，就退回默认展示：
- 板件数量
- 面积
当前旧文档里需要纠正的点
1）生产线工作台不是只有扫码页
旧文档把整个工作空间几乎都写成扫码上报页，但当前真实结构包含：
- 工序上报
- 上报记录
- 工作量统计
- 工作量明细（隐藏页）
2）“再次扫码才能完成”不是唯一方式
当前除了重新扫码，还可以从 上报记录 里点回对应批次，再进行完成上报。
3）工作量统计不是工资页
它是按工序和指标维度统计产出，不是简单的工资结算页。
4）按钮状态说明过于静态
旧文档把按钮理解成固定状态说明，但真实页面是根据“当前人最近一次记录是否完成”动态生成开始 / 完成 / 再次开始逻辑。
典型使用场景
场景一：现场扫码开始或完成工序
- 进入
工序上报； - 扫描批次二维码；
- 查看批次信息；
- 点击自己负责的工位按钮；
- 确认开始或完成上报。
场景二：先报开始，过后再补完成
- 第一次扫码后点击工位按钮报开始；
- 稍后进入
上报记录； - 找到该批次记录；
- 点回对应批次；
- 再点击工位按钮完成上报。
场景三：发现自己刚才报错了
- 在批次详情的上报记录时间线里找到自己的记录；
- 确认该记录还未结束；
- 点击
撤回； - 撤回后重新正确报工。
场景四：查看本周自己做了多少
- 进入
工作量统计； - 点击
本周； - 查看总计和各工序卡片；
- 点开某个工序进入
工作量明细查看具体订单。
注意事项
- 没有 对应权限时，页面会直接拦截。
- 页面底部只显示当前人可上报的工位，不代表这张批次全部工位。
- 撤回只适用于“本人上报且尚未结束”的记录。
- 工作量统计的自定义时间范围不能超过 62 天。
- 从上报记录回到批次后，仍然要以当前按钮状态判断是开始、完成还是再次开始。
- 旧文档里关于“订单工作量已锁定”的财务锁定报错，本轮核对到的当前前端页面里没有专门前端校验文案，正式教程不再把它写成当前页面确定会出现的标准提示。