Promotion Record

Record Inquiry 下的 Promotion Record 子页面 PRD，覆盖 Rebate 与 Cashback 两类优惠记录、筛选面板、宽表格、分页和导出。

Promotion Record 是 Record Inquiry 的优惠记录子页面，用于查询玩家返利、返现、优惠发放和相关金额记录。

页面摘要

项目	说明
页面性质	优惠记录只读查询页，支持 Rebate / Cashback 类型切换和导出
核心动作	按时间、品牌、玩家和代理筛选优惠记录，核对发放金额、比例字段和导出结果
数据范围	当前账号有权限查看的品牌、代理、会员和优惠记录
当前状态	Rebate / Cashback、筛选、宽表、分页和导出已定义；完整列名和比例字段以本页字段模型和业务规则为准

参考区

页面状态 Figma 截图

Record Inquiry

Promotion Record 的 Rebate 子页签高亮，右侧 Filters 面板展示 Date/Time、Select Brand、Player ID、Partner ID、Type 和 Include Sub-Partner。

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

Record Inquiry - 2.2 Promotion Cashback 筛选态

Promotion Record 的 Cashback 子页签高亮，表格展示 Deposit Amount、Withdrawal Amount、比例和 Release Amount 等返现字段。

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

全局依赖

全局模块	说明
Top	展示 Coupon Balance、Withdrawal Balance、消息和 Profile；本页筛选不改变 Top 口径。
Global One Line Notice	有维护公告时显示在 Top 下方。
Deposit & Withdrawal Record / Bet History	同属 Record Inquiry；三个子页面查询上下文互不强制同步。

功能规则

区域	UI 表现	对应功能规则
子页面导航	`Deposit & Withdrawal Record`、`Promotion Record` 高亮、`Bet History`	子页面导航
页面标题	`Promotion Record`，副文案 `Record of bonuses, offers, and promotions applied.`	页面上下文
查询与动作区	`Search for transaction`、`Search`、`Filter`、`Excel Download`	查询与动作
Rebate / Cashback	两个分段按钮，当前类型紫色高亮	记录类型切换
Filter 面板	Date/Time、Select Brand、Player ID、Partner ID、Type、Include Sub-Partner、Reset、Apply	Filter 面板
Rebate 表格	Date、Brand、Player ID、Partner ID、Level、Type、Provider、Release Amount 等	Rebate 表格
Cashback 表格	Date、Brand、Player ID、Partner ID、Level、Type、Deposit Amount、Withdrawal Amount、比例、Release Amount 等	Cashback 表格
分页区	横向滚动条、`Showing 1-10 of 1000`、页码	分页与横向滚动

功能地图

子页面导航

项目	说明
Deposit & Withdrawal Record	点击后进入 Deposit & Withdrawal Record。
Promotion Record	当前高亮，展示优惠记录。
Bet History	点击后进入 Bet History。
切换规则	切换子页面时保留各自已生效查询上下文，不把 Promotion 专属的 Rebate / Cashback 类型带入其他页面。

页面上下文

项目	说明
标题	`Promotion Record`。
副文案	`Record of bonuses, offers, and promotions applied.`
页面边界	本页只读，不直接发券、撤回、核销或修改优惠结果。

查询与动作

控件	规则
Search 输入框	占位文案为 `Search for transaction`。用于搜索优惠记录编号、玩家 ID 或代理 ID。
`Search`	按当前关键词和已生效筛选刷新当前 Rebate / Cashback 列表，并回到第 1 页。
`Filter`	打开或关闭右侧 Filter 面板；打开面板不触发查询。
`Excel Download`	导出当前类型、当前筛选、当前权限范围内的结果。

记录类型切换

类型	说明
Rebate	默认或可选类型之一，展示返利记录。截图中表格右侧出现 Provider / Release Amount 等字段。
Cashback	展示返现记录。截图中表格展示 Deposit Amount、Withdrawal Amount、比例和 Release Amount 等字段。

切换 Rebate / Cashback 时，保留通用筛选条件，但刷新当前表格列定义、金额口径和 Type 选项，并回到第 1 页。

Filter 面板

字段 / 控件	UI 表现	规则
Date/Time	日期范围输入，截图无必填星号	当前定义为可选；如业务需要强制时间范围，需要补充必填标记和默认范围。
Select Brand	下拉选择，默认 `All`	只展示当前账号有权限查看的品牌。
Player ID	文本输入	按玩家编号过滤。
Partner ID	文本输入	按代理编号过滤。
Type	下拉选择，默认 `All`	选项应随 Rebate / Cashback 切换；截图未展示展开项。
Include Sub-Partner	复选框，截图中默认勾选	只纳入当前账号权限范围内的下级代理数据。
`Reset`	底部次按钮	恢复当前类型默认查询，并回到第 1 页。
`Apply`	底部主按钮	提交筛选条件，刷新当前类型表格、横向滚动和分页。

Rebate 表格级定义

项目	定义
行粒度	每一行代表一条 Rebate 优惠记录。
汇总粒度	当前未定义 Total 行；如后续增加汇总，必须按当前 Rebate 类型和筛选范围计算。
默认排序	默认按 `Date` 倒序展示，最新记录优先。
数据范围	受 Date/Time、Brand、Player ID、Partner ID、Type、Include Sub-Partner 和当前账号权限限制。
父子 / 展开关系	当前表格没有行展开；右侧字段通过横向滚动查看。Rebate 与 Cashback 字段模型互不继承。
导出关系	Excel Download 只导出当前筛选、当前表格 / 弹窗层级的字段模型，并按权限脱敏；选择列、操作列、按钮入口、内部字段和未纳入字段模型的字段不导出。

Rebate 字段模型

