Ruby Agent System PRD

Daily Profit Statistics

Data Report 的日利润统计功能规则,覆盖日期筛选、表格展开、结算详情和发券确认。

Daily Profit Statistics 用于按日期查看代理商日利润、会员结算、下级收益和总计结算金额。运营、财务、产品、开发和 QA 主要用它核对日维度利润、展开品牌明细、查看结算详情、导出明细和进入发券流程。

页面摘要

项目说明
页面性质日维度利润查询页,包含展开明细、弹窗明细、导出和发券入口
核心动作按日期查询、展开品牌、查看会员结算 / 下级收益明细、导出、发券确认
数据范围当前账号有权限查看的品牌、会员、下级 Partner、结算金额和优惠券余额
当前状态查询、展开、详情弹窗和最终确认已描述;下级收益按直接下级 Partner 口径处理,发券配置弹窗在最终确认前补齐,默认不支持给下级代理发券

功能总览

页面定位

Daily Profit Statistics 是 Data Report 中的日维度利润页面,支持按日期汇总利润、展开品牌明细、查看结算详情、导出数据和发起优惠券确认。

全页功能地图

区域内容说明
日期筛选区日期范围输入框、Search、Reset控制当前列表的查询日期范围
日利润表格Total 汇总行、日期行、分页展示日期维度的会员、结算、下级收益和总计金额
品牌明细展开区Brand Details、品牌列表、View 操作展示单日内各品牌拆分数据
结算详情弹窗Member ID 搜索、明细表格、导出、发券查看会员结算或下级收益明细
发券配置弹窗发放对象、优惠券金额或券配置、备注、下一步当前 Figma 未提供,按本页发券配置流程补齐
发券确认弹窗Total Player、Coupon Amount、Confirm、No, cancel提交发券前的最终确认

全页业务规则

  • 本页所有数据必须限定在当前账号有权限查看的品牌和会员范围内。
  • 日期筛选、展开、弹窗和发券都必须继承当前查询上下文。
  • 汇总金额必须能与品牌明细、弹窗明细对账。
  • 表格无数据时显示空态,不展示模拟日期或模拟金额。
  • 弹窗内筛选不影响父级列表的日期范围、分页和展开状态。

日期筛选与日利润主表

主表参考

页面状态 Figma 截图

Data Report / Daily Profit Statistics

Data Report / Daily Profit Statistics - 3.2 表格默认态

该截图证明主表默认按日期分组展示,并可见 Total 汇总行和可展开日期行;当前可见列仅作为截图证据,完整字段、导出和遮挡列以字段模型为准。

截图说明只作为 Figma 证据摘要,不作为字段定义;字段口径、完整列、导出和权限规则以字段模型章节为准。

Data Report / Daily Profit Statistics - 3.3 日期范围选择器

点击日期输入框后打开双月日历,支持快捷范围、开始/结束日期、时间输入、Clear 和 Apply。

截图说明只作为 Figma 证据摘要,不作为字段定义;字段口径、完整列、导出和权限规则以字段模型章节为准。

Data Report / Daily Profit Statistics - 3.4 日期应用后

点击 Apply 后日期输入框显示已选范围,点击 Search 后按该范围刷新表格;Reset 清空筛选并恢复默认列表。

截图说明只作为 Figma 证据摘要,不作为字段定义;字段口径、完整列、导出和权限规则以字段模型章节为准。

主表规则摘要

本章节覆盖默认主表、日期选择器和日期应用后的状态。Figma 截图只证明查询区与主表在同一页面状态中联动展示;完整字段定义以本章节的主表字段模型为准。

日期筛选用于确定日利润表格的统计范围。日期选择器负责写入查询条件,Search 才真正刷新列表;主表按日期展示收益汇总,并支持展开日期行查看品牌明细。

主表功能地图

元素显示内容功能规则
日期输入框未选择时显示占位文案,选择后显示日期范围点击打开日期范围选择器
日期选择器双月日历、快捷范围、起止时间、Clear、Apply选择查询起止时间
Search紫色主按钮按当前日期范围查询列表
Reset次级按钮清空日期范围并恢复默认列表
Total 汇总行My Member Settlement、Sub-Partner Revenue、Total Settlement Amount展示当前查询范围的总计
日期行日期、Depositing Member / All Members、结算金额、下级收益、总计结算金额展示单日汇总数据
展开箭头行首箭头点击展开或收起品牌明细
分页每页数量、Previous、页码、Next控制列表分页

