first commit

2025-06-19 17:12:48 +08:00
commit 1edbd79e4c
506 changed files with 52853 additions and 0 deletions
--- a/app/main/api/desc/admin/role.api
+++ b/app/main/api/desc/admin/role.api
@@ -0,0 +1,124 @@
+syntax = "v1"
+
+info (
+	title:   "角色服务"
+	desc:    "角色服务"
+	author:  "Liangzai"
+	email:   "2440983361@qq.com"
+	version: "v1"
+)
+
+@server (
+	prefix: api/v1/admin/role
+	group:  admin_role
+	jwt:    JwtAuth
+)
+service main {
+	@doc "获取角色列表"
+	@handler GetRoleList
+	get /list (GetRoleListReq) returns (GetRoleListResp)
+
+	@doc "获取角色详情"
+	@handler GetRoleDetail
+	get /detail/:id (GetRoleDetailReq) returns (GetRoleDetailResp)
+
+	@doc "创建角色"
+	@handler CreateRole
+	post /create (CreateRoleReq) returns (CreateRoleResp)
+
+	@doc "更新角色"
+	@handler UpdateRole
+	put /update/:id (UpdateRoleReq) returns (UpdateRoleResp)
+
+	@doc "删除角色"
+	@handler DeleteRole
+	delete /delete/:id (DeleteRoleReq) returns (DeleteRoleResp)
+}
+
+type (
+	// 列表请求
+	GetRoleListReq {
+		Page     int64  `form:"page,default=1"`             // 页码
+		PageSize int64  `form:"pageSize,default=20"`        // 每页数量
+		Name     string `form:"name,optional"`              // 角色名称
+		Code     string `form:"code,optional"`              // 角色编码
+		Status   int64  `form:"status,optional,default=-1"` // 状态：0-禁用，1-启用
+	}
+
+	// 列表响应
+	GetRoleListResp {
+		Total int64          `json:"total"` // 总数
+		Items []RoleListItem `json:"items"` // 列表
+	}
+
+	// 列表项
+	RoleListItem {
+		Id          int64   `json:"id"`          // 角色ID
+		RoleName    string  `json:"role_name"`   // 角色名称
+		RoleCode    string  `json:"role_code"`   // 角色编码
+		Description string  `json:"description"` // 角色描述
+		Status      int64   `json:"status"`      // 状态：0-禁用，1-启用
+		Sort        int64   `json:"sort"`        // 排序
+		CreateTime  string  `json:"create_time"` // 创建时间
+		MenuIds     []int64 `json:"menu_ids"`    // 关联的菜单ID列表
+	}
+
+	// 详情请求
+	GetRoleDetailReq {
+		Id int64 `path:"id"` // 角色ID
+	}
+
+	// 详情响应
+	GetRoleDetailResp {
+		Id          int64   `json:"id"`          // 角色ID
+		RoleName    string  `json:"role_name"`   // 角色名称
+		RoleCode    string  `json:"role_code"`   // 角色编码
+		Description string  `json:"description"` // 角色描述
+		Status      int64   `json:"status"`      // 状态：0-禁用，1-启用
+		Sort        int64   `json:"sort"`        // 排序
+		CreateTime  string  `json:"create_time"` // 创建时间
+		UpdateTime  string  `json:"update_time"` // 更新时间
+		MenuIds     []int64 `json:"menu_ids"`    // 关联的菜单ID列表
+	}
+
+	// 创建请求
+	CreateRoleReq {
+		RoleName    string  `json:"role_name"`        // 角色名称
+		RoleCode    string  `json:"role_code"`        // 角色编码
+		Description string  `json:"description"`      // 角色描述
+		Status      int64   `json:"status,default=1"` // 状态：0-禁用，1-启用
+		Sort        int64   `json:"sort,default=0"`   // 排序
+		MenuIds     []int64 `json:"menu_ids"`         // 关联的菜单ID列表
+	}
+
+	// 创建响应
+	CreateRoleResp {
+		Id int64 `json:"id"` // 角色ID
+	}
+
+	// 更新请求
+	UpdateRoleReq {
+		Id          int64   `path:"id"`                   // 角色ID
+		RoleName    *string `json:"role_name,optional"`   // 角色名称
+		RoleCode    *string `json:"role_code,optional"`   // 角色编码
+		Description *string `json:"description,optional"` // 角色描述
+		Status      *int64  `json:"status,optional"`      // 状态：0-禁用，1-启用
+		Sort        *int64  `json:"sort,optional"`        // 排序
+		MenuIds     []int64 `json:"menu_ids,optional"`    // 关联的菜单ID列表
+	}
+
+	// 更新响应
+	UpdateRoleResp {
+		Success bool `json:"success"` // 是否成功
+	}
+
+	// 删除请求
+	DeleteRoleReq {
+		Id int64 `path:"id"` // 角色ID
+	}
+
+	// 删除响应
+	DeleteRoleResp {
+		Success bool `json:"success"` // 是否成功
+	}
+)