QWEN.md 19 KB

功率预测系统 (Electricity Service)

Spring Boot + Vue3 前后端分离项目,面向电力(光伏/风电)发电功率预测、气象监控、设备管理的现代化企业级系统。

仓库结构

qx/forecast/
├── forecast-backend-server/    # 后端 — Spring Boot 2.7.18
├── forecast-backend-vue/       # 前端 — Vue 3 + Ant Design Vue
├── forecast-common/            # 公共模块 (前后端共用)
├── forecast-dao/               # 数据访问层
├── gateway/                    # 微服务网关 (forecast-device-gateway)
├── pom.xml                     # 多模块根 POM
├── doc/                        # 项目文档
├── 资料/                        # 参考资料
└── release_note/               # 版本发布说明

1. forecast-backend-server — 后端服务

1.1 技术栈

层级 技术
框架 Spring Boot 2.7.18, Java 1.8
数据库 PostgreSQL (druid 连接池)
ORM MyBatis + PageHelper 分页插件
安全 Spring Security + JWT Token
缓存 Redis (spring-boot-starter-data-redis)
任务调度 Quartz
JSON Fastjson2 2.0.47
文件/Excel EasyExcel 4.0.3, Apache POI 5.2.5
代码生成 Velocity 模板
验证码 EasyCaptcha
支付 IJPay (微信/支付宝/银联/京东/PayPal)
AI OpenAI Java SDK 4.8.0

1.2 项目配置

  • 端口: 8081
  • 上下文: /
  • Profile: test (dev/test/prod 三套配置 application-{env}.yml)
  • Maven Profile: development (默认, 使用 dev profile), production (使用 prod profile)
  • 文件上传路径: ./upload (可通过环境变量 UPLOAD_PATH 覆盖)
  • Token 有效期: 30 分钟, header=Authorization, secret 通过 JWT_SECRET 环境变量覆盖
  • XSS 防护: 全局开启, 排除 /system/notice

1.3 包结构

com.ufo/
├── ElectricityServiceApplication.java    # 启动类
│
├── base/
│   ├── common/                           # 通用组件
│   │   ├── core/                         # 核心基础类 (文本工具等)
│   │   ├── constant/                     # 常量定义
│   │   ├── enums/                        # 枚举类
│   │   ├── filter/                       # 过滤器 (XSS 等)
│   │   ├── utils/                        # 工具类
│   │   └── xss/                          # XSS 防护
│   │
│   └── framework/                        # 框架层
│       ├── aspectj/                      # AOP 切面
│       ├── config/                       # 配置类
│       │   ├── ApplicationConfig         # 应用配置
│       │   ├── DruidConfig               # 数据库连接池
│       │   ├── FilterConfig              # 过滤器链
│       │   ├── MyBatisConfig             # MyBatis 配置
│       │   ├── RedisConfig               # Redis 序列化
│       │   ├── ResourcesConfig           # Web 资源
│       │   ├── SecurityConfig            # Spring Security/JWT
│       │   ├── ScheduleConfig            # Quartz 定时任务
│       │   ├── ThreadPoolConfig          # 线程池
│       │   └── ...
│       ├── datasource/                   # 多数据源支持
│       ├── interceptor/                  # 拦截器
│       ├── manager/                      # 异步任务管理
│       ├── redis/                        # Redis 工具
│       ├── security/                     # 安全认证
│       ├── task/                         # 定时任务
│       └── web/                          # Web 层基类
│
├── module/                               # 基础业务模块 (类 RuoYi)
│   ├── common/                           # 通用控制器
│   ├── system/                           # 系统管理 (用户/角色/菜单/字典/岗位/部门等)
│   ├── monitor/                          # 系统监控 (在线用户/操作日志/登录日志/服务/缓存/定时任务)
│   └── tool/                             # 系统工具 (代码生成 GenController)
│
└── project/                              # 业务模块
    ├── alarm/                            # 告警管理 (告警记录/规则/规则模板/故障处理/巡检记录/监控发送)
    ├── api/                              # API 开放平台 (OAuth2/访问控制/版本发布/API 记录)
    ├── assessment/                       # 考核管理 (指标/规则/任务)
    ├── config/                           # 配置管理 (站点/设备/测点/通道/协议/省份城市/供应商/限电等)
    │   ├── ConfigStationController       # 站点配置
    │   ├── ConfigDeviceController        # 设备配置
    │   ├── ConfigPointController         # 测点配置
    │   ├── ConfigStationPowerLimitCtrl   # 站点功率限额
    │   └── ...
    ├── data/                             # 数据报表 (光伏/风电数据对比、短期预测报表等)
    ├── datasource/                       # 数据采集源 (抓数据配置/文件分析/用户关联)
    ├── forecast/                         # ⭐ 功率预测 (核心业务)
    │   ├── shortterm/
    │   │   ├── power/                    # 短期功率预测 (原始/修正/发布/回填/报表)
    │   │   └── weather/                  # 短期气象预测 (原始/修正/发布/回填/报表)
    │   ├── supershorted/                 # 超短期预测 (原始/修正/发布/回填/报表)
    │   └── power/                        # 超短期功率预测
    ├── model/                            # 模型管理 (算法/版本/训练任务/预测任务/评估/精度排名/触发策略)
    ├── rbac/                             # RBAC 权限 (用户/角色/菜单/模块/角色菜单/用户角色)
    ├── realtime/                         # 实时数据 (超短期/站点设备功率/设备天气/气象站)
    ├── report/                           # 报表管理 (站点/模板/任务/指标统计/多模型)
    ├── weather/                          # 气象数据 (台风/天气预警/天气区域/警报)
    └── ...

