4. 平台指标字典设计
指标字典是工业能源管理平台的“数据宪法”。平台里所有看板、报表、告警、对标分析，最终都要落到一个个指标上。如果同一个“单位产品综合能耗”在A车间叫unit_energy、在B车间叫prod_energy_per_unit，单位一会儿是kgce/t、一会儿是tce/万件，那么跨部门汇总时必然出现口径打架、数值翻倍或量纲错乱。指标字典的任务，就是把“叫什么、怎么编、是什么、从哪来、怎么算”这五件事一次性定义清楚，并让后续新增指标有章可循。
一、指标命名规范：让名字自带语义
命名规范解决“可读性”和“唯一性”。推荐采用“业务域_对象_度量_口径”的分段式命名，全部使用小写英文与下划线，避免中文、空格和特殊符号。例如：
energy_electricity_consumption_total：全厂用电总量；energy_steam_consumption_workshop：车间蒸汽消耗量；kpi_unit_product_comprehensive_energy：单位产品综合能耗；carbon_co2_emission_total：二氧化碳排放总量。
分段含义要固定：第一段表示业务域（energy、carbon、cost、production），第二段表示对象或介质（electricity、steam、water、compressed_air），第三段表示度量类型（consumption、intensity、efficiency、cost），第四段表示统计口径（total、workshop、line、shift）。这样即使不查字典，工程师也能大致猜出指标含义。命名一经发布不得随意修改，确需调整时走版本管理，旧编码保留并标记为“已废弃”，避免历史报表断链。
二、编码规则：给每个指标一个稳定身份证
编码是机器识别的主键，必须稳定、可扩展、不承载过多易变信息。建议采用“域码 + 介质码 + 序号”的定长结构，例如EN-EL-0001：EN表示能源域，EL表示电力，0001为流水号。域码与介质码用两位大写字母，序号四位，不足补零。编码只增不改，指标废弃后编码冻结，不回收复用。这样在数据仓库建模、接口对接、报表引用时，编码始终是唯一锚点，名称可以优化，编码不动。
三、元数据定义：把“口径”写死
元数据是指标的完整说明书，至少包含单位、精度、计算公式、数据源、统计周期、责任部门和版本号。以“单位产品综合能耗”为例，可定义如下：
| 元数据项 | 示例值 | 说明 |
|---|---|---|
| 指标编码 | EN-EL-0001 | 唯一主键，发布后冻结 |
| 指标名称 | 单位产品综合能耗 | 业务可读名称 |
| 单位 | kgce/t | 千克标准煤每吨产品 |
| 精度 | 保留2位小数，四舍五入 | 展示与存储精度一致 |
| 计算公式 | 综合能耗总量 ÷ 合格产品产量 | 分子分母口径需同时定义 |
| 数据源 | 能耗表 dwd_energy_total、产量表 dwd_output | 注明表名与字段 |
| 统计周期 | 日、月 | 与报表粒度对齐 |
| 责任部门 | 能源管理部 | 口径解释与变更审批 |
公式定义要特别小心“分母口径”。同样是“单位产品能耗”，分母用合格品产量还是投料量，结果差异可能超过10%。因此字典中必须写明分母取数表、过滤条件（如剔除返工品）和时间对齐方式（按自然月还是按生产批次）。数据源要精确到表和字段，不能只写“来自MES系统”，否则后续排障无从下手。精度方面，建议存储精度高于展示精度一位，避免多次汇总后舍入误差累积。
四、指标字典管理流程：从申请到退役
指标字典不是一次性文档，而是有生命周期的管理对象。推荐流程为：申请 → 评审 → 发布 → 使用与变更 → 退役。申请环节由业务方填写指标名称、编码建议、元数据六要素和用途说明；评审环节由能源管理部、数据团队和报表使用方共同确认口径唯一性，重点检查是否与已有指标重复或近似；发布后进入平台元数据表，同步开放给报表和接口调用；任何口径变更必须走变更单，生成新版本号，旧版本保留并标注生效区间；指标不再使用时标记退役，但编码和历史数据不删除。
以一个常见问题为例：某平台月报中“吨产品电耗”突然比上月下降18%，排查发现是分母产量表在月初补录了上月产量，导致分子分母时间错位。若字典中已明确“产量按自然月最后一日结账数据、补录数据计入次月”，这类问题在评审阶段就能被拦截。可见指标字典的价值不仅在于“统一名字”，更在于把统计口径、取数边界和责任归属固化下来，让能源数据在跨系统、跨部门流转时保持可信和可复现。