taskmanager/2026-03-19_15-49-18-TaskManager-requirements.md
bojunC 38c5a466cd feat: 实现 Issue #1 - 项目初始化和环境配置
- 创建 monorepo 结构(Turborepo)
- 初始化前端项目(Next.js + TypeScript + Tailwind CSS)
- 初始化后端项目(NestJS + TypeScript)
- 配置开发工具(ESLint, Prettier, VS Code)
- 创建项目文档(README, 开发规范)

Closes #1
2026-03-19 16:14:26 +08:00

3.6 KiB
Raw Blame History

项目需求文档

项目名称: TaskManager 创建时间: 2026-03-19 15:49:18 项目类型: Web 应用(前端 + 后端)

项目描述

任务管理器 - 一个用于创建、管理和组织任务的 Web 应用系统。支持任务的完整生命周期管理,包括创建、编辑、状态管理和归档功能。

核心功能

  1. 创建任务 - 用户可以创建新任务,填写任务名称、描述等信息
  2. 编辑任务 - 修改任务的各项属性和信息
  3. 删除任务 - 移除不再需要的任务
  4. 修改任务状态 - 更新任务的完成状态(待办/进行中/已完成等)
  5. 归档任务 - 将已完成或不再活跃的任务归档保存
  6. 标签任务 - 为任务添加标签以便分类和筛选

技术栈

编程语言

  • TypeScript

框架

  • 前端: Next.jsReact 全栈框架)
  • 后端: NestJS企业级 Node.js 框架)

数据库

  • SQLite嵌入式关系型数据库

其他工具

  • 认证: 需要用户认证功能
  • API 文档: 需要Swagger/OpenAPI 自动生成)
  • 测试框架: 待定

依赖关系

┌─────────────────────────────────────────────┐
│              TaskManager 应用                │
├─────────────────┬───────────────────────────┤
│   Next.js 前端  │      NestJS 后端          │
│   (React SSR)   │   (RESTful API)           │
├─────────────────┴───────────────────────────┤
│              SQLite 数据库                   │
├─────────────────────────────────────────────┤
│         认证系统 + API 文档                  │
└─────────────────────────────────────────────┘

项目结构建议

taskmanager/
├── frontend/          # Next.js 前端项目
│   ├── app/          # App Router 路由
│   ├── components/   # React 组件
│   └── lib/          # 前端工具库
├── backend/          # NestJS 后端项目
│   ├── src/
│   │   ├── modules/  # 功能模块
│   │   ├── common/   # 公共代码
│   │   └── config/   # 配置文件
│   └── test/         # 测试文件
├── docs/             # 项目文档
│   ├── plan/         # 开发计划
│   └── modules/      # 模块文档
├── CLAUDE.md         # 开发规范
└── README.md         # 项目说明

开发阶段建议

阶段一:基础架构搭建

  • 初始化 Next.js 前端项目
  • 初始化 NestJS 后端项目
  • 配置 SQLite 数据库连接
  • 配置 TypeScript 编译环境

阶段二:认证系统实现

  • 实现用户注册/登录
  • JWT Token 认证机制
  • 路由权限保护

阶段三:核心功能开发

  • 任务 CRUD 操作
  • 任务状态管理
  • 标签系统
  • 归档功能

阶段四API 文档与测试

  • 集成 Swagger 文档
  • 编写单元测试
  • 编写集成测试

备注

  • 项目采用前后端分离架构,前端使用 Next.js后端使用 NestJS
  • 数据库选择 SQLite 便于快速开发和部署
  • 需要特别注意前后端的 API 接口设计和数据交互
  • 建议使用 monorepo 结构管理前后端代码

下一步操作: 使用 /gitea-init-project 初始化项目并创建 Gitea Issues