# smart-task-manager

**Repository Path**: roskin/smart-task-manager

## Basic Information

- **Project Name**: smart-task-manager
- **Description**: smart-task-manager
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-04-28
- **Last Updated**: 2026-04-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🎯 智能任务管理系统

> 基于四象限优先级管理的现代化任务管理系统

![License](https://img.shields.io/badge/license-MIT-blue.svg)
![Node](https://img.shields.io/badge/node-%3E%3D18-green.svg)
![React](https://img.shields.io/badge/react-18.x-blue.svg)
![TypeScript](https://img.shields.io/badge/typescript-5.x-blue.svg)

## 核心特性

### 🎯 四象限规划
- 基于重要性和紧急性的智能任务分类
- 视觉化的优先级矩阵
- 动态推荐最佳执行策略

### 📋 看板流水线  
- 拖拽式任务状态管理
- 实时进度追踪
- 依赖关系可视化

### 👥 团队协作
- 用户角色管理（Owner/Admin/Member）
- 任务分配和协作
- 团队成员管理

### 🏷️ 标签分类
- 多样化任务标签（工作、学习、健康等）
- 颜色分类和筛选
- 自定义标签创建

### 🔔 智能提醒
- 浏览器通知集成
- 逾期任务高亮
- 截止日期提醒

### 🔍 高级搜索
- 任务标题和内容搜索
- 标签、状态、优先级筛选
- 实时搜索结果

### 🏆 成果导向
- 价值创造追踪
- 日/周/月成果统计
- 成就记录与回顾

## 技术栈

### 前端
- React 19 + TypeScript
- Redux Toolkit (状态管理)
- Tailwind CSS (样式)
- @dnd-kit (拖拽)
- Lucide React (图标)

### 后端
- Node.js + Express
- Better SQLite3 (数据库)
- TypeScript

## 快速开始

### 1. 安装依赖
```bash
npm run install-all
```

### 2. 启动应用
```bash
npm run dev
```

这将同时启动：
- 前端服务：http://localhost:3000
- 后端API：http://localhost:3001

### 3. 单独启动服务

**仅启动前端：**
```bash
npm run client
```

**仅启动后端：**
```bash
npm run server
```

## 项目结构

```
todo/
├── client/                 # React前端应用
│   ├── src/
│   │   ├── components/     # UI组件
│   │   ├── store/         # Redux状态管理
│   │   ├── services/      # API服务
│   │   ├── types/         # TypeScript类型
│   │   └── utils/         # 工具函数
│   └── public/
├── server/                # Express后端服务
│   ├── src/
│   │   ├── routes/        # API路由
│   │   ├── database/      # 数据库配置
│   │   └── types/         # 类型定义
│   └── data/              # SQLite数据库文件
└── package.json           # 根配置文件
```

## API 接口

### 任务管理
- `GET /api/tasks` - 获取所有任务
- `POST /api/tasks` - 创建新任务
- `PUT /api/tasks/:id` - 更新任务
- `DELETE /api/tasks/:id` - 删除任务
- `GET /api/tasks/quadrant/:type` - 按象限获取任务

### 项目管理
- `GET /api/projects` - 获取所有项目
- `POST /api/projects` - 创建新项目
- `PUT /api/projects/:id` - 更新项目
- `DELETE /api/projects/:id` - 删除项目

### 成果追踪
- `GET /api/outcomes` - 获取所有成果
- `POST /api/outcomes` - 记录新成果
- `GET /api/outcomes/daily/:date` - 获取每日成果统计

## 使用指南

### 任务优先级设置
- **紧急程度(1-10)**：考虑时间压力，是否需要立即处理
- **重要程度(1-10)**：考虑对目标的影响，长期价值

### 四象限分类
1. **🔥 危机处理**（紧急+重要）：立即处理
2. **🎯 战略规划**（重要+不紧急）：重点投入80%精力
3. **📞 中断干扰**（紧急+不重要）：考虑委托或批量处理  
4. **📺 时间浪费**（不紧急+不重要）：考虑删除

### 看板使用技巧
- 合理控制"进行中"任务数量（建议≤3个）
- 利用彩色边框快速识别优先级
- 拖拽任务卡片改变状态

### 成果记录建议
- 关注"创造了什么价值"而不只是"做了什么事"
- 高价值成果(8-10分)：解决重要问题、创造长期影响
- 定期回顾成果记录，发现个人价值创造模式

## 开发说明

### 环境变量
```bash
# client/.env
REACT_APP_API_URL=http://localhost:3001/api
```

### 数据库
应用使用SQLite数据库，首次运行时会自动创建表结构。数据库文件位于 `server/data/tasks.db`。

### 构建部署

**开发环境构建：**
```bash
# 构建前端
npm run build

# 启动生产服务器
cd server && npm start
```

**生产环境部署：**

详见 [部署文档](DEPLOYMENT.md) 或使用一键部署脚本：

```bash
# 服务器部署（推荐）
sudo ./server-deploy-robust.sh

# Docker部署
./deploy.sh prod

# 手动部署
./deploy-without-docker.sh
```

## 贡献指南

1. Fork 项目
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request

## 许可证

MIT License - 详见 [LICENSE](LICENSE) 文件

---

**智能任务管理系统 - 专注于价值创造和高效执行** 🚀