# vibe-coding-SHU

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

## Basic Information

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

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🥬 诸葛菜 · 个人能效管理

> 基于 **FastAPI + 原生 HTML/CSS/JS + SQLite** 的个人任务管理工具。

当前仓库里有两套实现：

- 当前主线：`FastAPI + 原生前端`，目录在 `诸葛菜/`，这是默认启动方式
- 遗留版本：`Streamlit` 单体应用，保留在 `诸葛菜/app.py` 里作历史兼容和参考

## 当前版本

- 主线版本：`v2.1`
- 认证方式：`JWT`
- 数据存储：`SQLite`
- 前端形态：单页应用，静态资源由 FastAPI 直接挂载

## 主要功能

- 用户注册、登录、资料维护、密码修改
- 任务 CRUD、状态流转、搜索、分组与筛选
- 四象限任务管理与拖拽调整优先级
- 自定义分类管理
- 日程管理：截止日期、截止时间、提醒、自动升级紧急
- 重复任务：按天、按周、按月生成与滚动补齐
- 日历视图、首页仪表盘、周报统计、CSV 导出、完成历史
- 日志记录与单元/集成测试

## 仓库结构

```text
vibe-codding/
├── 诸葛菜/                         # 主项目目录
│   ├── backend/                    # FastAPI 后端
│   ├── frontend/                   # 原生 HTML/CSS/JS 前端
│   ├── tests/                      # pytest 测试
│   ├── 启动.bat                    # Windows 启动脚本
│   ├── app.py                      # 遗留 Streamlit 单体实现
│   └── README.md                   # 项目内详细说明
├── cursor_docs/                    # 技术文档与评审记录
├── build_exe/                      # 打包产物与打包脚本
└── README.md
```

## 快速启动

```bash
cd 诸葛菜
pip install -r backend/requirements.txt
python -m uvicorn backend.main:app --host 127.0.0.1 --port 8000 --reload
```

启动后访问：`http://localhost:8000`

Windows 下也可以直接运行：

```bat
诸葛菜\启动.bat
```

## 测试

```bash
cd 诸葛菜
python -m pytest tests/
python -m pytest tests/ -m unit
python -m pytest tests/ -m integration
```

## 文档

- 项目内使用说明：`诸葛菜/README.md`
- 技术文档：`cursor_docs/诸葛菜项目技术文档.md`

## 说明

- `诸葛菜/README.md` 现在已经按实际架构更新为 `FastAPI + 原生前端`
- `诸葛菜/app.py` 与 `诸葛菜/requirements.txt` 仍属于 Streamlit 遗留实现，不是默认运行入口