rewrited logic structure

README.md

@@ -74,6 +74,21 @@ TEACHER_USER=yourname TEACHER_PASSWORD=your-strong-password python3 app.py
 - `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`。