# 班主任使用文档

## 登录

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

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

---

## 功能说明

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

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

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

- **统计数据**：学生总数
- **快捷操作**：
  - 操行分管理
  - 导入学生
  - 导出德育分记录
- **操行分排行榜**：展示前100名学生的排名、学号、姓名和操行分

---

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

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

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

> 班主任加减分无限制。

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

---

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

#### 查看历史记录
- 展示所有操行分变动记录
- 支持筛选条件：
  - **开始日期** / **结束日期**：按时间范围筛选
  - **学生**：按学生筛选
- 点击"查询"按钮刷新列表

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

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

---

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

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

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

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

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

---

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

#### 添加考勤记录
1. 点击"添加考勤"按钮
2. 选择学生（支持多选）
3. 选择日期
4. 选择考勤状态：正常 / 迟到 / 缺勤 / 请假
5. 填写备注（可选）
6. 设置是否关联扣分（默认开启）
7. 可自定义扣分值
8. 点击"确认提交"

#### 查看考勤记录
- 按日期和学生筛选考勤记录
- 每条记录显示：学号、姓名、日期、考勤状态、备注

**默认扣分规则**：

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

---

### 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. 修改密码 (password.php)

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

---

## 常见问题

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

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

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

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

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

---

## 数据导出说明

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

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