更新使用文档

docs/teacher.md

@@ -0,0 +1,232 @@
+# 班主任使用文档
+
+## 登录
+
+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`