更新文档

README.md

@@ -9,12 +9,14 @@
 - 查看个人加减分历史明细（时间、分数变化、原因、操作人）
 - 查看个人作业提交情况
 - 查看个人考勤记录
+- 查看历史学期归档数据（操行分、考勤统计、作业统计）
 - 修改个人登录密码（首次登录强制修改）
 
 ### 家长端
 - 查询子女当前操行总分和班级排名
 - 查看子女操行分历史记录（加分/减分明细）
 - 查看子女考勤记录
+- 默认仅显示当前学期数据
 
 ### 管理端
 
@@ -25,6 +27,8 @@
 - 考勤管理：查看全班考勤记录、自定义考勤扣分值
 - 科目管理：动态增删学科
 - 管理员管理：添加/编辑/删除/重置密码班长/科代表/考勤委员/劳动委员/志愿委员
+- 学期管理：创建/编辑/删除学期、激活学期、归档学期（含考勤/作业统计快照）、关联历史记录、归档后可选重置分数
+- 排行榜百分比筛选：在排行榜上方输入百分比，筛选显示前N%的学生（抹零法）
 - 数据导出：导出历史记录、导出德育分记录（含加分/减分历史）
 
 **班长权限：**
@@ -88,6 +92,7 @@ classmanager/
 │   │   ├── conduct.py                # 操行分模型
 │   │   ├── homework.py               # 作业模型
 │   │   ├── log.py                    # 日志模型
+│   │   ├── semester.py              # 学期模型
 │   │   ├── student.py                # 学生模型
 │   │   ├── subject.py                # 科目模型
 │   │   └── user.py                   # 用户模型
@@ -98,6 +103,7 @@ classmanager/
 │   │   ├── auth.py                   # 认证接口
 │   │   ├── debug.py                  # 调试入口
 │   │   ├── parent.py                 # 家长端接口
+│   │   ├── semester.py              # 学期管理接口
 │   │   ├── student.py                # 学生端接口
 │   │   └── subject.py                # 科目管理接口
 │   │
@@ -108,6 +114,7 @@ classmanager/
 │   │   ├── common.py
 │   │   ├── conduct.py
 │   │   ├── parent.py
+│   │   ├── semester.py              # 学期请求模型
 │   │   ├── student.py
 │   │   └── subject.py
 │   │
@@ -120,6 +127,7 @@ classmanager/
 │   │   ├── homework_service.py
 │   │   ├── log_service.py
 │   │   ├── parent_service.py
+│   │   ├── semester_service.py      # 学期服务
 │   │   ├── student_service.py
 │   │   └── subject_service.py
 │   │
@@ -146,6 +154,7 @@ classmanager/
 │   │   ├── history.php               # 历史记录
 │   │   ├── homework.php              # 作业管理
 │   │   ├── password.php              # 修改密码
+│   │   ├── semesters.php            # 学期管理
 │   │   ├── students.php              # 学生管理
 │   │   └── subjects.php              # 科目管理
 │   │
@@ -166,7 +175,8 @@ classmanager/
 │   │
 │   ├── includes/                     # 公共包含文件
 │   │   ├── footer.php                # 公共底部
-│   │   └── header.php                # 公共头部
+│   │   ├── header.php                # 公共头部
+│   │   └── nav.php                  # 导航栏
 │   │
 │   ├── parent/                       # 家长端
 │   │   ├── attendance.php            # 考勤记录
@@ -178,7 +188,8 @@ classmanager/
 │       ├── conduct.php               # 操行分详情
 │       ├── dashboard.php             # 学生端首页
 │       ├── homework.php              # 作业情况
-│       └── password.php              # 修改密码
+│       ├── password.php              # 修改密码
+│       └── semester_history.php     # 学期记录
 │
 ├── sql/                              # 数据库脚本
 │   └── init.sql                      # 初始化表结构
@@ -207,7 +218,7 @@ classmanager/
 |------|-----------|-----------|---------|-------------|---------|
 | 班主任 | 全班 | 无限制 | 可撤销任何记录 | 全班所有记录 | 学生/管理员/科目管理、数据导出 |
 | 班长 | 全班 | ±5分 | 可撤销任何记录 | 全班所有记录 | - |
-| 学习委员 | 全班 | 仅扣分（按规则） | 不可撤销 | 仅自己提交的 | 作业管理、科目管理 |
+| 学习委员 | 全班 | ±5分以内（加减分） | 不可撤销 | 仅自己提交的 | 作业管理、科目管理 |
 | 考勤委员 | 全班 | 仅扣分（按规则） | 不可撤销 | 仅自己提交的 | 考勤管理 |
 | 劳动委员 | 全班 | 仅±1分（卫生值日） | 不可撤销 | 仅自己提交的 | - |
 | 志愿委员 | 全班 | 仅加分 | 不可撤销 | 仅自己提交的 | - |
@@ -243,7 +254,7 @@ classmanager/
 |------|---------|------|
 | v1.0 | 2026.4.19 | 初始版本发布，包含基础功能 |
 | v1.1 | 2026.4.20 | 更新家长端查看加减分记录功能 |
-| v1.2 | 2026.4.22 | 新增学期功能 |
+| v1.2 | 2026.4.22 | 学期管理（创建/编辑/归档/补录关联/归档重置）、env加减分上限、排行榜百分比筛选、学习委员加减分、撤销操作日志、调试入口开关 |
 
 ## 许可证