teacher-ai

面向独立英语家教的 AI 教学辅助系统。当前实现的是 MVP 0.1 骨架与试课成交闭环。

已实现

• pnpm workspace + Turborepo 单仓。
• Next.js Web 工作台。
• NestJS API。
• PostgreSQL + Prisma 数据模型。
• 教师邮箱密码注册、登录、登录态。
• 学生档案创建与列表。
• 试课备课分步向导。
• mock AI 生成试课备课计划、网页课件、试课后学习计划。
• V1.0 预留接口：日常辅导课、练习题生成。
• 千问/阿里云百炼 Provider 接口预留，可通过环境变量启用。
• 文档：项目计划、架构、UI 风格、部署清单。

本地开发

1. 安装依赖：

pnpm install

2. 复制环境变量：

cp .env.example .env

3. 启动数据库：

docker compose up -d postgres

4. 生成 Prisma Client 并迁移数据库：

pnpm db:generate
pnpm db:migrate:init
pnpm db:seed

5. 启动 Web 和 API：

pnpm dev

默认地址：

• Web：http://localhost:3000
• API：http://localhost:4000
• API 文档：http://localhost:4000/docs

Demo 账号：

email: demo@teacher-ai.local
password: teacher-ai-123456

AI Provider

默认使用 mock：

AI_PROVIDER=mock

切换千问/百炼兼容接口：

AI_PROVIDER=qwen
QWEN_API_KEY=your-key
QWEN_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
QWEN_MODEL=qwen-plus

没有配置 QWEN_API_KEY 时，QwenAiProvider 会自动回落到 mock，保证产品流程不断。