统一游戏平台 · 07

🖥️ 管理后台:一个后台管全系列

Vite + Vue3 SPA,托管在 Cloudflare Pages,Cloudflare Access(邮箱白名单)做第一道门,自有 JWT + RBAC 做第二道门,调用 VPS 上的 /admin/v1/* API。运营无需登服务器即可完成:看数据、调配置、处理用户与订单。

1. 模块总览

模块核心功能读的表 / 写的表最低角色
📊 数据看板大盘 + 单游戏钻取(见 §2 指标)stats_daily、events 聚合(只读)readonly
👤 用户管理按 openid/昵称/user_id 查用户;看资料/钱包/流水/存档/订单/风控分;封禁/禁言/调余额(双人复核)users、wallets、currency_txns(写:status、admin_adjust 流水)ops(调余额需 superadmin 复核)
💾 存档查询/修复查看任意用户任意游戏的 saves JSON;客诉时手工修复(表单编辑 + diff 预览);修复即 version+1 并落审计saves(写)ops
🎮 游戏库管理games 表 CRUD:上下架、排序、NEW 角标、逐款 config(体力/scoreMax/广告场景);改 config 即全量生效,无需发版games(写)ops
🛒 商品与订单products CRUD(价格/内容物/限购/上下架);订单查询、异常单补发货、退款标记、日对账报表(平台账单 vs orders)products、orders(写:补发货走标准发货事务)ops / 对账 readonly
🔗 分享数据分享漏斗(发起→回流→达成)、文案 A/B 胜率、回流拉新数、疑似刷量列表(同 IP 段聚集)share_records、share_visits(只读 + 拉黑写 risk)readonly
🏆 排行榜管理各游戏各赛季榜单、待复核高分队列(03 §5 风控标记)、删除作弊分、赛季手动结算兜底leaderboard_scores(写)、Redis 同步失效ops
⚙️ 配置与活动app_configs 可视化编辑:公告、首充弹窗开关、双通道场景配置(05 §4 表就是这里的编辑界面)、分享/广告每日限额、卡点参数(M6 日程调参入口)app_configs(写,带版本历史可回滚)ops
🔐 系统管理admin_users 与角色、审计日志查询、API 健康状态(探活结果)admin_users、audit_logssuperadmin

2. 数据看板指标(直接对齐 v2 验收基准)

2.1 大盘日报(首屏)

指标口径对标线(v2)
DAU / 新增 / 次留 / D7events.session_start 去重;次留=昨日新增今日回访中国 IAA 活跃次留 ≥40% 为优质(G6)
人均激励视频次数ad_complete / DAU及格 3 / 良好 5–8 / 优秀 10+
广告渗透率看过 ≥1 次激励视频的 DAU 占比及格 40% / 良好 60%
分享发起率 / 回流率share_create/DAU;share_visit/share_create回流拉新计入 K 因子
付费率 / ARPPU / 首充转化(阶段 4 起)付费 UV/DAU;GMV/付费 UV;首充购买/首充弹窗曝光付费率及格 1%、首充转化及格 2%(v2 3.6)
签到率 / streak 分布signins/DAU;current_streak 直方图7 天+ streak 用户占比是留存先行指标

2.2 单游戏钻取页

3. 权限模型(RBAC)

角色能力约束
readonly全部只读(看板、查询)
opsreadonly + 游戏库/配置/商品/榜单/存档修复/封禁所有写操作落 audit_logs;配置改动可回滚
superadminops + 调余额复核、admin 账号管理、退款标记调余额需第二名 superadmin 复核通过才执行(双人规则)

登录链路:CF Access 验证邮箱(Google/OTP)→ SPA 载入 → 用 Access JWT 换自有 admin JWT(服务端校验邮箱在 admin_users 且 status 正常)→ 按角色渲染菜单。红线 /admin/v1 与业务 API 同进程但独立密钥、独立限频,且仅接受来自 Cloudflare 的回源 IP 段(Nginx 白名单),防止扫到直连。

4. 关键页面线框(两例)

【用户详情页】
┌ 用户 #10086 · 微信 · 省份:广东 · risk:0 ──────── [封禁] [禁言] ┐
│ 钱包: 💰12,400  💎38  ⚡3/5        [调整余额(需复核)]           │
│ Tab: 流水 | 存档 | 订单 | 分享 | 设备                            │
│ 流水: 07-09 12:01  gem -10  consume_revive  g14   余额38        │
│       07-09 11:58  coin +200 ad_reward      g14   余额12,400   │
└ 存档: g14_mohei v17 (64KB内) [查看JSON] [修复(diff预览)]         ┘

【双通道场景配置页】(app_configs 可视化 = 05 §4 表)
┌ scene: revive ─────────────────────────────────┐
│ 通道: [✓]ad 每日6次  [✓]share 每日3次  [ ]pay    │
│ 平台覆盖: wx(全开) tt(share→sidebar)             │
│ [保存并生效]  历史版本: v3 07-08 ops@a  [回滚]     │
└────────────────────────────────────────────────┘

5. 交付边界