3. 指标定义与元数据规范

在制造运营指标体系里，最容易被低估、却最容易引发争议的并不是“指标算得对不对”，而是“这个指标到底指什么”。同一个“设备综合效率”，设备部按日历时间算，生产部按计划开机时间算，财务部又按资产折旧口径理解，三份报表放在一起，数字必然打架。指标定义与元数据规范要解决的，就是把这种口头共识变成可被系统读取、可被审计、可被复用的结构化描述。指标字典就是承载这些描述的载体，它既是数据服务的“接口契约”，也是口径争议的“仲裁依据”。

一、指标元数据的核心要素

一个可落地的指标定义，至少要回答六个问题：叫什么、算什么、怎么算、多久算一次、数据从哪来、谁负责。这六项构成指标元数据的最小完备集，缺任何一项，指标在跨部门流转时都会产生歧义。

• 指标名称与编码：名称面向人，编码面向系统。名称要唯一且无歧义，例如“设备综合效率（OEE）”优于“设备效率”；编码建议采用“域-主题-序号”结构，如 PRD-EQP-001，保证在数据服务、报表、API 中稳定引用。
• 业务口径：用自然语言描述指标的边界与判定规则，包括统计对象范围（哪些设备、哪些产线、哪些班次）、包含与排除项（是否含计划停机、是否含试产）、异常处理规则（数据缺失时是剔除还是补零）。口径是争议最多的地方，必须写到“可据此复现”的粒度。
• 计算公式：用可解析的表达式表达，并明确每个变量的来源字段。例如 OEE = 时间稼动率 × 性能稼动率 × 良品率，其中时间稼动率 = 实际运行时间 / 计划生产时间。
• 统计周期：明确计算的时间窗口与刷新频率，如“按自然日 00:00–24:00 汇总，T+1 08:00 前刷新”。周期决定了指标能否与其它指标对齐。
• 数据来源：指明源系统、表、字段及采集方式，如“MES 的 eqp_status_log 表，状态字段 status_code，每 30 秒一条”。
• 责任部门与责任人：口径的解释权归属，通常由业务归口部门担任“指标 Owner”，数据团队担任“数据 Steward”。

除最小集外，成熟体系还会补充：指标类型（原子指标/派生指标）、量纲与单位、精度与舍入规则、目标值与阈值、上下游依赖、变更记录。这些字段不是越多越好，而是“谁用谁需要”——面向看板的指标需要阈值，面向算法的指标需要精度和依赖。

二、指标字典的编写规范

指标字典不是一张随手维护的 Excel，而是一份需要评审、发布、受控的“数据契约”。编写时应遵循四条规范。

第一，一指标一条目，编码全局唯一。禁止出现“同一指标多个名称”或“同一名称多个口径”。若确实存在不同口径，应拆成两个指标并分别编码，例如“OEE（含计划停机）”与“OEE（不含计划停机）”，而不是在一个条目里写“视情况而定”。

第二，口径描述必须可复现。判断标准是：换一个人，仅凭字典条目就能算出同样的结果。因此要写清时间边界、对象边界、排除项和异常处理。例如：“统计范围为 MES 中状态为‘量产’的设备，排除试产与维修工单；计划停机计入分母，非计划停机不计入运行时间；状态日志缺失超过 5 分钟按停机处理。”

第三，公式与字段一一对应。公式中的每个变量都要能追溯到具体表字段，避免出现“运行时间”这种没有来源的中间量。推荐写法：

OEE = 时间稼动率 × 性能稼动率 × 良品率
时间稼动率 = SUM(actual_run_sec) / SUM(plan_run_sec)
性能稼动率 = (ideal_cycle_sec × total_count) / SUM(actual_run_sec)
良品率 = good_count / total_count
数据来源：MES.eqp_status_log、MES.production_count
统计周期：自然日 00:00–24:00，T+1 08:00 刷新

第四，责任到人，评审留痕。每个指标必须指定业务 Owner 和数据 Steward。新增或修改口径，需经业务 Owner 确认、数据 Steward 校验可实现性，并在字典中记录评审人与评审日期。没有评审记录的条目，不应进入正式发布状态。

三、版本管理：让口径变更可控可追溯

口径不是一成不变的。产线改造、工艺调整、统计范围变化，都会导致指标定义需要修订。版本管理要解决三个问题：改了什么、谁批准的、下游怎么办。

建议采用“语义化版本 + 状态机”的方式。版本号形如 v2.1.0：主版本号变更表示口径发生实质性变化（如统计范围调整），次版本号变更表示公式或字段调整，修订号变更表示文字澄清或精度调整。状态机包含“草稿—评审中—已发布—已废弃”四个状态，只有“已发布”版本才能被数据服务引用。

当主版本升级时，必须执行下游影响评估：哪些看板、报表、模型引用了该指标？是否需要并行运行新旧版本一段时间？旧版本何时废弃？建议在字典中维护“依赖清单”，并在版本发布时自动通知下游责任人。对于关键指标，可保留旧版本至少一个完整统计周期，便于对比验证。

四、一个可参考的指标字典条目示例

指标定义与元数据规范的价值，不在于文档写得多厚，而在于当两个人对同一个数字产生分歧时，能有一份双方都认可、且被系统实际引用的权威定义来快速收敛。把口径写清楚、把版本管起来、把责任落到人，指标才真正具备跨部门、跨系统复用的基础。