Ruby Agent System PRD

Partner List

Customer Mgmt. Partner List 独立子页面 PRD,覆盖 Partner 宽表、筛选抽屉、状态筛选与排序规则。

Partner List 是 Customer Mgmt. 下的独立子页面,用于按 Partner 维度查看品牌、层级、GGR / Bet 占比和当前状态,并通过独立筛选抽屉完成日期、品牌、Partner 账号、状态和排序查询。

页面摘要

项目说明
页面性质Partner 维度宽表查询页,定义 Send Coupons 入口;当前页只定义入口;Partner 发券默认进入“按 Partner 筛选会员”的发券流程
核心动作按日期、品牌、Partner 账号、状态、排序查询 Partner 宽表并核对层级和指标
数据范围当前账号有权限查看的品牌、Partner 层级、GGR / Bet 指标和状态
当前状态默认宽表、筛选抽屉和分页已定义;搜索字段、状态映射和发券入口已给出默认规则;本页不提供批量操作和 Partner 详情页

参考区

页面状态 Figma 截图

Customer Mgmt.

Customer Mgmt. - 4.1 Partner List 默认态

展示 Partner List 默认态:Customer Management 标题、搜索、Filter、Send Coupons、Partner 宽表、横向滚动条和分页。

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

页面状态 Figma 截图

Customer Mgmt.

Customer Mgmt. - 4.2 Partner List - Filter 默认态

Partner List Filter 浮层包含 Date/Time、Brand、Partner ID、Status、Order、Reset 和 Apply。

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

Customer Mgmt. - 4.3 Partner List - Date/Time 选择器

Partner List Date/Time 展开单月日期时间选择器,支持时间输入、Clear 和 Apply。

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

Customer Mgmt. - 4.4 Partner List - Brand 筛选

Brand 展开为复选列表,包含 All Brands、IKEA、W365、Oh my God、The King +。

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

Customer Mgmt. - 4.5 Partner List - Status 筛选

Status 展开项包含 All、Active、Inactive、Block 和 Succession。

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

Customer Mgmt. - 4.6 Partner List - Order 排序

Order 展开项包含 Latest、Oldest、Sort by Name、Sort by Amount。

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

截图校验说明

Figma 提供了两张 Partner List 默认态截图,但画面内容一致,文档按一个默认态收敛。Send Coupons 在页面上只有入口按钮,本页按入口处理;Partner 维度发券默认先按 Partner 筛选会员,再进入会员发券流程。

功能规则

区域UI 表现功能规则
面包屑与页签Home > Customer Management,当前高亮 Partner List页面入口与独立性
标题区Customer Management 和说明文案默认列表
操作区搜索框、Search、Filter、Send Coupons搜索与操作
Partner 表格Partner 宽表、横向滚动条Partner 表格
筛选抽屉Date/Time、Brand、Partner ID、Status、Order筛选抽屉
分页区Showing 1 to 10 of 100 Entries10 per page、页码分页

功能地图

页面入口与独立性

项目规则
页签关系Partner ListMember List 的同级独立页面,不属于 Member List 内部子章节。
默认页签进入 Customer Mgmt. 默认打开 Member List;用户切到 Partner List 后进入 Partner 维度页面。
状态隔离Partner ListMember List 的搜索词、筛选条件、横向滚动、分页和按钮状态互不共享。
返回规则Partner List 切回 Member List 时,不复用 Partner 宽表字段或抽屉字段。

默认列表

默认态展示 Customer Management 标题、搜索与操作按钮、Partner 宽表、横向滚动条和分页。

状态UI / 行为
有数据显示 Partner 表格、横向滚动条和底部分页。
无数据沿用共享表格空态:保留表头、横向滚动和分页容器,中部显示 No Data
Send Coupons 入口默认态可见;默认只定义入口展示;点击后按 Partner 筛选会员并进入发券流程。

搜索与操作

元素规则
搜索框占位文案为 Search for transaction;默认搜索 Partner ID / Partner Account;Top Partner 和 Brand 继续通过独立筛选项控制。
Search提交搜索词并刷新列表,通常回到第一页。
Filter打开右侧筛选抽屉;未点击 Apply 前不提交条件。
Send Coupons页面右上角有入口按钮;默认不直接给 Partner 实体发券;点击后按 Partner 筛选会员并进入会员发券流程。

Partner 表格级定义