字段	所在区域	定义 / 口径	展示规则	导出	备注
Date	Rebate 表格	返利记录日期。	使用统一日期格式；默认排序字段。	按权限导出	导出时必须与筛选日期口径一致。
Brand	Rebate 表格	记录所属品牌。	品牌标签展示。	按权限导出	只能展示授权品牌。
Player ID	Rebate 表格	玩家编号。	文本展示。	按权限导出	权限不足时按敏感字段规则处理。
Partner ID	Rebate 表格	代理编号。	文本展示。	按权限导出	必须在当前权限范围内。
Level	Rebate 表格	玩家等级，例如 GOLD。	等级文本展示。	按权限导出	等级词表以本页字段模型和业务规则为准。
Type	Rebate 表格	返利周期或类型，例如 Daily。	与 Type 筛选词表保持一致。	按权限导出	Type 选项使用 Rebate / Cashback 各自词表。
Provider	Rebate 表格	返利来源，例如 Sports、Live Casino、Slot。	文本展示。	按权限导出	供应商词表需与投注和游戏模块一致。
Release Amount	Rebate 表格	发放金额或数量；截图示例为 `42`。	金额或数量格式按金额展示规则处理。	按权限导出	计算口径以本页字段模型和业务规则为准。
右侧被遮挡列	横向滚动区域	右侧完整列名、顺序和口径以字段模型为准。	不得把当前可见列当完整字段清单。	不导出	以当前字段模型为准。

Cashback 表格级定义

项目	定义
行粒度	每一行代表一条 Cashback 优惠记录。
汇总粒度	当前未定义 Total 行；如后续增加汇总，必须按当前 Cashback 类型和筛选范围计算。
默认排序	默认按 `Date` 倒序展示，最新记录优先。
数据范围	受 Date/Time、Brand、Player ID、Partner ID、Type、Include Sub-Partner 和当前账号权限限制。
父子 / 展开关系	当前表格没有行展开；Cashback 与 Rebate 共用筛选入口但字段模型独立。
导出关系	Excel Download 只导出当前筛选、当前表格 / 弹窗层级的字段模型，并按权限脱敏；选择列、操作列、按钮入口、内部字段和未纳入字段模型的字段不导出。

Cashback 字段模型

字段	所在区域	定义 / 口径	展示规则	导出	备注
Date	Cashback 表格	返现记录日期。	使用统一日期格式；默认排序字段。	按权限导出	导出时必须与筛选日期口径一致。
Brand	Cashback 表格	记录所属品牌。	品牌标签展示。	按权限导出	只能展示授权品牌。
Player ID	Cashback 表格	玩家编号。	文本展示。	按权限导出	权限不足时按敏感字段规则处理。
Partner ID	Cashback 表格	代理编号。	文本展示。	按权限导出	必须在当前权限范围内。
Level	Cashback 表格	玩家等级，例如 GOLD。	等级文本展示。	按权限导出	等级词表以本页字段模型和业务规则为准。
Type	Cashback 表格	返现周期或类型，例如 Daily。	与 Type 筛选词表保持一致。	按权限导出	Type 选项使用 Rebate / Cashback 各自词表。
Deposit Amount	Cashback 表格	当前范围内的充值金额。	金额格式展示。	按权限导出	统计范围需与 Deposit & Withdrawal 口径一致。
Withdrawal Amount	Cashback 表格	当前范围内的提现金额。	金额格式展示。	按权限导出	统计范围需与 Deposit & Withdrawal 口径一致。
比例字段	Cashback 表格	可见百分比列例如 `5%`，但完整字段名和计算口径以字段模型为准。	百分比格式；小数精度以本页字段模型和业务规则为准。	不导出	以当前字段模型为准。
Release Amount	Cashback 表格	返现金额；截图示例为 `4,950`。	金额格式展示。	按权限导出	计算口径以本页字段模型和业务规则为准。

分页与横向滚动

控件	规则
横向滚动条	位于表格下方，用于查看右侧金额和比例字段。
结果提示	左下角展示 `Showing 1-10 of 1000`。
页码	右下角展示上一页、页码、下一页，当前页紫色高亮。
翻页	保留当前类型、关键词和已生效筛选条件。

业务规则

Promotion Record 是只读查询页，不直接发放、撤回、编辑或核销优惠。
Rebate 与 Cashback 之间共享通用筛选条件，但列定义、金额口径和 Type 词表必须独立。
Date/Time、Brand、Player ID、Partner ID、Type 和 Include Sub-Partner 之间按 AND 处理。
表格默认按 Date 倒序展示，最新记录优先。
Include Sub-Partner 不能突破当前账号权限范围。
Search、Filter Apply、Reset、类型切换和翻页后，当前结果回到第 1 页或保留翻页上下文，不能出现表格和导出范围不一致。
Excel Download 只导出当前 Rebate / Cashback 类型、当前筛选和当前权限范围下的数据。
Date/Time 没有必填星号，当前定义为可选；如果必须限制时间范围，需要补充默认范围。
Type 下拉未提供展开态；本页默认只允许 Rebate 与 Cashback 两个选项，并分别进入对应表格字段模型。
Rebate 与 Cashback 表格右侧完整列名和顺序以当前字段模型为准。
Rebate 的 42 和 Cashback 的 4,950 发放金额计算口径以本页字段模型和业务规则为准。

页面特例

场景	处理
查询无结果	保留类型按钮、搜索区、Filter、表头、横向滚动条和分页容器，表格主体展示空态说明。
Type 选项加载失败	保留当前结果，在 Type 下拉中展示重试入口。
日期范围非法	阻止 Apply，并在 Date/Time 附近提示。
查询失败	保留上一成功结果和当前草稿条件，提示重试。
导出失败	不清空列表，提示失败原因并允许重试。

本页目录