# PomodoroTrackerPro

**Repository Path**: from_0_To_Dead_Automation/pomodoro-tracker-pro

## Basic Information

- **Project Name**: PomodoroTrackerPro
- **Description**: 高级番茄钟应用——桌面端
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-17
- **Last Updated**: 2026-05-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Pomodoro Tracker Pro

一个基于 Tauri + React + SQLite 的高级番茄钟桌面应用，帮助你高效管理时间、追踪专注进度、培养良好工作习惯。

## 功能特性

### 核心功能
- **番茄钟计时器**：支持专注（25分钟）、短休息（5分钟）、长休息（15分钟）三种模式
- **项目看板**：Kanban 风格管理任务，支持待办/进行中/已完成三种状态
- **数据分析**：可视化展示专注趋势、项目分布、时段效率等多维度统计
- **成就系统**：完成专注目标解锁成就，持续激励保持专注
- **数据持久化**：所有数据存储在本地 SQLite 数据库，安全可靠

### 个性化设置
- **深浅色主题**：一键切换深色/浅色模式
- **主题颜色**：8种预设主题色可选
- **计时器时长**：自定义专注/休息时长
- **自动开始**：支持自动开始休息/专注
- **通知设置**：声音、桌面通知开关

## 技术栈

| 层级 | 技术 |
|------|------|
| 前端框架 | React 19 + TypeScript |
| 构建工具 | Vite 7 |
| 样式方案 | Tailwind CSS 3 |
| 状态管理 | Zustand |
| 数据可视化 | Recharts |
| 桌面框架 | Tauri v2 |
| 后端语言 | Rust |
| 数据库 | SQLite (rusqlite) |

## 快速开始

### 环境要求
- [Node.js](https://nodejs.org/) (v18+)
- [Rust](https://www.rust-lang.org/) (v1.77.2+)
- [Tauri  prerequisites](https://tauri.app/start/prerequisites/)

### 安装依赖

```bash
npm install
```

### 开发模式

```bash
npm run tauri dev
```

### 构建生产版本

```bash
npm run tauri build
```

构建完成后，安装包位于 `src-tauri/target/release/bundle/` 目录。

## 项目结构

```
pomodoro-tracker-pro/
├── src/                          # 前端源码
│   ├── api/tauri.ts              # Tauri API 调用封装
│   ├── store/appStore.ts         # Zustand 状态管理
│   ├── components/               # 公共组件
│   │   ├── Sidebar.tsx           # 侧边栏导航
│   │   └── TimerDisplay.tsx      # 计时器组件
│   └── pages/                    # 页面
│       ├── FocusPage.tsx         # 今日专注
│       ├── ProjectsPage.tsx      # 项目看板
│       ├── AnalyticsPage.tsx     # 数据分析
│       ├── AchievementsPage.tsx  # 成就中心
│       └── SettingsPage.tsx      # 设置
├── src-tauri/                    # Rust 后端
│   ├── src/
│   │   ├── main.rs               # 入口
│   │   ├── lib.rs                # Tauri 命令注册
│   │   ├── db.rs                 # SQLite 数据库
│   │   ├── models.rs             # 数据模型
│   │   └── commands.rs           # API 命令
│   └── Cargo.toml                # Rust 依赖
└── package.json                  # npm 脚本
```

## 数据库设计

### 表结构

| 表名 | 说明 |
|------|------|
| `projects` | 项目信息 |
| `tasks` | 任务信息 |
| `sessions` | 专注会话记录 |
| `achievements` | 成就数据 |
| `settings` | 应用设置 |

### API 接口

| 接口 | 说明 |
|------|------|
| `get_projects` / `create_project` / `delete_project` | 项目 CRUD |
| `get_tasks` / `create_task` / `update_task` / `delete_task` | 任务 CRUD |
| `get_sessions` / `create_session` | 会话记录 |
| `get_achievements` / `update_achievement_progress` | 成就系统 |
| `get_dashboard_stats` / `get_daily_stats` / `get_project_stats` | 统计数据 |
| `get_setting` / `set_setting` | 设置存储 |

## 截图

### 今日专注
专注计时器支持圆形进度条、模式切换、任务选择。

### 项目看板
Kanban 风格管理任务，支持新建项目/任务、状态切换、删除操作。

### 数据分析
多维度数据可视化，包括专注趋势、项目分布、时段效率等。

### 成就中心
完成专注目标解锁成就，追踪进度。

### 设置
支持主题切换、计时器时长、通知等个性化配置。

## 开发计划

- [x] 基础番茄钟计时器
- [x] 项目与任务管理
- [x] 数据持久化（SQLite）
- [x] 数据分析与可视化
- [x] 成就系统
- [x] 主题切换
- [ ] 数据导出（CSV）
- [ ] 系统托盘支持
- [ ] 桌面通知
- [ ] 多语言支持

## 贡献

欢迎提交 Issue 和 Pull Request！

## 许可证

MIT License