TaskPlan

基于 Vue 3 + TypeScript + Node.js 的轻量级任务与习惯管理应用

项目简介

该项目用于管理任务、习惯、优先级与日记，包含前端 SPA 和一个 TypeScript 编写的后端 API（见 api/ 目录）。适合作为个人时间管理或学习项目模板。

主要特性

• 任务管理：添加、编辑、删除任务与截止日期。
• 习惯追踪：打卡、统计与可视化（ActivityHeatmap）。
• 日志/日记：每日记录与检索。
• 通知与邮件调度（后端服务）。
• 响应式 UI，支持不同视图（日/周/月/列表/日程）。

技术栈

• 前端：Vue 3、Pinia、TypeScript、Vite、Tailwind CSS、Material Design
• 后端：Node.js、Express、TypeScript
• 数据库：SQLite（轻量持久化，见 api/db.ts）
• 其它：nodemon、concurrently、axios

快速开始

先决条件：安装 Node.js（建议 v16+）和 npm。

克隆仓库并安装依赖：

git clone <repo-url>
cd TaskPlan
npm install

开发（同时启动前端与后端）：

npm run dev

单独启动：

# 启动前端开发服务器
npm run client:dev

# 启动后端开发服务器（nodemon）
npm run server:dev

构建并预览生产包：

npm run build
npm run preview

更多脚本：npm run check（类型检查）、npm run lint / npm run lint:fix。

项目结构（重要目录）

• src/：前端源码（组件、页面、路由、store 等）。
• api/：后端 TypeScript 源码（路由、服务、数据库）。
• public/：静态资源。

API 说明

后端路由在 api/routes/ 中。启动后默认监听配置在 api/server.ts（请查看文件以获取端口和环境变量说明）。

贡献

欢迎提交 issue 或 PR：

1. Fork 仓库
2. 新建分支
3. 提交并发起 PR

请遵循现有代码风格并运行 npm run lint。

许可证

本仓库暂未指定许可证

联系

如有问题，请在仓库中打开 issue，或直接联系仓库维护者。