# 管理员端账户管理接口 接口前缀:`/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` 时只返回结业满六个月且尚未归档的学员。 ### 学员目录树 `GET /account/admin/student-tree?keyword=污泥`返回与班级管理完全一致的 `工种 → 年度 → 等级 → 班级`目录树。学员分页和导出除`classId`外还支持 `occupation`、`trainingYear`、`levelId`,因此点击任一层节点都可以查看该节点范围内的学员; 教师和管理员页签会忽略这些学员专用条件。 ## 新增、编辑与状态 | 方法 | 路径 | 说明 | | --- | --- | --- | | 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。 ### 学员正式花名册格式 `accountType=STUDENT` 时,模板和导出文件使用“花名册”工作表以及正式职业技能认定申报表 版式。前4行为固定抬头和两级表头,数据从第5行开始,共21列:序号、姓名、性别、身份证号、 联系电话、人员类别1/2、劳动关系单位名称及代码、实际用工单位名称及代码、最高学历、专业、 社保缴金年限、相关职业工作年限、前一等级证书的职业/等级/编号/日期、申报资质条款、备注。 - 模板预置48个空白学员行;仅预置序号的行不会被识别为待导入数据。 - 姓名和手机号必填,其他字段允许为空;填写身份证、性别和人员类别时会执行格式校验。 - 身份证、手机号、组织机构代码和证书编号按文本编号处理,兼容Excel科学计数法显示。 - 花名册“等级”属于“所持前一等级证书信息”;当前培训等级仍由`classId`对应班级决定。 - 导出少于48人时保留完整空白表格,超过48人时自动扩展并下移签字、备注区。 教师和管理员账户清单中的状态使用中文业务文案(如“启用”“禁用”);最后登录时间固定按 上海业务时区输出为 `yyyy-MM-dd HH:mm:ss`,从未登录的账户保持为空。状态转换同时覆盖学员 状态(“待激活”“在读”“已结业”“已归档”),供包含状态列的账户清单统一复用。 - 教师和管理员继续使用原有5列精简模板及账户清单格式。 ## 数据库 发布前执行 `src/main/resources/sql/account_management.sql`。脚本新增账户状态、工号、结业/归档时间、 角色适用端字段,以及登录日志和账户操作审计表;脚本可重复执行,并在末尾输出需要人工处理的 未分类角色和历史重复账号。