博彩平台报表系统与财务结算需求说明书
一、 系统架构与角色定义
系统采用三级架构模式：平台 ⇒ 总代理 ⇒ 代理。其中只有“代理”角色直接参与实际的盘口运营和对接最终用户。
- 平台： 提供底层技术、通道、三方游戏接入，抽取固定比例平台费。
- 总代理： 平台的下级，负责充值全局保证金，为其下属代理分配授信额度，并动态调配盘口股份。
- 代理： 总代的下级，作为独立盘口运营，直接发展用户，受制于总代分配的授信额度。
二、 核心运营与资金机制
2.1 保证金与授信制度 (实时风控)
底层逻辑：提现能力严格受限于资金池。无资金则阻断提现。
- 总代保证金： 由总代向平台充值。旗下所有代理共享此保证金池。代理旗下用户充值增加等额保证金，提现扣除等额保证金。保证金下限为 0。
- 代理授信额度： 由总代独立为单个代理分配。代理旗下用户充值增加本代理授信，提现扣减本代理授信。授信额度下限为 0。
- 阻断机制： 若总代保证金不足，或该代理授信额度不足，该代理下用户的提现申请将被直接拒绝/挂起。
2.2 平台股份制度与动态结算 (利润分配核心)
每一个代理盘口中存在三个利益分配方（平台、总代、代理）。总代理可以在一天内任意时间、任意次数调整这三方的股份占比。每日 0 点进行统一核算。
⚠️ 核心原则： 所有的流水、成本、盈亏核算，必须严格基于单笔注单下注发生那一刻的时间戳，去匹配当时的股份快照进行计算，最后加总。
三、 财务结算与成本分摊公式
在每日 0 点结算时，各类费用的计算规则如下（所有变量均针对单一盘口/代理线）：
1. 占股有效流水 (Valid Turnover)
占股有效流水 = Σ (单笔有效下注金额 × 下注当时的股份占比)
2. 注单盈亏 (Bet PnL)
注单盈亏 = Σ (单笔注单实际盈亏 × 下注当时的股份占比)
3. 平台费 (抽水) - 计入总成本
平台费 = 占股有效流水 × 0.3%
4. 三方 API 费用 - 计入总成本
三方API费 = Σ (单笔游戏盈亏产生的抽成金额 × 下注当时的股份占比)
5. 分摊通道费 - 计入总成本
分摊通道费 = 当日平台总通道费用 × (该角色当日占股有效流水 / 当日盘口总有效流水)
6. 退水 / 返水计算
平台应付退水(给总代) = 总代占股有效流水 × 0.5%
总代应付退水(给代理) = 代理占股有效流水 × 0.5%
代理应付返水(给用户) = 用户实际产生有效流水总额 × 返水比例
7. 最终净利润与资金划转
最终净利润 = 注单盈亏 - (平台费 + 三方API费 + 分摊通道费) + 应收退水 - 应付退水(或返水)
规则：各角色拥有独立利润账号。
若最终净利润 > 0：从保证金扣除对应金额，转入该角色的利润账号。
若最终净利润 < 0：直接从该角色的利润账号扣除（利润账号允许为负数）。
四、 报表 UI 结构设计
4.1 运营概况总表 (全局 100% 原始吞吐数据)
说明： 此表呈现盘口的宏观大盘数据。严格规定：此表格为业务对接总表，表头字段已锁死，不得增删改，仅做内部数据的精准映射。表中展示数据不包含任何股份乘数逻辑，只记录发生总额。
| 盈亏 | 返水 | 退水 | 抽水 | 成本 | 通道费 |
注册人数 | 首充人数 | 首充金额 | 充值笔数 | 充值金额 |
人工补分 | 人工扣分 | 充值人数 | 提现笔数 | 提现金额 |
提现人数 | 充提差额 | 投注金额 | 有效投注 | 投注人数 |
中奖金额 | 输赢差额 | 返水金额 | 活动金额 | 三方转进 | 三方转出 |
| 25,000 | 1,500 | 1,500 | 300 | 1,200 | 500 |
120 | 45 | 8,500 | 320 | 150,000 |
2,000 | 0 | 210 | 85 | 95,000 |
60 | 55,000 | 300,000 | 100,000 | 180 |
275,000 | 25,000 | 1,500 | 3,500 | 50,000 | 45,000 |
4.2 角色分润核算明细表 (财务分润结算专用)
说明： 此表为结算核心，所展示数据均为“乘过自身股份占比”后的切身利益数据。平台/总代可下钻查看，代理仅看自身。
| 业务线角色 |
当时股份占比 |
占股有效投注 |
占股注单盈亏 |
承担平台费(千三) |
承担三方API费 |
分摊通道费 |
应收退水 |
应付退/返水 |
最终净利润 |
| 总代 A |
40% |
40,000 |
+ 10,000 |
120 |
400 |
200 |
200 |
200 |
+ 9,280 |
| ↳ 代理 A1 |
30% |
30,000 |
- 5,000 |
90 |
300 |
150 |
150 |
150 |
- 5,540 |
4.3 资金池与风控监控表 (授信与提现卡点)
说明： 剥离业务盈亏，仅监控决定用户能否提现的资金池状态，以及可能引起资金敞口的人工操作。
| 角色层级 |
资金类型 |
当前余额(保证金/授信) |
今日净充值(充提差) |
异常人工补分敞口 |
利润账户余额 |
风控状态 |
| 总代 A |
保证金 |
500,000 |
+ 30,000 |
1,500 |
15,280 |
🟢 正常 |
| ↳ 代理 A1 |
授信额度 |
1,200 |
- 45,000 |
500 |
- 5,540 |
🔴 额度告警 |