Ruby Agent System PRD

Daily Record

Coupon Mgmt. Daily Record 子页面 PRD,覆盖每日优惠券汇总、Redeem Method 筛选、表格和分页。

Daily Record 是 Coupon Mgmt. 的日维度记录页,用于按日期汇总优惠券发放、使用、核销方式、金额和余额变化。

页面摘要

项目说明
页面性质日维度优惠券汇总查询页,不展示玩家明细,不发起发券或核销
核心动作按日期、品牌、状态、Redeem Method 查询每日汇总,核对发放、使用、核销和余额变化
数据范围当前账号有权限查看的品牌、下级代理和每日优惠券汇总记录
当前状态日汇总查询、筛选、表格和分页已定义;Date/Time 默认范围和部分状态口径仍待确认

需求状态

状态内容
ConfirmedDaily Record 聚焦日维度汇总;不展示玩家明细字段;查询条件、表格、金额和分页必须使用同一权限范围。
Inferred from FigmaDate/Time 因必填星号暂按重点筛选字段处理;Redeem Method 按当前截图作为查询维度保留。
Open QuestionDate/Time 是否强制、默认日期范围、Redeem Method / Status 词表和移动端状态仍待确认,见 开放问题

1. Figma 原型

页面状态 Figma 截图

Coupon Mgmt.

Coupon Mgmt. - 2.1 Daily Record 筛选态

Daily Record 页签高亮,页面标题为 Daily Coupon Records;右侧 Filter 抽屉展示 Date/Time、Brand、Status、Redeem Method 和 Include Sub-Partner。

2. 页面目标

项目定义
页面类型Feature Page PRD
所属模块Coupon Mgmt.
页面定位日维度优惠券汇总记录页
主要任务搜索每日记录、筛选日期 / 品牌 / 状态 / 兑换方式、核对金额和余额变化
数据范围当前账号有权限查看的品牌、下级代理和每日优惠券汇总记录

关键规则摘要

Daily Record 聚焦日维度汇总,不展示玩家明细字段。它与 Player Record 共享模块权限范围,但筛选条件、表格列和操作入口独立。

3. 页面组成

区域UI 表现对应功能说明
面包屑与页签Home > Coupon ManagementDaily Record 高亮页签导航
查询区Search for transactionSearchFilter查询
汇总卡片Release AmountUsed amountRelease Coupon Partner、第四张使用类卡片汇总卡片
Daily Record 表格Creation Time、Brand、Status、Quantity、Coupon Amount、Total Amount、Before Balance 等列Daily Record 表格
Filter 抽屉Date/Time、Brand、Status、Redeem Method、Include Sub-Partner、Reset、ApplyFilter 抽屉
分页区Showing 1 to 10 of 100 Entries10 per page、页码分页

4. 功能说明

4.1 页签导航

项目说明
Player Record点击后进入 Player Record
Daily Record当前选中,标题为 Daily Coupon Records
切换规则切换页签时保留 Daily Record 当前搜索词、筛选条件和分页状态,返回时恢复。

4.2 查询

元素说明
Search 输入框占位文案为 Search for transaction
Search 按钮提交当前关键词并刷新 Daily Record 表格和汇总卡片。
Filter 按钮打开右侧 Filter 抽屉。Daily Record 截图不显示 Send Coupons / Coupon Redeem 按钮。

4.3 Filter 抽屉

字段UI 表现规则
Date/Time带日历图标,截图显示 2025/08/01 - 2025/08/29当前页必填标记存在,默认范围需确认
Brand折叠手风琴只展示当前账号有权限的品牌
Status折叠手风琴状态词表应与表格状态胶囊一致
Redeem Method折叠手风琴用于区分兑换 / 核销方式,例如截图行值 Auto Redeem
Include Sub-Partner独立复选框,截图中勾选勾选后纳入下级代理日汇总
Clear all抽屉头部操作清空抽屉内条件但不提交
Reset抽屉底部操作恢复 Daily Record 默认条件
Apply抽屉底部主操作提交当前条件并刷新卡片、表格和分页

