更新文档

docs/cadre.md

@@ -16,7 +16,7 @@
 | 角色 | 操行分管理 | 历史记录 | 作业管理 | 考勤管理 | 科目管理 |
 |------|-----------|---------|---------|---------|---------|
 | 班长 | ±5分以内 | 全部（可撤销） | - | - | - |
-| 学习委员 | - | 自己的 | ✓ | - | ✓ |
+| 学习委员 | ±5分以内 | 自己的 | ✓ | - | ✓ |
 | 考勤委员 | - | 自己的 | - | ✓ | - |
 | 劳动委员 | ±1分（卫生值日） | 自己的 | - | - | - |
 | 志愿委员 | 仅加分 | 自己的 | - | - | - |
@@ -49,8 +49,6 @@
 
 #### 作业管理 (homework.php)
 
-本模块用于管理学生作业缺交情况。
-
 **批量扣分**：
 1. 在学生列表中勾选目标学生
 2. 点击"批量加减分"按钮
@@ -64,6 +62,16 @@
 
 > 扣分限制：每次加减分不超过3分。
 
+#### 操行分管理 (conduct.php)
+
+**加减分操作**：
+1. 在学生列表中勾选目标学生
+2. 点击"批量加减分"按钮
+3. 填写分数变动（±5分以内）和原因
+4. 点击"确认提交"
+
+> 加减分限制：每次操作不超过±5分（上限可在系统环境变量中配置）。
+
 #### 科目管理 (subjects.php)
 
 - 查看科目列表

docs/guide/cadre.md

@@ -11,7 +11,7 @@
 | 角色 | 操行分管理 | 历史记录 | 作业管理 | 考勤管理 | 科目管理 |
 |------|-----------|---------|---------|---------|---------|
 | 班长 | ±5分以内 | 全部（可撤销） | - | - | - |
-| 学习委员 | - | 自己的 | ✓ | - | ✓ |
+| 学习委员 | ±5分以内 | 自己的 | ✓ | - | ✓ |
 | 考勤委员 | - | 自己的 | - | ✓ | - |
 | 劳动委员 | ±1分（卫生值日） | 自己的 | - | - | - |
 | 志愿委员 | 仅加分 | 自己的 | - | - | - |
@@ -24,6 +24,7 @@
 
 ### 学习委员
 - **作业扣分**：勾选学生 → 批量加减分 → 选择未交/迟交/自定义 → 填写原因
+- **加减分**：勾选学生 → 批量加减分 → 填写分值（±5分以内）和原因
 - **科目管理**：添加/编辑/删除科目
 
 ### 考勤委员

docs/guide/parent.md

@@ -12,6 +12,8 @@
 | 历史记录 | 查看子女加减分明细（时间、类型、原因、分值、记录人），支持分页 |
 | 考勤记录 | 查看子女考勤记录（出勤/缺勤/迟到/请假统计 + 明细列表） |
 
+> 家长端默认仅显示当前学期数据。
+
 ## 常见问题
 
 - **忘记密码**：联系班主任重置。

docs/guide/student.md

@@ -14,6 +14,7 @@
 | 操行分详情 | 查看完整加减分历史（时间、分值、原因、操作人） |
 | 作业情况 | 查看缺交作业记录（科目、状态、备注） |
 | 考勤记录 | 查看个人考勤记录（按月） |
+| 学期记录 | 查看历史学期归档数据（操行分排名、考勤统计、作业统计） |
 | 修改密码 | 修改登录密码 |
 
 ## 常见问题

docs/guide/teacher.md

@@ -20,6 +20,7 @@
 | 学生管理 | 新增/编辑/删除/批量导入学生 |
 | 科目管理 | 增删改科目 |
 | 管理员管理 | 添加/编辑/删除/重置密码班干部账号 |
+| 学期管理 | 创建/编辑/删除/归档学期、关联历史记录、归档重置分数 |
 | 修改密码 | 修改登录密码 |
 
 ## 常用操作
@@ -31,6 +32,8 @@
 - **导入学生**：学生管理页 → 导入学生（JSON格式，需包含 `student_no` 和 `name`）
 - **添加班干部**：管理员管理页 → 添加管理员 → 填写账号信息和角色
 - **重置班干部密码**：管理员管理页 → 重置密码 → 输入新密码
