智习通 - 在线学习与教学管理平台

一款面向教育场景的在线学习与教学管理平台，专为教师和学生打造双向互动的教学环境。

功能特性

教师端功能

• ✅ 课程管理：创建和管理课程，上传课程资料
• ✅ 题目管理：支持多种题型（单选题、多选题、填空题、主观题），可设置知识点和难度
• ✅ 练习发布：创建练习并发布给学生，支持设置截止时间
• ✅ 数据统计：实时查看学生答题数据、错题分布及学习进度分析
• ✅ 可视化看板：通过图表直观展示学生学习情况

学生端功能

• ✅ 练习答题：接收教师发布的练习题，在线答题
• ✅ 错题本：系统自动识别错题并记录到错题本
• ✅ 智能推荐：基于错题类型，从题库中自动推送相似题目进行强化训练
• ✅ 学习进度：查看个人学习数据，包括正确率、知识点掌握情况等
• ✅ 数据可视化：通过图表了解学习薄弱环节

技术栈

后端

• 框架：FastAPI
• 数据库：SQLite（开发环境）
• ORM：SQLAlchemy
• 认证：JWT (JSON Web Token)
• 密码加密：bcrypt

前端

• 框架：React 18 + TypeScript
• 构建工具：Vite
• UI组件库：Ant Design
• 路由：React Router
• 图表库：Recharts
• HTTP客户端：Axios

项目结构

智习通/
├── backend/                 # 后端代码
│   ├── main.py              # FastAPI应用入口
│   ├── database.py          # 数据库配置
│   ├── models.py            # 数据模型
│   ├── schemas.py           # Pydantic模式
│   ├── auth.py              # 认证相关
│   ├── services.py          # 业务逻辑
│   └── requirements.txt     # Python依赖
├── frontend/                # 前端代码
│   ├── src/
│   │   ├── pages/           # 页面组件
│   │   │   ├── teacher/     # 教师端页面
│   │   │   └── student/     # 学生端页面
│   │   ├── components/      # 通用组件
│   │   ├── contexts/        # React Context
│   │   ├── services/        # API服务
│   │   └── types/           # TypeScript类型定义
│   ├── package.json
│   └── vite.config.ts
└── README.md

快速开始

环境要求

• Python 3.8+
• Node.js 16+
• npm 或 yarn

后端启动

1. 进入后端目录

cd backend

2. 安装依赖

pip install -r requirements.txt

3. 启动服务

python main.py

后端服务将在 http://localhost:8000 启动

前端启动

1. 进入前端目录

cd frontend

2. 安装依赖

npm install

3. 启动开发服务器

npm run dev

前端应用将在 http://localhost:5173 启动

API文档

启动后端服务后，可以访问以下地址查看API文档：

• Swagger UI: http://localhost:8000/docs
• ReDoc: http://localhost:8000/redoc

使用说明

教师端使用流程

1. 注册/登录：使用教师身份注册账号并登录
2. 创建课程：在"课程管理"中创建新课程
3. 添加题目：在"题目管理"中创建题目，支持多种题型
4. 发布练习：在"练习管理"中创建练习并选择题目，发布给学生
5. 查看统计：在"数据统计"中查看学生答题情况和错题分布

学生端使用流程

1. 注册/登录：使用学生身份注册账号并登录
2. 完成练习：在"我的练习"中查看并完成教师发布的练习
3. 查看错题：在"错题本"中查看所有错题
4. 强化训练：点击"获取相似题目"获取系统推荐的相似题目进行练习
5. 查看进度：在"学习进度"中查看个人学习数据和分析

核心功能实现

错题识别

系统在学生提交答案后自动判断答案正确性，并将错题记录到错题本中。

相似题推荐算法

基于以下维度推荐相似题目：

• 相同知识点
• 相同或相近难度（±1级）
• 排除已做错的题目
• 优先推荐未掌握的题目

数据可视化

• 学生答题情况柱状图
• 错题分布饼图
• 知识点正确率分析
• 学习进度统计

开发计划

• 支持文件上传（题目图片、资料等）
• 主观题人工评分功能
• 课程加入/退出功能
• 消息通知系统
• 移动端适配
• 更智能的推荐算法（基于机器学习）

许可证

MIT License

贡献

欢迎提交 Issue 和 Pull Request！