PRD-01— 概述与架构

6 个章节 · 版本 v1.0 · 2026-05-13

文档总数4

章节总数36

功能模块25

流程图8

1. 产品概述

1.1 背景

BetCore L0 Super Admin 是面向 B2B 商户的全生命周期管理平台,服务于 Sportsbook / Casino 行业。平台运营方(L0)通过该系统管理旗下所有商户(Tenant/Merchant)从准入申请到终止的完整生命周期。

1.2 目标用户

角色	职责	典型操作
Super Admin	全权限,可执行所有操作	终止合同、密钥轮换、系统配置
Ops Manager	商户配置、上线管理、状态变更	配置模块、UAT 管理、Canary 推进
Finance	结算配置、财务报表查看	结算版本审批、授信管理
Compliance	准入审核、KYC 审查、风险管控	准入审批、冻结账户
Customer Success	沟通记录、健康评分、满意度管理	沟通记录、CS Task 创建
Implementation	资源开通、技术配置、UAT 管理	资源开通、接入参数配置、UAT 执行

1.3 核心价值

全生命周期覆盖:从申请准入到终止,全流程可追溯
多维度管控:产品授权、功能矩阵、结算配置、风险管控
强审计能力:所有高风险操作均有二次确认 + 审计日志
灰度上线:UAT → Canary → Go-Live 三阶段保障上线质量

2. 术语定义

术语	定义
Merchant / Tenant	接入平台的 B2B 客户,即运营商
GGR	Gross Gaming Revenue,总博彩收入 = 玩家投注额 - 玩家赢得额
NGR	Net Gaming Revenue,净博彩收入 = GGR - 奖金 - 退款
MMG	Minimum Monthly Guarantee,最低月保证金
MTS	Merchant Trading System,投注接受系统
Canary	灰度发布,将部分流量切到新版本进行验证
UAT	User Acceptance Testing,用户验收测试
L1 Permission	商户后台一级权限,控制商户可操作的功能模块
Health Score	商户健康度综合评分(0-100)
NPS	Net Promoter Score,净推荐值(-100 到 100)
CSAT	Customer Satisfaction Score,客户满意度评分(1-5)
Negative Carryover	负结余结转,当期 GGR 为负时是否结转到下期
Revenue Share	收益分成模式,按 GGR 比例分成
Fixed Fee	固定费用模式,按月收取固定金额
Hybrid	混合模式,固定费用 + 收益分成
Tier	分层区间,用于结算分层计算

3. 整体架构与导航

3.1 一级导航结构

Dashboard
Merchant Management
  ├── Overview(商户总览)
  ├── Merchant List(商户列表)
  ├── Admission(准入审核)
  ├── Launch Board(上线看板)
  └── Audit Log(审计日志)
Country / Region Config
Risk & Compliance
Reporting & Finance
Game & Provider
Alert Center
System Settings

3.2 商户详情 Tab 结构

Merchant Detail (/merchant/detail/:id)
  ├── Overview(概览)—— KPI 卡片、快速操作
  ├── Basic Info(基本信息)—— 公司信息、联系人
  ├── Commercial(商务信息)—— 合同、结算条款
  ├── Product & Feature(产品与功能)—— 授权、功能开关
  ├── Integration(接入信息)—— 域名、密钥、依赖
  ├── Launch(上线进度)—— UAT/Canary/Go-Live 状态
  ├── Success(客户成功)—— 健康评分、沟通记录
  └── Logs(操作日志)—— 变更历史

3.3 配置模块入口(Configure Drawer)

从商户列表或详情页点击 Configure 按钮,弹出配置抽屉,包含 20 个配置模块,按阶段分组:

配置阶段(Configuring)

Contract → Onboarding → Subscription → Product Licensing
→ Feature Matrix → L1 Permission → Game Access
→ Sportsbook Config → Settlement → Dependency Config
→ Integration Params

上线阶段(Launch)

UAT → Canary → Go-Live

运营阶段(Post-Live)

Communication → Health Score → Satisfaction Survey
→ Version Upgrade → Status Control → Migration

4. 商户生命周期状态机

4.1 状态定义

