# class-management

**Repository Path**: T_cold/class-management

## Basic Information

- **Project Name**: class-management
- **Description**: 测试中测试中测试中测试中测试中
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-01-24
- **Last Updated**: 2025-01-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

本项目是借助Cursor开发的适用于信息科技教学的一款课堂管理系统。

运行run.py即可开启服务。


学生端登录后，教师端可以看到登录的学生情况。教师点击发布选择题。可以一次性发布多个题目供学生回答。学生端收到带有4个选项的若干题目。提交后，教师端可以查看所有学生的选项。教师通过设置正确答案，可以对学生的答题情况进行判断。正确为绿色，错误为红色。


![输入图片说明](app/QQ20250124-145100.png)


### 下一步需要完善的工作：
- 学生的答题情况，以图表化展示。教师可以更清晰的看到学生答题情况。
- 虽然用了数据库，但是无法持久化。学生每节课的答题情况还没法统计。
- 以教师名作为课堂标识，对课堂进行隔离，当前的版本无法实现多名教师开课。


项目根目录/
├── app/                  # 主应用目录
│   ├── __init__.py
│   ├── main.py          # FastAPI主程序
│   ├── models.py        # 数据库模型
│   └── database.py      # 数据库配置
├── static/              # 静态文件目录
├── migrations.py        # 数据库迁移脚本
├── requirements.txt     # 项目依赖
└── run.py              # 启动脚本

## 数据库设计

### 主要数据表
- students: 学生信息
- scores: 评分记录
- questions: 题目信息
- student_answers: 答题记录
- class_sessions: 课程会话

## API 接口

### 评分相关
- POST /api/scores - 提交评分
- GET /api/scores/latest - 获取最新评分
- GET /api/scores/history/{group_id} - 获取历史评分

### 学生相关
- POST /api/students - 创建学生
- GET /api/students/count - 获取学生数量
- GET /api/students/{group_id} - 获取小组成员
- DELETE /api/students/{group_id}/{student_name} - 删除学生

### 题目相关
- POST /api/questions - 创建题目
- GET /api/questions/active - 获取当前活动题目
- POST /api/questions/batch - 批量创建题目
- PUT /api/questions/{question_id}/correct-answer - 设置正确答案

## 使用说明

### 教师使用流程
1. 访问教师入口
2. 创建课堂题目
3. 查看学生答题情况
4. 设置正确答案
5. 对小组进行评分

### 学生使用流程
1. 访问学生入口
2. 选择/创建小组
3. 参与实时答题
4. 进行小组自评
5. 查看答题结果

## 开发计划

### 待实现功能
- [ ] 用户认证系统
- [ ] WebSocket实时通信
- [ ] 数据分析dashboard
- [ ] 更多题型支持
- [ ] 移动端适配

### 技术优化
- [ ] 前端框架重构
- [ ] 数据库性能优化
- [ ] 缓存系统
- [ ] 单元测试覆盖

## 贡献指南

欢迎提交 Issue 和 Pull Request。

## 许可证

[MIT License](LICENSE)

## 联系方式
284516189@qq.com