7.0 KiB
7.0 KiB
超级管理员后台功能规划（与当前系统功能对齐）
目标：在不脱离现有后端能力的前提下，确保“系统已有功能超管可介入管理”，并通过统一入口、跨租户筛选与批量操作提升运营效率。
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。 - 缺口：超管发送与批量触达接口、通知模板管理接口。
2.15 健康与告警 /superadmin/health
- 功能：平台健康总览、失败率/超时/风险租户聚合、告警列表。
- 接口：
GET /super/v1/health/overview、GET /super/v1/tenants/health（租户级健康明细）。 - 缺口：后续可补充告警订阅与自动化处理规则。
3) 导航与便捷性设计（建议）
- 统一筛选器：租户/用户/时间/状态为默认筛选维度。
- 快捷入口：租户详情可直接跳转到用户/内容/订单/提现。
- 审核队列：内容审核、退款、创作者申请、提现审核统一入口。
4) 推进顺序（与现有接口匹配）
- P0（已有接口即可落地）：登录、概览、租户管理、用户管理、内容治理、订单退款。
- P1（需补超管接口）：创作者审核、优惠券、提现/钱包、报表导出。
- P2（扩展增强）：资产/上传、通知中心、审计与系统配置、健康与告警。