日期筛选交互

交互逻辑
点击日期输入框打开日期选择器,未点击 Apply 前不改变输入框显示
点击 Apply把选择结果写入输入框,但不立即请求列表数据
点击 Search按当前日期范围查询数据,分页重置为第 1 页,已展开行收起
点击 Reset清空日期范围、关闭日期选择器、收起展开行、恢复默认分页和默认列表
点击 Clear清空选择器内的日期和时间,不主动刷新表格

主表表格级定义

项目定义
行粒度日期行每一行代表一个统计日期;Total 行代表当前筛选范围的跨日期汇总。
汇总粒度Total 行汇总当前已生效日期范围和权限范围内全部命中日期,不受当前分页限制。
默认排序默认按 Date 倒序展示,最新统计日期优先。
数据范围受日期筛选、当前账号权限范围、品牌范围和下级 Partner 可见范围共同限制。
父子 / 展开关系日期行可展开为品牌明细;Total 行不可展开;展开后品牌明细继承父级日期和当前筛选条件。
导出关系当前表格未展示独立导出入口;默认不导出。若后续新增导出入口,按当前表格字段模型和权限脱敏规则导出,选择列、操作列、按钮入口、内部字段和未纳入字段模型的字段不导出。

主表字段模型

字段所在区域定义 / 口径展示规则导出备注
展开列主表日期行控制当前日期的 Brand Details 展开或收起。Total 行不展示展开箭头;切换查询或分页后收起。不导出只表达层级关系,不是业务字段。
Date主表日期行统计日期,代表该行所有利润和结算指标所属的业务日。使用统一日期格式;展开后 Brand Details 必须继承同一日期。不导出主表当前无独立导出入口。
Depositing Member / All Members主表日期行、品牌明细行左侧为当日有充值会员数,右侧为当前权限范围内该日期的全部会员数。格式为 112/397;品牌明细汇总应可回算到日期行。不导出这是复合指标;如后续支持导出,应拆分为 Depositing Member 与 All Members 两个字段。
My Member SettlementTotal 行、日期行、品牌明细行当前账号直属或归属会员在该范围内产生的会员结算金额。金额格式使用韩元符号和千分位;日期行金额等于该日期所有品牌明细合计。不导出必须与会员结算详情弹窗可对账。
Sub-Partner RevenueTotal 行、日期行、品牌明细行当前账号直接下级 Partner 在该范围内贡献的收益。金额格式与 My Member Settlement 一致。不导出默认只统计直接下级 Partner;多级下级需另行扩展层级模型。
Total Settlement AmountTotal 行、日期行、品牌明细行当前行最终结算总额。默认按 My Member Settlement + Sub-Partner Revenue 对账;如财务公式不同,必须补充公式。不导出默认公式为 My Member Settlement + Sub-Partner Revenue;如财务公式变化,必须写入变更记录。
Total 汇总行主表首行当前已生效日期范围和权限范围的跨日期总计。不受当前分页限制;应等于所有命中日期行合计。不导出Total 是汇总行,不是普通日期行。

主表交互逻辑

交互逻辑
点击展开箭头在当前日期行下方展开 Brand Details
再次点击箭头收起当前日期行
切换页码刷新当前页数据,并收起已展开行
切换每页数量回到第 1 页并按新数量刷新

主表业务规则

  • 日期范围为空时使用产品配置的默认范围;当前默认最近 30 天。
  • 开始时间不得晚于结束时间,结束时间不得超过系统允许的最大查询时间。
  • 查询按钮点击后必须显示加载状态,避免重复触发。
  • 查询失败时保留当前已输入筛选条件,并显示失败反馈。
  • Total 汇总行必须基于当前筛选范围计算,不只统计当前页。
  • 日期行金额必须与该日期下所有品牌明细合计一致。
  • Depositing Member / All Members 使用“有充值会员 / 全部会员”口径。
  • 金额为 0 时显示 0 或标准金额格式,不留空。

品牌明细展开

品牌明细参考

页面状态 Figma 截图

