Skip to content

开发资产:能源消耗数据采集

← 返回场景概览 | 上一阶段:方案设计


📦 资产清单

本场景沉淀的可复用开发资产,帮助快速实现类似业务场景。

Skills(5个)

名称用途类型
数据采集频率规则根据能源类型自动设置采集频率业务规则
数据采集失败重试规则采集失败后的自动重试机制业务规则
数据标准化规则统一不同数据源的格式和单位数据处理
数据质量校验规则多维度校验数据完整性和准确性数据校验
数据修正审批规则重要数据修正的审批流程业务规则

Prompts(3个)

名称用途场景
数据源配置向导引导用户配置数据源连接参数系统配置
校验规则配置向导引导用户配置数据质量校验规则系统配置
数据异常分析分析数据异常的原因并提供修正建议数据处理

代码模板(3个)

名称技术栈说明
数据采集引擎Node.js + TypeScript支持多数据源的定时采集引擎
数据质量校验 APIExpress + TypeScript实现多维度数据校验的 REST API
数据采集监控面板React + Ant Design实时监控数据采集状态的前端组件

📖 使用说明

Skills 使用方法

  1. 复制 Skill 内容到项目的 .claude/skills/ 目录
  2. 在 AI 工具中通过 @skill-name 引用
  3. 根据实际业务调整规则参数

Prompts 使用方法

  1. 复制 Prompt 内容到项目的 .claude/prompts/ 目录
  2. 根据实际情况替换变量占位符(用 标记)
  3. 在开发过程中直接使用或作为参考

代码模板使用方法

  1. 查看代码模板了解实现思路
  2. 复制代码到项目中
  3. 根据实际技术栈和需求调整

🎯 核心规则摘要

数据采集规则

  • 采集频率规则:电力/天然气日度采集,煤炭/柴油月度采集
  • 失败重试规则:失败后自动重试3次(5分钟、30分钟、人工介入)
  • 数据标准化规则:统一单位换算、格式转换、数值精度

数据质量规则

  • 缺失值检查:必填字段不能为空
  • 合理范围检查:数值在合理范围内(如用电量 > 0)
  • 同比环比检查:同比变化不超过50%,环比变化不超过30%
  • 重复值检查:同一时间同一设备不能重复录入

数据修正规则

  • 修正权限规则:仅授权人员可修正数据
  • 修正记录规则:所有修正操作必须记录
  • 修正审批规则:修正幅度 > 20% 需要审批

🔧 API 接口建议

基于能源消耗数据采集场景的核心功能,建议实现以下 API 接口:

数据源管理

  • POST /api/datasources - 创建数据源配置
  • GET /api/datasources - 查询数据源列表
  • PUT /api/datasources/{id} - 更新数据源配置
  • POST /api/datasources/{id}/test - 测试数据源连接

采集规则管理

  • POST /api/collection-rules - 创建采集规则
  • GET /api/collection-rules - 查询采集规则列表
  • PUT /api/collection-rules/{id} - 更新采集规则
  • POST /api/collection-rules/{id}/trigger - 手动触发采集

能源数据管理

  • POST /api/energy-consumption - 人工录入能源数据
  • GET /api/energy-consumption - 查询能源数据列表
  • GET /api/energy-consumption/{id} - 查询数据详情
  • PUT /api/energy-consumption/{id} - 修正数据
  • POST /api/energy-consumption/validate - 数据质量校验
  • GET /api/energy-consumption/export - 导出数据

采集监控

  • GET /api/collection-logs - 查询采集日志
  • GET /api/collection-status - 查询采集状态
  • GET /api/data-quality-report - 数据质量报告

🎨 前端页面/组件建议

基于能源消耗数据采集场景的业务流程,建议实现以下页面/组件:

配置管理

  • 数据源配置页面:配置数据源连接参数,支持多种数据源类型
  • 采集规则配置页面:设置采集频率、数据范围、校验规则

数据管理

  • 能源数据列表页面:展示能源消耗数据,支持筛选、排序、分页
  • 数据录入表单:人工录入能源数据,支持单条录入和批量导入
  • 数据详情页面:展示单条数据的完整信息和修正历史

监控与分析

  • 采集监控仪表盘:实时监控采集状态、成功率、异常数据
  • 数据质量报告:展示数据完整性、准确性、一致性指标
  • 能耗趋势图表:可视化展示能耗趋势和同比环比分析

移动端

  • 移动端抄表APP:支持现场抄表和拍照上传凭证

💡 实施建议

开发优先级

  1. 第一阶段:实现核心数据采集功能

    • 数据源配置和连接
    • 定时采集任务
    • 人工数据录入
    • 基础数据质量校验
  2. 第二阶段:完善数据质量保障

    • 多维度数据校验
    • 数据修正和审批流程
    • 采集失败重试机制
    • 数据标准化处理
  3. 第三阶段:增强监控和分析能力

    • 实时采集监控仪表盘
    • 数据质量报告
    • 能耗趋势分析
    • 异常预警通知
  4. 第四阶段:优化用户体验

    • 移动端抄表APP
    • 批量数据导入导出
    • 智能数据修正建议
    • 性能优化

技术选型建议

  • 后端:Node.js + Express + TypeScript(或 Java + Spring Boot)
  • 前端:React + TypeScript + Ant Design(或 Vue 3 + Element Plus)
  • 数据库:PostgreSQL(关系数据)+ InfluxDB(时序数据)+ Redis(缓存)
  • 任务调度:Node-cron(或 Quartz)
  • 部署:Docker + Kubernetes

注意事项

  • 数据安全:连接参数加密存储,数据权限按角色和部门控制
  • 数据完整性:保证数据采集的完整性和一致性,避免数据丢失
  • 系统稳定性:采集失败自动重试,记录详细日志便于问题排查
  • 可扩展性:支持灵活配置数据源和校验规则,便于扩展新的能源类型
  • 用户体验:提供友好的配置向导和数据录入界面,降低使用门槛

数据源对接建议

  • 优先级:先对接数据量大、采集频率高的数据源(如电表系统)
  • 测试:充分测试连接稳定性和数据准确性
  • 备份:保留原始数据,便于问题排查和数据恢复
  • 增量采集:支持增量采集,避免重复采集历史数据

📚 相关资源


创建时间:2026-05-03
维护者:易活好场景设计团队

基于 AI 辅助开发,快速、灵活、可靠