# test_jolly3

**Repository Path**: vibe-coding-2026-3/test_jolly3

## Basic Information

- **Project Name**: test_jolly3
- **Description**: No description available
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-06
- **Last Updated**: 2026-04-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 个人能效管理系统

一个基于 FastAPI + React + SQLite 的个人任务管理系统，支持四象限管理、日历视图、分类标签等功能。

## 功能特性

- **用户管理**: 本地多用户账号切换
- **任务管理**: 完整的增删改查，支持优先级、状态、截止时间
- **四象限管理**: 基于紧急重要矩阵的任务视图
- **日历视图**: 周/月视图切换，任务在日历上的展示
- **分类管理**: 自定义分类，支持颜色和图标
- **标签系统**: 多标签关联任务
- **数据统计**: 任务完成率、四象限分布、趋势图表

## 技术栈

### 后端
- FastAPI 0.109.0
- SQLAlchemy 2.0.25
- SQLite
- Pydantic
- pytest

### 前端
- React 18
- TypeScript
- Tailwind CSS
- Zustand (状态管理)
- React Query
- Recharts (图表)
- Lucide React (图标)

## 项目结构

```
project/
├── backend/                    # FastAPI 后端
│   ├── app/
│   │   ├── main.py            # 应用入口
│   │   ├── config.py          # 配置
│   │   ├── database.py        # 数据库连接
│   │   ├── models/            # SQLAlchemy 模型
│   │   ├── schemas/           # Pydantic 模式
│   │   └── routers/           # API 路由
│   └── tests/unit/            # 单元测试
├── frontend/                   # React 前端
│   ├── src/
│   │   ├── components/        # 组件
│   │   ├── pages/             # 页面
│   │   ├── stores/            # 状态管理
│   │   ├── services/          # API服务
│   │   └── types/             # TypeScript类型
│   └── package.json
└── SPEC.md                     # 产品需求规格说明书
```

## 快速开始

### 1. 安装后端依赖

```bash
cd backend
pip install -r requirements.txt
```

### 2. 安装前端依赖

```bash
cd frontend
npm install
```

### 3. 启动后端服务

```bash
cd backend
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
```

或使用启动脚本：
```bash
python start_backend.py
```

### 4. 启动前端服务

```bash
cd frontend
npm run dev
```

或使用启动脚本：
```bash
python start_frontend.py
```

### 5. 访问应用

- 前端: http://localhost:5173
- 后端 API: http://localhost:8000
- API 文档: http://localhost:8000/docs

## 运行测试

### 后端测试

```bash
cd backend
pytest
```

## API 接口

### 用户接口
- `POST /users/` - 创建用户
- `GET /users/` - 获取用户列表
- `GET /users/{id}` - 获取用户详情
- `PUT /users/{id}` - 更新用户
- `DELETE /users/{id}` - 删除用户

### 任务接口
- `POST /tasks/` - 创建任务
- `GET /tasks/` - 获取任务列表（支持筛选）
- `GET /tasks/{id}` - 获取任务详情
- `PUT /tasks/{id}` - 更新任务
- `DELETE /tasks/{id}` - 删除任务
- `PATCH /tasks/{id}/status` - 更新任务状态
- `POST /tasks/{id}/complete` - 完成任务

### 分类接口
- `POST /categories/` - 创建分类
- `GET /categories/` - 获取分类列表
- `PUT /categories/{id}` - 更新分类
- `DELETE /categories/{id}` - 删除分类

### 标签接口
- `POST /tags/` - 创建标签
- `GET /tags/` - 获取标签列表
- `PUT /tags/{id}` - 更新标签
- `DELETE /tags/{id}` - 删除标签

## 开发计划

- [x] 第一阶段：基础架构
- [x] 第二阶段：核心功能（用户、任务、分类、标签）
- [x] 第三阶段：特色功能（四象限、日历）
- [ ] 第四阶段：增强功能（重复任务、数据导出、提醒）
- [ ] 第五阶段：测试与优化

## License

MIT