Data Report / Daily Profit Statistics

Data Report / Daily Profit Statistics - 3.5 展开日期明细

点击日期行箭头展开 Brand Details,按品牌展示会员数、会员结算、下级收益和总计结算金额,每个可查看字段提供 View 入口。

截图说明只作为 Figma 证据摘要,不作为字段定义;字段口径、完整列、导出和权限规则以字段模型章节为准。

品牌明细定位

品牌明细用于查看某一天内各品牌的会员和收益拆分,并提供进入明细弹窗的入口。

品牌明细功能地图

元素显示内容功能规则
Brand Details 标题日期标题和明细区域标识当前展开内容所属日期
品牌行品牌名称、会员数、会员结算、下级收益、总计结算金额展示单品牌日统计
View 按钮位于 My Member Settlement 和 Sub-Partner Revenue 字段旁打开对应明细弹窗
品牌色条不同品牌对应不同颜色帮助区分品牌行

品牌明细表格级定义

项目定义
行粒度每一行代表父级日期下的一个品牌。
汇总粒度所有品牌行应能汇总回父级日期行对应指标。
默认排序默认跟随 Figma 展示顺序;默认按品牌名称升序;名称缺失时使用后端稳定排序。
数据范围继承父级日期、当前筛选条件、当前账号品牌权限和下级范围。
父子 / 展开关系品牌明细只能由日期行展开产生;品牌行可通过 View 打开对应明细弹窗。
导出关系当前表格未展示独立导出入口;默认不导出。若后续新增导出入口,按当前表格字段模型和权限脱敏规则导出,选择列、操作列、按钮入口、内部字段和未纳入字段模型的字段不导出。

品牌明细字段模型

字段所在区域定义 / 口径展示规则导出备注
Brand品牌明细行品牌名称,代表该行数据所属品牌。使用品牌名和左侧品牌色条;品牌必须在当前账号权限范围内。不导出品牌名称必须与权限品牌词表一致。
Depositing Member / All Members品牌明细行当前日期、当前品牌下的充值会员数和全部会员数。格式与主表一致;所有品牌行合计应可对账日期行。不导出复合指标;如后续支持导出,应拆分为 Depositing Member 与 All Members 两个字段。
My Member Settlement品牌明细行当前日期、当前品牌下的会员结算金额。金额必须能汇总到对应日期行的 My Member Settlement。不导出可通过 View 查看明细。
My Member Settlement View品牌明细操作打开该日期、该品牌、会员结算类型的详情弹窗。弹窗标题必须包含日期、品牌和 My Member Settlement Details不导出这是操作入口,不是金额字段。
Sub-Partner Revenue品牌明细行当前日期、当前品牌下的下级 Partner 收益。金额必须能汇总到对应日期行的 Sub-Partner Revenue。不导出默认只统计直接下级 Partner;多级下级需另行扩展层级模型。
Sub-Partner Revenue View品牌明细操作打开该日期、该品牌、下级收益类型的详情弹窗。弹窗对象维度为直接下级 Partner,并继承当前日期和品牌。不导出默认不支持代理发券。
Total Settlement Amount品牌明细行当前品牌最终结算总额。默认按会员结算加下级收益对账;与主表日期行总额保持一致。不导出如公式变更需同步主表。

品牌明细交互

交互逻辑
展开日期行只展开当前点击日期的品牌明细
点击 My Member Settlement 的 View打开会员结算详情弹窗
点击 Sub-Partner Revenue 的 View打开下级收益详情弹窗
切换筛选或分页自动关闭所有品牌明细展开区

品牌明细业务规则

  • 品牌明细只展示当前账号有权限查看的品牌。
  • 品牌行总计必须与日期行对应字段可对账。
  • View 弹窗必须继承当前日期、品牌和明细类型。
  • 无品牌数据时显示空态,不隐藏日期行。

结算详情弹窗

明细弹窗参考

页面状态 Figma 截图

Data Report / Daily Profit Statistics

Data Report / Daily Profit Statistics - 3.6 会员结算详情

点击 My Member Settlement 的 View 打开明细弹窗,支持 Member ID 搜索、Reset、Excel Downloads、Send Coupons、横向滚动和分页。

