# mybatis-plus-jpa-upms

**Repository Path**: mybatis-plus-jpa/mybatis-plus-jpa-upms

## Basic Information

- **Project Name**: mybatis-plus-jpa-upms
- **Description**: 基于mybatis-plus-jpa-web实现的用户管理系统
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-24
- **Last Updated**: 2025-10-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 介绍
该项目是基于 MyBatis-Plus、JPA 和 Dicode 的综合示例项目，适用于统一权限管理系统（UPMS）的开发。它提供了一套完整的权限管理接口，包括用户、部门、角色和资源的管理功能。

## 软件架构
- **技术栈**：Spring Boot + MyBatis-Plus + JPA + Sa-Token
- **权限控制**：通过 Sa-Token 实现角色和权限校验。
- **模块结构**：
  - Controller：提供 RESTful API 接口，按用户、部门、角色、资源划分。
  - Service：定义接口逻辑，实现业务处理。
  - Model：定义实体类，与数据库表结构对应。
  - Config：配置类，用于组件扫描、实体扫描和 Mapper 扫描。

## 安装教程
1. 克隆项目：
   ```bash
   git clone https://gitee.com/mybatis-plus-jpa/mybatis-plus-jpa-upms.git
   ```
2. 导入数据库表结构（确保数据库配置与项目配置一致）。
3. 修改配置文件中的数据库连接信息（如 `application.yml` 或 `application.properties`）。
4. 构建并运行项目：
   ```bash
   mvn clean install
   mvn spring-boot:run
   ```

## 使用说明
- 用户权限管理：
  - 用户可通过接口获取自身信息、角色、部门和可见资源。
  - 管理员可查询用户、部门、角色和资源的详细信息，并进行分页处理。
- 权限校验：
  - 使用 `@SaCheckRole("admin")` 注解实现管理员角色校验。
- 接口文档：
  - 使用 Spring 的 `@RestController` 和 `@RequestMapping` 提供接口文档和路径映射。

## 参与贡献
1. Fork 项目。
2. 创建新分支。
3. 提交代码。
4. 创建 Pull Request。

## 特技
1. 使用 `Readme_XXX.md` 支持多语言文档，例如 `Readme_en.md`, `Readme_zh.md`。
2. 项目基于 Dicode 实现了灵活的权限管理逻辑。
3. 通过 `@ConditionalOnClass` 和 `@ConditionalOnMissingBean` 实现自动装配逻辑。
4. 提供了统一的 `ResultDto` 格式返回接口数据，便于前端处理。