状态	颜色	说明	可执行操作
Draft	灰色	草稿,申请未提交	编辑、提交申请
Pending Review	橙色	待审核	审核(通过/拒绝/补充材料)
Configuring	蓝色	配置中	所有配置模块操作、开始 UAT
In UAT	紫色	UAT 测试中	管理测试用例、进入 Canary
Canary	青色	灰度发布中	监控指标、推进/暂停/回滚
Ready for Go-Live	黄色	待上线	确认上线
Live	绿色	已上线(脉冲动画)	配置变更、冻结、暂停
Frozen	灰色	已冻结	解冻、终止
Suspended	红色	已暂停	恢复、终止
Terminated	深灰	已终止	仅查看(不可恢复)

4.2 状态流转规则

Draft ──提交申请──► Pending Review
                         │
              ┌──────────┼──────────┐
              ▼          ▼          ▼
           Approved   Rejected  Need Supplement
              │                     │
              │                  补充后重提交
              ▼                     │
         Configuring ◄──────────────┘
              │
         开始 UAT
              │
           In UAT
              │
         P0/P1 全通过
              │
           Canary
              │
         Promote to Go-Live
              │
       Ready for Go-Live
              │
         Confirm Go-Live
              │
            Live ◄──────────────────────────────┐
              │                                  │
         ┌────┴────┐                             │
         ▼         ▼                             │
       Frozen   Suspended                        │
         │         │                             │
       解冻       恢复 ──────────────────────────┘
         │         │
         └────┬────┘
              ▼
          Terminated(不可逆)

4.3 Go-Live Status(上线进度子状态)

子状态	对应主状态	说明
Not Started	Draft / Pending Review	尚未开始上线流程
Integration	Configuring	正在进行技术接入
UAT	In UAT	UAT 测试进行中
UAT Passed	In UAT(通过后)	UAT 全部通过
Canary	Canary	灰度发布中
Go-Live Pending	Ready for Go-Live	等待确认上线
Live	Live	已正式上线

5. 权限矩阵

操作	Super Admin	Ops Manager	Finance	Compliance	CS	Implementation
查看商户列表	✓	✓	✓	✓	✓	✓
创建商户申请	✓	✓	-	-	-	-
审核准入申请	✓	✓	✓	✓	-	-
配置合同	✓	✓	✓	-	-	-
配置结算	✓	-	✓	-	-	-
配置产品授权	✓	✓	-	-	-	✓
配置 Sportsbook	✓	✓	-	-	-	✓
配置接入参数	✓	✓	-	-	-	✓
查看 Secret Key	✓	✓	-	-	-	-
Rotate Key	✓	-	-	-	-	-
管理 UAT	✓	✓	-	-	-	✓
管理 Canary	✓	✓	-	-	-	-
Confirm Go-Live	✓	✓	-	-	-	-
Freeze 商户	✓	✓	-	✓	-	-
Suspend 商户	✓	✓	-	-	-	-
Terminate 商户	✓	-	-	-	-	-
查看审计日志	✓	✓	✓	✓	✓	✓
导出审计日志	✓	✓	✓	✓	-	-
管理沟通记录	✓	✓	-	-	✓	-
管理健康评分	✓	✓	-	-	✓	-
执行迁移	✓	-	-	-	-	✓

6. 非功能性需求

6.1 性能要求

场景	要求
商户列表加载	< 1s(100条数据)
审计日志查询	< 2s(百万级数据)
Canary 监控刷新	每 3 秒自动刷新
密钥轮换操作	< 5s 完成
迁移进度更新	实时(WebSocket 或轮询)

6.2 安全要求

要求	说明
高风险操作二次确认	Freeze / Suspend / Terminate / Rotate Key 均需二次确认
Secret Key 访问审计	每次查看 Secret Key 必须写入审计日志
操作 IP 记录	所有写操作记录操作人 IP
会话超时	30分钟无操作自动登出
敏感字段遮掩	Secret Key / Webhook Secret 默认遮掩显示

6.3 可用性要求

要求	说明
系统可用性	99.9%(月度)
计划维护窗口	每周日 02:00-04:00 UTC
数据备份	每日全量备份,保留 90 天
审计日志保留	最少 2 年

6.4 合规要求

要求	说明
审计追踪	所有数据变更必须有完整审计记录
不可篡改	审计日志不可修改或删除
数据隔离	不同商户数据严格隔离
GDPR	支持数据导出和删除请求

BetCore L0 Super Admin — 租户管理 PRD-01

概述与架构 | 版本 v1.0 | 2026-05-13