# Miu-admin

**Repository Path**: dev_mario/miu-admin

## Basic Information

- **Project Name**: Miu-admin
- **Description**: Miu（米悠）项目主程序仓库
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: http://47.101.135.87:9546
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-09-19
- **Last Updated**: 2026-04-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Miu-admin

## 项目介绍
Miu（米悠）是一个基于 Spring Boot 3.x 的现代化后台管理系统，采用前后端分离架构。本仓库为后端服务程序。

## 技术栈
- **基础框架**：Spring Boot 3.3.5
- **ORM 框架**：MyBatis-Plus 3.5.8
- **权限认证**：Sa-Token 1.39.0
- **数据库**：MySQL 8.0
- **缓存中间件**：Redis
- **API文档**：Springdoc OpenAPI 2.6.0
- **Excel处理**：Apache POI 5.3.0
- **工具集**：
  - Hutool 5.8.21
  - Lombok
  - Apache Commons
  - Jackson 2.17.2

## 项目结构
```
miu-admin
├── miu-common        // 公共模块，工具类和通用组件
├── miu-framework     // 框架模块，提供框架基础支持
├── miu-service       // 业务服务模块
└── miu-main         // 主程序模块，包含启动类和API接口
```

## 环境要求
- JDK 17+
- MySQL 8.0+
- Redis 6.0+
- Maven 3.8+

## 快速开始

### 1. 环境准备
- 安装 JDK 17 或更高版本
- 安装 MySQL 8.0 或更高版本
- 安装 Redis 6.0 或更高版本
- 安装 Maven 3.8 或更高版本

### 2. 配置修改
- 修改数据库连接信息：`miu-main/src/main/resources/application.yml`
- 修改Redis连接信息：`miu-main/src/main/resources/application.yml`

### 3. 编译部署
```bash
# 编译
mvn clean package

# 运行
java -jar miu-main/target/miu-main.jar
```

## 主要功能
- 用户权限管理
- 系统配置管理
- 数据字典管理
- 日志管理
- 文件上传管理
- 缓存管理

## 开发规范
1. 代码规范遵循阿里巴巴Java开发规范
2. 接口遵循RESTful设计规范
3. 前后端分离，统一使用JSON格式交互
4. 统一的异常处理和响应格式

## 贡献指南
1. Fork 本仓库
2. 新建 feat/xxx 分支
3. 提交代码
4. 新建 Pull Request

## 许可证
本项目使用 [MIT 许可证](LICENSE)