用户管理

本页讲账号的创建、导入与维护。角色与权限模型(超管、学科角色、题目可见性等)见 权限与角色。

用户字段

• 用户名、姓名、头像
• is_superuser(超级管理员标记)、is_active(启用状态)
• last_login、login_count(登录统计)

学科归属与角色不在用户账号上直接设置,而是在「学科管理 → 成员管理」中按学科授予,详见 权限与角色。

常见操作

• 创建用户：超级管理员在用户管理中新建账号并设定角色。
• 批量导入：超级管理员可通过 Excel 一次性创建多个账号，见下文。
• 修改资料：用户可修改自己的资料。
• 修改密码：用户可修改自己的密码。
• 启用 / 停用：管理员可停用账号。

批量导入用户

超级管理员可在「用户管理」页点击 批量导入，通过 Excel 一次性创建多个账号：

1. 下载 .xlsx 模板。

2. 按模板列填写数据：

   列	必填	说明
   用户名	✅	需唯一，且不能与文件内其他行或已有用户重复
   姓名	✅	用户全名
   密码	✅	至少 6 位
   管理员	❌	填「是」创建为管理员，留空为普通用户

3. 上传文件（仅支持 .xlsx，最大 5MB）。

4. 系统逐行校验并入库，随后返回成功数量与逐行失败明细，可一键复制错误信息，修正后重新导入。

TIP

合法行会立即创建，个别错误行不会影响其他行；重复上传时已存在的用户名会被跳过并在明细中提示。

自助注册

默认关闭。超级管理员可在 系统参数 的「注册设置」中开启：

• 开放自助注册：开启后登录页出现「立即注册」入口，访客可自行创建账号（仅普通用户，无法自助成为管理员）。
• 注册需管理员审核：开启后新注册账号默认停用（is_active=false），需管理员在用户管理中启用后方可登录。

首次初始化

首次启动通过初始化向导创建第一个超级管理员：

1. 检测是否已配置。
2. 选择数据库类型（桌面版 SQLite / 服务器版 MySQL）并校验连接。
3. 运行数据库迁移。
4. 创建管理员账号。

桌面版通过托盘「打开题库」进入向导；服务器版可用脚本创建超管：

docker compose exec backend python scripts/create_superuser.py