报工≠打卡：从任务报工到闭环管控的5个数据断点排查清单

在制造执行系统（MES）中，'报工'常被误等同于'打卡'------但真实场景下，大量报工失败、数据失真或闭环断裂，并非源于操作员疏漏，而是上游基础配置存在隐蔽断点。本文面向系统实施工程师与后端开发者，结合典型产线问题，逐项拆解5个高频、可验证、需代码/配置协同修复的数据断点。

断点一：人员未绑定技能导致工序匹配失败

报工任务在前端可提交，但状态停滞、进度条无响应？根源可能在人员档案的技能字段为空或编码不匹配。

系统逻辑：排产引擎依据工序模板中定义的技能编码（如 WELDING-A）匹配操作人；若人员仅绑定 WELDING_B（注意大小写与分隔符），匹配即失败。
表现特征：任务显示在报工页，提交后无状态变更，重排时跳过该工序。
开发侧可干预点：
- 在人员管理 API 中增加技能编码标准化校验（正则 /^[A-Z]{2,6}-[A-Z0-9]+$/）；
- 报工提交接口增加前置校验：查询 operator_id → skill_codes 是否包含当前工序 required_skill_code；
- 返回明确错误码（如 ERR_SKILL_MISMATCH）而非静默失败。

验证口诀：查任一报工异常任务 → 反查操作人 → 确认其技能列表是否包含该工序所需技能编码。

BOM 已维护辅料，但报工后成本归集仍缺失？关键在于工艺路线节点未显式绑定物料及用量字段。

系统逻辑：MRP 计算依赖 BOM，而工单级成本拆分依赖工艺路线中各工序节点的 material_usage 扩展属性；二者独立存储，不可自动映射。
典型错误：BOM 含 coolant: 2L，但 Machining 工序节点未配置 coolant 字段及用量值。
开发侧可干预点：
- 在工艺路线编辑 API 中强制校验关键工序节点是否填写 ext_attrs 中的必填字段（如 energy_kwh, material_usage）；
- 提供 BOM 与工艺路线字段比对工具接口，返回差异项清单（JSON 格式）；
- 成本计算服务加载工序数据时，增加 ext_attrs is not null 安全兜底日志。

验证口诀：比对同一工序的 BOM 物料清单与工艺路线物料配置，检查关键扩展字段是否一致。

设备负载视图显示'全天满载'，现场却长期空闲？问题出在设备未绑定有效生产日历，或日历优先级配置冲突。

系统逻辑：排产引擎默认按 24/7 计算设备可用性；真实约束（班次、维保、节假日）必须通过日历对象显式绑定并设置优先级。
隐蔽风险：全局日历（优先级 1）未被国庆日历（应设为 2+）覆盖，导致 10 月 1 日仍按白班排产。
开发侧可干预点：
- 设备资源服务增加 get_effective_calendar(date) 方法，按优先级降序合并日历规则；
- 负载计算模块调用前强制校验 device.calendar_id IS NOT NULL；
- 提供日历冲突检测 CLI 工具，扫描所有设备日历启用状态与优先级重叠。

验证口诀：在资源负载视图中点击高负载设备 → 查看其关联日历是否覆盖当前排产时段 → 核对日历状态是否启用、优先级是否高于其他冲突规则。

报工数成功提交，但后续重排反复失败？主设备已绑定，模具、夹具、专用人力等辅资源缺失或换型时长未配置。

系统逻辑：工序模板定义 primary_resource + aux_resources[]；若辅资源未声明占用规则（如 install_time: 15min），排产引擎将忽略切换耗时，导致计划过度乐观。
数据表现：同一设备切换 A/B 产品时，系统假设瞬时完成，实际报工频繁延期、数量不准。
开发侧可干预点：
- 工序模板保存接口校验 aux_resources 非空且含必要字段（code, max_quantity, install_time, remove_time）；
- 排产引擎在生成任务前，调用 validate_resource_availability() 检查辅资源时段冲突；
- 报工服务记录 resource_binding_snapshot 快照，用于事后追溯资源匹配依据。

验证口诀：抽取近期报工完成率低的工序 → 检查其工序模板中主辅资源绑定完整性 → 确认换型时长是否填入。

Excel 报工表上传后数量丢失、无报错提示？核心在于字段格式与系统期望不一致，或未启用版本隔离与累加逻辑。

系统逻辑：【订单报工数】为强校验字段，留空或非数字字符（如 100件）触发静默丢弃；旧模板重复上传易引发覆盖或重复计数。
开发侧可干预点：
- Excel 解析服务增加预校验阶段：对 report_date 字段强制匹配 ^\d{4}-\d{2}-\d{2}$，对 quantity 强制 ^\d+$；
- 上传接口返回结构化错误响应（含 field, row, reason），前端高亮定位；
- 启用报工表版本号字段（plan_version），服务层拒绝处理低版本重复提交。

验证口诀：下载最新下发报工表 → 对照操作手册检查【订单报工数】等核心字段格式与必填性 → 模拟上传测试。