更新使用文档

docs/guide/cadre.md

@@ -0,0 +1,42 @@
+# 班干部使用说明
+
+## 登录
+
+输入**用户名**和**密码**登录。首次登录需强制修改密码。
+
+> 密码要求：6-20位，包含大写字母、小写字母、数字、特殊符号中的至少3种。
+
+## 角色权限
+
+| 角色 | 操行分管理 | 历史记录 | 作业管理 | 考勤管理 | 科目管理 |
+|------|-----------|---------|---------|---------|---------|
+| 班长 | ±5分以内 | 全部（可撤销） | - | - | - |
+| 学习委员 | - | 自己的 | ✓ | - | ✓ |
+| 考勤委员 | - | 自己的 | - | ✓ | - |
+| 劳动委员 | ±1分（卫生值日） | 自己的 | - | - | - |
+| 志愿委员 | 仅加分 | 自己的 | - | - | - |
+
+## 常用操作
+
+### 班长
+- **加减分**：勾选学生 → 批量加减分 → 填写分值（±5分以内）和原因
+- **撤销记录**：历史记录页 → 点击撤销按钮
+
+### 学习委员
+- **作业扣分**：勾选学生 → 批量加减分 → 选择未交/迟交/自定义 → 填写原因
+- **科目管理**：添加/编辑/删除科目
+
+### 考勤委员
+- **添加考勤**：选择学生 → 选择日期和状态 → 填写备注 → 确认提交
+- 默认扣分：缺勤5分、迟到2分、请假1分
+
+### 劳动委员
+- **加减分**：以卫生值日为由进行 ±1 分操作
+
+### 志愿委员
+- **加分**：以服务时长为由进行加分操作
+
+## 常见问题
+
+- **忘记密码**：联系班主任重置。
+- **只能看到自己的记录**：班干部角色默认仅查看自己提交的操作记录（班长可查看全部）。

docs/guide/parent.md

@@ -0,0 +1,18 @@
+# 家长端使用说明
+
+## 登录
+
+输入**手机号**和**密码**登录。账号由系统自动创建，与子女信息关联。
+
+## 功能概览
+
+| 页面 | 说明 |
+|------|------|
+| 首页 | 查看子女操行分、班级排名、初始分提示 |
+| 历史记录 | 查看子女加减分明细（时间、类型、原因、分值、记录人），支持分页 |
+| 考勤记录 | 查看子女考勤记录（出勤/缺勤/迟到/请假统计 + 明细列表） |
+
+## 常见问题
+
+- **忘记密码**：联系班主任重置。
+- **初始操行分**：默认60分，首页底部有提示。

docs/guide/student.md

@@ -0,0 +1,22 @@
+# 学生端使用说明
+
+## 登录
+
+输入**长学号**和**密码**登录。首次登录需强制修改密码。
+
+> 密码要求：6-20位，包含大写字母、小写字母、数字、特殊符号中的至少3种。
+
+## 功能概览
+
+| 页面 | 说明 |
+|------|------|
+| 首页 | 查看操行分、班级排名、作业完成率、出勤率 |
+| 操行分详情 | 查看完整加减分历史（时间、分值、原因、操作人） |
+| 作业情况 | 查看缺交作业记录（科目、状态、备注） |
+| 考勤记录 | 查看个人考勤记录（按月） |
+| 修改密码 | 修改登录密码 |
+
+## 常见问题
+
+- **忘记密码**：联系班主任或开发人员重置。
+- **操行分有误**：联系班主任或班长核实调整。

docs/guide/teacher.md

@@ -0,0 +1,38 @@
+# 班主任使用说明
+
+## 登录
+
+输入**用户名**和**密码**登录。首次登录需强制修改密码。
+
+> 密码要求：6-20位，包含大写字母、小写字母、数字、特殊符号中的至少3种。
+
+## 功能概览
+
+班主任拥有管理端全部权限：
+
+| 页面 | 功能 |
+|------|------|
+| 首页 | 查看学生总数、排行榜、快捷入口 |
+| 操行分管理 | 对学生加减分（无限制）、导出德育分记录 |
+| 历史记录 | 查看/导出/撤销全班记录 |
+| 作业管理 | 发布缺交作业记录、关联扣分 |
+| 考勤管理 | 添加考勤记录、自定义扣分值 |
+| 学生管理 | 新增/编辑/删除/批量导入学生 |
+| 科目管理 | 增删改科目 |
+| 管理员管理 | 添加/编辑/删除/重置密码班干部账号 |
+| 修改密码 | 修改登录密码 |
+
+## 常用操作
+
+- **加减分**：勾选学生 → 批量加减分 → 填写分值和原因
+- **导出德育分**：操行分管理页 → 导出德育分记录（CSV）
+- **导出历史记录**：历史记录页 → 导出历史记录（CSV，可按日期/学生筛选）
+- **撤销记录**：历史记录页 → 点击撤销按钮
+- **导入学生**：学生管理页 → 导入学生（JSON格式，需包含 `student_no` 和 `name`）
+- **添加班干部**：管理员管理页 → 添加管理员 → 填写账号信息和角色
+- **重置班干部密码**：管理员管理页 → 重置密码 → 输入新密码
+
+## 常见问题
+
+- **班主任忘记密码**：联系系统管理员通过调试接口重置。
+- **考勤扣分规则**：在系统配置中设置，添加考勤时也可自定义扣分值。