智教助手

面向教师 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