# 虚拟电厂运营管理平台

## 模块信息

| 项目 | 内容 |
|------|------|
| 所属系统（模块） | 虚拟电厂运营管理平台 |
| 分区 | vpp |
| 英文全称 | Virtual Power Plant |
| 描述 | 分布式能源聚合管理、运行监控、需求响应、结算报送 |
| 模块分类 | 应用模块 |
| 工程模块 | service-vpp |

## 功能范围

依据《虚拟电厂平台详细设计文档 V1.0》，涵盖 13 个一级业务模块：

- 客户管理 / 合同管理 / 资源管理
- 运行监控 / 告警管理（复用 `base_*`、`rule_*`）
- 需求响应 / 结算管理 / 信息报送
- 统计报表 / 数据分析 / 系统管理 / 移动端

## 技术栈

- Java + Spring Boot + MyBatis-Plus
- MySQL 8.0（`vpp_*` 业务表 + 复用 `sys_*`/`dmp_*`/`base_*`/`rule_*`）
- TDengine（设备运行曲线）
- Redis（缓存）
- 国密 SM2/SM3（运管平台 UN/DN 对接）

## 模块结构

```
service-vpp/
├── service-vpp-api/         # Feign API 模块
├── service-vpp-biz/         # 业务逻辑与启动模块
│   ├── controller/          # REST 接口（网关前缀 /prod-api/service-vpp）
│   ├── service/             # 业务服务
│   ├── domain/              # 实体（28 张 vpp_* 表）
│   ├── mapper/              # MyBatis Mapper
│   └── resources/sql/       # DDL 脚本 vpp_schema.sql
└── pom.xml
```

## 接口规范

- 网关路径：`/prod-api/service-vpp/{module}/...`
- 响应格式：`ApiResult`（status/code/msg/data）
- 分页参数：`current`、`size`
- 运管平台 DN 端点：`/TokenRequest`、`/Poll` 等（见接口文档第 3 章）

## 启动

```bash
cd service-vpp/service-vpp-biz
mvn spring-boot:run
```

默认端口：`9906`

## 数据库初始化

执行 `service-vpp-biz/src/main/resources/sql/vpp_schema.sql` 创建 VPP 专属表。

平台公共表（用户、设备、告警、规则引擎等）沿用 `usky-cloud.sql`，无需重复创建。