学生自助分组系统

这是一个基于 B/S 架构的本地/校园网分组系统。项目使用 Python 标准库实现，不需要安装第三方依赖；数据库为 SQLite，学生名单来源为 2025mt.xlsx。

功能

• 学生用学号登录，首次登录密码也是学号，并强制修改密码。
• 学生登录后显示姓名、学号和登录状态。
• 学生可创建组并自动成为组长；其他学生可选择加入。
• 每组最多 6 人，包括组长。
• 已加入其他组的学生不能创建新组；组长加入新组时，需确认解散原组；普通成员切换组时需确认退出原组。
• 学生端和教师端都能直接看到全部组及成员的学号、姓名，无需点开详情。
• 教师可切换“当前开放登录班级”，未开放班级不能登录。
• 教师可停止/恢复学生分组操作。
• 教师可在“学生账号”页签中修改指定学生的登录密码；修改后该学生已有会话会退出。
• 停止后学生只能查看；教师仍可手工建组、改名、设组长、加入、移出、解散。
• 教师可导出当前班分组为 .xlsx。

启动

在本目录执行：

python3 app.py

默认访问地址：

• 学生端：http://127.0.0.1:8000/
• 教师端：http://127.0.0.1:8000/teacher

如果学生要从其他电脑/手机访问，请把 127.0.0.1 换成老师电脑的局域网 IP，例如：

http://192.168.1.20:8000/

可自定义端口和数据库：

PORT=8000 GROUP_DB=selfgroup.db python3 app.py

教师账号

默认账号：

账号：teacher
密码：teacher123

正式使用前建议改用环境变量设置：

TEACHER_USER=yourname TEACHER_PASSWORD=your-strong-password python3 app.py

注意：教师密码只在首次创建数据库时写入。如果数据库已存在，修改环境变量后还需要删除旧数据库或直接更新数据库中 settings 表的 teacher_password。

学生名单

服务第一次启动时，如果没有数据库，会自动读取当前目录的 2025mt.xlsx。表格至少需要以下表头：

班级    学号    姓名

也兼容读取：性别、录取编号、备注。

如果换了名单，可以在教师后台上传新的 .xlsx。导入会重建学生账号并解散全部已有分组。

数据文件

• selfgroup.db：学生、密码、分组、班级状态和登录会话。
• 2025mt.xlsx：首次启动导入的原始名单。

代码结构

服务端按职责拆分在 group_system/ 包中：

app.py                       启动入口，保留 python3 app.py 的用法
group_system/config.py       路径、端口、账号和业务默认值
group_system/security.py     PBKDF2 密码散列与校验
group_system/storage/        SQLite 连接、名单导入、账号、分组、管理、导出
group_system/http/           API 适配、静态文件路由和 HTTP 服务器
group_system/xlsx_io.py      无第三方依赖的 XLSX 读取/生成

前端仍在 static/ 目录中，接口协议保持不变。

建议部署方式

1. 在教师电脑上运行 python3 app.py。
2. 查看教师电脑局域网 IP。
3. 将学生端网址发到班级群。
4. 教师打开 /teacher，切换到要分组的班级。
5. 分组完成后点击“停止学生操作”。
6. 检查并手工调整分组，然后导出 Excel。

注意

• 学生密码使用 PBKDF2 加盐哈希保存，不以明文保存。
• 系统适合局域网使用；如果在公网部署，请使用 HTTPS 反向代理，并务必修改教师默认密码。
• SQLite 适合班级规模的小型并发使用，不建议多名教师同时频繁写数据库。