17 · 数据看板系统

0. 文档说明

项	内容
版本	V1.0

只读层。聚合 13 流水与各系统快照,嵌入 15 后台为模块;不产生任何业务写操作。

---

一、定位与职责

• 商户报表(商户控制台):本站运营全景 —— 用户、资金、游戏、成本、转化、推广;
• 平台经营视图(平台控制台):跨租户健康度、活跃、包网费结算依据;
• 定义指标口径(平台统一、租户不可改,保证跨站可比)与聚合链路。

按币种分列铁律(与 00 §4.2/02 一致,区分两个层级):

• 单站内 = 单币种(本位币):一租户 = 一「本位币站」,站内全链路单币种;商户报表金额一律本位币单口径,天然无跨币种加总问题(站内无「按币种切 tab」的分币种视图,统一本位币口径)。
• 跨站 = 多币种:平台跨租户视图汇聚不同站(不同本位币),一切金额指标按币种分列、严禁跨币种加总——此能力明确保留。任何跨站「总营收」类数字必须带币种维度;平台侧统一参考口径仅限 B2B 计费结算合计——见 billing_statements.fx_snapshot(§八):按 settlement_currency + 当期参考汇率快照给合计,明确标注「参考口径 · B2B 平台对商户结算用 · 不回流任何用户业务」(区别于用户资金无汇率铁律)。
• 展示铁律:已发生金额永远带出生币种、不重标、不换算;禁止「数字不变只换符号」的渲染。

---

二、核心概念与数据模型

2.1 指标域(商户报表 —— 单站,金额一律本位币 × 日单口径)

域	核心指标
用户	注册数、DAU、留存(次日/7日)、转化漏斗(注册→首充→复充)
资金	充值额/笔数、提现额/笔数、净入金、通道成功率(充提金额为本位币入账值,通道币种原值可下钻)
游戏	有效投注、GGR(总输赢)、NGR(唯一定义见 §2.3 / metric_defs)、Top 游戏/厂商;按场馆链路 route(原生/CNY 映射)可分档(中性对账维度)
成本	优惠发放(09)、俸禄(07)、返水(08)、任务(10)、佣金(11)—— 即 RewardClaimed/BONUS_GRANT 按 source 聚合
推广	邀请注册数、代理贡献流水、佣金支出
风控	拦截量、工单量、没收金额(14)

2.2 聚合链路

明细(13 账本 / 12 注单 / 03·04 订单 / claim_records)
   ─ T+1 离线聚合(日切后跑批,与 13 对账互验)─► agg_daily_*(宽表)
   ─ 实时计数(当日充提/在线/领取,近似值声明)─► realtime counters
商户控制台图表 = 读 agg + counters;平台视图 = 跨租户再聚合

2.3 指标口径(平台统一)

每个指标有唯一定义式,以 metric_defs 表为唯一事实源、版本化维护;口径变更全平台同步生效并在报表标注(保证「V18 商户 A 与商户 B 的 NGR 可比」)。NGR 唯一定义(扣玩家返利成本;佣金不进 NGR——佣金是 NGR 之下的获客成本,通常按 NGR/GGR 比例计,单列于成本域):

NGR = GGR − 优惠(09) − 返水(08) − 俸禄(07) − 任务(10)   （佣金 11 不进 NGR,见上）

全篇一切 NGR 表述(含 §2.1 游戏域、§七 展示)均指向本式 / metric_defs,不再另写简写。

---

三、业务规则

1. 只读隔离:聚合任务读从库/数仓,不触业务库主链路;
2. 对账互验:agg_daily 的资金合计必须与 13 日切对账结果一致,不一致阻断发布当日报表并出差异工单;
3. 可见性:商户只见本站;平台见全量;敏感明细(用户身份)不进看板(聚合值);
4. 实时数据标注:实时计数标「近似,T+1 为准」;
5. 包网佣金依据:平台按商户「月 GGR(盈利,按币种)」为 15 计费结算 供数(包网佣金 = GGR × 包网费率,按盈利抽成),15 按租户 billing 方案(revShare/fixed/hybrid)出账单 billing_statements(§八);跨站按各站本位币出分账单,合并应付额用 settlement_currency + fx_snapshot 给合计参考(仅 B2B 结算参考·不回流用户业务);账单每行可追溯到日聚合。

---

四、★ 租户可配置项(report 命名空间)

"report": {
  "visibleDomains": ["user", "fund", "game", "cost", "affiliate", "risk"],
  "defaultRange": "LAST_7D",
  "export": { "aggregate": true, "detail": false }   // 聚合可导出;明细导出走 13 权限 + 15 console.dataExport 总闸
}

指标定义不可配(口径统一);只配可见域与导出权限。商户报表金额恒本位币单口径,无站内币种切换;平台经营视图跨站按币种分列。

---

五、与其他系统的关系 / 接口

