# 管理员端账户管理接口 接口前缀:`/account/admin`。除登录接口外,下面所有接口都必须携带 `Authorization`, 服务端会解析JWT并校验“管理员”大类角色。 ## 页面初始化与查询 | 方法 | 路径 | 说明 | | --- | --- | --- | | GET | `/statistics` | 返回学员/教师/管理员总数及活跃数,用于Tab角标 | | GET | `/options` | 返回班级、教师角色、管理员角色选项 | | POST | `/page` | 三类账户分页筛选 | | GET | `/{id}` | 账户详情;学员额外返回课程出勤、成绩摘要、登录日志 | `POST /page` 示例: ```json { "pageNum": 1, "pageSize": 20, "accountType": "STUDENT", "keyword": "张", "classId": 12, "status": "STUDYING", "startDate": "2026-01-01", "endDate": "2026-12-31", "archiveOverSixMonths": false } ``` 状态约定:学员为 `PENDING / STUDYING / GRADUATED / ARCHIVED`;教师和管理员为 `ENABLED / DISABLED`。`archiveOverSixMonths=true` 时只返回结业满六个月且尚未归档的学员。 ## 新增、编辑与状态 | 方法 | 路径 | 说明 | | --- | --- | --- | | POST | `/` | 新增学员、教师或管理员 | | PUT | `/{id}` | 编辑基础信息、班级或角色 | | PUT | `/{id}/status` | 修改单个账户状态 | | POST | `/{id}/reset-password` | 重置为 `Wssg@2026` | | POST | `/batch` | 批量结业、归档、启禁用或重置密码 | 新增教师示例: ```json { "accountType": "TEACHER", "name": "王老师", "employeeNo": "T-2026-001", "phoneNumber": "13800138000", "roleId": 8, "initialPassword": "Wssg@2026", "status": "ENABLED" } ``` 新增管理员时以 `username` 作为登录账号;新增教师时以 `employeeNo` 作为登录账号;学员固定以 手机号作为登录账号。认证接口仍接收原字段 `phoneNumber`,但字段值现在可以是手机号、教师工号 或管理员登录账号。 批量请求示例: ```json { "ids": ["1912345678901234567", "1912345678901234568"], "action": "GRADUATE" } ``` 动作支持 `GRADUATE / ARCHIVE / RESET_PASSWORD / ENABLE / DISABLE`,单次最多500个ID。 服务端会阻止管理员禁用当前登录的自己。 ## Excel导入与导出 | 方法 | 路径 | 说明 | | --- | --- | --- | | GET | `/import/template?accountType=STUDENT` | 下载对应类型模板 | | POST | `/import` | `multipart/form-data`预览或确认导入 | | POST | `/export` | 按与分页相同的筛选条件导出全部匹配账户 | 导入参数:`accountType`、学员必填的 `classId`、`preview` 和 `file`。前端先以 `preview=true` 上传并展示逐行校验结果,用户确认后用同一文件以 `preview=false` 再次提交。 服务端只落库校验通过的行,单次最多500条、文件最大5MB。 ## 数据库 发布前执行 `src/main/resources/sql/account_management.sql`。脚本新增账户状态、工号、结业/归档时间、 角色适用端字段,以及登录日志和账户操作审计表;脚本可重复执行,并在末尾输出需要人工处理的 未分类角色和历史重复账号。