# 班主任使用文档

## 登录

1. 打开系统网址，进入登录页面
2. 输入**用户名**和**密码**
3. 点击"登录"按钮
4. 首次登录系统会强制要求修改密码

> **密码要求**：长度6-20位，必须包含大写字母、小写字母、数字、特殊符号中的至少3种。

---

## 功能说明

班主任拥有管理端**全部权限**。

### 1. 首页 (dashboard.php)

管理端首页展示以下内容：

- **统计数据**：学生总数
- **快捷操作**：
  - 操行分管理
  - 导入学生
  - 导出德育分记录
- **操行分排行榜**：展示前100名学生的排名、学号、姓名和操行分。排行榜上方提供百分比筛选框，可输入1-100的数字筛选显示前N%的学生（抹零法：如49人×15%=7.35，显示前7人）。

---

### 2. 操行分管理 (conduct.php)

#### 查看学生列表
- 展示所有学生的学号、姓名、当前操行分
- 支持按学生选择

#### 批量加减分
1. 在学生列表中勾选目标学生（可点击"全选"）
2. 点击"批量加减分"按钮
3. 填写以下信息：
   - **分数变动**：正数为加分，负数为扣分
   - **原因**：填写加减分原因（必填）
4. 点击"确认提交"

> 班主任加减分无限制。

#### 导出德育分记录
1. 点击"导出德育分记录"按钮
2. 系统自动生成CSV文件并下载
3. 文件格式：`学号,姓名,分数,加分历史,减分记录`
4. 历史记录以分号分隔，包含原因和分值

---

### 3. 历史记录 (history.php)

#### 查看历史记录
- 展示所有操行分变动记录
- 支持筛选条件：
  - **开始日期** / **结束日期**：按时间范围筛选
  - **学生**：按学生筛选
  - **扣分类型**：按来源筛选（手动加减分 / 作业 / 考勤）
- 点击"查询"按钮刷新列表
- 已撤销的记录会显示"由 XXX 撤销"标记

#### 导出历史记录
1. 设置筛选条件（可选）
2. 点击"导出历史记录"按钮
3. 系统自动生成CSV文件并下载
4. 文件格式：`时间,学号,姓名,分数变动,原因,操作人`

#### 撤销记录
1. 在历史记录列表中找到目标记录
2. 点击右侧"撤销"按钮
3. 确认撤销操作

---

### 4. 作业管理 (homework.php)

本模块用于管理学生作业缺交情况。

#### 查看学生列表
- 展示所有学生的学号、姓名、当前操行分
- 可勾选学生进行批量操作

#### 批量扣分
1. 在学生列表中勾选目标学生（可点击"全选"）
2. 点击"批量加减分"按钮
3. 选择扣分类型：
   - **未交作业**：按配置扣分（默认2分）
   - **迟交作业**：按配置扣分（默认1分）
   - **自定义**：手动输入扣分值
4. 填写原因（自动填充或手动修改）
5. 可选择是否关联扣分
6. 点击"确认提交"

> 扣分限制：每次加减分不超过3分。

---

### 5. 考勤管理 (attendance.php)

考勤按**时段**管理，每日分三个时段独立记录：

| 时段 | 标识 | 时间点 |
|------|------|--------|
| 早上 | morning | 7:15 |
| 中午 | afternoon | 14:00 |
| 晚修 | evening | 19:30 |

每个学生每天每个时段最多一条考勤记录。

#### 添加考勤记录
1. 选择**日期**和**时段**（早上/中午/晚修）
2. 在状态按钮组中选择考勤状态：缺勤 / 迟到 / 请假
3. 可选填写自定义扣分值（留空使用默认值）
4. 可选填写原因
5. 在学生方格中**点击选择**有考勤异常的学生（已记录的时段会显示为虚线框）
6. 点击"全选"可快速选中所有未记录的学生
7. 点击"提交考勤"批量提交

#### 查看考勤记录
- 按日期筛选考勤记录
- 每条记录显示：学号、姓名、状态、原因、记录人、扣分情况

**默认扣分规则**：

| 考勤状态 | 默认扣分 |
|---------|---------|
| 缺勤 | 3分 |
| 迟到 | 1分 |
| 请假 | 0分 |

---

### 6. 学生管理 (students.php)

#### 查看学生列表
- 展示所有学生的学号、姓名、家长手机号、状态等信息
- 支持搜索

#### 新增学生
1. 点击"新增学生"按钮
2. 填写学号、姓名
3. 可选填家长手机号（填写后系统自动创建家长账号）
4. 点击"确认"

#### 批量导入学生
1. 点击"导入学生"按钮
2. 下载导入模板
3. 上传JSON格式的学生数据文件
4. 系统自动解析并导入
5. 导入结果展示成功/失败数量

> 导入的学生初始操行分为60分，系统自动创建学生登录账号和密码。

---

### 7. 科目管理 (subjects.php)

#### 查看科目列表
- 展示所有科目及其状态

#### 添加科目
1. 点击"添加科目"按钮
2. 填写科目名称
3. 可选填科目编码和排序
4. 点击"确认"

#### 管理科目
- 编辑：修改科目信息
- 删除：删除科目（已有作业关联的科目不可删除）
- 启用/禁用：控制科目状态

---

### 8. 管理员管理 (admins.php)

#### 添加管理员
1. 点击"添加管理员"按钮
2. 填写以下信息：
   - **用户名**：登录账号
   - **姓名**：真实姓名
   - **密码**：留空则自动生成8位随机密码
   - **角色**：选择角色类型
3. 点击"添加"
4. 添加成功后会显示管理员信息和初始密码（请妥善保存）

#### 编辑管理员
- 点击"编辑"按钮可修改**姓名**和**角色类型**

#### 重置密码
1. 点击"重置密码"按钮
2. 输入新密码
3. 点击"确认重置"

#### 删除管理员
- 点击"删除"按钮确认删除（不可恢复）

---

### 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)

- 输入原密码和新密码
- 新密码需符合密码强度要求
- 修改成功后需重新登录

---

## 常见问题

### Q: 忘记密码怎么办？
请联系系统管理员通过调试接口重置。

### Q: 如何导出全班德育分记录？
在"操行分管理"页面点击"导出德育分记录"按钮，系统会生成包含所有学生当前分数及加减分历史的CSV文件。

### Q: 如何撤销错误的加减分？
在"历史记录"页面找到对应记录，点击"撤销"按钮。

### Q: 导入学生时格式错误怎么办？
请确保上传的文件是JSON格式，包含 `students` 数组，每个学生对象至少包含 `student_no`（学号）和 `name`（姓名）字段。

### Q: 考勤扣分规则可以修改吗？
考勤扣分规则在系统配置中设置。班主任在添加考勤记录时可以自定义扣分值。

---

## 数据导出说明

### 德育分记录导出
- **位置**：操行分管理页面
- **格式**：CSV（UTF-8编码）
- **字段**：学号、姓名、分数、加分历史、减分记录
- **文件名**：`德育分记录_日期.csv`

### 历史记录导出
- **位置**：历史记录页面
- **格式**：CSV（UTF-8编码）
- **字段**：时间、学号、姓名、分数变动、原因、操作人
- **支持筛选**：可按时间范围和学生筛选后导出
- **文件名**：`历史记录_日期.csv`