1.4 启动方式

cd forecast-backend-server
# 默认使用 test profile
mvn spring-boot:run

# 或指定 profile
mvn spring-boot:run -Dspring.profiles.active=dev
mvn spring-boot:run -Dspring.profiles.active=prod

# 打包
mvn clean package -Pproduction

1.5 数据库

  • 数据库: PostgreSQL
  • MyBatis Mapper XML 位置: src/main/resources/mybatis/ (按业务模块分目录: power/, rbac/, config/, alarm/, datasource/, monitor/ 等)
  • SQL 脚本: src/main/resources/sql/
    • electricity_init_new.sql — 初始化表结构
    • electricity_init_new_dm.sql — 达梦数据库版本
    • electricity_mock_new.sql — 模拟数据
    • 20260819_short_term_power_forecasting.sql — 短期预测表
    • 20260819_ultra_short_term_power_forecasting.sql — 超短期预测表

1.6 代码生成器

基于 Velocity 模板,可一键生成前后端 CRUD 代码。

  • 配置入口: base/framework/config/GenConfig
  • 控制器: module/tool/gen/controller/GenController
  • Mapper XML 位于 mybatis/tool/ 目录

1.7 核心业务领域

这是一个电力功率预测系统,主要功能包括:

  1. 功率预测 (核心): 短期/超短期功率预测和气象预测,每个预测周期有原始(RO)→修正(CO)→发布(IS)→回填(BA)→报表(RP) 五个状态
  2. 站点设备管理: 光伏/风电站点、设备、测点、通道、协议的 CRUD 配置
  3. 实时数据采集: 设备功率、天气、气象站等实时数据
  4. 气象数据: 台风预警、天气警报、天气区域
  5. 告警管理: 告警规则、告警记录、故障处理、巡检记录
  6. 模型管理: 预测模型算法、版本、训练/预测任务、精度评估
  7. 报表统计: 气象指标、考核指标、报表模板和任务
  8. 系统管理: 基于 RBAC 的权限体系 (用户/角色/菜单)
  9. API 开放平台: OAuth2 客户端、API 版本发布、访问控制

2. forecast-backend-vue — 前端

基于 BearJia 模板定制,面向电力功率预测业务的前端应用。

2.1 技术栈

层级 技术
框架 Vue 3.4.21 (Composition API)
UI 组件库 Ant Design Vue 4.1.2
构建工具 Vite 5.1.4
状态管理 Pinia 2.1.7
路由 Vue Router 4.3.0
HTTP 客户端 Axios 1.6.7
图表 ECharts 5.6.0
表单 FormCreate (ant-design-vue) 3.2.31
富文本 WangEditor 5.1.23
代码高亮 vue3-highlightjs
工具库 VueUse 10.9.0, dayjs 1.11.10, JS Cookie, SortableJS
开发辅助 Unplugin Auto Import, Unplugin Vue Components

2.2 环境配置

环境 文件 端口 基础路径 代理路径
开发 .env.dev 8090 / /dev-api → localhost:8080
测试 .env.test 8088 / /test-api → Nginx 代理
生产 .env.prod 80 / /prod-api → Nginx 代理

2.3 目录结构

