106 lines
3.5 KiB
Markdown
106 lines
3.5 KiB
Markdown
# 学生自助分组系统
|
||
|
||
这是一个基于 B/S 架构的本地/校园网分组系统。项目使用 Python 标准库实现，不需要安装第三方依赖；数据库为 SQLite，学生名单来源为 `2025mt.xlsx`。
|
||
|
||
## 功能
|
||
|
||
- 学生用学号登录，首次登录密码也是学号，并强制修改密码。
|
||
- 学生登录后显示姓名、学号和登录状态。
|
||
- 学生可创建组并自动成为组长；其他学生可选择加入。
|
||
- 每组最多 6 人，包括组长。
|
||
- 已加入其他组的学生不能创建新组；组长加入新组时，需确认解散原组；普通成员切换组时需确认退出原组。
|
||
- 学生端和教师端都能直接看到全部组及成员的学号、姓名，无需点开详情。
|
||
- 教师可切换“当前开放登录班级”，未开放班级不能登录。
|
||
- 教师可停止/恢复学生分组操作。
|
||
- 停止后学生只能查看；教师仍可手工建组、改名、设组长、加入、移出、解散。
|
||
- 教师可导出当前班分组为 `.xlsx`。
|
||
|
||
## 启动
|
||
|
||
在本目录执行：
|
||
|
||
```bash
|
||
python3 app.py
|
||
```
|
||
|
||
默认访问地址：
|
||
|
||
- 学生端：<http://127.0.0.1:8000/>
|
||
- 教师端：<http://127.0.0.1:8000/teacher>
|
||
|
||
如果学生要从其他电脑/手机访问，请把 `127.0.0.1` 换成老师电脑的局域网 IP，例如：
|
||
|
||
```text
|
||
http://192.168.1.20:8000/
|
||
```
|
||
|
||
可自定义端口和数据库：
|
||
|
||
```bash
|
||
PORT=8000 GROUP_DB=selfgroup.db python3 app.py
|
||
```
|
||
|
||
## 教师账号
|
||
|
||
默认账号：
|
||
|
||
```text
|
||
账号：teacher
|
||
密码：teacher123
|
||
```
|
||
|
||
正式使用前建议改用环境变量设置：
|
||
|
||
```bash
|
||
TEACHER_USER=yourname TEACHER_PASSWORD=your-strong-password python3 app.py
|
||
```
|
||
|
||
注意：教师密码只在首次创建数据库时写入。如果数据库已存在，修改环境变量后还需要删除旧数据库或直接更新数据库中 `settings` 表的 `teacher_password`。
|
||
|
||
## 学生名单
|
||
|
||
服务第一次启动时，如果没有数据库，会自动读取当前目录的 `2025mt.xlsx`。表格至少需要以下表头：
|
||
|
||
```text
|
||
班级 学号 姓名
|
||
```
|
||
|
||
也兼容读取：性别、录取编号、备注。
|
||
|
||
如果换了名单，可以在教师后台上传新的 `.xlsx`。导入会重建学生账号并解散全部已有分组。
|
||
|
||
## 数据文件
|
||
|
||
- `selfgroup.db`：学生、密码、分组、班级状态和登录会话。
|
||
- `2025mt.xlsx`：首次启动导入的原始名单。
|
||
|
||
## 代码结构
|
||
|
||
服务端按职责拆分在 `group_system/` 包中：
|
||
|
||
```text
|
||
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 适合班级规模的小型并发使用，不建议多名教师同时频繁写数据库。
|