# 真实软件案例

> 3 个真实场景的需求描述，用于验证 Software Generator 在实际业务中的表现。

---

## 案例 1: TeamFlow — 团队协作看板

**场景:** 一个 10 人创业团队，使用 Trello 但觉得太重，想要一个轻量自托管的看板工具。

**需求描述:**

```
做一个团队协作看板工具叫 TeamFlow。核心功能：
1. 看板视图：支持创建多个看板，每个看板有多个列（待办/进行中/已完成等），卡片可以在列之间拖拽
2. 任务管理：每个任务卡片支持标题、描述、标签、截止日期、负责人、优先级（P0-P3）
3. 团队成员：邀请成员、分配任务、查看成员工作负载
4. 筛选和搜索：按标签、负责人、优先级筛选，全文搜索任务
5. 活动日志：记录谁在什么时候做了什么操作
6. 数据统计：每个成员的任务数、完成率、超期任务数

技术要求：
- 自托管，不需要外部数据库，用 SQLite
- 支持移动端访问（响应式）
- 简洁现代的 UI，参考 Linear 的设计风格
```

**验证点:**
- 能否生成拖拽看板的前端组件
- 能否生成活动日志的后端实现
- 统计功能是否涉及聚合查询

---

## 案例 2: MealPrep — 备餐管理系统

**场景:** 一个健身教练需要管理客户的饮食计划，目前用 Excel 管理 50+ 客户的每周备餐方案。

**需求描述:**

```
做一个备餐管理系统叫 MealPrep，帮助健身教练管理客户的饮食计划。
功能需求：
1. 食物库：管理食物信息（名称、分类、每100g营养成分：蛋白质/碳水/脂肪/热量），支持自定义添加
2. 客户管理：客户档案（姓名、年龄、体重、目标体重、活动量、过敏原、饮食偏好）
3. 餐计划：为每个客户创建每周餐计划（早/中/晚/加餐），每餐选择食物和份量
4. 营养计算：自动计算每餐和每日总营养，与客户目标对比（热量缺口/盈余）
5. 购物清单：根据餐计划自动生成本周购物清单，按食材分类（蔬菜/肉类/谷物等）
6. 模板功能：保存常用餐计划为模板，快速复用给其他客户

技术要求：
- 单用户使用，不需要复杂认证
- 数据本地存储
- 移动端优先设计（教练在健身房用手机操作）
- 中文界面
```

**验证点:**
- 营养计算逻辑能否在后端正确实现
- 购物清单聚合查询
- 模板复用的数据模型设计

---

## 案例 3: BookShelf — 个人读书管理

**场景:** 一个每年读 50+ 本书的人，想要一个自托管的读书管理系统，替代豆瓣标记。

**需求描述:**

```
做一个个人读书管理系统叫 BookShelf。
功能：
1. 书籍库：添加书籍（书名、作者、出版社、ISBN、封面图URL、分类、总页数）
2. 阅读状态：想读/在读/已读，记录开始日期和完成日期
3. 阅读进度：更新当前页数，自动计算完成百分比
4. 笔记和标注：对某一页写笔记，支持高亮段落摘抄
5. 书评：读完后写书评，打分（1-5星）
6. 统计仪表盘：年度阅读量、月度趋势、分类分布、平均评分、阅读总页数
7. 搜索和筛选：按状态/分类/作者/评分筛选

技术要求：
- 单用户，简单登录即可
- SQLite 存储
- 响应式设计，手机和电脑都能用
- 支持导入豆瓣标记的 CSV
- 中文界面
```

**验证点:**
- 文件上传（CSV 导入）功能
- 统计仪表盘的图表数据 API
- 一对多关系（书籍 → 笔记）的数据模型
