# 超级管理员后台功能规划（与当前系统功能对齐）

> 目标：在不脱离现有后端能力的前提下，确保“系统已有功能超管可介入管理”，并通过统一入口、跨租户筛选与批量操作提升运营效率。

## 0) 设计原则

- **全量可管**：覆盖租户、用户、内容、订单、优惠券、钱包、提现、上传、通知等现有能力。
- **便捷优先**：跨租户统一筛选、全局搜索、批量处理、审核队列，减少重复跳转。
- **风险可控**：默认只读，危险操作需二次确认，动作全量记录。
- **接口对齐**：优先复用 `/super/v1/*` 现有能力，其它模块按“超管包装层”补齐。

## 1) 当前系统能力地图（基于现有路由）

- **租户与成员**：租户列表/详情、创建、状态变更、续期、健康检查、成员关注/加入/邀请。
- **用户与认证**：登录/OTP、资料更新、实名、钱包/充值、订单、收藏/点赞、通知、优惠券。
- **内容与互动**：内容列表/详情、话题、评论、点赞/收藏。
- **创作者与运营**：申请、内容 CRUD、优惠券 CRUD/发放、成员审核/邀请、订单与退款、报表、提现、结算账户、设置。
- **交易与支付**：订单创建/支付/状态、支付回调。
- **资产与存储**：分片/直传上传、哈希检查、上传完成、媒体资产删除、存储签名上传/下载。

## 2) 超管平台页面规划（按业务域）

### 2.1 登录与权限 `/auth/login`
- **功能**：登录、token 续期、权限校验。
- **接口**：`POST /super/v1/auth/login`，`GET /super/v1/auth/token`。

### 2.2 平台概览 `/`
- **功能**：核心指标、异常概览、快捷入口。
- **接口**：`GET /super/v1/users/statistics`，`GET /super/v1/orders/statistics`，`GET /super/v1/tenants`（count），`GET /super/v1/contents`（count）。
- **缺口**：平台级内容/订单趋势、退款率、提现统计。

### 2.3 租户管理 `/superadmin/tenants`
- **功能**：租户列表、创建、状态变更、续期、健康检查。
- **接口**：`GET/POST /super/v1/tenants`，`PATCH /super/v1/tenants/:id/status`，`PATCH /super/v1/tenants/:id`，`GET /super/v1/tenants/health`，`GET /super/v1/tenants/statuses`。

### 2.4 租户详情 `/superadmin/tenants/:tenantID`
- **功能**：租户信息、成员、内容、订单、资金与运营概览。
- **接口**：`GET /super/v1/tenants/:id`，`GET /super/v1/tenants/:tenantID/users`，`GET /super/v1/tenants/:tenantID/contents`，`GET /super/v1/orders`（按 tenant_id 过滤）。
- **缺口**：租户成员邀请/审核、租户级财务/报表聚合。

### 2.5 用户管理 `/superadmin/users`
- **功能**：用户列表、状态/角色、关联租户、账户概要（余额/冻结/实名认证）。
- **接口**：`GET /super/v1/users`，`PATCH /super/v1/users/:id/status`，`PATCH /super/v1/users/:id/roles`，`GET /super/v1/users/statistics`，`GET /super/v1/users/statuses`。
- **缺口**：实名信息、钱包明细、通知、优惠券、充值记录等超管视图接口。

### 2.6 用户详情 `/superadmin/users/:userID`
- **功能**：资料、角色、加入/拥有租户、订单与内容消费、收藏/点赞/关注、优惠券与通知。
- **接口**：`GET /super/v1/users/:id`，`GET /super/v1/users/:id/tenants`，`GET /super/v1/orders`（按 user_id 过滤）。
- **缺口**：用户钱包/通知/优惠券明细需要新接口。

### 2.7 内容治理 `/superadmin/contents`
- **功能**：跨租户内容列表、审核、状态变更、违规处置。
- **接口**：`GET /super/v1/contents`，`POST /super/v1/contents/:id/review`，`PATCH /super/v1/tenants/:tenantID/contents/:contentID/status`。
- **缺口**：评论治理、内容举报、内容资产明细（若需要）。

### 2.8 订单与退款 `/superadmin/orders`
- **功能**：订单列表、退款/强制退款、问题订单标记、支付状态核对。
- **接口**：`GET /super/v1/orders`，`GET /super/v1/orders/:id`，`POST /super/v1/orders/:id/refund`。

### 2.9 创作者与成员审核 `/superadmin/creators`
- **功能**：创作者申请审核、成员加入审核/邀请、创作者设置查看、提现与结算账户审核。
- **接口**：租户级 `POST /t/:tenantCode/v1/creator/apply`、`POST /t/:tenantCode/v1/creator/members/:id/review`、`POST /t/:tenantCode/v1/creator/members/invite`、`GET /t/:tenantCode/v1/creator/payout-accounts`、`POST /t/:tenantCode/v1/creator/withdraw`。
- **缺口**：超管跨租户管理接口（建议新增 `/super/v1/creators/*`）。

### 2.10 优惠券 `/superadmin/coupons`
- **功能**：跨租户优惠券列表、状态变更、发放记录、异常核查。
- **接口**：租户级 `GET/POST/PUT /t/:tenantCode/v1/creator/coupons`、`POST /t/:tenantCode/v1/creator/coupons/:id/grant`、用户侧 `/t/:tenantCode/v1/me/coupons*`。
- **缺口**：超管聚合查询与冻结/归档接口。

### 2.11 财务与钱包 `/superadmin/finance`
- **功能**：提现审核、用户钱包概况、异常充值/退款排查。
- **接口**：租户级 `POST /t/:tenantCode/v1/creator/withdraw`、用户侧 `GET/POST /t/:tenantCode/v1/me/wallet*`。
- **缺口**：超管提现列表与审批接口、钱包流水接口。

### 2.12 报表与导出 `/superadmin/reports`
- **功能**：跨租户报表、导出运营数据（订单、内容、退款、提现）。
- **接口**：租户级 `GET /t/:tenantCode/v1/creator/reports/overview`、`POST /t/:tenantCode/v1/creator/reports/export`。
- **缺口**：超管聚合与导出接口。

### 2.13 资产与上传 `/superadmin/assets`
- **功能**：上传记录、媒体资产清理、异常上传排查、存储用量。
- **接口**：租户级 `POST /t/:tenantCode/v1/upload/*`、`DELETE /t/:tenantCode/v1/media-assets/:id`、`/t/:tenantCode/v1/storage/*`。
- **缺口**：资产列表/用量统计/跨租户查询接口。

### 2.14 通知与消息 `/superadmin/notifications`
- **功能**：通知查看、批量触达、模板管理。
- **接口**：用户侧 `GET /t/:tenantCode/v1/me/notifications`。
- **缺口**：超管发送与批量触达接口、通知模板管理接口。

## 3) 导航与便捷性设计（建议）

- 统一筛选器：租户/用户/时间/状态为默认筛选维度。
- 快捷入口：租户详情可直接跳转到用户/内容/订单/提现。
- 审核队列：内容审核、退款、创作者申请、提现审核统一入口。

## 4) 推进顺序（与现有接口匹配）

- **P0（已有接口即可落地）**：登录、概览、租户管理、用户管理、内容治理、订单退款。
- **P1（需补超管接口）**：创作者审核、优惠券、提现/钱包、报表导出。
- **P2（扩展增强）**：资产/上传、通知中心、审计与系统配置。
