# vibe-coding-ycf

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

## Basic Information

- **Project Name**: vibe-coding-ycf
- **Description**: 记录vibe coding学习之旅
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 诸葛菜任务管理系统

一个基于Streamlit和SQLite的个人任务管理系统，支持任务分类、四象限优先级管理、搜索和排序功能。

## 功能特性

- ✅ **任务管理**：创建、编辑、删除、标记完成任务
- ✅ **任务分类**：工作、学习、生活、其他四个分类
- ✅ **四象限优先级**：重要且紧急、重要不紧急、紧急不重要、不重要不紧急
- ✅ **任务搜索**：支持按标题和描述进行关键词搜索
- ✅ **任务排序**：支持按创建时间、标题、分类、优先级排序
- ✅ **数据持久化**：基于SQLite数据库，重启服务后数据仍然存在
- ✅ **任务统计**：实时统计各分类和优先级的任务数量
- ✅ **任务筛选**：支持按分类和优先级筛选任务

## 技术栈

- Python 3.x
- Streamlit 1.35.0
- SQLite3（Python内置）
- unittest（测试框架）

## 项目结构

```
vibe-coding-ycf/
├── app.py                    # 主应用入口
├── service.py                 # 业务逻辑层
├── add_test_data.py          # 添加测试数据脚本
├── requirements.txt           # 项目依赖
├── modules/                  # 功能模块
│   ├── database.py           # 数据库操作
│   ├── task_management.py    # 任务管理
│   ├── task_categories.py    # 任务分类
│   ├── task_overview.py     # 任务概览
│   └── quadrant_view.py     # 四象限视图
├── styles/                  # 样式文件
│   └── material_design.css  # Material Design样式
└── tests/                   # 测试文件
    └── unit/
        └── test_app_unittest.py  # 单元测试
```

## 快速开始

### 1. 安装依赖

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

### 2. 添加测试数据（可选）

```bash
python add_test_data.py
```

### 3. 启动应用

```bash
streamlit run app.py
```

应用将在浏览器中自动打开，默认地址为 http://localhost:8501

### 4. 运行测试

```bash
python -m unittest tests.unit.test_app_unittest -v
```

## 使用说明

### 任务管理

1. **添加任务**：
   - 填写任务标题（3-50个字符）
   - 选择任务分类
   - 选择优先级
   - 填写任务描述（可选）
   - 点击"添加任务"

2. **编辑任务**：
   - 在任务列表中点击"编辑"按钮
   - 修改任务信息
   - 点击"保存修改"

3. **标记完成**：
   - 点击任务右侧的"标记完成"按钮

4. **删除任务**：
   - 点击任务右侧的"删除"按钮

### 任务搜索

- 在"搜索任务"输入框中输入关键词
- 系统会自动搜索标题和描述中包含该关键词的任务
- 搜索不区分大小写，支持部分匹配

### 任务排序

- 在"排序"下拉框中选择排序方式：
  - 最新创建：最新的任务显示在前面
  - 最早创建：最早的任务显示在前面

### 任务筛选

- 选择分类筛选：按工作、学习、生活、其他筛选
- 选择优先级筛选：按四象限优先级筛选
- 搜索、筛选、排序可以组合使用

## 数据库

### 数据库文件

- 数据库文件：`tasks.db`
- 首次运行时自动创建
- 建议定期备份数据库文件

### 数据库结构

**tasks表**

| 字段名 | 类型 | 说明 |
|--------|------|------|
| id | TEXT | 任务唯一ID（主键） |
| title | TEXT | 任务标题 |
| description | TEXT | 任务描述 |
| category | TEXT | 任务分类 |
| priority | TEXT | 任务优先级 |
| created_at | TEXT | 创建时间 |
| completed | INTEGER | 完成状态（0=未完成，1=已完成） |

## 测试

项目包含完整的单元测试，覆盖所有核心功能：

- 任务标题验证
- 任务创建
- 任务筛选
- 任务统计
- 任务更新
- 任务删除
- 任务搜索
- 任务排序

测试文件：`tests/unit/test_app_unittest.py`

## 注意事项

1. 数据库文件 `tasks.db` 会在应用首次运行时自动创建
2. 建议定期备份数据库文件
3. 如需重置数据库，删除 `tasks.db` 文件后重新运行应用
4. 所有数据库操作都包含错误处理，确保应用稳定性

## 许可证

请参考项目根目录的LICENSE文件。

## 参与贡献

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request