forecast-backend-vue/
├── config/vite/                    # Vite 配置模块化
├── src/
│   ├── api/                        # API 接口 (按业务域分包)
│   │   ├── alarm/                  # 告警接口
│   │   ├── assessment/             # 考核接口
│   │   ├── config/                 # 配置接口 (站点/设备/测点等)
│   │   ├── data/                   # 数据报表接口
│   │   ├── datasource/             # 数据采集接口
│   │   ├── forecast/               # 预测接口 (短期/超短期)
│   │   ├── model/                  # 模型接口
│   │   ├── monitor/                # 监控接口
│   │   ├── power/                  # 功率接口
│   │   ├── rbac/                   # 权限接口
│   │   ├── realtime/               # 实时数据接口
│   │   ├── report/                 # 报表接口
│   │   ├── system/                 # 系统管理接口
│   │   └── weather/                # 气象接口
│   │
│   ├── assets/                     # 静态资源
│   ├── components/                 # 公共组件
│   │   ├── BearJiaProTable/        # 统一表格组件 (含搜索/分页/导出)
│   │   ├── SearchForm/             # 搜索表单组件
│   │   ├── TableActionBar/         # 表格操作栏
│   │   ├── PageContainer/          # 页面容器
│   │   ├── DictTag/                # 字典标签
│   │   ├── FileUpload/             # 文件上传
│   │   ├── ImageUpload/            # 图片上传
│   │   ├── ImagePreview/           # 图片预览
│   │   ├── IconSelector/           # 图标选择器
│   │   ├── Ellipsis/               # 文本省略
│   │   ├── editor/                 # 富文本编辑器 (WangEditor)
│   │   ├── layout/                 # 布局组件 (侧边栏/顶栏/历史导航/设置抽屉)
│   │   └── common/                 # 通用组件 (消息中心/全局加载/搜索/全屏)
│   │
│   ├── composables/                # Composition API 组合函数
│   │   ├── useDict.js              # 字典管理
│   │   ├── useTable.js             # 表格逻辑
│   │   └── useFullscreen.js        # 全屏处理
│   │
│   ├── config/                     # 运行时配置
│   │   └── system.config.js
│   │
│   ├── directive/                  # 自定义指令
│   │   └── permission/             # 权限指令 v-hasPermi
│   │
│   ├── layout/                     # 布局文件
│   │   ├── BaseLayout.vue          # 主布局 (含侧边栏/顶栏/标签页)
│   │   ├── FrontendLayout.vue      # 前端展示页布局
│   │   ├── ParentView/             # 父级容器
│   │   └── InnerLink/              # 内嵌链接
│   │
│   ├── plugins/                    # Vue 插件
│   │   ├── auth.js                 # 权限校验
│   │   ├── cache.js                # 缓存工具
│   │   ├── errorHandler.js         # 全局错误处理
│   │   ├── modal.js                # 弹窗封装
│   │   ├── table.js                # 表格插件
│   │   ├── tab.js                  # 标签页插件
│   │   └── dayjs.js                # 日期配置
│   │
│   ├── router/                     # 路由配置
│   │   ├── vueRouter.js            # Vue Router 实例 (含守卫)
│   │   ├── routes.js               # 路由定义 (公共+动态)
│   │   ├── electricity.js          # 电力业务路由
│   │   └── frontend.js             # 前端展示路由
│   │
│   ├── stores/                     # Pinia 状态管理
│   │   ├── app.js                  # 应用状态
│   │   ├── user.js                 # 用户信息/Token
│   │   ├── permission.js           # 动态路由 (菜单权限过滤)
│   │   ├── tagsView.js             # 标签页状态
│   │   └── tableConfig.js          # 表格配置
│   │
│   ├── style/                      # 全局样式 (Less)
│   │   └── global.less
│   │
│   ├── utils/                      # 工具函数
│   │   ├── request.js              # Axios 封装 (拦截器/Token/错误处理)
│   │   ├── theme.js                # 主题服务 (亮色/暗色/系统跟随)
│   │   └── configInit.js           # 配置初始化
│   │
│   └── views/                      # 页面组件
│       ├── ufo/                    # ⭐ 业务页面 (统一 /ufo/ 前缀)
│       │   ├── workbench/          # 主看板/工作台
│       │   ├── electricity/        # 电力核心业务
│       │   │   ├── forecast/       # 功率预测页面 (短期/超短期)
│       │   │   ├── analysis/       # 数据分析页面
│       │   │   ├── dashboard/      # 数据看板
│       │   │   ├── realtime/       # 实时数据页面
│       │   │   ├── report/         # 报表页面
│       │   │   ├── device/         # 设备管理页面
│       │   │   ├── weather/        # 气象页面
│       │   │   └── fault/          # 故障处理页面
│       │   ├── config/             # 配置管理页面
│       │   │   └── station/        # 站点配置 (含设备/测点/模块子页面)
│       │   ├── system/             # 系统管理页面 (用户/角色/菜单/字典/岗位/部门/通知)
│       │   ├── monitor/            # 系统监控 (在线用户/操作日志/登录日志/服务/缓存/定时任务/Druid)
│       │   ├── datareport/         # 数据报表页面
│       │   └── tool/               # 系统工具 (代码生成)
│       ├── frontend/               # 前端展示页
│       ├── error/                  # 错误页 (404 等)
│       └── LoginPage[23].vue       # 多主题登录页

