待办事项管理系统 (Todo Management System) 基于 Spring Boot 3.x 的待办事项管理应用，提供完整的任务管理、分类管理、统计分析功能。
待办事项管理 ：创建、编辑、删除、标记完成任务分类 ：自定义分类管理优先级设置 ：高、中、低三级优先级截止日期 ：支持设置任务截止时间操作历史 ：记录任务变更历史
分类统计 ：按分类汇总任务数量优先级统计 ：按优先级统计完成情况趋势分析 ：按日期查看任务完成趋势完成时间统计 ：平均完成时间分析
用户登录/注册
JWT Token 认证
密码加密存储
技术
版本
说明
Java
17+
开发语言
Spring Boot
3.1.5
应用框架
MySQL
8.x
关系数据库
Redis
-
缓存服务
MyBatis-Plus
3.5.7
ORM 框架
Lombok
1.18.36
简化代码
JWT (jjwt)
0.11.5
认证方案
src/main/java/com/todo/
├── controller/ # REST API 控制器
│ ├── TodoController.java
│ ├── CategoryController.java
│ ├── StatisticsController.java
│ └── AuthController.java
├── service/ # 业务逻辑层
│ └── impl/ # 服务实现
├── mapper/ # MyBatis-Plus Mapper
├── entity/ # 数据库实体
│ ├── TodoItem.java
│ ├── Category.java
│ ├── User.java
│ └── AuditLog.java
├── dto/ # 数据传输对象
│ ├── request/ # 请求 DTO
│ └── response/ # 响应 DTO
├── config/ # 配置类
│ ├── RedisConfig.java
│ ├── MyBatisConfig.java
│ ├── WebMvcConfig.java
│ └── AuthInterceptor.java
├── common/ # 公共组件
│ ├── enums/ # 枚举类
│ ├── exception/ # 异常处理
│ └── result/ # 统一响应
└── util/ # 工具类
├── JwtUtil.java
└── PasswordUtil.java
JDK 17+
MySQL 8.x
Redis
Maven 3.6+
克隆项目
git clone < repository-url>
cd todo-management
创建数据库
CREATE DATABASE todo_management ;
配置数据库连接
编辑 src/main/resources/application-dev.yml：
spring :
datasource :
url : jdbc:mysql://localhost:3306/todo_management?useSSL=false&serverTimezone=Asia/Shanghai
username : your_username
password : your_password
配置 Redis
spring :
data :
redis :
host : localhost
port : 6379
运行项目
服务将在 http://localhost:8082 启动。
方法
URL
说明
POST
/api/v1/todo-items创建待办事项
PUT
/api/v1/todo-items/{id}更新待办事项
DELETE
/api/v1/todo-items/{id}删除待办事项
PUT
/api/v1/todo-items/{id}/complete标记完成
GET
/api/v1/todo-items/{id}获取详情
GET
/api/v1/todo-items/{id}/history获取历史记录
GET
/api/v1/todo-items查询列表（支持分页、筛选）
方法
URL
说明
POST
/api/v1/categories创建分类
PUT
/api/v1/categories/{id}更新分类
DELETE
/api/v1/categories/{id}删除分类
GET
/api/v1/categories获取分类列表
方法
URL
说明
GET
/api/v1/statistics/by-category分类统计
GET
/api/v1/statistics/by-priority优先级统计
GET
/api/v1/statistics/trend趋势分析
GET
/api/v1/statistics/completion-time完成时间统计
方法
URL
说明
POST
/api/v1/auth/login用户登录
POST
/api/v1/auth/register用户注册
GET
/api/v1/auth/user-info获取用户信息
待办事项查询支持以下参数：
GET /api/v1/todo-items?page=1&size=10&status=1&priority=2&categoryId=1&keyword=任务
# 编译项目# 运行测试test
# 运行单个测试test -Dtest=TodoServiceTest
# 打包项目# 运行应用# 指定配置文件运行
实体类使用 @TableName 指定表名
使用 Lombok 减少样板代码
Controller 返回统一的 Result<T> 响应
URL 使用 RESTful 风格，小写连字符分隔
表名使用下划线命名：todo_item, category
主键使用 id，BIGINT 类型自增
必须包含 created_at, updated_at 字段
逻辑删除字段：is_deleted
文件
用途
application.yml主配置
application-dev.yml开发环境
application-prod.yml生产环境
server :
port : 8082
mybatis-plus :
configuration :
map-underscore-to-camel-case : true
global-config :
db-config :
id-type : auto
logic-delete-field : isDeleted
jwt :
secret : <your-secret-key>
expiration : 86400000 # 24小时
分支
说明
main生产环境代码
develop开发主分支
feature/*功能开发分支
bugfix/*Bug 修复分支
release/*发布分支
MIT License