# save energy

**Repository Path**: showword/save-energy

## Basic Information

- **Project Name**: save energy
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-18
- **Last Updated**: 2026-01-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 节能减排可视化管理系统

Energy Saving and Emission Reduction Visualization System

## 项目简介

基于 React + TypeScript + Vite 构建的节能减排可视化管理系统，旨在通过实时监控能源消耗、分析碳排放数据、评估节能潜力，辅助企业或区域实现绿色低碳发展目标。系统集成了能耗监测、碳排分析、新能源利用和能效评估等核心功能。

## 技术栈

- **前端框架**: React 18 + TypeScript
- **构建工具**: Vite
- **状态管理**: Zustand
- **数据可视化**: ECharts 5.x
- **地图组件**: Leaflet + React-Leaflet
- **UI 组件库**: Ant Design 5.x
- **HTTP 客户端**: Axios
- **实时通信**: WebSocket

## 项目结构

```
energy-reduction-dashboard/
├── src/
│   ├── components/      # 通用组件
│   ├── features/        # 功能模块
│   ├── services/        # API 服务
│   ├── stores/          # 状态管理
│   ├── types/           # TypeScript 类型定义
│   ├── utils/           # 工具函数
│   ├── App.tsx          # 主应用组件
│   ├── main.tsx         # 应用入口
│   └── index.css        # 全局样式
├── public/              # 静态资源
├── .kiro/               # Kiro 规范文档
├── vite.config.ts       # Vite 配置
├── tsconfig.json        # TypeScript 配置
├── package.json         # 项目依赖
└── README.md            # 项目说明
```

## 开发指南

### 安装依赖

```bash
npm install
```

### 启动开发服务器

```bash
npm run dev
```

访问 http://localhost:3000

### 构建生产版本

```bash
npm run build
```

### 代码检查

```bash
npm run lint
```

### 代码格式化

```bash
npm run format
```

### 运行测试

```bash
npm run test
```

## 环境变量

复制 `.env.example` 到 `.env.development` 或 `.env.production` 并配置相应的环境变量：

- `VITE_API_BASE_URL`: API 基础 URL
- `VITE_WS_URL`: WebSocket URL
- `VITE_MAP_API_KEY`: 地图 API 密钥
- `VITE_ENABLE_MOCK_DATA`: 是否启用模拟数据
- `VITE_ENABLE_DEBUG`: 是否启用调试模式

## 核心功能模块

1. **能耗实时监测** - 实时监控水、电、气等各类能源消耗数据与趋势
2. **碳排放核算分析** - 基于能耗数据自动计算碳排放量，展示碳足迹
3. **新能源利用监测** - 监控光伏、风电等清洁能源的发电量与消纳比例
4. **能效水平评估** - 分析重点用能设备的能效状态，识别节能空间
5. **节能潜力分析** - 基于历史数据与行业标准，挖掘节能减排潜力
6. **区域能源地图** - 可视化展示区域内各节点的能耗强度与碳排分布
7. **告警与异常诊断** - 及时发现能耗异常与设备故障，降低能源浪费
8. **绿色绩效考核** - 多维度的节能减排指标考核与数据报表

## 开发规范

- 遵循 ESLint 和 Prettier 配置
- 使用 TypeScript 严格模式
- 组件使用函数式组件和 Hooks
- 状态管理使用 Zustand
- API 调用统一通过 services 层
- 样式使用 CSS Modules 或 Ant Design 主题

## 许可证

MIT