完善文档

docs/admin.md

@@ -1 +1,295 @@
-# 管理端使用文档
+# 管理端使用文档
+
+## 登录
+
+1. 打开系统网址，进入登录页面
+2. 输入**用户名**和**密码**
+3. 点击"登录"按钮
+4. 首次登录系统会强制要求修改密码
+
+> **密码要求**：长度6-20位，必须包含大写字母、小写字母、数字、特殊符号中的至少3种。
+
+---
+
+## 角色说明
+
+管理端根据角色不同，拥有不同的功能权限：
+
+| 角色 | 操行分管理 | 历史记录 | 作业管理 | 考勤管理 | 科目管理 | 管理员管理 | 数据导出 |
+|------|-----------|---------|---------|---------|---------|-----------|---------|
+| 班主任 | 无限制 | 全部 | 全部 | 全部 | ✓ | ✓ | ✓ |
+| 班长 | ±5分 | 全部 | - | - | - | - | - |
+| 学习委员 | - | 自己的 | ✓ | - | ✓ | - | - |
+| 考勤委员 | - | 自己的 | - | ✓ | - | - | - |
+| 劳动委员 | ±1分 | 自己的 | - | - | - | - | - |
+| 志愿委员 | 仅加分 | 自己的 | - | - | - | - | - |
+
+---
+
+## 功能说明
+
+### 1. 首页 (dashboard.php)
+
+管理端首页展示以下内容：
+
+- **统计数据**：学生总数
+- **快捷操作**：
+  - 操行分管理（班主任/班长/劳动委员/志愿委员）
+  - 导入学生（班主任）
+  - 导出德育分记录（班主任）
+- **操行分排行榜**：展示前100名学生的排名、学号、姓名和操行分
+
+---
+
+### 2. 操行分管理 (conduct.php)
+
+#### 查看学生列表
+- 展示所有学生的学号、姓名、当前操行分
+- 支持按学生选择
+
+#### 批量加减分
+1. 在学生列表中勾选目标学生（可点击"全选"）
+2. 点击"批量加减分"按钮
+3. 填写以下信息：
+   - **分数变动**：正数为加分，负数为扣分
+   - **原因**：填写加减分原因（必填）
+4. 点击"确认提交"
+
+**加减分限制**：
+| 角色 | 限制 |
+|------|------|
+| 班主任 | 无限制 |
+| 班长 | ±5分以内 |
+| 劳动委员 | 固定±1分（卫生值日理由） |
+| 志愿委员 | 仅限加分 |
+
+#### 单人加减分
+点击学生行右侧的"加减分"按钮，操作同批量加减分。
+
+#### 导出德育分记录（仅班主任）
+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. 点击"保存"
+
+#### 重置密码
+1. 点击管理员行的"重置密码"按钮
+2. 输入新密码（至少6位）
+3. 点击"确认重置"
+
+#### 删除管理员
+1. 点击管理员行的"删除"按钮
+2. 确认删除操作
+3. 不可恢复，请谨慎操作
+
+---
+
+### 9. 修改密码 (password.php)
+
+- 输入原密码和新密码
+- 新密码需符合密码强度要求
+- 修改成功后需重新登录
+
+---
+
+## 导航栏说明
+
+管理端侧边导航栏包含以下入口：
+
+| 导航项 | 页面 | 权限 |
+|-------|------|------|
+| 首页 | /admin/dashboard.php | 所有管理员 |
+| 操行分管理 | /admin/conduct.php | 班主任/班长/劳动委员/志愿委员 |
+| 历史记录 | /admin/history.php | 所有管理员 |
+| 作业管理 | /admin/homework.php | 班主任/学习委员 |
+| 考勤管理 | /admin/attendance.php | 班主任/考勤委员 |
+| 学生管理 | /admin/students.php | 班主任 |
+| 科目管理 | /admin/subjects.php | 班主任/学习委员 |
+| 管理员管理 | /admin/admins.php | 班主任 |
+| 修改密码 | /admin/password.php | 所有管理员 |
+
+---
+
+## 常见问题
+
+### Q: 忘记密码怎么办？
+班主任密码请联系系统管理员通过调试接口重置。其他管理员请联系班主任或开发人员重置。
+
+### Q: 如何导出全班德育分记录？
+班主任登录后，在"操行分管理"页面点击"导出德育分记录"按钮，系统会生成包含所有学生当前分数及加减分历史的CSV文件。
+
+### Q: 如何撤销错误的加减分？
+在"历史记录"页面找到对应记录，点击"撤销"按钮。班主任和班长可以撤销任何人的扣分记录。
+
+### Q: 导入学生时格式错误怎么办？
+请确保上传的文件是JSON格式，包含 `students` 数组，每个学生对象至少包含 `student_no`（学号）和 `name`（姓名）字段。
+
+### Q: 考勤扣分规则可以修改吗？
+考勤扣分规则在系统配置中设置，如需调整请联系系统管理员修改后端配置文件。班主任在添加考勤记录时可以自定义扣分值。
+
+---
+
+## 数据导出说明
+
+### 德育分记录导出
+- **位置**：操行分管理页面
+- **权限**：仅班主任
+- **格式**：CSV（UTF-8编码）
+- **字段**：学号、姓名、分数、加分历史、减分记录
+- **文件名**：`德育分记录_日期.csv`
+
+### 历史记录导出
+- **位置**：历史记录页面
+- **权限**：仅班主任
+- **格式**：CSV（UTF-8编码）
+- **字段**：时间、学号、姓名、分数变动、原因、操作人
+- **支持筛选**：可按时间范围和学生筛选后导出
+- **文件名**：`历史记录_日期.csv`