项目定义
行粒度每一行代表当前筛选范围内的一个 Partner 账号或 Partner 统计对象。
汇总粒度当前表格无 Total 行;分页总数代表当前筛选范围内 Partner 记录数。
默认排序Order 筛选项控制;未选择时默认按最新更新时间倒序;选择 Sort by NameSort by Amount 后覆盖默认排序。
数据范围受搜索词、Date/Time、Brand、Partner ID、Status、Order 和当前账号权限范围限制。
父子 / 展开关系无展开行、详情弹窗或行级操作按钮;如后续增加 Partner 详情,需独立字段模型。
导出关系当前页面未提供导出入口;默认不导出。若后续新增导出入口,按当前筛选、字段模型和权限脱敏规则导出,选择列、操作列、按钮入口和内部字段不导出。

Partner 字段模型

字段所在区域定义 / 口径展示规则导出备注
BrandPartner 表格Partner 所属品牌。文本或品牌标签,示例 w365不导出受 Brand 筛选和权限范围限制。
Partner IDPartner 表格Partner 账号。文本展示,示例 Daebak_Partner001不导出默认搜索包含该列。
Top PartnerPartner 表格上级 Partner 或归属代码。文本展示,示例 Daebak_Code001不导出默认表示上级 Partner 账号或上级推广代码,不作为当前行 Partner Code。
Partner StagePartner 表格Partner 层级。示例 Step 1不导出层级词表使用 Step 1, Step 2 等 Partner 层级命名。
Sports GGR%Partner 表格Sports GGR 占比。百分比格式。不导出公式遵守财务统一口径。
Casino GGR%Partner 表格Casino GGR 占比。百分比格式。不导出公式遵守财务统一口径。
Slot GGR%Partner 表格Slot GGR 占比。百分比格式。不导出公式遵守财务统一口径。
Sports Bet%Partner 表格Sports 投注占比。百分比格式。不导出分母为当前行 Partner 在同一筛选范围内的总投注额。
Casino Bet%Partner 表格Casino 投注占比。百分比格式。不导出分母为当前行 Partner 在同一筛选范围内的总投注额。
Slot Bet%Partner 表格Slot 投注占比。百分比格式。不导出分母为当前行 Partner 在同一筛选范围内的总投注额。
StatusPartner 表格Partner 当前状态。行值可见 NormalBlock不导出默认映射为 Normal = ActiveBlock = BlockInactiveSuccession 仅在后端返回对应状态时展示。

筛选抽屉

点击 Filter 后在右侧打开浮层。筛选项均为抽屉内临时状态,只有点击 Apply 才生效。

筛选项UI / 行为
Date/Time必填项,默认展示 2025/08/01 - 2025/08/29;点击后展开单月日期时间选择器,支持时间输入、ClearApply
Brand多选复选框,包含 All BrandsIKEAW365Oh my GodThe King +
Partner ID文本输入;截图中占位文案分别出现 Enter your partner IDEnter your partner account,需统一。
Status多选项,包含 AllActiveInactiveBlockSuccession
Order排序项包含 LatestOldestSort by NameSort by Amount。默认一次只允许一种排序生效。
Reset清空抽屉临时值,不立即提交。
Apply提交当前抽屉条件并刷新列表。

Date/Time 选择器

元素规则
月份结构单月视图,截图中为 June 2025
时间输入小时 / 分钟 / 秒均显示 00 输入框。
Clear清空本次日期选择。
Apply确认日期范围并回填输入框。

分页

项目规则
计数文案Showing 1 to 10 of 100 Entries
每页数量默认 10 per page
切页保留已提交搜索词和筛选条件;不保留未 Apply 的抽屉临时值。
横向滚动与分页组合使用时应保持当前页签独立,不影响 Member List。

业务规则

  • Partner List 只展示 Partner 维度字段,不下沉 Member Detail 结构。

  • 搜索、筛选和排序应共同作用于同一列表结果。

  • BrandStatus 可以组合筛选;Partner ID 默认支持精确和模糊匹配,完整 ID 优先精确匹配。

  • Status 行值与筛选值命名口径必须统一后才能进入开发。

  • Send Coupons 若在 Partner 页面可执行,必须额外定义以 Partner 维度发券的目标范围和确认口径。

  • Partner ID 搜索默认覆盖 Partner ID 和 Partner Account;Top Partner 和 Brand 保持独立筛选。

  • 表格状态显示 Normal / Block,筛选项为 Active / Inactive / Block / Succession,默认映射为 Normal = ActiveBlock = BlockInactiveSuccession 需后端返回对应状态。

  • Order 只允许一个当前生效排序。

  • Send Coupons 进入按 Partner 筛选会员的发券流程,不直接给 Partner 实体发券;Partner 详情页不在本页范围。

本页目录