# TaskFlow

**Repository Path**: nanqu_ait/taskflow

## Basic Information

- **Project Name**: TaskFlow
- **Description**: TaskFlow 是一个基于 Web 的轻量级任务管理平台，旨在帮助个人用户高效记录、跟踪和完成日常任务。系统支持用户注册登录、创建/编辑/删除任务、标记任务状态（待办、进行中、已完成）等功能，并提供简洁友好的响应式用户界面。
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-12-23
- **Last Updated**: 2026-02-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Task Flow 任务管理系统

## 项目简介

Task Flow 是一个基于 Java Spring Boot 的任务管理系统，提供用户注册、登录和任务管理功能。系统采用现代化的前后端分离架构，后端提供 RESTful API 接口，前端使用 HTML/CSS/JavaScript 实现。项目中还集成了 JWT 认证机制和 MyBatis 数据访问层。

## 主要功能

- **用户管理**：支持用户注册、登录和身份验证
- **任务管理**：提供任务的增删改查功能
- **状态跟踪**：支持任务状态（待办、进行中、已完成）管理
- **权限控制**：基于 JWT 的安全认证机制

## 技术栈

- 后端：Java Spring Boot, MyBatis, JWT, MySQL
- 前端：HTML5, CSS3 (含 Bootstrap 5), JavaScript
- 安全框架：Spring Security
- 数据库：MySQL

### 学习本项目
[学习项目 `teach.md`](teach.md)
## 系统架构

```
src/
├── main/
│   ├── java/
│   │   └── org/task/flow/backend/
│   │       ├── config/         # 配置类 (JWT, Security)
│   │       ├── controller/     # REST API 控制器
│   │       ├── mapper/         # 数据库映射接口
│   │       ├── model/          # 数据模型
│   │       ├── service/        # 业务逻辑接口及实现
│   │       └── BackendApplication.java # 启动类
│   │
│   └── resources/
│       ├── static/             # 前端资源文件
│       │   ├── css/
│       │   ├── js/
│       │   ├── html/
│       │   └── favicon.ico
│       ├── application.properties # 配置文件
│       └── schema.sql          # 数据库结构
```

## API 文档

完整 API 文档请查看 [API_DOCS.md](API_DOCS.md)，包含以下接口：

### 认证相关 API
- 用户注册 `/api/auth/register`
- 用户登录 `/api/auth/login`
- 获取当前用户信息
- 用户登出

### 任务管理 API
- 获取任务列表 `/api/tasks`
- 创建新任务 `/api/tasks`
- 更新任务 `/api/tasks/{id}`
- 删除任务 `/api/tasks/{id}`

## 使用说明

### 启动项目

1. 确保已安装 JDK 21+ 和 Maven
2. 创建 MySQL 数据库并执行 `schema.sql`
3. 修改 `application.properties` 中的数据库配置
4. 执行 `mvn spring-boot:run` 启动项目

### 访问方式

- 后端 API: `http://localhost:8080/api/`
- 前端页面:
  - 登录页: `http://localhost:8080/login.html`
  - 任务管理页: `http://localhost:8080/tasks.html`

## 贡献指南

欢迎贡献代码！请遵循以下步骤：
1. Fork 本项目
2. 创建新分支
3. 提交代码更改
4. 创建 Pull Request

## 许可证

本项目采用 MIT License，详情请查看 [LICENSE](LICENSE) 文件。