EMS 报表与收益

设计目标

报表中心将高频时序转换为可核对的运营数据，并进一步结合电价形成收益。核心要求不是“能算出数字”，而是数字口径统一、输入质量透明、计算过程可重跑、历史版本可追溯、已审核结果不可静默覆盖。

这页主要帮用户看三件事：电站发了多少电、产生了多少收益、这些数字靠不靠谱。页面把发电量、收益、减碳、上网电量和质量异常放在一起，业务人员不用翻原始数据，也能快速判断当天或当月的运营表现。

收益离不开电价。电价管理负责维护峰、平、谷等价格规则，并把规则绑定到具体电站。系统后续计算收益时，会按电站时区和当时生效的价格逐段计算，而不是拿一个平均价粗略估算。

报表范围

• 电站报表：发电、用电、上网、下网、充电、放电、收益和运行时长。
• 逆变器报表：直流侧、交流侧、发电量、转换效率与运行状态。
• PCS 报表：充放电量、充放电时长、峰值功率和状态统计。
• 储能报表：SOC 区间、可用电量、循环量、充放电量与收益。

常用指标

所有指标需要定义来源、公式、方向、单位、聚合方式和缺失处理。没有正式定义的指标不能仅根据前端字段名称临时拼装。

报表生命周期

原始采样
  -> 按设备和时间窗口聚合
  -> 质量检查与缺口记录
  -> 电站 / 设备报表物化
  -> 电价与收益计算
  -> 审核、重算、导出

报表状态

DRAFT -> CALCULATED -> QUALITY_WARNING -> PUBLISHED -> APPROVED -> ARCHIVED
             \-> FAILED

覆盖率不足或存在估算数据时进入 QUALITY_WARNING，允许查看但不作为正式结算。PUBLISHED 表示面向业务用户发布，APPROVED 表示完成审核，后续变更只能产生新版本。

电价方案

电价方案按电站时区解析，可配置峰、平、谷等时段及对应价格。方案可复制、编辑、套用到多电站，并保留生效时间。历史报表使用当时有效的方案版本，调整新价格不会静默改写已归档结果。

电价模型

一个方案包含方案基本信息、版本、生效区间和多个时段。时段支持尖、峰、平、谷及自定义名称，分别配置购电价格、上网价格和可选服务费。必须校验一天 24 小时没有重叠；是否允许空档由业务规则决定，空档存在时收益标记不完整。

电价套用关系记录站点、方案版本、生效时间和失效时间。同一电站同一时刻只能有一个有效方案，切换方案时自动闭合旧区间。

收益口径

关键经营指标

光伏自用电量 = min(光伏发电量, 同期负荷可消纳量)
光伏上网电量 = 并网点反送累计量或经平衡校验后的上网量
自发自用率   = 光伏自用电量 / 光伏发电量
光伏消纳率   = (光伏发电量 - 弃光电量) / 光伏发电量
储能效率     = 有效放电量 / 有效充电量
等效循环次数 = 放电吞吐量 / 额定可用容量

当分母为 0 或数据缺失时返回空值与原因，不返回 0% 误导用户。

可追溯性

每份报表记录资源范围、时间范围、数据版本、电价方案、缺失点数和计算时间。当历史补拉或电价修订触发重算时，旧版结果和重算原因保留，便于审计与对账。

报表详情建议提供“计算说明”抽屉，显示输入设备、指标版本、覆盖率、估算比例、绑定版本、电价方案、任务批次和公式版本。用户无需查看数据库即可解释数字来源。

计算流水线

采样水位线 -> 5 分钟窗口 -> 小时物化 -> 日/月/年结算
                    |             |
                    +-> 质量门禁 --+-> 电价解析 -> 收益版本

每个阶段输出 jobId、输入水位线、输出版本和统计计数。下游只消费已成功提交的版本，失败任务可从最后成功窗口继续，不重复覆盖已审核结果。

任务调度顺序

1. 5 分钟历史窗口关闭并通过基础质量检查。
2. 每小时第 10 分钟左右计算上一完整小时，预留迟到安全窗口。
3. 每日凌晨按各电站本地时区汇总上一日。
4. 月初、年初基于已完成日/月数据生成高层报表。
5. 缺口修复与迟到数据任务发现变更后，按依赖顺序触发重算。

同一租户、站点、报表类型和时间窗口使用唯一任务键，多实例调度通过分布式锁和数据库唯一约束共同防重。

收益公式与方向

