# vibe-coding-lr

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

## Basic Information

- **Project Name**: vibe-coding-lr
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 个人能效管理系统

一个基于Streamlit的个人能效管理应用，支持任务管理、四象限优先级、用户认证等功能。

## 功能特性

### 核心功能
- ✅ 任务管理（增删改查）
- ✅ 四象限优先级系统（重要紧急、重要不紧急、不重要紧急、不重要不紧急）
- ✅ 任务分类管理（工作、学习、生活、健康）
- ✅ 任务搜索和排序
- ✅ 数据导出（CSV格式）
- ✅ 数据统计和可视化
- ✅ 用户认证（注册、登录）
- ✅ 数据隔离（用户数据隔离）

### 技术特性
- 🔒 安全密码存储（PBKDF2-HMAC-SHA256）
- 🗄️ SQLite数据库持久化
- 📊 数据可视化（matplotlib）
- 🧪 完整的测试覆盖
- 📝 类型注解支持
- 🔍 代码质量检查

## 项目结构

```
vibe-coding-lr/
├── app.py                      # 主应用文件
├── database.py                 # 数据库管理模块
├── types.py                    # 类型定义
├── exceptions.py               # 自定义异常
├── validators.py              # 输入验证
├── requirements.txt           # 依赖列表
├── pyproject.toml           # 项目配置
├── Makefile                 # 自动化脚本
├── tests/                   # 测试目录
│   └── unit/              # 单元测试
│       ├── test_database_categories.py
│       ├── test_database_quadrants.py
│       ├── test_database_tasks.py
│       ├── test_database_user.py
│       ├── test_database_user_tasks.py
│       ├── test_database_password_migration.py
│       └── test_database_password_security.py
└── .github/
    └── workflows/
        └── ci.yml          # CI/CD配置
```

## 快速开始

### 环境要求
- Python 3.8+
- pip

### 安装依赖

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

### 运行应用

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

或者使用Makefile：

```bash
make run
```

### 开发模式

```bash
make dev
```

## 测试

### 运行所有测试

```bash
pytest tests/ -v
```

或者使用Makefile：

```bash
make test
```

### 运行测试并生成覆盖率报告

```bash
make test-coverage
```

## 代码质量

### 代码检查

```bash
make lint
```

### 代码格式化

```bash
make format
```

### 运行所有检查

```bash
make check
```

## 工具说明

### Makefile命令

| 命令 | 说明 |
|--------|------|
| `make install` | 安装依赖 |
| `make test` | 运行测试 |
| `make test-coverage` | 运行测试并生成覆盖率报告 |
| `make lint` | 运行代码检查 |
| `make format` | 格式化代码 |
| `make check` | 运行所有检查 |
| `make clean` | 清理临时文件 |
| `make run` | 运行应用 |
| `make dev` | 开发模式 |
| `make reset-db` | 重置数据库 |

### 密码重置

如果需要重置用户密码：

```bash
python reset_password.py
```

## 安全特性

### 密码存储
- 使用PBKDF2-HMAC-SHA256算法
- 随机盐值（16字节）
- 100,000次迭代
- 兼容旧SHA256格式（自动迁移）

### 数据隔离
- 用户数据完全隔离
- 所有操作都基于user_id
- 防止跨用户数据访问

### 输入验证
- 用户名、密码、邮箱验证
- 任务标题、描述验证
- 分类、象限、状态验证
- SQL注入防护

## 数据库

### 数据库文件
- 默认位置：`productivity_manager.db`
- SQLite格式

### 主要表结构

#### users表
- id: 主键
- username: 用户名（唯一）
- password: 密码哈希
- email: 邮箱（可选）
- created_at: 创建时间
- updated_at: 更新时间

#### tasks表
- id: 主键
- title: 任务标题
- description: 任务描述
- category: 分类
- quadrant: 象限（1-4）
- status: 状态（待办/进行中/已完成）
- user_id: 用户ID（外键）
- created_at: 创建时间
- updated_at: 更新时间

#### categories表
- id: 主键
- name: 分类名称（唯一）

## 四象限优先级

| 象限 | 名称 | 说明 |
|--------|------|------|
| 1 | 重要且紧急 | 🔴 立即处理 |
| 2 | 重要但不紧急 | 🟡 计划处理 |
| 3 | 不重要但紧急 | 🟠 委托处理 |
| 4 | 不重要且不紧急 | 🟢 删除或延后 |

## 开发指南

### 代码风格
- 遵循PEP 8规范
- 使用Ruff进行代码检查
- 使用Black进行代码格式化
- 添加类型注解
- 编写单元测试

### 提交规范
- 清晰的提交信息
- 运行测试确保通过
- 代码检查无错误

## CI/CD

项目使用GitHub Actions进行持续集成：

- 代码检查（Ruff）
- 单元测试（pytest）
- 安全检查（bandit）
- 类型检查（mypy）
- 覆盖率报告（codecov）

## 许可证

MIT License

## 贡献

欢迎提交Issue和Pull Request！

## 联系方式

如有问题，请提交Issue。