MiQroProbe-Backend

MiQroProbe 项目管理系统后端服务，基于 Spring Boot 开发的现代化项目管理平台。

技术栈

• 核心框架：Spring Boot
• 安全框架：Sa-Token
• 持久层框架：MyBatis-Plus
• 数据库：MySQL
• 缓存：Redis
• 文档：Knife4j (Swagger)
• 文件存储：MinIO
• 其他：Hutool、Lombok

项目结构

miqroprobe-backend
├── miqroproject-app        // 应用启动模块，包含配置文件和启动类
├── miqroproject-base       // 基础模块，包含公共工具类和基础配置
├── miqroproject-biz        // 业务模块，包含具体业务实现
└── miqroproject-generator  // 代码生成器模块

主要功能

• 用户认证与授权
• 项目管理
  • 项目创建与配置
  • 项目成员管理
  • 项目布局编辑
  • 实时协作（支持多人在线状态显示）
• 任务管理
  • 任务模板
  • 任务分组
  • 任务分配与跟踪
• 国际化支持
• 文件上传

快速开始

环境要求

• JDK 17+
• MySQL 8.0+
• Redis 6.0+
• Maven 3.8+

开发环境配置

1. 克隆项目代码
2. 配置 application-dev.yml 中的数据库和Redis连接信息
3. 执行数据库初始化脚本
4. 启动项目

   mvn spring-boot:run

配置说明

主要配置文件位于 miqroproject-app/src/main/resources/ 目录：

• application.yml：主配置文件
• application-dev.yml：开发环境配置
• application-local.yml：本地环境配置

端口与路径

• 服务端口：8080
• 接口路径前缀：/api
• 接口文档地址：http://localhost:8080/api/doc.html

安全配置

• 用户密码重试次数限制：5次
• 密码锁定时间：10分钟
• Token 有效期：24小时
• 使用 JWT 进行身份验证

部署

打包

mvn clean package

生成的可执行jar文件位于：miqroproject-app/target/miqroproject.jar

运行

java -jar miqroproject.jar --spring.profiles.active=prod

API文档

项目集成了 Knife4j 接口文档，启动项目后访问：http://localhost:8080/api/doc.html

开发规范

• 遵循阿里巴巴Java开发手册规范
• 使用统一的接口返回格式
• 统一的异常处理机制
• 接口遵循RESTful规范

注意事项

1. Redis缓存在并发场景下的使用
2. 文件上传大小不限制，注意服务器存储容量
3. 接口调用需要携带token，格式为：Bearer {token}
4. 项目布局编辑时要注意并发控制

许可证

[待补充]