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 层级、GGR / Bet 指标和状态
当前状态默认宽表、筛选抽屉和分页已定义;搜索字段、状态映射、批量/详情/发券流程仍待确认

需求状态

状态内容
ConfirmedPartner List 是 Customer Mgmt. 独立子页面;宽表、筛选、状态和排序不复用 Member List 字段。
Inferred from FigmaSend Coupons 只按入口处理;搜索框暂不把 Search for transaction 作为正式搜索范围;表格按宽表横向滚动处理。
Open QuestionSend Coupons 后续流程、搜索字段、状态映射、批量用途、详情弹窗和完整列定义仍待确认,见 开放问题

1. Figma 参考稿

页面状态 Figma 截图

Customer Mgmt.

Customer Mgmt. - 4.1 Partner List 默认态

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

页面状态 Figma 截图

Customer Mgmt.

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

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

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

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

Customer Mgmt. - 4.4 Partner List - Brand 筛选

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

Customer Mgmt. - 4.5 Partner List - Status 筛选

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

Customer Mgmt. - 4.6 Partner List - Order 排序

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

截图校验说明

Figma 提供了两张 Partner List 默认态导出图,但画面内容一致,文档按一个默认态收敛。Send Coupons 在页面上只有入口按钮,点击后的弹窗或成功态未提供截图,本页暂只确认入口存在。

2. 页面目标

项目定义
页面类型Feature Page PRD
所属模块Customer Mgmt.
页面入口Customer Mgmt. 中切换到 Partner List 页签
主要任务查看 Partner 宽表、搜索 Partner、筛选 Partner、按状态和排序审查 Partner 数据
数据范围当前账号有权限查看的品牌和下级 Partner
相关模块Coupon Mgmt. 承接页面中的 Send Coupons 审计与记录

3. 页面组成

区域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、页码分页

4. 功能说明

4.1 页面入口与独立性

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

4.2 默认列表

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

状态UI / 行为
有数据显示 Partner 表格、横向滚动条和底部分页。
无数据当前未提供空态截图;建议沿用 Member List 的表头保留 + 中央 No Data 模式,待产品确认。
Send Coupons 入口默认态可见,但点击后的交互截图缺失,当前只确认入口展示。

4.3 搜索与操作

元素规则
搜索框占位文案为 Search for transaction;搜索字段未在设计稿中明确,需确认是否按 Partner ID / Top Partner / Brand 组合搜索。
Search提交搜索词并刷新列表,通常回到第一页。
Filter打开右侧筛选抽屉;未点击 Apply 前不提交条件。
Send Coupons页面右上角有入口按钮;由于缺少点击后截图,暂不定义 Partner 页面是否复用 Member 侧发券弹窗。

4.4 Partner 表格

列 / 元素说明
Brand品牌列,示例值为 w365
Partner IDPartner 账号,如 Daebak_Partner001
Top Partner上级 Partner / 代码字段,示例值为 Daebak_Code001
Partner StagePartner 层级,如 Step 1
Sports GGR%体育 GGR 占比,例如 2.3%
Casino GGR%真人 / 赌场 GGR 占比,例如 5.5%
Slot GGR%老虎机 GGR 占比,例如 2.8%
Sports Bet%体育投注占比,例如 2.1%
Casino Bet%真人 / 赌场投注占比,例如 1.5%
Slot Bet%老虎机投注占比,例如 3.2%
Status行状态 pill,截图中出现 NormalBlock

Partner List 为明显的宽表结构,依赖底部横向滚动条查看所有指标列。当前截图未显示复选框列、详情弹窗入口或行级操作按钮,因此本页暂不定义 Partner 详情弹窗。

4.5 筛选抽屉

点击 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。UI 为 checkbox 风格,但业务上建议只允许一种排序生效,待产品确认。
Reset清空抽屉临时值,不立即提交。
Apply提交当前抽屉条件并刷新列表。

Date/Time 选择器

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

4.6 分页

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

5. 业务规则

  • Partner List 只展示 Partner 维度字段,不下沉 Member Detail 结构。
  • 搜索、筛选和排序应共同作用于同一列表结果。
  • BrandStatus 可以组合筛选;Partner ID 为精确或模糊匹配需后续确认。
  • Status 行值与筛选值命名口径必须统一后才能进入开发。
  • Send Coupons 若在 Partner 页面可执行,必须额外定义以 Partner 维度发券的目标范围和确认口径。

6. 开放问题

Partner List 当前仍有信息缺口

  • 默认态导出图有两张重复图,文档已按一个默认态处理。
  • Partner ID 输入框占位文案不一致:partner ID / partner account
  • 表格状态显示 Normal / Block,筛选项为 Active / Inactive / Block / Succession,映射关系未确认。
  • Order 使用 checkbox 风格,但是否允许多选未确认。
  • 缺少空态、加载态、错误态、Send Coupons 点击后态和 Partner 详情态截图。

7. 验收标准

  • 左侧进入 Customer Mgmt. 后可通过页签进入独立的 Partner List 页面。
  • Partner List 不复用 Member List 的表格字段和 Member Detail 弹窗描述。
  • 默认态文档明确覆盖 Partner 宽表、搜索、Filter、Send Coupons、横向滚动条和分页。
  • 筛选抽屉文档完整覆盖 Date/TimeBrandPartner IDStatusOrderResetApply
  • Brand、Status、Order 的选项列表与设计稿一致。
  • 日期选择器按单月 + 时间输入 + Clear / Apply 记录。
  • 所有待确认点在文档中显式标注,而不是被默认省略。

本页目录