能耗查询
能耗查询用于在明确组织范围、数据对象、能源类型、统计粒度和时间范围后，查看能源数据趋势与边界变化。它是核对数据覆盖情况的查询页面，不是月度事实录入或年度碳排放确认页面。
图中内容为结构示意，数值和组织名称均为脱敏示例。
用途
通过一致的筛选条件查看电、气、水等能源对象的时序数据，识别数据点缺失、期间边界变化和趋势异常，为月度事实核对或碳核算准备提供证据线索。
适用人员与权限
适用于能源管理员、组织数据负责人和负责核算复核的人员。用户必须具有能耗查询页面权限，并且对所选组织、能源对象或计量范围具有读取权限；页面不会因为手册链接而扩大数据范围。
使用前提
- 组织层级和能源对象已经在 CarbonPilot 中配置完成。
- 已知需要查看的组织节点、能源类型和统计粒度（例如日或月）。
- 了解查询期间的开始和结束边界；跨月、跨年时要特别核对边界是否包含在查询结果中。
页面区域说明
| 区域 | 说明 |
|---|---|
| 组织选择 | 选择要查看的组织节点；组织范围改变后，结果应重新加载。 |
| 数据对象 | 选择计量对象、能源资产或页面提供的查询对象。 |
| 能源类型 | 选择电力、天然气、用水等已配置的能源类型；不要用类型名称推断单位。 |
| 统计粒度 | 选择实时、小时、日或月等可用粒度，粒度变化会改变点数和汇总口径。 |
| 时间范围 | 输入开始和结束时间；检查时区、月份首尾和跨年边界。 |
| 趋势区域 | 展示查询结果的趋势、单位和时间点状态。 |
| 数据状态提示 | 区分缺失、未覆盖、延迟或可用点；状态不是数值本身。 |
具体业务任务：核对一个月度能源趋势
- 在页面顶部的“组织选择”中选择目标组织节点，在“数据对象”中选择要核对的计量对象。
- 在“能源类型”选择对应能源，在“统计粒度”选择“月”，输入该年度的起止月份。
- 点击查询后，先核对趋势图横轴的首尾月份，再查看异常点提示和单位。
- 将缺失点、期间边界变化或异常跳变记录下来，回到月度事实工作台核对来源。
预期结果：页面返回所选组织和对象的月度趋势；有数据的点显示实际汇总值，缺失或未覆盖的点保持状态提示，不会自动被当成真实零值。
数据来源与关键口径
- 查询结果来自 CarbonPilot 已接入的计量读数、聚合事实或配置的能源对象；具体来源以页面返回的对象和状态为准。
- 统计粒度决定汇总窗口。日、月等边界切换时，必须使用页面实际显示的时间标签核对开始和结束范围。
- “没有读数”“读数为零”和“尚未覆盖”是不同状态。零值只有在来源明确记录为零时才可解释为零。
- 组织节点、对象和能源类型均可能影响可查询范围；不要跨组织拼接结果后再用于核算。
空数据、缺失、权限与失败处理
- 空结果：确认组织、对象、能源类型和时间范围四项筛选；筛选正确仍为空时，说明当前范围没有可读数据，不要补填零值。
- 空点或缺失点：保留缺失状态，核对计量设备、聚合周期或月度事实来源；不要用相邻月份插值替代系统数据。
- 边界变化：跨月或跨年时，比较首尾时间点和单位，必要时缩短到单月重新查询。
- 没有权限：页面应显示无权访问或空范围提示；联系管理员补充组织读取范围。
- 查询失败：保留筛选条件和页面错误提示，先重试一次；重复失败时提交错误时间和范围，不要根据旧图表猜测新结果。