ai_soc_sw/projects/P01_errlens_app/docs/01_需求概要.md

# P01_errlens_app — 需求概要

## 项目概述

ErrLens 小程序是一款面向中小学生的 **AI 错题本**，帮助学生拍照录入错题、自动归类分析、获得针对性练习推荐。

## 项目定位

- **产品类型**: AI 错题本（教育类微信小程序）
- **目标用户**: 中小学生（10-18 岁），以初中生为典型交互设计
- **核心价值**: 拍照录入 → AI 分析错误原因 → 识别薄弱知识点 → 推荐同类练习

## 技术栈

### 前端框架
| 技术 | 版本 | 说明 |
|------|------|------|
| Taro | 4.1.x | 跨端开发框架 |
| React | 18.x | UI 框架 |
| TypeScript | 5.x | 类型安全 |
| Tailwind CSS | 4.x | 原子化样式 |
| Zustand | 5.x | 状态管理 |

### 后端框架
| 技术 | 版本 | 说明 |
|------|------|------|
| NestJS | 10.x | Node.js 服务端框架 |
| PostgreSQL | 15+ | 关系数据库 |
| Drizzle ORM | 0.45.x | ORM 工具 |

### 集成服务
| 服务 | 说明 |
|------|------|
| Supabase | 数据库托管 |
| S3 兼容存储 | 错题图片存储 |
| Coze SDK | AI OCR + 知识点分类 + 错误诊断 |
| 微信开放平台 | 微信登录 + 小程序能力 |

## 核心功能模块

### 1. 拍照录入模块
- [ ] 拍照/选图 → AI 识别题目文字、学科、知识点
- [ ] 识别结果展示 + 用户修正
- [ ] 正确答案录入（可选）

### 2. 错题管理模块
- [ ] 错题列表（按时间/学科/知识点/错误类型筛选）
- [ ] 错题详情（题目 + AI 分析 + 知识点标注）
- [ ] 错题编辑（修正 AI 识别结果）

### 3. AI 分析模块
- [ ] 单题错误诊断（知识点欠缺/粗心/审题偏差/概念混淆）
- [ ] 薄弱知识点汇总与排序
- [ ] 学习报告（周/月度趋势）

### 4. 用户模块
- [ ] 微信授权登录
- [ ] 年级和学科设置
- [ ] 个人中心

### 5. 练习推荐模块（P1）
- [ ] 基于薄弱点推荐同类题
- [ ] 自定义组题练习

## 页面结构

```
pages/
├── index/            # 首页（错题概览 + 快捷入口）
├── auth/
│   └── login/        # 微信授权登录
├── capture/          # 拍照录入
│   ├── index/        # 拍照页
│   └── review/       # 识别结果确认页
├── error-list/       # 错题列表
├── error-detail/     # 错题详情 + AI 分析
├── weak-points/      # 薄弱点分析
├── practice/         # 练习推荐 (P1)
└── profile/          # 个人中心
```

## 多端支持

| 平台 | 状态 | 优先级 |
|------|------|--------|
| 微信小程序 | MVP 唯一平台 | P0 |
| 抖音小程序 | 按需适配 | P3 |
| H5 | 兜底+开发调试 | P2 |

## 用户体验目标

- **录入效率**: 拍照到保存 < 30s（含 AI 识别 3-5s）
- **首屏加载**: < 2s
- **交互流畅**: 60fps，长列表使用虚拟列表
- **离线可用**: 图片本地缓存，网络恢复后上传

## 安全要求

- 微信 OAuth 登录，不存储密码
- 用户数据严格隔离（API 鉴权）
- 图片上传使用签名 URL
- 敏感信息传输加密

---

**文档版本**: v0.1.0 | **基于**: [PRD.md](../../../docs/01_产品需求/PRD.md) | **最后更新**: 2026-05-26