# helio-boot-modular **Repository Path**: zhengfuping1606/helio-boot-modular ## Basic Information - **Project Name**: helio-boot-modular - **Description**: 基于 Spring Boot 3.x，是一款预置SaaS、RBAC能力的单体项目脚手架，适合初学者学习 JavaWeb 开发的良好实践；本项目已拆分多Maven模块，单模块版请移步至helio-boot项目 - **Primary Language**: Unknown - **License**: MulanPSL-2.0 - **Default Branch**: 2.x - **Homepage**: https://helio.uncarbon.cc - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 4 - **Created**: 2025-07-09 - **Last Updated**: 2025-07-09 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # helio-boot-modular ## 项目介绍 基于 Spring Boot 3.x，是一款预置SaaS、RBAC能力的单体项目脚手架，适合初学者学习 JavaWeb 开发的良好实践 按职责拆分为多Maven模块，依然是大单体，但命名及用途对标`helio-cloud`；适合多人协作、但不打算使用微服务架构的团队 单模块版请移步至[helio-boot](https://github.com/uncarbon97/helio-boot)项目 JDK compatibility: 17 - 21 【[前端演示站](https://helio-demo.uncarbon.cc/)】 【[官方文档](https://helio.uncarbon.cc/)】 【[主要技术栈依赖](https://helio.uncarbon.cc/#/i18n/zh-CN/helio-starters/dependencies)】 【[快速启动步骤](https://helio.uncarbon.cc/#/i18n/zh-CN/helio-boot/quick-start)】 【[更新记录](https://helio.uncarbon.cc/#/i18n/zh-CN/appendix/change-log)】 【[编码良好实践](https://helio.uncarbon.cc/#/i18n/zh-CN/experience/good-practices)】 需要先安装 `MySQL`、`Redis` 等必需中间件 基础支撑构件 [helio-starters](https://github.com/uncarbon97/helio-starters) 已推送至Maven中央仓库，加载时会自动拉取 ## 配套代码生成器 & 后台管理前端模板 & 移动端模板 | 项目名 | 简介 | Gitee | GitHub | |-----------------------|-----------------------------------------------------------------------------|-------------------------------------------------------------|---------------------------------------------------------------| | helio-generator | 可一键生成单体or微服务版的前、后端代码，减少无谓的重复劳动 | [Gitee](https://gitee.com/uncarbon97/helio-generator) | [GitHub](https://github.com/uncarbon97/helio-generator) | | helio-admin-vue-vben | 基于[Vue vben admin](https://github.com/anncwb/vue-vben-admin) 改造适配的前端框架，开箱即用 | [Gitee](https://gitee.com/uncarbon97/helio-admin-vue-vben) | [GitHub](https://github.com/uncarbon97/helio-admin-vue-vben) | | helio-app-vue-unibest | 基于[unibest](https://github.com/feige996/unibest) 改造适配的移动端模板 | [Gitee](https://gitee.com/uncarbon97/helio-app-vue-unibest) | [GitHub](https://github.com/uncarbon97/helio-app-vue-unibest) | ## 源码包结构 ``` ├───api │ ├───admin-api 【Maven模块】admin-api，用于后台管理的HTTP-API │ │ └───src │ │ └───main │ │ └───java │ │ └───cc │ │ └───uncarbon │ │ └───module │ │ └───adminapi │ │ ├───aspect 自定义切面 │ │ │ └───extension 自定义切面扩展类 │ │ ├───constant 常量 │ │ ├───helper 助手类 │ │ ├───model 抽象模型 │ │ │ └───response 用于响应的 │ │ ├───util 静态工具类 │ │ └───web 即：Controller │ │ ├───auth 登录登出接口 │ │ ├───common 常用通用接口 │ │ ├───oss 对象存储接口 │ │ └───sys 预置系统管理接口（如：后台用户、后台角色、后台菜单等） │ └───app-api 【Maven模块】app-api，用于C端的HTTP-API【只是一个骨架，并没有业务实现】 │ └───src │ └───main │ └───java │ └───cc │ └───uncarbon │ └───module │ └───appapi │ ├───constant 常量 │ └───web 即：Controller ├───attachments 附件 │ └───db 数据库变更脚本 │ ├───MySQL │ │ └───upgrade Helio升级时MySQL变更脚本 │ └───PostgreSQL │ └───upgrade Helio升级时PostgreSQL变更脚本 ├───bootstrap 【Maven模块】项目主入口，负责启动SpringBoot │ └───src │ ├───main │ │ ├───java │ │ │ └───cc │ │ │ └───uncarbon │ │ │ ├───config 全局配置类 │ │ │ └───interceptor Web拦截器 │ │ └───resources 资源，包含符合Spring Boot标准的YAML配置文件、Logback配置文件等 │ │ └───i18n 国际化文案定义 ├───service-module │ ├───oss 【Maven模块】对象存储服务 │ │ ├───oss-facade 【Maven模块】对象存储服务门面 │ │ │ └───src │ │ │ └───main │ │ │ └───java │ │ │ └───cc │ │ │ └───uncarbon │ │ │ └───module │ │ │ └───oss │ │ │ ├───constant 常量 │ │ │ ├───enums 枚举 │ │ │ ├───facade 门面 │ │ │ └───model 抽象模型 │ │ │ ├───request 用于请求的 │ │ │ └───response 用于响应的 │ │ └───oss-service 【Maven模块】对象存储服务实现 │ │ └───src │ │ └───main │ │ └───java │ │ └───cc │ │ └───uncarbon │ │ └───module │ │ └───oss │ │ ├───biz 门面实现类 │ │ ├───config 配置类 │ │ ├───entity 实体 │ │ ├───mapper Mybatis Mapper │ │ └───service 服务类 │ └───sys 【Maven模块】预置系统管理服务 │ ├───sys-facade 【Maven模块】预置系统管理服务门面 │ │ └───src │ │ └───main │ │ └───java │ │ └───cc │ │ └───uncarbon │ │ └───module │ │ └───sys │ │ ├───annotation 自定义注解 │ │ ├───constant 常量 │ │ ├───enums 枚举 │ │ ├───extension 自定义扩展 │ │ │ └───impl 自定义扩展实现类 │ │ ├───facade 门面 │ │ └───model 抽象模型 │ │ ├───request 用于请求的 │ │ └───response 用于响应的 │ └───sys-service 【Maven模块】预置系统管理服务实现 │ └───src │ └───main │ └───java │ └───cc │ └───uncarbon │ └───module │ └───sys │ ├───biz 门面实现类 │ ├───entity 实体 │ ├───mapper Mybatis Mapper │ │ └───xml Mybatis Mapper XML │ ├───service 服务类 │ └───util 静态工具类 ├───middleware │ └───biz-common 【Maven模块】业务开发公共包 ```