智教助手平台:完整初始化
- 前端:Vue3 + TS + Element Plus,24 个页面路由(课件/组题/教案/动画/思维导图/作文批改/命题/课堂/资源/社区等) - 后端:FastAPI + SQLAlchemy + SQLite,17 个路由模块,AI 服务层含降级模板 - AI:glm-5.x 推理模型已禁用思维链,确保输出真实内容 - 修复:ai_service 两处请求体注入 enable_thinking/thinking disabled - 测试账号:13900999999 / test1234
This commit is contained in:
@@ -0,0 +1,118 @@
|
||||
# 智教助手
|
||||
|
||||
面向教师 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 |
|
||||
Reference in New Issue
Block a user