huang
4abbf558e4
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 4m28s
- 修复所有 DTO 文件的 description 标签（10 个文件） - 枚举字段统一使用中文说明（用户类型、角色类型、权限类型等） - 状态字段明确说明 0/1 含义 - validate 标签与 OpenAPI 标签保持一致 - 在 AGENTS.md 和 CLAUDE.md 添加 DTO 规范章节 - AI 助手必须执行的 7 项检查清单 - 常见枚举字段标准值参考 - 确保未来 AI 助手自动遵循规范 - 创建规范文档 - docs/code-review-checklist.md（Code Review 检查清单） - docs/dto-improvement-summary.md（DTO 改进总结） - docs/ai-dto-guidelines-update.md（AI 指引更新说明） - 重新生成 OpenAPI 文档（375 个 description 标签） 影响：所有 API 字段现在都有清晰的中文说明，前端开发更友好
80 lines
3.7 KiB
Go
80 lines
3.7 KiB
Go
package model
|
|
|
|
// CreateRoleRequest 创建角色请求
|
|
type CreateRoleRequest struct {
|
|
RoleName string `json:"role_name" validate:"required,min=1,max=50" required:"true" minLength:"1" maxLength:"50" description:"角色名称"`
|
|
RoleDesc string `json:"role_desc" validate:"omitempty,max=255" maxLength:"255" description:"角色描述"`
|
|
RoleType int `json:"role_type" validate:"required,min=1,max=2" required:"true" minimum:"1" maximum:"2" description:"角色类型 (1:平台角色, 2:客户角色)"`
|
|
}
|
|
|
|
// UpdateRoleRequest 更新角色请求
|
|
type UpdateRoleRequest struct {
|
|
RoleName *string `json:"role_name" validate:"omitempty,min=1,max=50" minLength:"1" maxLength:"50" description:"角色名称"`
|
|
RoleDesc *string `json:"role_desc" validate:"omitempty,max=255" maxLength:"255" description:"角色描述"`
|
|
Status *int `json:"status" validate:"omitempty,min=0,max=1" minimum:"0" maximum:"1" description:"状态 (0:禁用, 1:启用)"`
|
|
}
|
|
|
|
// UpdateRoleParams 更新角色参数聚合
|
|
type UpdateRoleParams struct {
|
|
IDReq
|
|
UpdateRoleRequest
|
|
}
|
|
|
|
// RoleListRequest 角色列表查询请求
|
|
type RoleListRequest struct {
|
|
Page int `json:"page" query:"page" validate:"omitempty,min=1" minimum:"1" description:"页码"`
|
|
PageSize int `json:"page_size" query:"page_size" validate:"omitempty,min=1,max=100" minimum:"1" maximum:"100" description:"每页数量"`
|
|
RoleName string `json:"role_name" query:"role_name" validate:"omitempty,max=50" maxLength:"50" description:"角色名称模糊查询"`
|
|
RoleType *int `json:"role_type" query:"role_type" validate:"omitempty,min=1,max=2" minimum:"1" maximum:"2" description:"角色类型 (1:平台角色, 2:客户角色)"`
|
|
Status *int `json:"status" query:"status" validate:"omitempty,min=0,max=1" minimum:"0" maximum:"1" description:"状态 (0:禁用, 1:启用)"`
|
|
}
|
|
|
|
// RoleResponse 角色响应
|
|
type RoleResponse struct {
|
|
ID uint `json:"id" description:"角色ID"`
|
|
RoleName string `json:"role_name" description:"角色名称"`
|
|
RoleDesc string `json:"role_desc" description:"角色描述"`
|
|
RoleType int `json:"role_type" description:"角色类型 (1:平台角色, 2:客户角色)"`
|
|
Status int `json:"status" description:"状态 (0:禁用, 1:启用)"`
|
|
Creator uint `json:"creator" description:"创建人ID"`
|
|
Updater uint `json:"updater" description:"更新人ID"`
|
|
CreatedAt string `json:"created_at" description:"创建时间"`
|
|
UpdatedAt string `json:"updated_at" description:"更新时间"`
|
|
}
|
|
|
|
// RolePageResult 角色分页响应
|
|
type RolePageResult struct {
|
|
Items []RoleResponse `json:"items" description:"角色列表"`
|
|
Total int64 `json:"total" description:"总记录数"`
|
|
Page int `json:"page" description:"当前页码"`
|
|
Size int `json:"size" description:"每页数量"`
|
|
}
|
|
|
|
// AssignPermissionsRequest 分配权限请求
|
|
type AssignPermissionsRequest struct {
|
|
PermIDs []uint `json:"perm_ids" validate:"required,min=1" required:"true" minItems:"1" description:"权限ID列表"`
|
|
}
|
|
|
|
// AssignPermissionsParams 分配权限参数聚合
|
|
type AssignPermissionsParams struct {
|
|
IDReq
|
|
AssignPermissionsRequest
|
|
}
|
|
|
|
// RemovePermissionParams 移除权限参数聚合
|
|
type RemovePermissionParams struct {
|
|
RoleID uint `path:"role_id" required:"true" description:"角色ID"`
|
|
PermID uint `path:"perm_id" required:"true" description:"权限ID"`
|
|
}
|
|
|
|
// UpdateRoleStatusRequest 更新角色状态请求
|
|
type UpdateRoleStatusRequest struct {
|
|
Status int `json:"status" validate:"required,min=0,max=1" required:"true" minimum:"0" maximum:"1" description:"状态 (0:禁用, 1:启用)"`
|
|
}
|
|
|
|
// UpdateRoleStatusParams 更新角色状态参数聚合
|
|
type UpdateRoleStatusParams struct {
|
|
IDReq
|
|
UpdateRoleStatusRequest
|
|
}
|