统一以“用户视角”定义正负：购电成本为负、售电收入为正。储能收益按放电电量乘放电时段价格减去充电成本、转换损耗和服务费；电量统一使用 kWh，功率统一使用 kW，金额保留 2 位小数但中间计算保留 6 位。

光伏收益 = 自用电量 × 购电价 + 上网电量 × 上网价
储能收益 = 放电电量 × 放电价 - 充电电量 × 充电价 - 损耗成本 - 服务费
净收益   = 光伏收益 + 储能收益 + 节能收益 + 其他收益

分时段计算

收益不能用“全天总电量 × 某个平均电价”代替，应先在最小结算粒度内匹配价格：

窗口购电成本 = 窗口下网电量 × 对应购电价
窗口上网收入 = 窗口上网电量 × 对应上网价
日收益 = Σ窗口收入 - Σ窗口成本 - 损耗成本 - 服务费

跨越价格边界的窗口需要按边界切分，或使用足够小的 5 分钟粒度避免明显偏差。

储能基线

储能收益既可以按实际充放电现金流计算，也可以与“无储能基线”比较。两种口径必须明确区分：实际现金流反映充放电时段价差，基线收益还需要构建同一负荷和光伏条件下未启用储能的理论购电成本。

对账与导出

导出文件携带报表版本、生成时间、时区、电价方案 ID、数据覆盖率和筛选条件。财务确认后将版本标记为 APPROVED，电价或历史数据变更只能生成新版本，不允许修改已批准行。

数据质量门禁

质量门槛可以租户级配置，但降低门槛必须记录审批和生效时间。

重算策略

重算请求包含资源范围、时间范围、原因、目标公式版本和请求号。系统先分析受影响的最小窗口，再生成新版本。大范围重算进入异步任务，提供预计窗口数、进度、失败明细和取消能力。

重算完成后输出旧值、新值、差异比例和影响原因。已批准版本保持只读，新版本需要重新发布或审核。

性能与导出

页面查询优先读取物化报表，不在线扫描原始时序。列表分页、汇总卡片和趋势图使用同一筛选范围；大于 31 天或超过行数上限的明细导出转异步文件任务，避免 HTTP 长连接超时。

报表验收

验收至少使用一个完整晴天、一个低发电日、一个设备离线日和一个跨电价边界日，对照原始表计、5 分钟历史和人工计算。核对功率方向、累计量差分、时区、边界时刻、覆盖率、金额舍入和重算版本。

经营收益引擎：用户到底看什么

报表与收益模块不是简单做一张表，而是把现场数据变成能解释经营结果的数字。用户打开页面后，能直接看到“发了多少电、赚了多少钱、收益来自哪里、有没有数据异常”。管理层看总览，运营看趋势，财务看口径，运维看质量问题。

收益算法说明

平台以最小结算窗口匹配电价，不用全天均价粗算。每个窗口先完成电量归因，再按当时有效的购电价、上网价和电站时区计算收益，最终汇总成日、月、年报表。

自用电量 = max(光伏发电量 - 上网电量, 0)
上网收益 = 上网电量 × 上网电价
自发自用节省 = 自用电量 × 购电电价
储能套利收益 = 放电量 × 放电时段购电价 - 充电量 × 充电时段购电价
页面总收益 = 上网收益 + 自发自用节省 + 储能套利收益

当前页面总收益强调“发电与储能带来的经营增量”，购电成本作为独立字段展示，方便区分节省、收入与电网现金支出。需要财务净现金流时，可在平台收益基础上叠加运维费、服务费、容量费、补贴、考核和合同结算项。

技术亮点

• 按时段精算：峰、平、谷价格不同，系统按最小时间窗口逐段套价，不用平均价糊弄结果。
• 能解释来源：总收益可以拆成上网收益、自发自用节省、储能套利和购电成本，方便对账。
• 能发现问题：数据缺失、电表方向不对、累计量回拨、电价没绑定，页面都会给出质量提示。
• 能保留版本：电价或历史数据改了，只生成新版本，不偷偷覆盖已经确认过的报表。
• 能支撑经营：同一套数据既能做日报月报，也能做投资回报、站点排名和托管服务证明。

经营分析场景

对于园区业主，报表展示光伏消纳率、储能峰谷套利、今日节省和月度收益趋势，直接支撑能源资产投资回报评估。对于安装商，报表用于对比不同站点的发电效率、设备可用率和运维质量，形成托管服务的可量化交付结果。对于集团总部，报表提供跨站排名、收益归因和异常波动解释，帮助管理层识别最值得扩容、改造或重点运维的站点。