+
+

+

+

+

+
+
+
+
+[](https://github.com/RemainderTime/spring-boot-base-demo)
+[](./LICENSE)
---
-### 项目介绍
-[](https://blog.csdn.net/qq_39818325?type=blog)
-[](https://github.com/RemainderTime/spring-boot-base-demo)
-
-
-
-
-
----
-> 这是一个基于 **Spring Boot 3.3.3** 的快速构建单体架构脚手架,旨在帮助开发者快速搭建高效、稳定的项目基础框架。项目集成了多种常用的技术组件与功能,涵盖从用户认证到数据加密、从全局异常处理到搜索引擎操作,适合个人学习与企业级单体应用开发。
+### 「 为企业级开发而生的高效脚手架 」
-#### 分支
-- master 快速上手开发spring boot 用户端单体应用
-- feature/admin-auth-spring-security 基于master分支集成spring官方鉴权框架spring security框架,可用于后台管理系统后端项目,实现RBAC模型(角色 → 用户 → 菜单 → 权限)基于角色的访问控制
-- feature/admin-auth-sa-token 基于master分支集成国产权限框架sa-token,可用于后台管理系统后端项目,实现RBAC模型(角色 → 用户 → 菜单 → 权限)基于角色的访问控制
-- component/rocketmq-and-es 基于master分支集成消息队列原生RocketMQ5.x与原生Elasticsearch 8.x,提供消息队列与搜索引擎服务,实现消息持久化与全文检索
-- feature/master-payment 基于master分支集成支付宝沙盒功能(H5支付、APP支付)
+
+ 💎 关于项目 |
+ ⚡ 核心亮点 |
+ 🌿 生态全景 |
+ 🚀 快速运行 |
+ 📅 项目日志
+
+
-### 集成技术与功能亮点
+
+
+| 🚀 **前沿技术** | 🔐 **安全无忧** | 🐳 **云原生友好** |
+| :--- | :--- | :--- |
+| 紧跟 **Spring Boot 3.x** 生态,
基于 **Java 17 LTS** 构建,
享受最新技术红利。 | 深度整合 **JWT** 令牌认证
& **RSA** 非对称加密,
为数据安全保驾护航。 | 内置 **Dockerfile** 脚本,
支持 **Docker Compose** 编排,
部署快人一步。 |
+
+| 💾 **数据增强** | 🔌 **微服务预装** | 🛠 **极致体验** |
+| :--- | :--- | :--- |
+| **MyBatis Plus** 强力驱动,
**Dynamic Datasource**
轻松驾驭多数据源场景。 | 原生集成 **Nacos**,
配置中心与注册中心开箱即用,
平滑过渡微服务。 | **SpringDoc (OpenAPI 3)**
自动生成精美文档,
调试开发得心应手。 |
+
+
---
-如果这个项目对你有帮助,请随手点个 Star ⭐ 支持一下吧!🎉✨ 你的支持是我持续优化的动力!❤️
+
+## 🌿 生态全景
+
+我们采用 **"核心 + 插件化"** 的分支管理策略,以 `master` 为稳定基石,通过不同分支满足多样化的业务需求。
+
+| 🌳 分支标识 | 🎯 定位 | 📝 功能描述 | 🏭 最佳应用场景 |
+| :--- | :--- | :--- | :--- |
+| **`master`** | **核心底座** | 标准化脚手架,含 JWT/Nacos/Redis | 🚀 快速启动标准单体项目 |
+| `feature/admin-auth-spring-security` | **安全堡垒** | Spring Security 官方方案 (RBAC) | 🏦 金融级、政府级后台系统 |
+| `feature/admin-auth-sa-token` | **敏捷权限** | Sa-Token 轻量级权限控制 | ⚡ 中小型项目、国内快速开发 |
+| `component/rocketmq-and-es` | **高并发** | RocketMQ 5.x + Elasticsearch 8.x | 📈 海量日志、搜索、高吞吐业务 |
+| `feature/master-payment` | **商业变现** | 支付宝沙盒支付 (H5/App) | 💳 电商、会员订阅、SaaS 平台 |
+
+> **💡 提示**: 所有分支均基于 `master` 演进,可根据项目规模灵活 `git merge` 所需功能模块。
+
+---
+
+## 🚀 快速运行
+
+### 🛠️ 环境依赖
+* **JDK**: 17 +
+* **Maven**: 3.8 +
+* **MySQL**: 8.0 +
+* **Redis**: 5.0 +
+* **Nacos**: 2.x (可选)
+
+### 🏃♂️ 启动步骤
+
+> **Step 1: 获取源码**
+> ```bash
+> git clone https://github.com/RemainderTime/spring-boot-base-demo.git
+> cd spring-boot-base-demo
+> ```
+
+> **Step 2: 数据准备**
+> * 创建数据库 `xf_boot_base`
+> * 修改 `src/main/resources/application.yml` 配好你的数据库账号密码
+> * *(注:实体类完善,表结构建议通过 JPA 或手动创建)*
+
+> **Step 3: 启动服务**
+>
+> **方式 A: 本地 Maven 运行**
+> ```bash
+> mvn spring-boot:run
+> ```
+>
+> **方式 B: Docker Compose 一键编排**
+> ```bash
+> cd src/main/resources/docker
+> docker-compose -f boot-docker-compose.yml up -d
+> ```
+
+> **Step 4: 探索接口**
+> 打开浏览器访问: `http://localhost:8080/doc.html`
+
+---
+
+## 📅 项目日志
+
+### v1.0.1 (2024-10-12)
+* ⬆️ **内核升级**: Spring Boot 3.3.3 & MyBatis Plus 3.5.8
+* 📝 **文档重构**: 全面拥抱 SpringDoc OpenAPI,弃用旧版 Swagger
+* 🛡️ **安全加固**: 优化全局异常拦截与参数校验机制
+
+---
+
+## 📈 关注趋势
+
+[](https://star-history.com/#RemainderTime/spring-boot-base-demo&Date)
+
+