项目介绍

慧知虚拟电厂平台面向充电桩资源参与电网需求响应:前端给用户看仪表盘、事件调度、执行监测、评估结算和收益,后端负责权限、数据、状态流转、调度算法与结算口径。简单理解,它不是一个孤立页面项目,而是一整套从资源台账到收益分账的需求响应运营平台。
工程结构
vpp(仓库根)
├── pc_web # Vue 2 管理台与需求响应大屏
└── platform-service # 微服务后端
├── vpp-gateway # 统一 API 网关(48080)
├── vpp-auth # 认证授权中心(39200)
├── vpp-api # 跨服务接口契约
├── vpp-common # 通用工程能力
│ ├── vpp-common-core
│ ├── vpp-common-security
│ ├── vpp-common-datascope
│ ├── vpp-common-datasource
│ ├── vpp-common-mybatisplus
│ ├── vpp-common-redis
│ ├── vpp-common-log
│ ├── vpp-common-message
│ ├── vpp-common-seata
│ └── vpp-common-swagger
├── vpp-event-service # 事件与资源域业务服务(39310)
├── vpp-dispatch-service # 调度与经营域业务服务(39320)
├── vpp-modules
│ ├── vpp-system # 租户、用户、角色、菜单(39201)
│ ├── vpp-file # 文件服务(39300)
│ ├── vpp-gen # 代码生成(39202)
│ └── vpp-job # 分布式任务调度(39204)
├── vpp-visual
│ └── vpp-monitor # 服务运行监控面板(39100)
├── vpp-register # 内置 Nacos(8848)
├── sql # 系统库、业务表与 Nacos 种子配置
└── docker # docker-compose 一键部署
后端业务服务
vpp-event-service(事件与资源域)
com.witos.vpp.event
├── controller # 场站、资源、事件、申报、仪表盘 API
├── domain # dr_station、dr_resource、dr_event、dr_apply 模型
├── mapper # MyBatis-Plus 数据访问层
├── service # 申报校验、容量口径、聚合统计
└── task # 事件状态流转、分钟/日功率、容量快照、桩状态任务
vpp-dispatch-service(调度与经营域)
com.witos.vpp.dispatch
├── controller # 调度分配、执行监测、效果评估、结算分账 API
├── domain # dr_dispatch、dr_execute、dr_assess、dr_settlement 模型
├── mapper # MyBatis-Plus 数据访问层
└── service # 分配算法、偏差分析、评估积分、三方分账
前端业务域
views/index:仪表盘(登录首页),可调容量指标卡、容量趋势、收益分成与最近事件。vpp/station:场站管理,站点主数据与分成比例。vpp/resource、vpp/resource-stats:充电桩台账与资源统计。vpp/event、vpp/event-detail:事件管理与事件详情工作台。vpp/apply:需求响应申报与确认。vpp/dispatch:调度分配与两级确认下发。vpp/execute:执行监测与偏差分析。vpp/assess:效果评估。vpp/settlement、vpp/earnings:结算管理与我的收益。vpp/screen:需求响应运行监控大屏。
关键设计原则
- 事件是一条主线:申报、分配、执行、评估、结算全部挂在事件上。
- 容量与基线口径在模型层定义一次,页面与结算共用。
- 事件状态由定时任务推进,不依赖用户请求触发。
- 结算金额由服务端按电量与比例计算,前端不产生入账数字。
- 业务数据统一逻辑删除并保留创建/更新留痕,结算争议可复核。
平台产品气质
慧知虚拟电厂平台不是单一后台管理系统,而是一套面向需求响应业务的聚合运营平台。工程结构围绕“资源、事件、调度、执行、评估、结算、安全、运维”展开。每个服务能独立演进,也共享同一套租户、权限、数据口径和审计体系。
| 层级 | 能力表达 | 代表模块 |
|---|---|---|
| 资源层 | 场站、桩、容量口径、基线与状态采集 | event-service、task |
| 调度层 | 事件状态机、桩级分配、两级确认下发 | event-service、dispatch-service |
| 应用层 | 仪表盘、事件工作台、执行监测、运行大屏 | pc_web views |
| 治理层 | 多租户权限、场站收窄、操作日志、逻辑删除 | system、common-security |
工程化优势
项目采用模块化工程结构,业务服务按“事件/资源”与“调度/经营”两个域拆分,既方便业务快速迭代,也能支撑生产级稳定性。docker-compose 提供一键部署,SQL 脚本覆盖系统库、业务表与 Nacos 种子配置。后续要扩展资源类型、接入真实采集通道或对接电网侧系统,都有清晰的落点。