2.4 核心功能模块

  1. 主看板/工作台: 系统总览,关键指标展示
  2. 功率预测: 短期/超短期功率预测和气象预测的前端操作界面
  3. 数据分析: 预测数据分析与可视化
  4. 设备管理: 光伏/风电站点、设备、测点、通道配置
  5. 实时数据: 设备功率、天气、气象站实时数据展示
  6. 报表管理: 预测报表、统计报表查看与导出
  7. 告警管理: 告警记录查看、故障处理、巡检记录
  8. 气象中心: 台风预警、天气警报管理
  9. 系统管理: 用户/角色/菜单/字典/岗位/部门管理
  10. 系统监控: 在线用户/操作日志/登录日志/服务/缓存/定时任务
  11. 数据字典: 下拉选项配置与管理

2.5 前端特色

  • 动态路由: 基于菜单权限动态加载路由 (后端 /getRouters 接口)
  • 多布局模式: 侧边栏/顶栏/混合布局,通过 SettingDrawer 配置抽屉切换
  • 主题系统: 亮色/暗色主题,支持跟随系统 (基于 Less 变量)
  • BearJiaProTable: 统一表格组件,集成搜索、分页、列设置、导出功能
  • 历史导航: 智能标签页管理,支持右键菜单
  • FormCreate: 动态表单渲染
  • 组件自动导入: Unplugin Auto Import + Unplugin Vue Components,无需手动 import

2.6 启动方式

cd forecast-backend-vue

# 安装依赖
yarn install   # 或 npm install

# 启动开发服务器 (dev 环境, 端口 8090)
yarn dev

# 测试环境构建
yarn build:test

# 生产环境构建
yarn build:prod

# 预览构建结果
yarn preview

# 代码检查与格式化
yarn lint
yarn lint:fix
yarn format

3. 开发约定

  • 项目参考 BearJia/RuoYi-Vue 架构,基础模块遵循 module + framework 分层
  • 业务模块放在 project 下,按领域分包: config/forecast/alarm/model/data/report/weather/api/assessment/datasource/realtime/rbac
  • Controller → Service → Mapper 三层架构
  • Domain 对象统一放在 com.ufo.project.{module}.domain
  • Mapper XML 统一放在 src/main/resources/mybatis/{module}/
  • 接口命名: Service 使用 I{Domain}Service,实现类 {Domain}ServiceImpl
  • 前端路由统一使用 /ufo/ 前缀,页面组件放在 src/views/ufo/ 下
  • 前端 API 接口按业务域分包,放在 src/api/ 下,与后端模块对应

3.1 理论功率模块

  • 包位置: com.ufo.project.theoretical(controller/service/domain,Mapper XML 在 src/main/resources/mybatis/theoretical/)
  • 16 个查询/导出接口统一基路径 /theoretical/power,全部 POST
  • 测光法系数 a1/a2 读字典 algorithm_config/测光法配置,校核阈值读字典 theoretical_power_config;字典缓存为纯 Redis、无 DB 回源,改字典后必须重启后端服务才生效
  • config_station.inverter_quantity 为测光法逆变器台数 n(P = n×(a1×G+a2×T))

3.2 SQL 脚本规范(release_note)

  • 新版本脚本放 release_note/{yyyyMMdd}/(目录不存在则新建),按文件拆分: 表结构/ALTER/COMMENT 与菜单 → ddl.sql,字典与初始化数据 → dml.sql,维护 release_note.md(功能说明 / [更新说明] / [备注] 三段)
  • 全部脚本可重复执行: 建表先 drop 再 create(含 sequence);insert 加 WHERE NOT EXISTS 或先删后插;alter 加 IF NOT EXISTS
  • 菜单脚本格式: 一级菜单 M 类型 parent_id=0 字面量,path 单英文单词,component/query/route_name/perms 留空;二级菜单 C 类型 parent_id 按父菜单名称反查(须加 and t.parent_id = 0 限定),path/component/route_name/perms 必填;menu_id 统一用 nextval(pg_get_serial_sequence('sys_menu','menu_id'));生成时调用方只需提供菜单名称 / order_num / 所属一级菜单名称 / 页面 path