# 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 Management System

## Project Overview

Task Flow is a task management system built on Java Spring Boot, offering user registration, login, and task management functionalities. The system adopts a modern front-end and back-end separated architecture, with the back-end providing RESTful API interfaces and the front-end implemented using HTML/CSS/JavaScript. The project also integrates JWT authentication and the MyBatis data access layer.

## Key Features

- **User Management**: Supports user registration, login, and authentication
- **Task Management**: Provides CRUD operations for tasks
- **Status Tracking**: Supports task status management (To Do, In Progress, Completed)
- **Access Control**: Security authentication mechanism based on JWT

## Technology Stack

- Back-end: Java Spring Boot, MyBatis, JWT, MySQL
- Front-end: HTML5, CSS3 (including Bootstrap 5), JavaScript
- Security Framework: Spring Security
- Database: MySQL

## System Architecture

```
src/
├── main/
│   ├── java/
│   │   └── org/task/flow/backend/
│   │       ├── config/         # Configuration classes (JWT, Security)
│   │       ├── controller/     # REST API controllers
│   │       ├── mapper/         # Database mapping interfaces
│   │       ├── model/          # Data models
│   │       ├── service/        # Business logic interfaces and implementations
│   │       └── BackendApplication.java # Main application class
│   │
│   └── resources/
│       ├── static/             # Front-end resource files
│       │   ├── css/
│       │   ├── js/
│       │   ├── html/
│       │   └── favicon.ico
│       ├── application.properties # Configuration file
│       └── schema.sql          # Database schema
```

## API Documentation

For the complete API documentation, see [API_DOCS.md](API_DOCS.md), which includes the following endpoints:

### Authentication APIs
- User registration: `/api/auth/register`
- User login: `/api/auth/login`
- Get current user information
- User logout

### Task Management APIs
- Get task list: `/api/tasks`
- Create new task: `/api/tasks`
- Update task: `/api/tasks/{id}`
- Delete task: `/api/tasks/{id}`

## Usage Instructions

### Starting the Project

1. Ensure JDK 1.8+ and Maven are installed
2. Create a MySQL database and execute `schema.sql`
3. Update the database configuration in `application.properties`
4. Run `mvn spring-boot:run` to start the project

### Access Methods

- Back-end API: `http://localhost:8080/api/`
- Front-end Pages:
  - Login page: `http://localhost:8080/login.html`
  - Task management page: `http://localhost:8080/tasks.html`

## Contribution Guidelines

Contributions are welcome! Please follow these steps:
1. Fork this project
2. Create a new branch
3. Commit your changes
4. Submit a Pull Request

## License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.