fa6f1e5c58
- 数据库：auth_roles 表新增 level 字段（1=超管, 10=管理员, 100=普通用户） - 后端：新增 GetAllRoles/GetUserMaxLevel/SetUserRoles/FindByCodeList DAO 方法 - 后端：SetRolesRequest 替换 AssignRoleRequest，AdminUserInfo.Roles 改为 []RoleInfo - 后端：所有管理操作（禁用/启用/角色分配/创建用户）强制层级权限校验 - 后端：PUT /users/:id/roles（批量设置角色）+ GET /roles（角色列表） - 前端：角色管理改为 Checkbox Group 多选，高等级角色禁用 - 前端：禁用/启用按钮受角色层级约束，列表页操作按钮权限管控 - 前端：创建用户对话框角色选项根据操作者等级动态过滤 - 文档：API 文档、设计方案、集成规范、进度文档同步更新 Made-with: Cursor
62 lines
3.2 KiB
Go
62 lines
3.2 KiB
Go
// Package dto 定义数据传输对象
|
||
package dto
|
||
|
||
// UserListRequest 管理端用户列表查询请求参数
|
||
type UserListRequest struct {
|
||
Page int `form:"page" binding:"required,min=1"` // 页码，从 1 开始
|
||
PageSize int `form:"page_size" binding:"required,min=1,max=100"` // 每页数量，1-100
|
||
Keyword string `form:"keyword"` // 搜索关键词（匹配用户名或邮箱）
|
||
Status *int `form:"status"` // 状态筛选：1=正常, 2=禁用, 3=注销；为空则不筛选
|
||
}
|
||
|
||
// UserListResponse 管理端用户列表响应
|
||
type UserListResponse struct {
|
||
Total int64 `json:"total"` // 符合条件的用户总数
|
||
List []AdminUserInfo `json:"list"` // 当前页的用户列表
|
||
}
|
||
|
||
// AdminUserInfo 管理端用户信息（比 UserInfo 更详细，包含管理字段）
|
||
type AdminUserInfo struct {
|
||
ID int64 `json:"id"` // 用户 ID
|
||
Username string `json:"username"` // 用户名
|
||
Email string `json:"email"` // 邮箱
|
||
Nickname string `json:"nickname"` // 昵称
|
||
Avatar string `json:"avatar"` // 头像 URL
|
||
Gender int `json:"gender"` // 性别：0=未知, 1=男, 2=女
|
||
Phone string `json:"phone,omitempty"` // 手机号
|
||
Status int `json:"status"` // 账号状态
|
||
StatusText string `json:"status_text"` // 状态中文描述
|
||
Roles []RoleInfo `json:"roles"` // 角色详情列表（含 code/name/level）
|
||
MaxLevel int `json:"max_level"` // 用户最高权限等级（最小 level 值）
|
||
LastLoginAt string `json:"last_login_at,omitempty"` // 最后登录时间
|
||
LastLoginIP string `json:"last_login_ip,omitempty"` // 最后登录 IP
|
||
CreatedAt string `json:"created_at"` // 注册时间
|
||
UpdatedAt string `json:"updated_at"` // 更新时间
|
||
}
|
||
|
||
// RoleInfo 角色信息（用于前端角色列表展示和角色分配）
|
||
type RoleInfo struct {
|
||
Code string `json:"code"` // 角色代码
|
||
Name string `json:"name"` // 角色中文名称
|
||
Level int `json:"level"` // 角色等级，值越小权限越高
|
||
}
|
||
|
||
// UpdateUserStatusRequest 更新用户状态请求
|
||
type UpdateUserStatusRequest struct {
|
||
Status int `json:"status" binding:"required,oneof=1 2"` // 目标状态：1=正常, 2=禁用
|
||
}
|
||
|
||
// SetRolesRequest 批量设置用户角色请求（替换原有的单角色分配）
|
||
type SetRolesRequest struct {
|
||
RoleCodes []string `json:"role_codes" binding:"required,min=1"` // 角色代码列表
|
||
}
|
||
|
||
// AdminCreateUserRequest 管理员手动创建用户请求
|
||
type AdminCreateUserRequest struct {
|
||
Username string `json:"username" binding:"required,min=3,max=50"` // 用户名
|
||
Email string `json:"email" binding:"required,email"` // 邮箱
|
||
Password string `json:"password" binding:"required,min=6,max=50"` // 初始密码
|
||
Nickname string `json:"nickname" binding:"max=50"` // 昵称（选填）
|
||
RoleCode string `json:"role_code" binding:"omitempty"` // 初始角色（选填，默认 user）
|
||
}
|