4.4 汇总卡片

卡片说明
Release Amount当前日期 / 品牌 / 状态范围内的发放金额。
Used amount当前范围内的已使用金额。
Release Coupon Partner当前范围内发生发券的代理数量。
第四张使用类卡片截图右侧被 Filter 抽屉遮挡,只能确认存在同样样式的卡片;字段名需补无抽屉态确认。

4.5 Daily Record 表格

列 / 元素说明
Creation Time日汇总记录创建时间。
Brand记录所属品牌。
Status彩色胶囊状态,截图出现 UsedIssueExpiredRedeemCollect
Quantity当前行对应的数量。
Coupon Amount单张或单次优惠券金额。
Total Amount当前行总金额。
Before Balance操作前余额。
After Balance截图右侧被抽屉部分遮挡,行值可见 3,000,000,列名需补图确认。
Redeem Method兑换方式,截图可见行值 Auto Redeem,列名位置被抽屉遮挡需补图确认。

字段完整性状态:

范围状态规则
左侧可见列Confirmed from visible columnsCreation Time 到 Before Balance 可作为当前 Daily Record 字段基线。
After BalancePartially confirmed行值可见且业务含义明确,但表头被遮挡;需补无抽屉态确认最终列名。
Redeem MethodPartially confirmed行值可见且与筛选项一致,但表头位置被遮挡;需补图确认列顺序。
导出字段Open Question导出字段必须等待右侧列完整确认,不能只按当前抽屉遮挡截图截断。

4.6 分页

项目说明
计数文案左下角显示 Showing 1 to 10 of 100 Entries
分页大小右下角提供 10 per page
页码控件包含 Previous、页码、...Next;切换页码保持当前筛选条件。

5. 业务规则

  • Daily Record 的 Search、Filter、汇总卡片、表格和分页必须使用同一日汇总数据范围。
  • Daily Record 不展示 Player Record 的 Member ID、Partner ID、Sender、Worker 输入筛选。
  • Redeem Method 只在 Daily Record Filter 中出现,用于筛选兑换 / 核销方式。
  • 任意搜索或筛选提交后,当前页回到第 1 页。
  • Include Sub-Partner 只扩大当前账号权限范围内的下级代理日汇总。
  • 如果右侧余额和兑换方式列被抽屉遮挡,实际实现仍必须保证表格横向可查看或抽屉关闭后可查看完整列。

6. 异常与空态

场景处理
查询无结果保留汇总卡片和筛选条件,表格主体显示空态。
Redeem Method 选项为空禁用该折叠项并显示无可选项提示。
品牌无权限Brand 折叠项禁用并提示当前账号无可选品牌。
查询失败保留上一次成功数据并提示重试,不展示模拟数据。

7. 开放问题

Daily Record 需确认项

  • 表格右侧表头被 Filter 抽屉遮挡,需要补充抽屉关闭态或横向滚动到右侧的截图,确认 After BalanceRedeem Method 列名。
  • 第四张汇总卡片被抽屉遮挡,需要确认字段名是否仍为 Number of Used Players
  • Status 词表仍存在 Issue / Active 不一致问题,需要与 Player Record 一起统一。
  • Date/Time 有必填星号,需要确认 Daily Record 是否必须带默认日期范围。

8. 验收标准

  1. 左侧菜单中 Coupon Mgmt. 下必须能进入 Daily Record 子页面。
  2. Daily Record 页签高亮,标题为 Daily Coupon Records
  3. Filter 抽屉必须包含 Date/Time、Brand、Status、Redeem Method、Include Sub-Partner、Reset、Apply。
  4. Search 或 Apply 后,汇总卡片、表格、计数文案和分页使用同一条件刷新。
  5. Daily Record 不出现 Send Coupons / Coupon Redeem 按钮,除非后续 Figma 明确补充。
  6. 查询失败或无数据时保留页面结构和已提交条件,不展示模拟数据。

本页目录