# shumacoding-boot

**Repository Path**: shumacoding/shumacoding-boot

## Basic Information

- **Project Name**: shumacoding-boot
- **Description**: 戍码编程项目底座-开源基础版
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-07
- **Last Updated**: 2026-05-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">

<img alt="madong-boot" style="border-radius: 8px;" width="80" src="./docs/images/logo/logo.png">

# madong-boot

**Spring Boot 4 企业级权限管理系统后端**
</div>

![](https://foruda.gitee.com/images/1708618984641188532/a7cca095_716974.png "rainbow.png")

## 简介

**madong-boot** 是一套基于 Spring Boot 4 的企业级权限管理系统后端，配套前端 [vue3-element-admin] 和移动端 [shumacoding-app]，并提供 **6 种语言实现**（Java / Node.js / Go / Python / PHP / C#），共享同一套 API 规范与数据库结构。适用于企业中后台管理系统的学习参考与二次开发。

## 核心特性

- 🔐 **安全体系** — Spring Security + JWT/Redis Token 双会话模式、令牌续期、多端互斥
- 🛡️ **细粒度权限** — RBAC 五级：数据 → 菜单 → 按钮 → 接口 → 字段
- ⚡ **代码生成器** — 一键生成前后端 CRUD 代码
- 📦 **模块齐全** — 用户、角色、菜单、部门、字典、文件、定时任务、消息中心、操作日志
- 🌐 **多租户 SaaS** — 数据隔离 + 租户配置，独立 [madong-boot-tenant] 版本
- 🔌 **实时通信** — SSE 推送：在线用户数、字典同步、通知广播

## 技术架构

<p align="center">
  <img alt="madong-boot 技术架构图" width="900" src="./docs/images/architecture/architecture.png">
</p>

## 系统预览

**PC 端**

<table align="center">
  <tr>
    <td><img alt="PC预览1" width="400" src="./docs/images/preview/pc-01.png"></td>
    <td><img alt="PC预览2" width="400" src="./docs/images/preview/pc-02.png"></td>
  </tr>
  <tr>
    <td><img alt="PC预览3" width="400" src="./docs/images/preview/pc-03.png"></td>
    <td><img alt="PC预览4" width="400" src="./docs/images/preview/pc-04.png"></td>
  </tr>
    <tr>
    <td><img alt="PC预览3" width="400" src="./docs/images/preview/pc-05.png"></td>
    <td><img alt="PC预览4" width="400" src="./docs/images/preview/pc-06.png"></td>
  </tr>
</table>


## 快速开始

**环境要求**：JDK 17+ · MySQL 8.0+ · Redis 6.0+

1. 克隆项目：`git clone https://gitee.com/shumacoding/shumacoding-boot.git`
2. 导入数据库：`sql/shumacoding-admin.sql`
3. 修改配置（可选，默认已配置线上只读数据源）：`src/main/resources/application-dev.yml`
4. 启动服务，访问 http://localhost:8083/doc.html

默认账号：`admin` / `123456`

**Docker 部署**：`cd deploy/docker`，然后 `docker-compose up -d`

## 技术栈

| 技术 | 版本 | 说明 |
|:-----|:-----|:-----|
| Spring Boot | 4.0.5 | 核心框架 |
| Spring Security | 6.x | 认证授权 |
| MyBatis-Plus | 3.5.15 | ORM 框架 |
| Druid | 1.2.24 | 数据库连接池 |
| Redis + Redisson | 6.0+ / 4.1.0 | 缓存 · 会话 · 分布式锁 |
| Caffeine | 2.9.3 | 本地缓存 |
| XXL-Job | 3.2.0 | 分布式定时任务 |
| Knife4j | 4.5.0 | API 文档 |
| MapStruct | 1.6.3 | 对象映射 |
| MinIO | 8.5.10 | 对象存储 |

## 目录结构

```
madong-boot/
├── deploy/
│   └── docker/                      # Docker 部署编排
├── docs/                            # 项目文档与图片资源
├── sql/                             # 数据库初始化脚本
├── src/main/java/com/shumacoding/boot/
│   ├── ShuMaCodingBootApplication.java   # 启动类
│   ├── auth/                        # 认证授权（登录/登出/令牌）
│   ├── codegen/                     # 代码生成器
│   ├── common/                      # 公共模块（常量/枚举/统一响应）
│   ├── file/                        # 文件服务（MinIO/本地/OSS）
│   ├── framework/                   # 技术框架层
│   │   ├── apidoc/                  # OpenAPI / Knife4j
│   │   ├── cache/                   # Redis / Caffeine 缓存
│   │   ├── captcha/                 # 图形验证码
│   │   ├── integration/             # 短信 / 邮件 / 微信
│   │   ├── job/                     # XXL-Job 定时任务
│   │   ├── mybatis/                 # MyBatis-Plus 配置
│   │   ├── security/                # Security / JWT / Token
│   │   └── web/                     # 全局异常 / 跨域 / 限流
│   ├── message/                     # SSE 消息推送
│   └── system/                      # 系统业务（用户/角色/菜单/部门）
└── pom.xml                          # Maven 依赖管理
```

---

<p align="center">
<img src="./docs/images/qr/wenya.png" height="180" alt="扫一扫加微信"><br>
<em>商务合作 · 技术交流 · 问题反馈</em>
</p>