Zhang Jing Xuan
0841b1a103
- 前端：Vue3 + TS + Element Plus，24 个页面路由（课件/组题/教案/动画/思维导图/作文批改/命题/课堂/资源/社区等） - 后端：FastAPI + SQLAlchemy + SQLite，17 个路由模块，AI 服务层含降级模板 - AI：glm-5.x 推理模型已禁用思维链，确保输出真实内容 - 修复：ai_service 两处请求体注入 enable_thinking/thinking disabled - 测试账号：13900999999 / test1234
119 lines
3.6 KiB
Markdown
119 lines
3.6 KiB
Markdown
# 智教助手
|
||
|
||
面向教师 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 |
|