用户管理

1. 访问用户管理

管理后台左侧菜单进入「用户管理」，即可查看所有用户列表、进行新增、编辑、删除等操作。

2. 用户列表

2.1 列表功能

用户列表页面提供以下功能：

2.2 列表字段

用户列表展示以下信息：

2.3 角色标签

用户角色共分为四种：

2.4 状态标识

2.5 登录方式图标

登录方式图标直观显示用户已绑定的登录渠道：

• 密码登录
• Github
• Google
• QQ
• Microsoft

3. 新增用户

3.1 打开表单

点击用户列表页的「新增用户」按钮，弹出用户表单对话框。

3.2 表单字段

3.3 头像上传

点击头像上传区域，可选择本地图片作为头像：

• 支持 JPG、PNG、GIF、WebP 等格式
• 上传后显示本地预览
• 点击确认提交时统一上传到服务器
• 上传尺寸建议：120x120 像素

3.4 表单验证

3.5 提交保存

点击「确定」按钮提交表单：

1. 表单验证通过后
2. 如果有头像，先上传头像
3. 创建用户账户
4. 显示成功提示
5. 关闭对话框并刷新列表

4. 编辑用户

4.1 打开表单

在用户列表中点击某用户的「编辑」按钮，弹出编辑用户表单。

4.2 表单差异

编辑表单与新增表单有以下差异：

4.3 表单预填

编辑表单会自动填充用户的当前信息：

• 邮箱、昵称、网站地址、铭牌标识、角色
• 头像显示当前头像图片
• 启用状态显示当前设置

4.4 更新提交

点击「确定」按钮更新用户：

1. 表单验证通过后
2. 如果有新头像，先上传头像
3. 构建更新数据（密码留空则不包含）
4. 调用更新接口
5. 显示成功提示
6. 关闭对话框并刷新列表

5. 删除用户

5.1 删除操作

在用户列表中点击某用户的「删除」按钮。

5.2 确认提示

删除前系统会弹出确认框：确定要删除这个用户吗？

5.3 删除类型

用户删除采用软删除机制：

• 用户数据不会从数据库物理删除
• 仅设置 deleted_at 时间戳标记
• 被删除用户在列表中显示「已删除」标签
• 「已删除」用户不显示编辑和删除按钮

6. 用户角色权限

6.1 角色说明

6.2 权限范围