fix: resolve frontend build error and order refund bug, add member price filter

This commit is contained in:
2026-01-07 21:49:04 +08:00
parent 5b45f7d5c4
commit a1de16bc01
18 changed files with 772 additions and 282 deletions

148
docs/superadmin_plan.md Normal file
View File

@@ -0,0 +1,148 @@
# 超级管理员后台功能规划(按页面拆解)
> 目标:基于现有 `/super/v1/*` 能力,补齐平台级“管理 + 统计”闭环。以下按页面拆分,分别给出管理动作、统计指标与接口对照。
## 0) 全局约定
- **鉴权**`Authorization: Bearer <token>`;登录后本地持久化 token。
- **路由基座**`/super/`前端API 基座 `/super/v1`
- **分页**:统一 `page/limit`,响应为 `requests.Pager`
- **枚举**:优先取 `/super/v1/tenants/statuses``/super/v1/users/statuses`
## 1) 登录 `/auth/login`
- 管理功能账号登录、token 写入、自动续期。
- 统计功能可选记录登录失败次数、IP、设备指纹审计
- 现有接口:
- `POST /super/v1/auth/login`(需补齐实现)
- `GET /super/v1/auth/token`token 校验/续期)
## 2) 概览 Dashboard `/`
- 管理功能:快捷入口(租户/用户/订单/内容)。
- 统计指标(建议):
- 租户总数/活跃数/过期数
- 用户总数/活跃数(按状态拆分)
- 订单数/成交额/退款额(按日、按状态)
- 内容总数/新增内容/被封禁内容
- 现有接口:
- `GET /super/v1/users/statistics`(需补齐实现)
- `GET /super/v1/orders/statistics`(需补齐实现)
- `GET /super/v1/tenants?limit=1&page=1`(可取 total
- `GET /super/v1/contents?limit=1&page=1`(可取 total
## 3) 租户管理 `/superadmin/tenants`
- 管理功能:
- 新建租户(绑定管理员)
- 更新租户状态(正常/禁用)
- 续期/变更过期时间
- 统计指标:
- 状态分布(待审核/正常/禁用)
- 即将过期租户数7/30 天)
- 租户 GMV Top N需补接口
- 现有接口:
- `POST /super/v1/tenants`
- `GET /super/v1/tenants`
- `PATCH /super/v1/tenants/{tenantID}/status`
- `PATCH /super/v1/tenants/{tenantID}`(续期)
- `GET /super/v1/tenants/statuses`
## 4) 租户详情 `/superadmin/tenants/:tenantID`
- 管理功能(建议):
- 基本信息/状态/过期时间编辑
- 管理员与成员列表(角色管理)
- 内容列表、订单列表、资金汇总
- 统计指标(建议):
- 租户用户数、内容数、订单数、GMV
- 现有接口:
- `GET /super/v1/tenants/{tenantID}`(已有)
- 建议补充接口:
- `GET /super/v1/tenants/{tenantID}/users`
- `GET /super/v1/tenants/{tenantID}/contents`
- `GET /super/v1/tenants/{tenantID}/orders`
- `GET /super/v1/tenants/{tenantID}/statistics`
## 5) 用户管理 `/superadmin/users`
- 管理功能:
- 用户列表筛选(用户名/状态/角色/所属租户)
- 状态变更、角色授予
- 统计指标:
- 用户状态统计(已提供)
- 现有接口:
- `GET /super/v1/users`
- `PATCH /super/v1/users/{userID}/status`
- `PATCH /super/v1/users/{userID}/roles`
- `GET /super/v1/users/statistics`
- `GET /super/v1/users/statuses`
## 6) 用户详情 `/superadmin/users/:userID`
- 管理功能(建议):
- 用户资料、角色、状态
- 用户所属/拥有租户列表
- 用户订单与内容购买记录
- 统计指标(建议):
- 用户消费总额、退款次数
- 现有接口:
- `GET /super/v1/users/{userID}`(已有)
- 建议补充接口:
- `GET /super/v1/users/{userID}/tenants`
- `GET /super/v1/users/{userID}/orders`
- `GET /super/v1/users/{userID}/contents`
## 7) 订单管理 `/superadmin/orders`
- 管理功能:
- 订单列表(按租户/用户/状态/时间过滤)
- 退款操作(平台侧)
- 统计指标:
- 订单状态分布、GMV、退款额
- 现有接口:
- `GET /super/v1/orders`
- `POST /super/v1/orders/{orderID}/refund`(需补齐实现)
- `GET /super/v1/orders/statistics`(需补齐实现)
## 8) 订单详情 `/superadmin/orders/:orderID`
- 管理功能:
- 查看订单快照、支付信息、退款信息
- 退款/强制关闭
- 现有接口:
- `GET /super/v1/orders/{orderID}`(需补齐实现)
## 9) 内容管理 `/superadmin/contents`
- 管理功能:
- 跨租户内容列表
- 内容状态更新(封禁/下架)
- 统计指标:
- 内容状态分布、热门内容 Top N
- 现有接口:
- `GET /super/v1/contents`
- `PATCH /super/v1/tenants/{tenantID}/contents/{contentID}/status`
## 10) 财务/提现(可选)
- 管理功能:
- 提现订单审核(通过/驳回)
- 记录操作原因
- 统计指标:
- 提现订单数、金额、失败率
- 现有接口:无(服务层有 `ListWithdrawals/Approve/Reject`,需补 controller + route
## 11) 审计日志 / 操作记录(建议)
- 管理功能:
- 展示后台操作日志(操作人、对象、动作、时间)
- 支持导出
- 现有接口:无(可基于 `services.Audit` 扩展)
## 12) 系统配置 / 平台策略(建议)
- 管理功能:
- 平台佣金比例、内容审核策略、默认到期策略
- 现有接口:无(需新增配置表与接口)