# lemon-admin-server

**Repository Path**: aiy/lemon-admin-server

## Basic Information

- **Project Name**: lemon-admin-server
- **Description**: 基于 JDK 17 + Spring Boot 4 + Spring Security 构建的前后端分离权限管理系统。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-03
- **Last Updated**: 2026-04-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 📢 项目简介

基于 **JDK 17 + Spring Boot 4 + Spring Security** 构建的前后端分离权限管理系统。

### 为什么选择 lemon-admin-server？

| 特性              | 说明                                                  |
| ----------------- | ----------------------------------------------------- |
| 🚀 **最新技术栈** | Spring Boot 4 + JDK 17，持续跟进最新版本              |
| 🔐 **企业级认证** | Spring Security + JWT + Redis，支持令牌续期、多端互斥 |
| 🔑 **细粒度权限** | RBAC 模型，接口级 + 按钮级权限控制                    |
| 🛠️ **开箱即用**   | 用户、角色、菜单、部门、字典等核心模块                |
| 📦 **代码生成**   | 内置代码生成器，快速构建 CRUD 功能                    |
| 🌐 **完整生态**   | Web 管理前端 + 移动端配套项目，多语言后端支持         |

---

## 🚀 快速开始

### 环境要求

- JDK 17+
- MySQL 5.7+/8.0+
- Redis 6.0+

### 启动步骤

**1. 克隆项目**

```bash
git clone https://gitee.com/aiy/lemon-admin-server.git
```

**2. 初始化数据库**

执行 [lemon_admin.sql](sql/mysql/lemon_admin.sql) 创建数据库和基础数据。

**3. 修改配置**

编辑 [application-dev.yml](src/main/resources/application-dev.yml)，配置 MySQL 和 Redis：

```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/lemon_admin # 数据库连接地址
    username: root # 数据库用户名
    password: 123456 # 数据库密码
  data:
    redis:
      host: localhost # Redis 地址
      port: 6379 # Redis 端口
```

> 💡 默认连接线上环境（仅读权限），可直接启动体验。

**4. 启动项目**

运行 [LemonBootApplication.java](src/main/java/com/lemon/boot/LemonBootApplication.java)，访问 http://localhost:8000/doc.html 查看接口文档。

---

## 📁 目录结构

```bash
lemon-boot
├── docker/                          # Docker 部署
├── sql/                             # 数据库脚本
├── src/main/java/com/lemon/boot/
│   ├── auth/                        # 认证授权业务
│   ├── common/                      # 全局通用（常量、枚举、工具类、统一响应结果）
│   ├── framework/                   # 底层技术基座（高内聚积木块）
│   │   ├── cache/                   # Redis/Caffeine 缓存
│   │   ├── captcha/                 # 验证码
│   │   ├── integration/             # SMS/Mail/WxMa 集成
│   │   ├── job/                     # XxlJob 定时任务
│   │   ├── mybatis/                 # 数据库/MP配置/拦截器
│   │   ├── openapi/                 # OpenAPI/Swagger 文档
│   │   ├── security/                # 鉴权过滤器/Token机制
│   │   └── web/                     # 跨域/全局异常/限流/Jackson
│   ├── module/                      # 业务模块（File、Codegen 等）
│   ├── system/                      # 核心系统模块（用户/角色/菜单/部门）
│   └── LemonBootApplication.java    # 启动类
└── pom.xml                          # Maven 配置
```
---