接口	调用方	说明
dashboard(tenant, domain, range)	15 商户控制台	本站图表数据(金额恒本位币,币种隐含 = tenant.baseCurrency)
platformOverview(range)	平台控制台	跨租户视图(按币种分列,不同站不同本位币)
billingData(tenant, month)	15 计费结算	该站当月 GGR/流水(按本位币),供 15 按 billing 方案出账单(→ 15 §5.7);跨站合计参考汇率快照口径见 §八 billing_statements
消费:13 日切产物(含 route 分档)、各系统日快照	← 批任务	聚合输入

---

六、运营后台能力(→ 15)

侧	能力
平台控制台	跨租户经营视图(按币种分列,不同站不同本位币)、租户健康度(充提/成本/风控异常)、为 15 计费结算供数(月 GGR/流水按币种,→ 15 §5.7)、指标口径管理
商户控制台	各域报表(本位币单口径,无站内币种切换)、时间对比、聚合导出;首页驾驶舱(今日充提/新增/在线 实时卡,本位币)

---

七、展示契约

• 看板为 15 后台内嵌模块(桌面 Web 图表),用户端 App 无本系统界面;
• 商户报表金额恒本位币单口径、无站内币种切换;平台经营视图跨租户按币种分列(不同站不同本位币),无跨币种合并总额;
• 成本域直接按 claim_records.source 五色堆叠(优惠/俸禄/返水/任务/佣金),与 13 §2.2 枚举一致,合计即 NGR 扣减项(§2.3);
• 游戏域可按场馆 route(原生/CNY 映射)分档,仅作中性对账/口径溯源维度(route 为平台超管专属对账口径开关,→ 13 按 route 分档对账、15 §5.6),平台侧不出任何商业测算。

---

八、数据库设计(聚合层;全表含 tenant_id)

表	关键字段	约束/索引
agg_daily_tenant_currency	tenant_id, currency(= 站本位币,冗余列供平台跨站按币种分列聚合), stat_date, deposit_amt/cnt, withdraw_amt/cnt, turnover, ggr, bonus_cost, rakeback_cost, salary_cost, task_cost, commission_cost, register_cnt, dau	UK(tenant_id,stat_date)(单站单币种)
agg_game_daily	tenant_id, currency(= 本位币), stat_date, game_type, vendor, route(NATIVE/CNY_MAPPING,中性对账/口径溯源维度), turnover, ggr, bet_users, declared_turnover(向厂商申报口径数值,CNY 映射=本位币数值1:1)	UK(tenant_id,stat_date,game_type,vendor,route)
agg_funnel_daily	tenant_id, stat_date, register, first_deposit, re_deposit	UK(tenant_id,stat_date)
metric_defs(平台级)	metric PK, formula, version, note	—
billing_statements(平台级)	statement_id PK, tenant_id, period(YYYY-MM), currency(该站本位币,或 settlement 合并行的 settlement_currency), mode(revShare/fixed/hybrid), ggr(当期盈利/玩家输赢·计费依据), rate_or_tier(命中费率或阶梯 JSON), min_guarantee, amount_due, settlement_currency, fx_snapshot(跨站合计参考汇率快照,仅 B2B 结算参考·不回流用户业务), status(DRAFT/ISSUED/PAID/OVERDUE), issued_at, due_at, paid_at	UK(tenant_id,period,currency)

---

九、扩展点与开放问题

• 用户标签/人群包:RFM、流失预测,供 09 定向与 16 营销群发,V2 数据能力;
• 实时看板深度:秒级大屏(运营活动日)按需立项。

包网佣金计费模型(revShare 盈利分成 · 默认 / fixed / hybrid,按 GGR 盈利抽成)与账单状态机由 15 §5.7 定义、数据源本系统、账单表 billing_statements(§八);跨站合计参考汇率口径收敛为 billing_statements.fx_snapshot(仅 B2B 结算合计参考、显著标注、与用户业务隔离)。

---

十、验收要点

• [ ] 商户报表金额恒本位币单口径、无站内币种切换;平台经营视图跨站按币种分列、找不到任何跨币种合计数字;
• [ ] agg_daily 资金项与 13 日切对账结果一致;制造差异时报表阻断并出工单;
• [ ] 五类奖励成本堆叠合计 = 当日 RewardClaimed+BONUS_GRANT 之和(本位币);
• [ ] NGR 全篇唯一口径 = GGR − 优惠 − 返水 − 俸禄 − 任务(佣金不进 NGR),与 metric_defs 一致;报表任一处 NGR 取值同源;
• [ ] 游戏域 route 分档仅作中性对账/口径溯源,全篇无任何商业测算;
• [ ] 商户 A 无法看到商户 B 任何数据;平台视图可下钻到单租户;
• [ ] 指标口径版本变更后,新旧报表标注清晰;
• [ ] billing_statements:按 billing.mode 出账、status 走 DRAFT→ISSUED→PAID/OVERDUE;每行追溯到每日聚合(按该站本位币);跨站合计仅用 settlement_currency+fx_snapshot 且标注 B2B 参考口径、不回流用户业务。