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/ # 版本发布说明
| 层级 | 技术 |
|---|---|
| 框架 | 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 |
8081/test (dev/test/prod 三套配置 application-{env}.yml)development (默认, 使用 dev profile), production (使用 prod profile)./upload (可通过环境变量 UPLOAD_PATH 覆盖)Authorization, secret 通过 JWT_SECRET 环境变量覆盖/system/noticecom.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/ # 气象数据 (台风/天气预警/天气区域/警报)
└── ...
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
src/main/resources/mybatis/ (按业务模块分目录: power/, rbac/, config/, alarm/, datasource/, monitor/ 等)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 — 超短期预测表基于 Velocity 模板,可一键生成前后端 CRUD 代码。
base/framework/config/GenConfigmodule/tool/gen/controller/GenControllermybatis/tool/ 目录这是一个电力功率预测系统,主要功能包括:
基于 BearJia 模板定制,面向电力功率预测业务的前端应用。
| 层级 | 技术 |
|---|---|
| 框架 | 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 |
| 环境 | 文件 | 端口 | 基础路径 | 代理路径 |
|---|---|---|---|---|
| 开发 | .env.dev |
8090 | / |
/dev-api → localhost:8080 |
| 测试 | .env.test |
8088 | / |
/test-api → Nginx 代理 |
| 生产 | .env.prod |
80 | / |
/prod-api → Nginx 代理 |
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 # 多主题登录页
/getRouters 接口)SettingDrawer 配置抽屉切换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
module + framework 分层project 下,按领域分包: config/forecast/alarm/model/data/report/weather/api/assessment/datasource/realtime/rbaccom.ufo.project.{module}.domainsrc/main/resources/mybatis/{module}/I{Domain}Service,实现类 {Domain}ServiceImpl/ufo/ 前缀,页面组件放在 src/views/ufo/ 下src/api/ 下,与后端模块对应com.ufo.project.theoretical(controller/service/domain,Mapper XML 在 src/main/resources/mybatis/theoretical/)/theoretical/power,全部 POSTalgorithm_config/测光法配置,校核阈值读字典 theoretical_power_config;字典缓存为纯 Redis、无 DB 回源,改字典后必须重启后端服务才生效config_station.inverter_quantity 为测光法逆变器台数 n(P = n×(a1×G+a2×T))release_note/{yyyyMMdd}/(目录不存在则新建),按文件拆分: 表结构/ALTER/COMMENT 与菜单 → ddl.sql,字典与初始化数据 → dml.sql,维护 release_note.md(功能说明 / [更新说明] / [备注] 三段)WHERE NOT EXISTS 或先删后插;alter 加 IF NOT EXISTSparent_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