Promotion Record
Record Inquiry 下的 Promotion Record 子页面 PRD，覆盖 Rebate 与 Cashback 两类优惠记录、筛选面板、宽表格、分页和导出。
Promotion Record 是 Record Inquiry 的优惠记录子页面，用于查询玩家返利、返现、优惠发放和相关金额记录。
| 项目 | 说明 |
|---|
| 页面性质 | 优惠记录只读查询页，支持 Rebate / Cashback 类型切换和导出 |
| 核心动作 | 按时间、品牌、玩家和代理筛选优惠记录，核对发放金额、比例字段和导出结果 |
| 数据范围 | 当前账号有权限查看的品牌、代理、会员和优惠记录 |
| 当前状态 | Rebate / Cashback、筛选、宽表、分页和导出已定义；完整列名和比例字段仍待确认 |
| 状态 | 内容 |
|---|
Confirmed | Promotion Record 是 Record Inquiry 的只读优惠记录页；当前类型、筛选、表格和导出必须保持同一数据范围。 |
Inferred from Figma | Rebate / Cashback 按当前截图作为两个优惠记录视图；部分右侧字段因面板遮挡需后续补图确认。 |
Open Question | 完整列名、比例字段、搜索字段、导出字段和移动端状态仍待确认，见 开放问题。 |
页面状态 Figma 截图
Record Inquiry
Promotion Record 的 Rebate 子页签高亮，右侧 Filters 面板展示 Date/Time、Select Brand、Player ID、Partner ID、Type 和 Include Sub-Partner。
Promotion Record 的 Cashback 子页签高亮，表格展示 Deposit Amount、Withdrawal Amount、比例和 Release Amount 等返现字段。
| 项目 | 定义 |
|---|
| 页面类型 | Feature Page PRD |
| 所属模块 | Record Inquiry |
| 页面定位 | 优惠、返利和返现记录查询页 |
| 主要任务 | 在 Rebate / Cashback 间切换，按时间、品牌、玩家和代理筛选，核对发放金额并导出当前结果 |
| 数据范围 | 当前账号有权限查看的品牌、下级代理、会员和优惠记录 |
| 默认排序 | Date 倒序，最新记录优先 |
关键规则摘要
Promotion Record 是独立子页面。Rebate 与 Cashback 共享通用筛选入口，但两类记录的金额口径、右侧列定义和 Type 词表必须独立维护，不能混用。
| 区域 | 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、页码 | 分页与横向滚动 |
| 项目 | 说明 |
|---|
| 标题 | 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 页。
| 字段 / 控件 | UI 表现 | 规则 |
|---|
| Date/Time | 日期范围输入，截图无必填星号 | 当前定义为可选；如业务需要强制时间范围，需要补充必填标记和默认范围。 |
| Select Brand | 下拉选择，默认 All | 只展示当前账号有权限查看的品牌。 |
| Player ID | 文本输入 | 按玩家编号过滤。 |
| Partner ID | 文本输入 | 按代理编号过滤。 |
| Type | 下拉选择，默认 All | 选项应随 Rebate / Cashback 切换；截图未展示展开项。 |
| Include Sub-Partner | 复选框，截图中默认勾选 | 只纳入当前账号权限范围内的下级代理数据。 |
Reset | 底部次按钮 | 恢复当前类型默认查询，并回到第 1 页。 |
Apply | 底部主按钮 | 提交筛选条件，刷新当前类型表格、横向滚动和分页。 |
| 字段 | 说明 |
|---|
| Date | 返利记录日期。 |
| Brand | 品牌标签。 |
| Player ID | 玩家编号。 |
| Partner ID | 代理编号。 |
| Level | 玩家等级，例如 GOLD。 |
| Type | 返利周期或类型，例如 Daily。 |
| Provider | 返利来源，例如 Sports、Live Casino、Slot。 |
| Release Amount | 发放金额或数量，截图示例为 42。 |
| 右侧隐藏列 | 当前截图有部分右侧表头被 Filter 面板遮挡，需要后续补图确认完整列名。 |
| 字段 | 说明 |
|---|
| Date | 返现记录日期。 |
| Brand | 品牌标签。 |
| Player ID | 玩家编号。 |
| Partner ID | 代理编号。 |
| Level | 玩家等级，例如 GOLD。 |
| Type | 返现周期或类型，例如 Daily。 |
| Deposit Amount | 当前范围内的充值金额。 |
| Withdrawal Amount | 当前范围内的提现金额。 |
| 比例字段 | 截图显示百分比列，例如 5%；完整字段名待补图确认。 |
| Release Amount | 返现金额，截图示例为 4,950。 |
字段完整性状态：
| 范围 | 状态 | 规则 |
|---|
| Rebate 可见列 | Confirmed from visible columns | Date 到 Release Amount 可用于当前只读查询页实现；右侧被遮挡列除外。 |
| Cashback 可见列 | Partially confirmed | Date 到 Release Amount 可作为当前字段基线，但 比例字段 的完整列名和计算口径仍需确认。 |
| 右侧被遮挡列 | Open Question | 需要无 Filter 面板或右滚截图确认完整列名、列顺序和是否进入导出。 |
| Excel Download 字段 | Open Question | 导出字段必须按 Rebate / Cashback 类型分别确认，不能把两类表格字段混用。 |
| 控件 | 规则 |
|---|
| 横向滚动条 | 位于表格下方，用于查看右侧金额和比例字段。 |
| 结果提示 | 左下角展示 Showing 1-10 of 1000。 |
| 页码 | 右下角展示上一页、页码、下一页，当前页紫色高亮。 |
| 翻页 | 保留当前类型、关键词和已生效筛选条件。 |
- Promotion Record 是只读查询页，不直接发放、撤回、编辑或核销优惠。
- Rebate 与 Cashback 之间共享通用筛选条件，但列定义、金额口径和 Type 词表必须独立。
- Date/Time、Brand、Player ID、Partner ID、Type 和 Include Sub-Partner 之间按 AND 处理。
- Include Sub-Partner 不能突破当前账号权限范围。
- Search、Filter Apply、Reset、类型切换和翻页后，当前结果回到第 1 页或保留翻页上下文，不能出现表格和导出范围不一致。
- Excel Download 只导出当前 Rebate / Cashback 类型、当前筛选和当前权限范围下的数据。
| 场景 | 处理 |
|---|
| 查询无结果 | 保留类型按钮、搜索区、Filter、表头、横向滚动条和分页容器，表格主体展示空态说明。 |
| Type 选项加载失败 | 保留当前结果，在 Type 下拉中展示重试入口。 |
| 日期范围非法 | 阻止 Apply，并在 Date/Time 附近提示。 |
| 查询失败 | 保留上一成功结果和当前草稿条件，提示重试。 |
| 导出失败 | 不清空列表，提示失败原因并允许重试。 |
Promotion Record 需确认项
- Date/Time 没有必填星号，当前定义为可选；如果必须限制时间范围，需要补充默认范围。
- Type 下拉未提供展开态，需要确认 Rebate 和 Cashback 各自的选项词表。
- Rebate 与 Cashback 表格右侧部分列名被 Filter 面板遮挡，需要补充无面板态或滚动到右侧截图。
- Rebate 的
42 和 Cashback 的 4,950 发放金额计算口径需要业务确认。
