Files
SharedClassManager/docs/admin.md
2026-04-19 15:59:20 +08:00

296 lines
8.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 管理端使用文档
## 登录
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: 考勤扣分规则可以修改吗?
考勤扣分规则在系统配置中设置,如需调整请联系系统管理员修改后端配置文件。班主任在添加考勤记录时可以自定义扣分值。
---
## 数据导出说明
### 德育分记录导出
- **位置**:操行分管理页面
- **权限**:仅班主任
- **格式**CSVUTF-8编码
- **字段**:学号、姓名、分数、加分历史、减分记录
- **文件名**`德育分记录_日期.csv`
### 历史记录导出
- **位置**:历史记录页面
- **权限**:仅班主任
- **格式**CSVUTF-8编码
- **字段**:时间、学号、姓名、分数变动、原因、操作人
- **支持筛选**:可按时间范围和学生筛选后导出
- **文件名**`历史记录_日期.csv`