截图说明只作为 Figma 证据摘要,不作为字段定义;字段口径、完整列、导出和权限规则以字段模型章节为准。

Data Report / Daily Profit Statistics - 3.7 下级收益详情

当前截图展示 Sub-Partner Revenue 明细弹窗,但其中 Player ID / Member ID 搜索口径按 PRD 默认规则改为代理 / Partner 字段。

截图说明只作为 Figma 证据摘要,不作为字段定义;字段口径、完整列、导出和权限规则以字段模型章节为准。

Sub-Partner Revenue 弹窗对象口径: 下级收益按直接下级 Partner 维度展示,不把 Figma 中的 Player ID / Member ID 当作定稿字段。

明细弹窗定位

结算详情弹窗用于查看某日某品牌下的会员结算或下级收益明细,并支持搜索、导出和发券入口。

明细弹窗功能地图

元素显示内容功能规则
弹窗标题日期、品牌、明细类型明确当前弹窗上下文
关闭按钮右上角关闭图标关闭弹窗并返回父级表格
对象搜索输入框、Search、Reset会员结算按 Member ID 搜索;下级收益按 Partner ID、Partner Code 或 Agent Name 搜索
Excel Downloads绿色按钮导出当前弹窗筛选结果
Send Coupons黄色按钮会员结算弹窗可对勾选玩家发起发券;下级收益弹窗不展示 Send Coupons
明细表格勾选框、对象 ID、比例字段、金额字段会员结算展示 Player ID;下级收益展示 Partner ID、Partner Code、Agent Name 等代理字段
横向滚动条表格底部支持查看超宽字段
分页每页数量、页码控制弹窗表格分页

明细弹窗表格级定义

项目定义
行粒度My Member Settlement 弹窗每行代表一个会员结算对象;Sub-Partner Revenue 弹窗每行代表一个直接下级 Partner。
汇总粒度弹窗表格金额应汇总回父级品牌行对应字段;弹窗内分页不改变汇总口径。
默认排序默认使用后端稳定排序;如存在金额列排序,优先按结算金额倒序展示。
数据范围继承父级日期、品牌、明细类型和当前账号权限;弹窗内搜索只缩小当前弹窗结果。
父子 / 展开关系弹窗由品牌明细行的 View 打开;关闭后返回原父级展开状态,不刷新父级表格。
导出关系Excel Download 只导出当前筛选、当前表格 / 弹窗层级的字段模型,并按权限脱敏;选择列、操作列、按钮入口、内部字段和未纳入字段模型的字段不导出。

桌面端和移动端使用同一字段模型。移动端可采用横向滚动、固定首列、列分组或详情抽屉承载宽表,但不能因为屏幕较窄而删除财务字段、比例字段、对象 ID 或导出字段;如移动端首屏只展示核心列,完整字段必须能通过横向滚动或详情入口查看。

明细表格字段模型

字段所在区域定义 / 口径展示规则导出备注
选择列两个弹窗表头和行级复选框用于选择当前页对象。选择结果用于导出或发券上下文;默认只选择当前页,不跨页保留。不导出下级收益弹窗不使用选择列发券。
Player IDMy Member Settlement 弹窗会员结算对象 ID。点击或选择行为不应改变父级表格状态。按权限导出会员敏感字段展示需遵守权限规则。
Player IDSub-Partner Revenue 弹窗当前截图仍展示 Player ID,但下级收益不按玩家维度结算。不作为下级收益对象字段实现。不导出以 Partner 字段模型为准。
Partner IDSub-Partner Revenue 弹窗下级 Partner 或代理编号。作为下级收益对象的必填识别字段展示。按权限导出与 Partner Code 的关系需保持唯一可解释。
Partner CodeSub-Partner Revenue 弹窗下级 Partner 推广码或归属码。与 Partner ID 同行展示时必须口径一致。按权限导出默认作为主搜索字段。
GGR Sports% / GGR Casino% / GGR Slot%两个弹窗各游戏大类 GGR 比例。使用百分比格式,保留统一小数位。按权限导出公式和小数精度遵守财务统一口径。
Bet Profit Sports% / Bet Profit Casino% / Bet Profit Slot%两个弹窗各游戏大类投注利润比例。完整列顺序以字段模型为准。按权限导出不得用截图裁切结果当完整列模型。
Actual Bet AmountMy Member Settlement;Sub-Partner Revenue 以字段模型为准实际投注金额。使用标准金额或整数格式;必须与投注明细口径一致。按权限导出默认不适用于 Sub-Partner Revenue。
Valid Bet AmountMy Member Settlement 右侧可见但列名被截断有效投注金额。完整列名和计算口径以字段模型为准;默认不适用于 Sub-Partner Revenue。不导出当前不作为定稿字段;如需要导出,先补全列名和公式。
右侧扩展指标列两个弹窗完整列顺序和部分字段口径以字段模型为准。实现和 QA 不能把当前截图裁切结果当最终列模型。不导出以当前字段模型为准。

