ZenTask 是一款基于 Web 的个人待办事项管理工具,旨在通过干净、美观且无干扰的界面,帮助用户高效地组织任务、跟踪进度并专注于最重要的事情。
- 框架: Vue 3 (Composition API)
- 构建工具: Vite
- 路由: Vue Router
- 状态管理: Pinia
- HTTP请求: Axios
- UI框架: Tailwind CSS
- 图标库: Heroicons
- 服务器框架: NestJS
- 数据库: MySQL 8.0+
- ORM: Prisma
- 认证: JWT (JSON Web Tokens)
zentask/
├── frontend/ # Vue3 前端应用
├── backend/ # NestJS 后端应用
├── doc/ # 项目文档
├── docker-compose.yml # Docker 容器编排
└── README.md # 项目说明
- Node.js >= 18.0.0
- MySQL >= 8.0 (可选,支持Docker自动启动)
- npm 或 yarn
- Docker & Docker Compose (可选)
Linux/macOS:
# 智能启动(自动检测MySQL服务)
chmod +x start-smart.sh
./start-smart.sh
# 或使用原始启动脚本
chmod +x start.sh
./start.shWindows:
# 智能启动(自动检测MySQL服务)
start-smart.bat
# 或使用原始启动脚本
start.bat智能启动特性:
- 🔍 自动检测已运行的MySQL服务
- 🚀 智能选择启动方式(使用现有服务或启动新容器)
- 💡 避免重复启动MySQL容器
- 📝 详细的状态日志输出
- ⚡ 零配置启动体验
# 安装前端依赖
cd frontend
npm install
# 安装后端依赖
cd ../backend
npm install# 启动后端服务 (端口: 3000)
cd backend
npm run start:dev
# 启动前端服务 (端口: 5173)
cd frontend
npm run dev# 启动所有服务(包括MySQL)
docker-compose up -d
# 仅启动MySQL服务
docker-compose -f docker-compose.mysql-only.yml up -d
# 查看服务状态
docker-compose ps
# 停止服务
docker-compose down- ✅ 用户注册/登录
- ✅ 多项目列表管理
- ✅ 任务CRUD操作
- ✅ 拖拽排序
- ✅ 智能视图(今天、最近7天)
- ✅ 响应式设计
- ✅ 深浅色主题切换
- ✅ 优雅的动画效果
- 🔧 智能MySQL服务检测
- 🐳 Docker容器化支持
- 🚀 一键启动脚本
- 📊 服务状态监控
- 🔄 自动环境配置
详细的开发计划请查看项目任务列表,包含19个主要开发阶段,从环境搭建到最终部署。
- Fork 项目
- 创建功能分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 打开 Pull Request
本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。