# TimeMaster

**Repository Path**: zouyou1022/time-master

## Basic Information

- **Project Name**: TimeMaster
- **Description**: No description available
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-03
- **Last Updated**: 2026-03-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 任务管理系统

个人任务管理 + 番茄工作法系统

## 功能特性

### ✅ 任务管理
- 多维度分类（工作/个人/学习/健康/其他）
- 优先级管理（高/中/低）
- 任务分解（项目 → 任务 → 子任务）
- 时间管理（截止时间、预估时间、时间段）
- 状态跟踪（待办/进行中/完成/取消）

### 🍅 番茄工作法
- 25 分钟工作 + 5 分钟休息
- 每 4 个番茄后长休息 15 分钟
- 番茄计数和统计
- 任务关联

### 📊 统计分析
- 任务完成率
- 类型分布
- 优先级分布
- 番茄统计
- 逾期提醒

### 📅 日历视图
- 任务时间分布
- 截止日期可视化
- 周/月视图

### 🖥️ NiceGUI 界面
- 仪表盘总览
- 任务列表和筛选
- 快速操作
- 响应式设计

---

## 快速开始

### 1. 安装依赖

```bash
cd tasks-system
pip install -r requirements.txt
```

### 2. 运行系统

```bash
python ui.py
```

访问：http://localhost:8081

---

## 文件结构

```
tasks-system/
├── config.py           # 配置
├── models.py           # 数据库模型
├── task_manager.py     # 任务管理逻辑
├── pomodoro.py         # 番茄计时器
├── ui.py               # NiceGUI 界面
├── main.py             # 入口（可选）
├── requirements.txt    # 依赖
└── tasks.db            # SQLite 数据库（自动生成）
```

---

## API 使用示例

### Python 代码使用

```python
from task_manager import task_manager

# 创建项目
project = task_manager.create_project("交易系统开发", "量化交易系统")

# 创建任务
task = task_manager.create_task(
    title="完善 main.py",
    task_type="work",
    priority="high",
    project_id=project.id,
    due_datetime=datetime(2026, 3, 10, 18, 0),
    estimated_hours=2.0,
    estimated_pomodoros=4,
)

# 查询任务
tasks = task_manager.get_tasks(status="todo", priority="high")

# 完成任务
task_manager.complete_task(task.id)

# 获取统计
stats = task_manager.get_statistics()
print(f"完成率：{stats['completion_rate']}%")
```

---

## 配置选项

创建 `.env` 文件：

```env
# 数据库
DB_PATH=./tasks.db

# 番茄钟设置
WORK_MINUTES=25
SHORT_BREAK_MINUTES=5
LONG_BREAK_MINUTES=15
POMODOROS_UNTIL_LONG_BREAK=4

# UI 设置
UI_PORT=8081
UI_TITLE=任务管理系统
```

---

## 数据库模型

### Task（任务）
- title: 任务标题
- description: 描述
- task_type: 类型（work/personal/study/health/other）
- priority: 优先级（high/medium/low）
- status: 状态（todo/in_progress/done/cancelled）
- project_id: 所属项目
- parent_task_id: 父任务（用于分解）
- due_datetime: 截止时间
- estimated_hours: 预估工时
- pomodoro_count: 完成番茄数
- estimated_pomodoros: 预估番茄数
- tags: 标签

### Project（项目）
- name: 项目名称
- description: 描述
- status: 状态（active/completed/on_hold）

### PomodoroSession（番茄记录）
- task_id: 关联任务
- started_at: 开始时间
- completed_at: 完成时间
- duration_minutes: 时长
- interrupted: 是否中断

---

## 开发计划

- [ ] 飞书集成（自动同步待办）
- [ ] 邮件提醒
- [ ] 移动端优化
- [ ] 数据导出（CSV/Excel）
- [ ] 任务模板
- [ ] 重复任务
- [ ] 甘特图视图

---

## 技术栈

- **后端**: Python 3.10+
- **数据库**: SQLite + Peewee ORM
- **UI**: NiceGUI
- **配置**: pydantic-settings

---

## 作者

为 Jerry 的量化交易工作流定制开发

**创建时间**: 2026-03-03