+- **学期管理**：学期管理页 → 创建学期（可快捷填充日期）→ 关联历史数据 → 归档（可选重置分数）
+- **排行榜筛选**：首页 → 输入百分比 → 点击筛选（抹零法，如15%显示前15%的学生）
 
 ## 常见问题
 

docs/parent.md

@@ -49,6 +49,8 @@
   - 考勤状态（正常/迟到/缺勤/请假）
   - 备注（如有）
 
+> 家长端默认仅显示当前学期的数据。历史学期归档数据请在管理端或学生端查看。
+
 ---
 
 ## 导航栏说明

docs/student.md

@@ -58,7 +58,18 @@
   - 考勤状态（正常/迟到/缺勤/请假）
   - 备注（如有）
 
-### 5. 修改密码
+### 5. 学期记录
+
+查看历史学期的归档数据：
+
+- 显示所有已归档学期的列表
+- 每个学期显示：
+ - 学期名称、日期范围
+ - 最终操行分和排名
+ - 考勤统计（出勤/缺勤/迟到/请假次数）
+ - 作业统计（已交/未交/迟交数量）
+
+### 6. 修改密码
 
 - 输入原密码和新密码
 - 新密码需符合密码强度要求
@@ -74,6 +85,7 @@
 | 操行分详情 | 完整加减分历史 |
 | 作业情况 | 作业缺交记录 |
 | 考勤记录 | 考勤记录明细 |
+| 学期记录 | 查看历史学期归档数据（操行分、考勤、作业统计） |
 | 修改密码 | 修改登录密码 |
 
 ---

docs/teacher.md

@@ -24,7 +24,7 @@
   - 操行分管理
   - 导入学生
   - 导出德育分记录
-- **操行分排行榜**：展示前100名学生的排名、学号、姓名和操行分
+- **操行分排行榜**：展示前100名学生的排名、学号、姓名和操行分。排行榜上方提供百分比筛选框，可输入1-100的数字筛选显示前N%的学生（抹零法：如49人×15%=7.35，显示前7人）。
 
 ---
 
@@ -189,7 +189,59 @@
 
 ---
 
-### 9. 修改密码 (password.php)
+### 9. 学期管理 (semesters.php)
+
+#### 创建学期
+1. 点击"创建新学期"按钮
+2. 填写学期名称（如"2025秋季学期"）
+3. 可使用快捷按钮自动填充日期：
+   - **上学期**：9月1日 - 次年2月末（自动处理闰年）
+   - **下学期**：3月1日 - 7月15日
+4. 结束日期为可选，不确定可不填
+5. 点击"创建学期"
+6. 系统自动根据日期判断是否为当前活跃学期
+
+> 创建学期的日期范围包含今天时，自动设为当前活跃学期；否则（如补录上学期）不会自动激活。
+
+#### 编辑学期
+1. 在学期列表中点击"编辑"按钮
+2. 修改学期名称或日期
+3. 点击"保存修改"
+4. 已归档的学期不可编辑
+
+#### 删除学期
+1. 在编辑模态框中点击"删除学期"按钮
+2. 确认删除操作
+3. 已有归档数据的学期不可删除
+
+#### 激活学期
+- 点击"激活"按钮将学期设为当前活跃学期
+- 当前活跃学期标记为"当前学期"（绿色标签）
+
+#### 关联历史数据
+1. 点击"关联数据"按钮
+2. 系统将自动把该学期日期范围内未分配学期的操行分记录和考勤记录关联到该学期
+3. 关联完成后显示关联的记录数量
+
+> 用于补录上学期数据：创建上学期的学期记录后，通过"关联数据"将已有的历史记录关联到该学期。
+
+#### 归档学期
+1. 点击"归档"按钮
+2. 确认归档操作：
+   - 系统将保存所有学生的操行分快照、考勤统计和作业统计
+   - 可选勾选"归档后重置所有学生操行分为初始值（60分）"
+3. 点击"确认归档"
+4. 归档成功后该学期变为只读
+
+> **归档说明**：归档仅创建数据快照，不会删除或修改任何原始数据。如勾选重置，归档完成后将所有学生操行分恢复为初始值，所有历史记录和操作日志完整保留。
+
+#### 查看归档数据
+- 已归档学期显示"查看归档"按钮
+- 展示归档时的学生排名、操行分、考勤统计、作业统计
+
+---
+
+### 10. 修改密码 (password.php)
 
 - 输入原密码和新密码
 - 新密码需符合密码强度要求