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
3.6 KiB
3.6 KiB
智教助手
面向教师 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
快速开始
后端启动
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
前端启动
cd frontend
npm install
npm run dev
前端运行在 http://localhost:5173
Docker 部署
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 |