# DLee_learn

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

## Basic Information

- **Project Name**: DLee_learn
- **Description**: DLee的一个学习仓库
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 个人能效管理系统

一个现代化的前后端分离个人任务管理应用，基于四象限法则，支持多用户系统，提供完整的任务管理、分类、优先级设置和任务进度追踪功能。

## 功能特性

- **用户认证**：注册、登录、JWT 令牌认证、密码加密存储
- **四象限法则**：紧急/重要矩阵，支持拖拽调整任务象限
- **任务管理**：增删改查、分类（工作/学习/生活/健康）、优先级、紧急性、搜索、排序
- **数据可视化**：ECharts 饼图、柱状图、折线图展示任务统计
- **响应式设计**：适配移动端、平板和桌面端
- **API 文档**：FastAPI 自动生成 Swagger UI

## 技术栈

| 层级 | 技术 |
|------|------|
| 前端框架 | Vue 3 + Composition API |
| UI 框架 | Element Plus |
| 构建工具 | Vite 5 |
| 状态管理 | Pinia |
| 路由 | Vue Router 4 |
| 图表 | ECharts 5 |
| 拖拽 | Vuedraggable 4 |
| HTTP 客户端 | Axios |
| 后端框架 | FastAPI |
| ORM | SQLAlchemy 2.0 |
| 数据验证 | Pydantic 2.0 |
| 认证 | JWT (python-jose + passlib) |
| 数据库 | SQLite（开发）/ PostgreSQL（生产） |

## 项目结构

```
zgc-app/
├── backend/                    # FastAPI 后端
│   ├── api/                    # API 路由
│   │   ├── auth.py             # 认证 API
│   │   ├── tasks.py            # 任务管理 API
│   │   └── deps.py             # 依赖注入
│   ├── core/                   # 核心配置
│   │   ├── config.py           # 应用配置
│   │   ├── database.py         # 数据库连接
│   │   └── auth.py             # 认证逻辑
│   ├── models/                 # SQLAlchemy 数据模型
│   ├── schemas/                # Pydantic 数据模式
│   ├── services/               # 业务逻辑层
│   ├── utils/                  # 工具函数
│   ├── main.py                 # 应用入口
│   └── requirements.txt        # Python 依赖
├── frontend/                   # Vue 3 前端
│   ├── src/
│   │   ├── api/                # API 调用封装
│   │   ├── layouts/            # 布局组件
│   │   ├── router/             # 路由配置
│   │   ├── stores/             # Pinia 状态管理
│   │   ├── utils/              # 工具函数
│   │   └── views/              # 页面组件
│   │       ├── Login.vue       # 登录页
│   │       ├── Register.vue    # 注册页
│   │       ├── Dashboard.vue   # 统计首页
│   │       ├── Tasks.vue       # 四象限任务列表
│   │       └── AddTask.vue     # 添加/编辑任务
│   ├── index.html
│   ├── package.json
│   └── vite.config.js
├── tests/unit/                 # 单元测试
├── app.py                      # Streamlit 旧版应用（保留）
├── db_manager.py               # 旧版数据库管理（保留）
├── service.py                  # 旧版服务层（保留）
└── task_manager.py             # 旧版任务管理（保留）
```

## 快速开始

### 环境要求

- Python 3.8+
- Node.js 16+

### 启动后端

```bash
cd backend
pip install -r requirements.txt
python main.py
```

后端默认运行在 http://localhost:8000

### 启动前端

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

前端默认运行在 http://localhost:5173

### 访问地址

- 前端应用：http://localhost:5173
- API 文档：http://localhost:8000/docs
- 健康检查：http://localhost:8000/health

## 数据库设计

| 表名 | 说明 | 关键字段 |
|------|------|----------|
| users | 用户表 | id, username, password_hash, email |
| tasks | 任务表 | id, user_id, title, category, priority, urgency |
| task_progress | 任务进度表 | id, task_id, total_subtasks, completed_subtasks |
| subtasks | 子任务表 | id, task_progress_id, title, completed |

## 部署

```bash
# 构建前端
cd frontend && npm run build

# 启动后端（生产环境）
cd backend && uvicorn main:app --host 0.0.0.0 --port 8000
```

将 `frontend/dist` 目录由 Nginx 等静态服务器托管，并配置反向代理指向后端 API。