主题
工作量结算
页面定位
工作量结算是财务管理里用于封存生产工作量的页面。它不是直接发工资的页面，也不是传统“草稿 → 审核 → 付款”的财务单据流程，而是把某一时间范围内的可结算工作量统一归入一个结算批次，并把这些工作量从“可调整”切换成“已结算”。
当前系统里，工作量结算会同时处理两类数据：
- 生产工序工作量；
- 分拣打包工作量。
所以你可以把它理解成：计件工资核算前的工作量封存页。
菜单路径
财务管理 → 工作量结算
谁会用到这个页面
- 财务人员：按结算周期封存工作量，为后续计件工资核算提供基础数据；
- 生产管理人员：核对当前可结算的工序工作量有没有遗漏或异常；
- 管理者：按批次回看某段时间内已经结算的生产工作量结构。
先理解一个最重要的边界
工作量结算页展示的是工作量指标，不是工资金额。
也就是说，这里重点看的是：
- 板件数
- 面积
- 封边长度
- 包裹数
- 特殊工艺等产出指标
而不是：
- 单价
- 应发工资
- 实发工资
这张图想帮你看懂：工作量结算更像“封存工作量基础数据”，不是直接发工资。
建议你先看哪里
如果你第一次进入这个页面，建议按下面顺序理解：
这张图想帮你建立正确阅读顺序：先理解规则，再选时间，再看预览，最后才确认结算。
页面整体结构
工作量结算页面分成两层：
这张图想帮你看懂：主页面只负责管理结算批次，真正的结算动作发生在全屏窗口里。
列表页能做什么
1. 查询区
当前列表页的真实筛选条件只有一个：
| 筛选项 | 说明 |
|---|---|
| 结算名称 | 按结算批次名称模糊查询 |
目前并没有按状态、时间范围、结算模式等字段做列表筛选。
2. 列表字段
结算批次列表会展示：
| 字段 | 说明 |
|---|---|
| 结算名称 | 结算批次名称，可点击进入详情 |
| 结算模式 | 按报工完成 / 按订单进度 |
| 结算期间 | 开始日期 ~ 结束日期，或 截止至结束日期 |
| 结算时间 | 创建这次结算的时间 |
| 备注 | 批次备注 |
3. 列表操作
列表页支持：
- 新建
- 查看
- 删除
- 刷新
其中删除不是单纯删一条记录，而是会把本次结算关联的工作量一起解锁，这一点非常重要。
工作量结算到底怎么生效
当前系统不是“创建一张结算单草稿，再慢慢编辑”，而是创建即结算。
后端真实逻辑是：
- 先创建一条工作量结算批次记录；
- 再把命中的生产工序工作量和分拣打包工作量关联到结算批次；
- 并把它们的状态从"已计算"改成"已结算"；
- 后续查看详情时，再按这些已挂到当前批次的原始记录做实时汇总。
这张图想帮你看懂：系统没有单独保存一份“明细快照表”，而是直接把原始工作量归属到某个结算批次。
新建结算时要先看两个规则
工作量结算要先同时理解两个维度：
- 结算模式；
- 时间方式。
一、结算模式
结算模式不是你在页面里手选的，而是由工厂配置决定。当前系统支持两种：
| 模式 | 含义 |
|---|---|
| 按报工完成 | 按生产工序和分拣打包的完成时间取数 |
| 按订单进度 | 先找出在指定时间达到目标进度的订单，再汇总这些订单下尚未结算的工作量 |
如果工厂配置的是“按订单进度”，但没有配置对应的结算进度，系统就不能创建结算。
二、时间方式
页面里有两种时间方式：
| 时间方式 | 含义 |
|---|---|
| 截止至 | 只选结束日期，把该日期当天及以前所有未结算数据都带出来 |
| 范围筛选 | 选开始日期和结束日期，只取这个区间内的未结算数据 |
这张图想帮你看懂：两个时间方式不是界面写法不同，而是取数范围真的不同。
新建结算怎么做
操作步骤
- 在列表页点击
新增； - 进入全屏结算页；
- 填写结算名称；
- 选择时间方式；
- 选择截止日期或时间范围；
- 查看系统实时预览结果；
- 确认无误后点击
确认结算。
默认值是什么
新建时，系统会自动：
- 把时间方式默认成
截止至； - 把结算名称默认成上个月，例如
2026年3月； - 预设上月第一天和最后一天作为默认时间；
- 自动加载一版预览数据。
但要注意：虽然界面默认会给开始日期一个值，在“截止至”模式下真正提交给后端时并不会使用这个开始日期。
表单字段
| 字段 | 是否必填 | 说明 |
|---|---|---|
| 结算名称 | 是 | 结算批次名称，同租户下不能重名 |
| 时间方式 | 是 | 截止至 / 范围筛选，仅新建时可选 |
| 截止至 | 是 | 在截止至模式下必填 |
| 时间范围开始 | 条件必填 | 仅范围筛选模式下必填 |
| 备注 | 否 | 结算说明，结算后也可继续修改 |
页面会实时预览什么
在你还没真正确认结算之前，页面会先预览两类数据：
- 生产工序工作量汇总；
- 分拣打包工作量汇总。
系统会用提示框明确告诉你两件事：
- 当前工厂采用的是哪种结算模式；
- 你现在选的时间方式会带来什么取数范围。
这部分非常适合拿来做实际操作判断：
- 如果你担心遗漏之前未结的数据，优先用“截止至”；
- 如果你就是要做严格月结或周结，再用“范围筛选”。
预览区域怎么看
预览区分成两个页签：
| 页签 | 作用 |
|---|---|
| 生产工序 | 查看生产报工形成的工作量汇总 |
| 分拣打包 | 查看分拣、打包形成的工作量汇总 |
1. 生产工序页签
这里按工人 + 工序汇总展示。
固定会看到的字段有：
- 工人姓名
- 工序名称
- 订单数
其他工作量指标列会根据工序配置动态出现，可能包括：
- 板件数量
- 面积
- 封边长度
- 大板数量
- 钻孔板件数
- 封边板件数
- 异形板件数
- 特殊工艺
这意味着这些列不是每个工厂、每个工序都完全一样，教程里不能把它们写成固定不变的全量列。
2. 动态维度列
某些指标还可能继续按以下维度展开：
- 厚度
- 花色
- 材质
所以你看到的列结构可能会因工序配置不同而不同。
3. 汇总行
生产工序表格底部会展示汇总行，帮助你快速核对当前预览总量。
4. 指标明细钻取
大多数非 0 的指标值都可以点击。点击后会弹出明细浮窗，查看原始报工记录。
浮窗里常见字段包括：
| 字段 | 说明 |
|---|---|
| 订单编号 | 这条工作量归属哪个订单 |
| 客户编号 | 对应客户编号 |
| 批次 | 对应生产批次 |
| 上报时间 | 报工上报时间 |
| 分配比例 | 这条记录在多人分摊中的比例 |
| 当前指标值 | 你刚才点击的那一个指标值 |
如果当前指标配置了关注维度，浮窗还会追加显示对应的厚度、花色或材质拆分值。
5. 分拣打包页签
分拣打包页签按工人汇总展示，字段包括：
- 工人
- 分拣板件数
- 分拣面积
- 打包板件数
- 打包面积
- 包裹数
- 订单数
它同样有合计行，但要注意：当前实现里，底部合计并没有把“订单数”这一列做总计展示。
什么时候不能创建结算
1. 后端会拦截的情况
后端明确会拒绝这两类情况：
- 当前工厂采用“按订单进度”模式，但没有配置结算所需订单进度；
- 你选择的范围内，生产工序和分拣打包两类工作量都为空。
2. 前端会拦截的情况
前端还会额外拦截：
- 表单校验不通过；
- 生产工序预览为空时，不允许点击确认结算。
这里要特别注意一个真实实现差异：当前前端只看“生产工序预览”是否为空，没有把“分拣打包预览”纳入按钮可用判断。因此如果某个周期里只有分拣打包数据、没有生产工序数据，后端理论上允许创建，但前端页面可能会拦住。
查看详情时能做什么
已创建的结算批次可以进入查看模式。
查看模式下：
- 表单主体只读；
- 备注仍然可以修改；
- 支持打印；
- 支持删除当前结算批次。
备注怎么保存
详情页里的备注不是点保存按钮，而是输入后失焦自动保存。
打印
只有在查看模式下才显示打印按钮。
删除结算意味着什么
删除工作量结算，不是简单删除一条记录，而是一次反结算。
系统会做三件事：
- 把这次结算关联的生产工序工作量从"已结算"改回"已计算"；
- 把这次结算关联的分拣打包工作量从"已结算"改回"已计算"；
- 取消关联结算批次，再删除结算批次本身。
这张图想帮你看懂：删除结算会直接把底层工作量“解锁”，所以不能把它当成普通删除按钮随便点。
它和生产管理、订单、财务的关系
1. 和生产管理的关系
生产工序工作量来自生产模块，工作量一旦进入"已结算"状态，生产侧会把它当成已封存数据处理。当前代码里已经明确限制：已结算工作量不能再重新计算，部分场景下也不能重置。
2. 和订单的关系
如果工厂采用“按订单进度”模式，订单会变成工作量结算的入口条件：系统先找出在指定时间达到目标进度的订单，再把这些订单下尚未结算的工作量纳入本次结算。
所以在这个模式下，结算不是按报工完成时间切，而是按订单到达某个业务节点来切。
3. 和财务的关系
虽然页面挂在财务管理下，但它处理的不是付款记录，而是生产工作量封存。更准确地说，它属于“财务视角下的生产计件结算基础页”。
常见问题
1. 为什么我选了时间范围，却没有看到想要的工作量？
先检查三件事：
- 当前工厂采用的是“按报工完成”还是“按订单进度”；
- 你选的是“截止至”还是“范围筛选”；
- 这批工作量是否已经进入别的结算批次，状态变成"已结算"。
2. 为什么按订单进度模式下无法创建结算？
最常见的原因是工厂没有配置结算所需订单进度。当前代码里，没配这个进度会直接报错，不能继续结算。
3. 工作量结算是不是已经算出了工资金额？
不是。当前页面只处理工作量指标汇总和封存，不直接展示工资金额、单价或应发工资。
4. 删除结算后会发生什么？
删除后，这次结算关联的工作量会被反结算并重新解锁，相关工作量记录会恢复成可调整状态。
5. 已结算后还能不能继续修改备注？
可以。当前实现允许在查看模式下继续修改备注，而且是失焦自动保存。
使用建议与最佳实践
- 第一次用时，先确认工厂当前配置的是哪种结算模式；
- 如果你担心漏掉历史未结数据，优先用“截止至”；
- 如果你要做严格期间结算，再用“范围筛选”；
- 看预览时不要只盯生产工序，也要切到分拣打包页签核对；
- 删除结算前先确认影响范围，因为它会直接解锁底层工作量数据；
- 不要把工作量结算误解成工资发放，它只是工资核算前的基础数据封存步骤。