# TodoPro **Repository Path**: chord-one/todo-pro ## Basic Information - **Project Name**: TodoPro - **Description**: TodoPro是一款功能强大、易于使用的任务管理系统,旨在帮助个人和团队高效管理日常任务,提高工作效率。 - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 2 - **Forks**: 0 - **Created**: 2025-11-27 - **Last Updated**: 2026-11-12 ## Categories & Tags **Categories**: project-management **Tags**: None ## README # TodoPro ## 项目概述 TodoPro是一款功能强大、易于使用的任务管理系统,旨在帮助个人和团队高效管理日常任务,提高工作效率。系统采用前后端分离架构,提供了直观的用户界面和丰富的功能,支持任务创建、编辑、删除、状态管理、优先级设置、分类管理、截止时间提醒等核心功能。此外,系统还集成了智能助手功能,支持通过自然语言对话创建、查询和管理任务,为用户提供更加智能、便捷的交互体验。 ## 核心功能 ### 📋 任务管理 - 创建、编辑、删除任务 - 支持任务分类(工作、生活、学习) - 支持任务优先级设置(高、中、低) - 支持任务状态切换(未完成/已完成) - 支持设置任务截止时间 - 任务筛选功能(按分类、优先级、状态、截止日期) ### 📊 数据看板 - 任务统计数据可视化 - 任务分类占比图表 - 任务优先级分布图表 - 任务完成率实时更新 - 任务总数与已完成任务数统计 ### 👤 用户管理 - 用户注册、登录功能 - 基于JWT的安全认证机制 - 个人中心,支持头像上传与管理 - 个人简介修改 - 完整的用户资料管理 ### ⚙️ 系统设置 - 修改密码功能 - 个性化配置选项 ### 🤖 智能助手 - 与智能助手进行自然语言对话 - 支持通过对话创建、查询、管理任务 - 支持按分类、优先级、状态等条件查询相关任务 - 对话历史记录管理 - 对话摘要自动生成,支持长期记忆 - API调用频率限制,保障服务稳定性 - Token估算优化(tiktoken),精准控制上下文长度 - Markdown渲染支持,富文本消息展示 - 实时消息处理和加载动画 ### 📧 验证码系统 - 基于Redis的验证码存储 - 5分钟自动过期机制 - 邮件发送验证码 - 注册时的验证码验证 ### 🔔 通知中心 - 任务截止时间自动提醒 - 每日任务概览通知 - 通知已读/未读状态管理 - 支持批量标记已读和清空通知 - 基于Celery定时任务的后台调度 ### 🎨 界面设计 - 现代化、简洁美观的UI设计 - 响应式布局,适配不同屏幕尺寸 - 流畅的动画效果和交互体验 - 直观的任务状态展示 - 支持Markdown渲染,安全展示富文本内容 ## 环境要求 ### 前端环境 - Node.js >= 18.x - npm >= 9.x ### 后端环境 - Python >= 3.10 - pip >= 22.x - Redis >= 7.0 (用于验证码存储和缓存) ## 安装与配置 ### 1. 克隆项目 ```bash git clone cd TodoPro ``` ### 2. 后端安装与配置 #### 2.1 进入后端目录 ```bash cd backend ``` #### 2.2 创建虚拟环境(可选但推荐) ```bash # Windows python -m venv venv venv\Scripts\activate # Linux/macOS python3 -m venv venv source venv/bin/activate ``` #### 2.3 安装依赖 ```bash pip install -r requirements.txt ``` #### 2.4 配置环境变量(可选) 在后端目录创建 `.env` 文件,配置以下环境变量: ```env # 数据库配置 DATABASE_URL=postgresql://todopro:todopro@localhost:5432/todopro # Redis配置 REDIS_URL=redis://localhost:6379/0 # 邮件配置 EMAIL_BACKEND=django.core.mail.backends.smtp.EmailBackend EMAIL_HOST=smtp.163.com EMAIL_PORT=465 EMAIL_USE_SSL=True EMAIL_HOST_USER=your_email@163.com EMAIL_HOST_PASSWORD=your_email_password DEFAULT_FROM_EMAIL=your_email@163.com # LLM配置 LLM_MODEL=deepseek-chat LLM_API_KEY=your_deepseek_api_key LLM_API_BASE=https://api.deepseek.com/v1 # Django配置 SECRET_KEY=your_secret_key DEBUG=True ``` #### 2.5 数据库迁移 ```bash python manage.py migrate ``` 使用 Docker Compose 时,建议通过独立迁移容器执行一次性迁移: ```bash docker compose run --rm migrate ``` #### 2.6 创建超级用户(可选) ```bash python manage.py createsuperuser ``` #### 2.7 启动Redis服务(必要) 确保Redis服务已启动: ```bash # Windows(使用WSL或Redis Windows版本) redis-server # Linux/macOS redis-server ``` #### 2.8 启动Celery Worker(可选,用于异步任务) ```bash # Windows celery -A todopro_backend worker -l info -P solo # Linux/macOS celery -A todopro_backend worker -l info ``` #### 2.9 启动Celery Beat(可选,用于定时任务) ```bash # Windows celery -A todopro_backend beat -l info # Linux/macOS celery -A todopro_backend beat -l info ``` #### 2.10 启动后端服务 ```bash python manage.py runserver ``` ### 3. 前端安装与配置 #### 3.1 进入前端目录 ```bash cd ../frontend ``` #### 3.2 安装依赖 ```bash npm install ``` #### 3.3 启动前端开发服务器 ```bash npm run dev ``` 前端服务将在 http://localhost:5173 启动 #### 3.4 构建生产版本 ```bash npm run build ``` ## 许可证 本项目采用MIT许可证,详情请查看[LICENSE](LICENSE)文件。