# classroom_manager

**Repository Path**: excelsiorly/classroom_manager

## Basic Information

- **Project Name**: classroom_manager
- **Description**: 信息科技课纪律管理系统
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-29
- **Last Updated**: 2025-09-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🏆 机房纪律管理系统

## 项目简介

机房纪律管理系统是一个基于Web的课堂纪律管理工具，专门为中小学初中计算机教室环境设计（有时候确实很难管好纪律）。系统通过量化评分机制，结合教育心理学原理，有效管理学生课堂行为，促进良好学习习惯的养成。

![alt text](image.png)

## ✨ 核心特色

### 🎯 教育理念驱动
- **正向激励**：强化良好行为，培养内在学习动机
- **分级管理**：根据行为严重程度采取差异化处理
- **成长导向**：关注学生进步，而非单纯惩罚
- **自我调节**：通过可视化反馈促进学生自我管理

### ⚡ 技术特色
- **实时反馈**：即时记录和显示行为评分变化
- **数据可视化**：直观的进度条和状态指示器
- **多维度评价**：从纪律、协作、创新等多个角度评估
- **持久化存储**：数据自动保存，支持多设备访问

## 🚀 主要功能

### 课堂纪律管理
- **快速记录**：一键记录学生课堂行为表现
- **分级评价**：轻微违纪(-1) → 私自游戏(-2) → 严重违纪(-3)
- **正向激励**：良好表现(+1) → 优秀表现(+2) → 突出贡献(+3)
- **实时反馈**：分数变化立即反映在界面中

### 上课计时控制
- **灵活课时**：支持10-60分钟课程时长设置
- **自动监测**：系统自动跟踪课堂纪律状况
- **全勤奖励**：连续4节课无违纪自动奖励3分
- **协作表现**：整节课无违纪自动奖励2分

### 奖励与惩罚系统
- **自由探索时间**：根据分数等级获得5-15分钟自由上机时间
- **分级惩罚**：警告通知 → 暂停1节课 → 暂停2节课 → 暂停3节课
- **手动核销**：教师可灵活使用奖励时间或执行惩罚
- **自动重置**：奖励/惩罚使用完毕后分数自动重置

### 数据管理
- **班级管理**：支持多个班级的独立管理
- **历史记录**：详细记录所有评分变动和核销操作
- **数据备份**：支持数据的导入导出，防止数据丢失
- **统计分析**：可视化展示班级纪律趋势

## 🎓 教育理论基础

### 行为评价标准

#### 违纪行为
- **轻微违纪(-1分)**：随意走动、小声交谈、注意力分散、设备轻微违规
- **私自游戏(-2分)**：玩游戏、浏览无关内容、使用社交软件、逃避任务
- **严重违纪(-3分)**：顶撞教师、恶意破坏、大声喧哗、欺负同学、作弊行为

#### 正向行为
- **良好表现(+1分)**：积极回答、帮助同学、遵守纪律、任务完成、设备整洁
- **优秀表现(+2分)**：创造性思维、主动探究、协作精神、技术应用、知识分享
- **突出贡献(+3分)**：示范引领、问题解决、组织协调、创新应用、助教行为

### 评分规则
- **初始分数**：40分
- **分数范围**：0-100分
- **特权冻结**：低于30分暂停自由探索特权

## 🛠 技术架构

### 前端技术
- **HTML5**：语义化结构，响应式布局
- **CSS3**：渐变背景、网格布局、动画效果
- **JavaScript**：原生JS，异步数据交互
- **Web Workers**：后台计时，保证计时准确性

### 后端技术
- **Python Flask**：轻量级Web框架
- **JSON数据存储**：无需数据库，简单易部署
- **RESTful API**：前后端分离架构

### 部署要求
- Python 3.6+
- 现代浏览器支持（Chrome、Firefox、Edge等）
- 网络环境：支持本地网络访问

## 📦 安装与部署

### 环境准备
```bash
# 确保已安装Python 3.6+
python --version

# 安装Flask（如尚未安装）
pip install flask
```

### 启动服务
```bash
# 克隆或下载项目文件
git clone https://gitee.com/excelsiorly/classroom_manager.git

# 进入项目目录
cd classroom-manager

# 启动Flask服务
python app.py

# 服务将在 http://localhost:9898 启动
```

### 访问系统
1. 打开浏览器，访问 `http://localhost:9898`
2. 系统将自动创建必要的数据文件
3. 开始添加班级和管理课堂纪律

## 📖 使用指南

### 首次使用
1. **添加班级**：在"班级管理"页面创建新班级
2. **设置阈值**：调整特权冻结阈值（默认30分）
3. **开始上课**：选择班级，设置时长，开始计时

### 日常操作
1. **记录行为**：使用快速记录按钮或自定义记录
2. **监控状态**：实时查看班级纪律状态和进度
3. **执行核销**：在奖励与惩罚面板使用自由时间或执行停课
4. **查看历史**：在历史记录页面查看详细操作日志

### 数据维护
- **定期备份**：使用数据导出功能备份重要数据
- **数据恢复**：通过导入功能恢复备份数据
- **班级管理**：可随时添加、删除或修改班级信息

## 🎨 界面说明

### 主要界面区域
- **课堂记录**：核心操作区，包含计时器和快速记录
- **班级管理**：班级的增删改查管理
- **历史记录**：详细的操作历史查看和筛选
- **数据管理**：数据备份、恢复和系统信息

### 状态指示器
- **颜色编码**：红色(危险) → 橙色(警告) → 绿色(安全)
- **进度条**：直观显示当前分数在惩罚和奖励区间的位置
- **星级评价**：5星制直观反映班级整体表现
- **考勤点**：显示最近4次课的纪律状况

## 🔧 自定义配置

### 阈值调整
- **特权冻结阈值**：可调整触发特权冻结的分数阈值
- **课程时长**：支持10-60分钟灵活设置
- **奖励时间**：系统自动根据分数区间计算

### 规则定制
通过修改后端代码可以自定义：
- 评分规则和分值
- 奖励和惩罚的具体内容
- 自动奖励的条件和分值

## 📊 数据文件说明

系统使用以下JSON文件存储数据：
- `classes.json`：班级基本信息和当前分数
- `history.json`：所有操作的历史记录
- `active_class.json`：当前活跃课程信息

## 🤝 贡献指南

欢迎提交Issue和Pull Request来改进这个项目：
1. Fork本项目
2. 创建特性分支
3. 提交更改
4. 推送到分支
5. 创建Pull Request

## 📄 许可证

本项目采用MIT许可证，详情请查看LICENSE文件。

## 🆘 常见问题

### Q: 数据丢失了怎么办？
A: 定期使用数据导出功能备份，可通过导入功能恢复。

### Q: 多个老师能同时使用吗？
A: 可以，但建议在不同时间段使用，或部署多个实例。

### Q: 支持移动设备吗？
A: 支持，系统采用响应式设计，可在手机和平板上使用。

### Q: 如何修改评价标准？
A: 需要修改前端JavaScript和后端Python代码中的相关规则。

### Q: 想要赞赏作者？
A: 谢谢老板👇

![img](thank-u-boss.jpg)
---

**开发团队**：just me
**版本**：v1.0  
**最后更新**：2025年9月