叁好学社智能平台产品系统

定位：面向中学教师/学校的 AI 错题管理系统（SaaS 形态）。

解决的痛点：
- 教师日常批改作业/试卷后，错题整理全靠手工抄录、拍照存档，效率极低且无法结构化检索。
- 传统错题本只记录题目本身，缺乏 AI 逐题讲解和举一反三的同类题生成能力。
- 学校内部多位教师之间无法共享错题库，数据孤岛严重。

量化业务背景：一个 30 人班级的某次考试可产生 150+ 道错题，手工整理耗时约 2-3 小时，系统可将此流程压缩到拍照上传后数分钟内自动完成。

1. 拍照上传 + OCR : 批量上传作业/试卷照片，OpenCV 自动检测题目区域并裁剪提取
2. AI 题目解析 : 从裁剪图像中提取结构化题目文本 + 知识点标签（支持豆包/OpenAI兼容/Claude 三个 AI 提供商动态切换）
3. AI 错题讲解 :流式（SSE）生成每道题的解题思路与解析，支持 LaTeX 数学公式
4. AI 练习生成 ： 根据错题知识点自动生成同类型变式练习题
5. 学生管理 : 教师-学生多对多关联，校长角色（principle）可全局查看所有数据
6. PDF 导出: 自定义排版导出题目、解析、练习题，前端 jspdf + 后端 reportlab 双通道
7. 文件存储（错题，错题标签和解析内容）： 统一存储抽象层，开发用本地 Mock Bucket，生产无缝切换阿里云 OSS（客户选择的阿里oss）
8. 数据库备份 : 一键 pg_dump 备份上传到 OSS，带时间戳归档
9. 权限控制 : JWT 认证 + 角色分级（校长/教师）

项目由本人全栈开发并且在客户的服务器上完成部署，项目实现：
后端框架：Python 3.11 + FastAPI 0.115（异步 ASGI）
ORM / 数据库：SQLAlchemy 2.0 + PostgreSQL 15 + Alembic 迁移
前端：Next.js 16.1 + React 19.2 + TypeScript 5 + Tailwind CSS 4
AI SDK：openai SDK（对接豆包/OpenAI）+ anthropic SDK
图像处理：OpenCV（opencv-python-headless）+ Pillow + NumPy
容器化：Docker Compose（4 服务：db、backend、frontend-builder、nginx）
Web 服务器：nginx（反向代理 + 静态文件 + gzip）