lq/qitongxue-api
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

小程序一些功能更新

Browse Source
This commit is contained in:
李琦
2026-09-29 10:57:01 +08:00
parent 0cb70a7618
commit 3bb7fa8db3
96 changed files with 13890 additions and 213 deletions
Download Patch File Download Diff File Expand all files Collapse all files

191
api/admin/v1/admin.go
View File

@@ -21,13 +21,95 @@ 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"`
Permissions []string `json:"permissions"` // T17：当前角色拥有的权限点，前端据此隐藏入口
}
// ===== 管理员管理（T17）=====
type AdminItem struct {
Id int64 `json:"id"`
Account string `json:"account"`
NickName string `json:"nick_name"`
RoleName string `json:"role_name"`
RoleValue string `json:"role_value"`
Status int `json:"status"`
CreatedAt string `json:"created_at"`
}
type AdminListReq struct {
g.Meta `path:"/admin/list" method:"get" tags:"admin" summary:"管理员列表"`
}
type AdminListRes struct {
List []AdminItem `json:"list"`
}
type AdminSaveReq struct {
g.Meta `path:"/admin/save" method:"post" tags:"admin" summary:"新增/修改管理员"`
Id int64 `json:"id"`
Account string `json:"account"` // 新增必填；编辑时不可改
Password string `json:"password"`
NickName string `json:"nick_name"`
RoleName string `json:"role_name"`
RoleValue string `json:"role_value" v:"required|in:super,operator,readonly#角色非法"`
}
type AdminSaveRes struct{}
type AdminStatusReq struct {
g.Meta `path:"/admin/status" method:"post" tags:"admin" summary:"启停管理员"`
Id int64 `v:"required" json:"id"`
Status int `json:"status"`
}
type AdminStatusRes struct{}
// ===== 操作审计（T17）=====
type AuditItem struct {
Id int64 `json:"id"`
AdminId int64 `json:"admin_id"`
AdminAccount string `json:"admin_account"`
AdminName string `json:"admin_name"`
RoleValue string `json:"role_value"`
Action string `json:"action"`
TargetType string `json:"target_type"`
TargetId string `json:"target_id"`
BeforeJson string `json:"before_json"`
AfterJson string `json:"after_json"`
Result int `json:"result"`
Remark string `json:"remark"`
Ip string `json:"ip"`
CreatedAt string `json:"created_at"`
}
type AuditListReq struct {
g.Meta `path:"/audit/list" method:"get" tags:"admin" summary:"操作审计列表"`
Page int `json:"page"`
PageSize int `json:"pageSize"`
AdminKeyword string `json:"adminKeyword"` // 操作人账号模糊匹配
Action string `json:"action"` // 模糊匹配
Result *int `json:"result"` // nil=全部
DateFrom string `json:"dateFrom"` // YYYY-MM-DD
DateTo string `json:"dateTo"` // YYYY-MM-DD
}
type AuditListRes struct {
List []AuditItem `json:"list"`
Total int `json:"total"`
}
// AuditRecordReq 前端主动上报审计（如「导出」为纯前端动作，服务端无法感知）
type AuditRecordReq struct {
g.Meta `path:"/audit/record" method:"post" tags:"admin" summary:"上报一条操作审计"`
Action string `v:"required" json:"action"`
TargetType string `json:"target_type"`
TargetId string `json:"target_id"`
Remark string `json:"remark"`
}
type AuditRecordRes struct{}
// ===== 用户管理 =====
type AdminUserItem struct {
@@ -50,6 +132,17 @@ type UserListReq struct {
Page int `json:"page"`
PageSize int `json:"pageSize"`
Keyword string `json:"keyword"`
// ===== T16 多条件筛选 =====
LevelKey string `json:"levelKey"` // 按等级筛选（空=全部）
Status *int `json:"status"` // 按状态筛选（nil=全部，0/1 精确匹配）
DateFrom string `json:"dateFrom"` // 注册时间范围起（YYYY-MM-DD）
DateTo string `json:"dateTo"` // 注册时间范围止（YYYY-MM-DD）
// ===== T16 排序（sortBy 走白名单，非法值回落默认）=====
SortBy string `json:"sortBy"` // id/created_at/level_key/status
SortOrder string `json:"sortOrder"` // asc/desc
// ===== T04.6 会员到期筛选 =====
// expiring7 | expiring30 | expired | forever | none | 空
MemberExpire string `json:"memberExpire"`
}
type UserListRes struct {
List []AdminUserItem `json:"list"`
@@ -60,6 +153,10 @@ 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"`
// ExpireAt 到期时间；**空 = 永久（写 NULL）**。
// 续费/开通时不得把已存在的 NULL（永久）覆写成有限期（约定 S10）。
ExpireAt string `json:"expireAt"`
Remark string `json:"remark"`
}
type UserSetLevelRes struct{}
@@ -89,10 +186,13 @@ type LevelListRes struct {
List []LevelItem `json:"list"`
}
// LevelSaveReq 保存等级。
// 注意：LevelKey 是跨端契约字段（小程序按它判定权益），**任何情况必填**；
// 编辑路径同样要回传原值（服务端会校验其与库中一致，不允许变更）。
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"`
LevelKey string `v:"required#等级标识不能为空" json:"levelKey"`
Name string `v:"required#等级名称不能为空" json:"name"`
Modules []string `v:"required#至少勾选一个模块" json:"modules"`
Sort int `json:"sort"`
@@ -159,6 +259,12 @@ type ToolsListReq struct {
ModuleKey string `json:"moduleKey"`
Keyword string `json:"keyword"`
IncludeDisabled bool `json:"includeDisabled"`
// ===== T16 多条件筛选 =====
IsEnabled *int `json:"isEnabled"` // 按上下架筛选（nil=不限）
IsHot *int `json:"isHot"` // 按推荐位筛选（nil=不限）
// ===== T16 排序（sortBy 走白名单，非法值回落默认）=====
SortBy string `json:"sortBy"` // id/sort/usage_count/is_enabled/is_hot/name/module_key
SortOrder string `json:"sortOrder"` // asc/desc
}
type ToolsListRes struct {
List []AdminToolItem `json:"list"`
@@ -203,15 +309,55 @@ type TopItem struct {
Count int64 `json:"count"`
}
// AmountItem 金额趋势点（T16）：cents 为「分」，避免浮点误差。
type AmountItem struct {
Date string `json:"date"`
Cents int64 `json:"cents"`
}
// LevelDistItem 等级分布项（T16）
type LevelDistItem struct {
LevelKey string `json:"level_key"`
Name string `json:"name"`
Count int64 `json:"count"`
}
// DistItem 通用分布项（T16）：key 机读，label 展示
type DistItem struct {
Key string `json:"key"`
Label string `json:"label"`
Value int64 `json:"value"`
}
type DashboardStatsReq struct {
g.Meta `path:"/dashboard/stats" method:"get" tags:"admin" summary:"看板统计"`
}
// DashboardStatsRes 看板统计响应。
//
// ⚠️ 历史豁免（S1 例外）：本结构体出参为 **camelCase**（userCount / revenueCents /
// quotaFreeUsed …），系与前端 qitongxue-admin/src/views/dashboard/Dashboard.vue 一致
// 约定的**既有接口**，**勿单独改成 snake_case** —— 改动必须前后端同步，否则会直接打断看板。
// 注意本接口键风格本身**不对称**：顶层键为 camelCase，而嵌套项为 snake_case
// （如 levelDist 元素读 level_key / name / count，见 Dashboard.vue:108）。
// 豁免**仅限已列明的既有接口，不得新增**：新增接口一律 snake_case（铁律 S1）。
type DashboardStatsRes struct {
UserCount int64 `json:"userCount"`
TodayActive int64 `json:"todayActive"`
TotalUsage int64 `json:"totalUsage"`
WeekTrend []TrendItem `json:"weekTrend"`
ToolsTop []TopItem `json:"toolsTop"`
// ===== T16 指标扩充（全部后端聚合，前端不再拉全量自算）=====
MemberCount int64 `json:"memberCount"` // 当前有效会员数（有到期时间且未过期、等级高于默认）
OrderCount int64 `json:"orderCount"` // 已发货订单数
RevenueCents int64 `json:"revenueCents"` // 累计收入（已发货订单金额，分）
RevenueTrend []AmountItem `json:"revenueTrend"` // 近 7 日收入趋势（分，缺失补 0）
QuotaFreeUsed int64 `json:"quotaFreeUsed"` // 本周期免费额度已用合计
QuotaMemberUsed int64 `json:"quotaMemberUsed"` // 本周期会员额度已用合计
QuotaPaidUsed int64 `json:"quotaPaidUsed"` // 付费额度累计已消耗（次数包)
LevelDist []LevelDistItem `json:"levelDist"` // 各等级用户分布
OrderDist []DistItem `json:"orderDist"` // 订单构成（会员套餐 / 次数包）
}
// ===== 反馈管理 =====
@@ -241,3 +387,46 @@ type FeedbackHandleReq struct {
Id int64 `v:"required" json:"id"`
}
type FeedbackHandleRes struct{}
// ===== 批量操作（T15）=====
//
// 统一契约：请求 ids + action(+参数)，响应「部分成功」结果：
//
// success 成功的条数
// failed 失败的条数
// failures 失败明细（id + 原因），用于前端逐条展示
//
// 语义：幂等（重复提交同一批得到同样结果）；不存在的 id 计入 failed 而非整体报错。
// BatchFailure 单条失败明细
type BatchFailure struct {
Id int64 `json:"id"`
Reason string `json:"reason"`
}
// UserBatchReq 批量操作用户：action=status（启停）/ level（改等级）/ delete（软删除，可恢复）
type UserBatchReq struct {
g.Meta `path:"/user/batch" method:"post" tags:"admin" summary:"批量操作用户"`
Ids []int64 `v:"required|min-length:1#请选择要操作的用户" json:"ids"`
Action string `v:"required|in:status,level,delete#动作非法" json:"action"`
Status int `json:"status"` // action=status 时使用（0/1）
LevelKey string `json:"level_key"` // action=level 时使用
}
type UserBatchRes struct {
Success int `json:"success"`
Failed int `json:"failed"`
Failures []BatchFailure `json:"failures"`
}
// ToolsBatchReq 批量操作工具：action=is_enabled / is_hot / delete（软删除，可恢复）
type ToolsBatchReq struct {
g.Meta `path:"/tools/batch" method:"post" tags:"admin" summary:"批量操作工具"`
Ids []int64 `v:"required|min-length:1#请选择要操作的工具" json:"ids"`
Action string `v:"required|in:is_enabled,is_hot,delete#动作非法" json:"action"`
Value int `json:"value"` // 0/1
}
type ToolsBatchRes struct {
Success int `json:"success"`
Failed int `json:"failed"`
Failures []BatchFailure `json:"failures"`
}