明细弹窗交互

交互逻辑
输入对象条件并搜索只刷新当前弹窗表格,不影响父级表格
点击 Reset清空弹窗内搜索条件并恢复弹窗默认列表
勾选对象更新当前已选对象集合
点击 Excel Downloads导出当前弹窗筛选后的数据
点击关闭关闭弹窗,父级日期行和筛选上下文保持不变

明细弹窗业务规则

  • 会员结算弹窗和下级收益弹窗字段可以不同,但标题必须清楚表达明细类型。
  • 下级收益弹窗不得直接沿用会员结算弹窗的 Player ID 字段,除非业务明确表示下级收益仍以玩家维度展示。
  • 导出数据必须与当前弹窗筛选结果一致。
  • 搜索无结果时显示弹窗内空态,不关闭弹窗。
  • 弹窗打开期间父级页面遮罩置灰,避免用户误操作父级内容。

发券确认

发券确认参考

页面状态 Figma 截图

Data Report / Daily Profit Statistics

Data Report / Daily Profit Statistics - 3.8 发券确认

当前截图仅展示发券最终确认,包含 Total Player 和 Coupon Amount;点击 Send Coupons 后的发券配置弹窗仍需补充。

截图说明只作为 Figma 证据摘要,不作为字段定义;字段口径、完整列、导出和权限规则以字段模型章节为准。

Send Coupons 配置弹窗: 当前 Figma 只有最终确认弹窗,本页默认在最终提交前增加配置弹窗,补齐对象、金额来源、备注和下一步行为。

发券确认定位

发券确认用于在执行批量发券前进行二次确认,避免误发。

发券确认功能地图

元素显示内容功能规则
图标礼物图标强化当前操作为发券
Total Player已选玩家数量展示本次发券影响人数
Coupon Amount优惠券总金额展示本次发券总额
Confirm主按钮确认并提交发券
No, cancel次级按钮取消本次发券
关闭图标右上角关闭关闭确认弹窗

发券确认交互

交互逻辑
点击 Send Coupons若已选择对象,应先打开发券配置弹窗;当前 Figma 未提供该弹窗,本页按配置弹窗流程补齐
在发券配置弹窗点击下一步打开最终发券确认弹窗,并展示 Total Player 与 Coupon Amount
点击 Confirm提交发券请求,进入提交中状态并禁止重复点击
点击 No, cancel 或关闭图标关闭确认弹窗,不改变已选对象
提交成功关闭确认弹窗,展示成功反馈,并按业务需要刷新余额或列表
提交失败保留弹窗或回到明细弹窗,并展示失败原因

发券确认业务规则

  • 未选择对象时不能提交发券,必须给出明确提示。

  • Total PlayerCoupon Amount 由当前选择结果计算,不允许手动修改。

  • 发券提交需要校验 Coupon Balance 是否足够。

  • 发券成功或失败都必须有明确反馈,避免用户重复操作。

  • Sub-Partner Revenue 弹窗展示代理 / Partner 字段,不使用 Player ID / Member ID 作为主对象。

  • 下级收益默认只展示直接下级;多级视图需要新增层级、上级关系、汇总去重和分页规则

  • 默认不允许给下级代理发 Coupon;下级收益弹窗不展示 Send Coupons。

  • Send Coupons 配置弹窗缺失: 本页默认在最终二次确认前增加配置弹窗,定义对象、金额来源、备注和下一步行为

  • Coupon Amount 支持单一批量金额编辑;不启用券模板,不支持每个对象不同金额。

本页目录