# dims-springboot

**Repository Path**: coderzys/dims-springboot

## Basic Information

- **Project Name**: dims-springboot
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-14
- **Last Updated**: 2025-11-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DIMS - Data Information Management System 后端系统

这是一个基于Spring Boot的后端系统，为DIMS前端提供API接口支持。

## 技术栈

- Spring Boot 2.7.15
- MyBatis-Plus
- MySQL
- Redis
- Spring Security
- JWT
- Swagger

## 快速开始

### 环境要求

- JDK 1.8+ 
- Maven 3.6+ 
- MySQL 5.7+ 
- Redis 5.0+ 

### 数据库初始化

1. 使用MySQL客户端连接数据库
2. 执行`init.sql`脚本创建数据库和表结构

```sql
mysql -u root -p < init.sql
```

### 配置修改

根据您的环境修改`src/main/resources/application.yml`文件中的配置：

```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/dims?useUnicode=true&characterEncoding=utf-8&useSSL=false&serverTimezone=Asia/Shanghai
    username: root
    password: 123456
  redis:
    host: localhost
    port: 6379
    password: 
```

### 运行项目

使用Maven命令运行：

```bash
mvn spring-boot:run
```

或者打包成JAR文件运行：

```bash
mvn clean package
java -jar target/dims-springboot-1.0.0.jar
```

### 访问API文档

项目启动后，可以访问Swagger API文档：

```
http://localhost:8080/api/swagger-ui.html
```

## 项目结构

```
src/main/java/com/dims/
├── DimsApplication.java        # 应用主入口
├── common/                     # 通用模块
│   └── Result.java             # 统一返回结果
├── config/                     # 配置模块
│   ├── SecurityConfig.java     # Spring Security配置
│   └── SwaggerConfig.java      # Swagger配置
├── controller/                 # 控制器层
│   ├── AuthController.java     # 认证控制器
│   ├── SysUserController.java  # 用户管理控制器
│   ├── SysRoleController.java  # 角色管理控制器
│   └── SysPermissionController.java # 权限管理控制器
├── entity/                     # 实体类
│   ├── SysUser.java            # 用户实体
│   ├── SysRole.java            # 角色实体
│   └── SysPermission.java      # 权限实体
├── exception/                  # 异常处理
│   └── GlobalExceptionHandler.java # 全局异常处理器
├── mapper/                     # Mapper接口
│   ├── SysUserMapper.java      # 用户Mapper
│   ├── SysRoleMapper.java      # 角色Mapper
│   └── SysPermissionMapper.java # 权限Mapper
├── service/                    # 服务层
│   ├── impl/                   # 服务实现
│   │   ├── SysUserServiceImpl.java  # 用户服务实现
│   │   ├── SysRoleServiceImpl.java  # 角色服务实现
│   │   └── SysPermissionServiceImpl.java # 权限服务实现
│   ├── SysUserService.java     # 用户服务接口
│   ├── SysRoleService.java     # 角色服务接口
│   └── SysPermissionService.java # 权限服务接口
└── utils/                      # 工具类
    └── JwtUtil.java            # JWT工具类
```

## 默认账号

系统初始化后，会创建一个默认管理员账号：

- 用户名：admin
- 密码：123456

## 接口说明

### 认证相关接口

- POST /api/auth/login - 用户登录
- GET /api/auth/captcha - 获取验证码
- GET /api/auth/info - 获取用户信息
- POST /api/auth/logout - 用户登出

### 用户管理接口

- GET /api/sys/user/list - 查询用户列表
- GET /api/sys/user/info/{userId} - 获取用户详情
- POST /api/sys/user - 添加用户
- PUT /api/sys/user - 修改用户
- DELETE /api/sys/user/{userId} - 删除用户
- POST /api/sys/user/resetPwd/{userId} - 重置密码
- PUT /api/sys/user/status/{userId} - 更新用户状态

### 角色管理接口

- GET /api/sys/role/list - 查询角色列表
- GET /api/sys/role/info/{roleId} - 获取角色详情
- POST /api/sys/role - 添加角色
- PUT /api/sys/role - 修改角色
- DELETE /api/sys/role/{roleId} - 删除角色
- POST /api/sys/role/assignPerms - 分配权限给角色

### 权限管理接口

- GET /api/sys/permission/menuTree - 获取菜单树结构
- GET /api/sys/permission/list - 查询权限列表
- GET /api/sys/permission/info/{id} - 获取权限详情
- POST /api/sys/permission - 添加权限
- PUT /api/sys/permission - 修改权限
- DELETE /api/sys/permission/{id} - 删除权限

## 注意事项

1. 本系统使用JWT进行身份验证，请在登录后在请求头中添加Authorization字段
2. 密码使用BCrypt进行加密存储
3. 系统包含基本的RBAC权限控制功能
4. 如需扩展功能，请按照现有的代码结构进行开发