初始化
This commit is contained in:
235
api/admin/v1/admin.go
Normal file
235
api/admin/v1/admin.go
Normal file
@@ -0,0 +1,235 @@
|
||||
package v1
|
||||
|
||||
import "github.com/gogf/gf/v2/frame/g"
|
||||
|
||||
// ===== 登录 =====
|
||||
|
||||
type LoginReq struct {
|
||||
g.Meta `path:"/login" method:"post" tags:"admin" summary:"管理员登录"`
|
||||
Account string `v:"required#请输入账号" json:"account"`
|
||||
Password string `v:"required#请输入密码" json:"password"`
|
||||
Remember bool `json:"remember"`
|
||||
}
|
||||
type LoginRes struct {
|
||||
Token string `json:"token"`
|
||||
NickName string `json:"nick_name"`
|
||||
RoleName string `json:"role_name"`
|
||||
RoleValue string `json:"role_value"`
|
||||
}
|
||||
|
||||
type MyInfoReq struct {
|
||||
g.Meta `path:"/user/my-info" method:"get" tags:"admin" summary:"当前管理员信息"`
|
||||
}
|
||||
type MyInfoRes struct {
|
||||
Id int64 `json:"id"`
|
||||
Account string `json:"account"`
|
||||
NickName string `json:"nick_name"`
|
||||
RoleName string `json:"role_name"`
|
||||
RoleValue string `json:"role_value"`
|
||||
}
|
||||
|
||||
// ===== 用户管理 =====
|
||||
|
||||
type AdminUserItem struct {
|
||||
Id int64 `json:"id"`
|
||||
Nickname string `json:"nickname"`
|
||||
AvatarUrl string `json:"avatar_url"`
|
||||
Openid string `json:"openid"`
|
||||
LevelKey string `json:"level_key"`
|
||||
LevelName string `json:"level_name"`
|
||||
Status int `json:"status"`
|
||||
UsageCount int64 `json:"usage_count"`
|
||||
LastUsedAt string `json:"last_used_at"`
|
||||
CreatedAt string `json:"created_at"`
|
||||
}
|
||||
|
||||
type UserListReq struct {
|
||||
g.Meta `path:"/user/list" method:"get" tags:"admin" summary:"用户列表"`
|
||||
Page int `json:"page"`
|
||||
PageSize int `json:"pageSize"`
|
||||
Keyword string `json:"keyword"`
|
||||
}
|
||||
type UserListRes struct {
|
||||
List []AdminUserItem `json:"list"`
|
||||
Total int `json:"total"`
|
||||
}
|
||||
|
||||
type UserSetLevelReq struct {
|
||||
g.Meta `path:"/user/set-level" method:"post" tags:"admin" summary:"设置用户等级"`
|
||||
UserId int64 `v:"required" json:"userId"`
|
||||
LevelKey string `v:"required" json:"levelKey"`
|
||||
}
|
||||
type UserSetLevelRes struct{}
|
||||
|
||||
type UserStatusReq struct {
|
||||
g.Meta `path:"/user/status" method:"post" tags:"admin" summary:"启停用户"`
|
||||
UserId int64 `v:"required" json:"userId"`
|
||||
Status int `json:"status"`
|
||||
}
|
||||
type UserStatusRes struct{}
|
||||
|
||||
// ===== 等级管理 =====
|
||||
|
||||
type LevelItem struct {
|
||||
Id int64 `json:"id"`
|
||||
LevelKey string `json:"level_key"`
|
||||
Name string `json:"name"`
|
||||
Modules []string `json:"modules"`
|
||||
Sort int `json:"sort"`
|
||||
IsEnabled int `json:"is_enabled"`
|
||||
Remark string `json:"remark"`
|
||||
}
|
||||
|
||||
type LevelListReq struct {
|
||||
g.Meta `path:"/level/list" method:"get" tags:"admin" summary:"等级列表"`
|
||||
}
|
||||
type LevelListRes struct {
|
||||
List []LevelItem `json:"list"`
|
||||
}
|
||||
|
||||
type LevelSaveReq struct {
|
||||
g.Meta `path:"/level/save" method:"post" tags:"admin" summary:"保存等级"`
|
||||
Id int64 `json:"id"`
|
||||
LevelKey string `v:"required-if:id,0#等级标识不能为空" json:"levelKey"`
|
||||
Name string `v:"required#等级名称不能为空" json:"name"`
|
||||
Modules []string `v:"required#至少勾选一个模块" json:"modules"`
|
||||
Sort int `json:"sort"`
|
||||
IsEnabled int `json:"isEnabled"`
|
||||
Remark string `json:"remark"`
|
||||
}
|
||||
type LevelSaveRes struct{}
|
||||
|
||||
// ===== 模块管理 =====
|
||||
|
||||
type ModuleItem struct {
|
||||
Id int64 `json:"id"`
|
||||
ModuleKey string `json:"module_key"`
|
||||
Name string `json:"name"`
|
||||
Icon string `json:"icon"`
|
||||
Description string `json:"description"`
|
||||
Sort int `json:"sort"`
|
||||
IsEnabled int `json:"is_enabled"`
|
||||
ToolCount int `json:"tool_count"`
|
||||
}
|
||||
|
||||
type ModuleListReq struct {
|
||||
g.Meta `path:"/module/list" method:"get" tags:"admin" summary:"模块列表"`
|
||||
}
|
||||
type ModuleListRes struct {
|
||||
List []ModuleItem `json:"list"`
|
||||
}
|
||||
|
||||
type ModuleSaveReq struct {
|
||||
g.Meta `path:"/module/save" method:"post" tags:"admin" summary:"保存模块"`
|
||||
Id int64 `json:"id"`
|
||||
ModuleKey string `v:"required-if:id,0#模块标识不能为空" json:"moduleKey"`
|
||||
Name string `v:"required#模块名称不能为空" json:"name"`
|
||||
Icon string `json:"icon"`
|
||||
Description string `json:"description"`
|
||||
Sort int `json:"sort"`
|
||||
IsEnabled int `json:"isEnabled"`
|
||||
}
|
||||
type ModuleSaveRes struct{}
|
||||
|
||||
// ===== 工具管理 =====
|
||||
|
||||
type AdminToolItem struct {
|
||||
Id int64 `json:"id"`
|
||||
ToolKey string `json:"tool_key"`
|
||||
ModuleKey string `json:"module_key"`
|
||||
ModuleName string `json:"module_name"`
|
||||
Name string `json:"name"`
|
||||
Icon string `json:"icon"`
|
||||
Description string `json:"description"`
|
||||
Sort int `json:"sort"`
|
||||
IsEnabled int `json:"is_enabled"`
|
||||
IsHot int `json:"is_hot"`
|
||||
UsageCount int64 `json:"usage_count"`
|
||||
}
|
||||
|
||||
type ToolsListReq struct {
|
||||
g.Meta `path:"/tools/all" method:"get" tags:"admin" summary:"工具列表(全量)"`
|
||||
Page int `json:"page"`
|
||||
PageSize int `json:"pageSize"`
|
||||
ModuleKey string `json:"moduleKey"`
|
||||
Keyword string `json:"keyword"`
|
||||
IncludeDisabled bool `json:"includeDisabled"`
|
||||
}
|
||||
type ToolsListRes struct {
|
||||
List []AdminToolItem `json:"list"`
|
||||
Total int `json:"total"`
|
||||
}
|
||||
|
||||
type ToolsSaveReq struct {
|
||||
g.Meta `path:"/tools/save" method:"post" tags:"admin" summary:"保存工具"`
|
||||
Id int64 `json:"id"`
|
||||
ToolKey string `v:"required-if:id,0#工具标识不能为空" json:"toolKey"`
|
||||
ModuleKey string `v:"required#所属模块不能为空" json:"moduleKey"`
|
||||
Name string `v:"required#工具名称不能为空" json:"name"`
|
||||
Icon string `json:"icon"`
|
||||
Description string `json:"description"`
|
||||
Sort int `json:"sort"`
|
||||
IsEnabled int `json:"isEnabled"`
|
||||
IsHot int `json:"isHot"`
|
||||
}
|
||||
type ToolsSaveRes struct{}
|
||||
|
||||
type ToolsToggleReq struct {
|
||||
g.Meta `path:"/tools/toggle" method:"post" tags:"admin" summary:"工具开关"`
|
||||
Id int64 `v:"required" json:"id"`
|
||||
Field string `v:"required|in:is_enabled,is_hot" json:"field"`
|
||||
Value int `json:"value"`
|
||||
}
|
||||
type ToolsToggleRes struct{}
|
||||
|
||||
// ===== 数据看板 =====
|
||||
|
||||
type TrendItem struct {
|
||||
Date string `json:"date"`
|
||||
Count int64 `json:"count"`
|
||||
}
|
||||
|
||||
type TopItem struct {
|
||||
ToolKey string `json:"tool_key"`
|
||||
Name string `json:"name"`
|
||||
Count int64 `json:"count"`
|
||||
}
|
||||
|
||||
type DashboardStatsReq struct {
|
||||
g.Meta `path:"/dashboard/stats" method:"get" tags:"admin" summary:"看板统计"`
|
||||
}
|
||||
type DashboardStatsRes struct {
|
||||
UserCount int64 `json:"userCount"`
|
||||
TodayActive int64 `json:"todayActive"`
|
||||
TotalUsage int64 `json:"totalUsage"`
|
||||
WeekTrend []TrendItem `json:"weekTrend"`
|
||||
ToolsTop []TopItem `json:"toolsTop"`
|
||||
}
|
||||
|
||||
// ===== 反馈管理 =====
|
||||
|
||||
type FeedbackItem struct {
|
||||
Id int64 `json:"id"`
|
||||
UserId int64 `json:"user_id"`
|
||||
Content string `json:"content"`
|
||||
Contact string `json:"contact"`
|
||||
Status int `json:"status"`
|
||||
CreatedAt string `json:"created_at"`
|
||||
}
|
||||
|
||||
type FeedbackListReq struct {
|
||||
g.Meta `path:"/feedback/list" method:"get" tags:"admin" summary:"反馈列表"`
|
||||
Page int `json:"page"`
|
||||
PageSize int `json:"pageSize"`
|
||||
Status *int `json:"status"`
|
||||
}
|
||||
type FeedbackListRes struct {
|
||||
List []FeedbackItem `json:"list"`
|
||||
Total int `json:"total"`
|
||||
}
|
||||
|
||||
type FeedbackHandleReq struct {
|
||||
g.Meta `path:"/feedback/handle" method:"post" tags:"admin" summary:"标记已处理"`
|
||||
Id int64 `v:"required" json:"id"`
|
||||
}
|
||||
type FeedbackHandleRes struct{}
|
||||
Reference in New Issue
Block a user