# Tuiwen

**Repository Path**: fangshune/tuiwen

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-05-30
- **Last Updated**: 2025-12-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 能源系统状态监测与智能分析平台

## 项目概述

能源系统状态监测与智能分析平台是一个基于Django开发的综合性能源管理系统，旨在实现对能源系统的实时监测、智能分析和优化控制。系统集成了传感器数据采集、设备状态监控、告警系统、能源管理、智能分析、多能协同调度、低碳化管理等功能，为能源系统的高效运行提供全面支持。

## 系统架构

系统采用模块化设计，主要包含以下模块：

1. **核心模块 (core)**：提供基础功能和通用组件
2. **传感器模块 (sensors)**：负责传感器数据采集与实时处理
3. **分析模块 (analytics)**：实现智能分析与决策优化功能
4. **调度模块 (scheduling)**：提供多能协同调度功能
5. **可视化模块 (visualization)**：实现数据可视化与便捷运维功能
6. **可持续性模块 (sustainability)**：负责低碳化与可持续性功能

系统采用前后端分离架构，后端使用Django REST Framework提供API接口，前端可通过WebSocket实现实时数据推送。

## 功能模块

### 1. 传感器数据采集与实时处理
- 支持多种传感器数据采集
- 实时数据处理与存储
- 数据质量校验与异常处理
- 历史数据查询与分析

### 2. 设备状态监控与告警系统
- 设备状态实时监控
- 告警规则配置与管理
- 实时告警推送与处理
- 告警历史记录与分析

### 3. 能源管理与优化控制
- 能源消耗统计与分析
- 能耗趋势预测
- 负载均衡与优化建议
- 能源优化策略管理

### 4. 智能分析与决策优化
- 异常检测与诊断
- 能源效率分析
- 设备故障预测
- 智能决策支持

### 5. 多能协同调度
- 能源类型管理
- 调度任务配置
- 多能协同策略
- 调度效果评估

### 6. 低碳化与可持续性
- 碳排放记录与统计
- 碳中和目标管理
- 可再生能源使用监控
- 环保认证与标准管理

## 技术栈

- **后端框架**：Django 5.2.9
- **REST API**：Django REST Framework 3.16.1
- **实时通信**：Channels 4.3.2
- **数据库**：SQLite (开发), PostgreSQL (生产)
- **数据分析**：Pandas, NumPy, Scikit-learn
- **数据可视化**：Matplotlib
- **消息队列**：Redis, Celery

## 安装与部署

### 开发环境

1. **克隆项目**
   ```bash
   git clone <repository-url>
   cd energy_management
   ```

2. **创建虚拟环境**
   ```bash
   python -m venv venv
   ```

3. **激活虚拟环境**
   ```bash
   # Windows
   .\venv\Scripts\Activate.ps1
   
   # Linux/macOS
   source venv/bin/activate
   ```

4. **安装依赖**
   ```bash
   pip install -r requirements.txt
   ```

5. **配置数据库**
   ```bash
   python manage.py migrate
   ```

6. **创建超级用户**
   ```bash
   python manage.py createsuperuser
   ```

7. **启动开发服务器**
   ```bash
   python manage.py runserver
   ```

### 生产环境

1. **配置环境变量**
   ```bash
   export DJANGO_SECRET_KEY='your-secret-key'
   export DJANGO_ALLOWED_HOSTS='your-domain.com'
   export DJANGO_DB_NAME='energy_management'
   export DJANGO_DB_USER='postgres'
   export DJANGO_DB_PASSWORD='password'
   export DJANGO_DB_HOST='localhost'
   export DJANGO_DB_PORT='5432'
   export REDIS_HOST='localhost'
   ```

2. **使用生产设置**
   ```bash
   export DJANGO_SETTINGS_MODULE='energy_management.settings_production'
   ```

3. **收集静态文件**
   ```bash
   python manage.py collectstatic
   ```

4. **启动服务**
   使用Gunicorn作为WSGI服务器：
   ```bash
   gunicorn energy_management.wsgi:application
   ```

   使用Daphne作为ASGI服务器（用于WebSocket）：
   ```bash
   daphne energy_management.asgi:application
   ```

## 使用说明

### 管理后台

系统提供了Django管理后台，可通过`/admin`访问，使用超级用户账号登录。在管理后台可以：
- 管理用户和权限
- 配置传感器和设备
- 查看和管理告警规则
- 配置能源优化策略
- 管理碳排放和碳中和目标

### API接口

系统提供了完整的REST API接口，主要包括：

#### 传感器模块
- `GET /api/sensors/` - 获取传感器列表
- `GET /api/sensor-data/` - 获取传感器数据
- `POST /api/sensor-data/` - 提交传感器数据

#### 告警模块
- `GET /api/alerts/` - 获取告警列表
- `POST /api/alerts/` - 创建告警
- `PATCH /api/alerts/{id}/` - 更新告警状态

#### 能源管理模块
- `GET /api/energy-consumption/` - 获取能源消耗数据
- `GET /api/energy-forecasts/` - 获取能源预测数据
- `GET /api/optimization-suggestions/` - 获取能源优化建议

#### 多能协同模块
- `GET /api/energy-types/` - 获取能源类型列表
- `GET /api/schedules/` - 获取调度任务列表
- `POST /api/schedules/` - 创建调度任务

#### 可持续性模块
- `GET /api/carbon-emissions/` - 获取碳排放记录
- `GET /api/carbon-goals/` - 获取碳中和目标
- `GET /api/renewable-energy/` - 获取可再生能源使用数据

详细的API文档可通过Swagger或Redoc访问。

## 贡献指南

1. Fork项目
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启Pull Request

## 许可证

本项目采用MIT许可证 - 查看LICENSE文件了解详情。

## 联系方式

如有问题或建议，请联系项目团队。