# 智教助手

面向教师 AI 教学创作场景设计的智能体系统，帮助教师将教学想法快速转化为互动课件、教学动画、课堂工具和教案成果。

## 核心功能

| 模块 | 功能 | 说明 |
|------|------|------|
| AI课件生成 | 一句话生成互动课件 | 输入教学想法，AI自动生成交互式课件 |
| 教学动画 | 交互式教学动画生成 | 数学公式可视化、物理实验模拟等 |
| 互动练习 | 游戏化练习生成 | 贪吃蛇、消消乐等趣味单词/知识点练习 |
| 教案生成 | 智能教案辅助 | AI根据课程内容生成结构化教案 |
| AI命题 | 智能出题 | 根据知识点自动生成各类题型 |
| 作文批改 | AI作文评分与批注 | 多维度作文分析与改进建议 |
| 课堂工具 | 实时课堂互动 | 白板、倒计时、答题器、连线等 |
| 资源库 | 教学资源共享 | 课件、动画、教案等资源管理 |
| 教师社区 | 同行交流 | 资源分享、经验交流社区 |

## 技术栈

### 后端
- **框架**: Python 3.11 + FastAPI
- **数据库**: SQLite (开发) / PostgreSQL (生产)
- **ORM**: SQLAlchemy 2.0 + Alembic
- **缓存**: Redis
- **AI**: OpenAI API 兼容接口
- **任务队列**: Celery + Redis

### 前端
- **框架**: Vue 3 + TypeScript + Vite
- **UI库**: Element Plus
- **状态管理**: Pinia
- **图表**: ECharts
- **动画**: Lottie + Canvas
- **编辑器**: TinyMCE / WangEditor

### 部署
- **容器化**: Docker + Docker Compose
- **Web服务器**: Nginx
- **CI/CD**: GitHub Actions

## 项目结构

```
jiaoyu/
├── README.md
├── docs/                           # 项目文档
│   ├── architecture.md             # 架构设计
│   └── api.md                      # API文档
├── backend/                        # 后端服务
│   ├── requirements.txt
│   ├── main.py                     # 应用入口
│   ├── config.py                   # 配置管理
│   ├── database.py                 # 数据库连接
│   ├── models/                     # SQLAlchemy模型
│   ├── schemas/                    # Pydantic模型
│   ├── routers/                    # API路由
│   ├── services/                   # 业务逻辑
│   └── utils/                      # 工具函数
├── frontend/                       # 前端应用
│   ├── package.json
│   ├── vite.config.ts
│   ├── index.html
│   └── src/
│       ├── main.ts
│       ├── App.vue
│       ├── router/
│       ├── stores/
│       ├── api/
│       ├── views/
│       ├── components/
│       ├── styles/
│       └── utils/
└── docker-compose.yml
```

## 快速开始

### 后端启动

```bash
cd backend
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env      # 编辑配置
python main.py
```

后端运行在 http://localhost:8000，API文档 http://localhost:8000/docs

### 前端启动

```bash
cd frontend
npm install
npm run dev
```

前端运行在 http://localhost:5173

### Docker 部署

```bash
docker-compose up -d
```

## 环境变量

| 变量名 | 说明 | 默认值 |
|--------|------|--------|
| DATABASE_URL | 数据库连接字符串 | sqlite:///./jiaoyu.db |
| REDIS_URL | Redis连接 | redis://localhost:6379 |
| AI_API_KEY | AI服务API密钥 | - |
| AI_API_BASE | AI服务基础URL | https://api.openai.com/v1 |
| AI_MODEL | 默认AI模型 | gpt-4o |
| SECRET_KEY | JWT密钥 | - |
| CORS_ORIGINS | 允许的跨域来源 | http://localhost:5173 |