Player Record
Coupon Mgmt. Player Record 子页面 PRD，覆盖玩家优惠券明细、筛选抽屉、查询结果、汇总卡片和发券入口。
Player Record 是 Coupon Mgmt. 的默认子页面，用于按玩家维度追踪优惠券发放、使用、核销和处理记录。
页面摘要
| 项目 | 说明 |
|---|---|
| 页面性质 | 玩家维度优惠券记录查询页，当前只确认发券和核销入口，不确认完整后续流程 |
| 核心动作 | 搜索玩家优惠券记录，组合筛选，核对汇总卡、宽表格和 Total 行 |
| 数据范围 | 当前账号有权限查看的品牌、下级代理、会员和玩家优惠券记录 |
| 当前状态 | 查询、筛选、汇总卡、宽表格和分页已定义；发券表单、核销流程、批量用途和 Date/Time 必填仍待确认 |
需求状态
| 状态 | 内容 |
|---|---|
Confirmed | Player Record 是 Coupon Mgmt. 默认子页面；查询条件、汇总卡片、宽表格、Total 行和分页必须使用同一已生效数据口径。 |
Inferred from Figma | Date/Time 因星号暂作为重点筛选字段；Include Sub-Partner 按当前截图默认勾选处理；表格复选框暂只表示选择状态。 |
Open Question | Date/Time 是否强制、默认时间范围、复选框批量用途、Send Coupons / Coupon Redeem 后续流程和状态字段口径仍待确认，见 开放问题。 |
1. Figma 原型
页面状态 Figma 截图
Coupon Mgmt.
Player Record 默认态展示左半区列：Issue Time、Sender、Sender Stage、Member ID、Brand、Partner ID、Partner Code、Coupon Amount、Start Time。
同一张宽表的右半区列：End Time、Valid Period、Status、Usage Time、Redeem Time、Memo、Worker、Edit，并确认底部总计行、横向滚动条和分页。
页面状态 Figma 截图
Coupon Mgmt.
Filter 抽屉打开后，Date/Time 字段展开双月日期范围选择器，支持时间选择、Clear 和 Apply。
Brand 手风琴展开后显示 All Brands、IKEA、W365、Oh my God、The King+ 复选列表，用于组合品牌范围。
Status 手风琴展开后显示 All、Active、Collect、Expired、Redeem、Used 选项；截图同时保留 Date/Time 与 Brand 折叠态。
Member / Partner 筛选态展示完整抽屉高度：Date/Time、Brand、Status 折叠，Member ID、Partner ID、Sender、Worker 输入框和 Include Sub-Partner 复选框可见。
页面状态 Figma 截图
Coupon Mgmt.
查询或筛选生效后，在标题下方显示条件 chips，并同步刷新汇总卡片和记录表。当前导出图仍高亮 Player Record，需结合 PRD 说明理解为记录查询结果态。
2. 页面目标
| 项目 | 定义 |
|---|---|
| 页面类型 | Feature Page PRD |
| 所属模块 | Coupon Mgmt. |
| 页面定位 | 玩家维度优惠券发放、使用、核销和操作记录页 |
| 主要任务 | 搜索玩家记录、组合筛选、核对汇总卡片、进入 Send Coupons / Coupon Redeem |
| 数据范围 | 当前账号有权限查看的品牌、下级代理、会员和玩家优惠券记录 |
关键规则摘要
Player Record 的查询条件、汇总卡片、宽表格、Total 行和分页必须使用同一数据口径。横向滚动只改变可见列，不改变查询结果。
3. 全局依赖
| 全局模块 | 说明 |
|---|---|
| Top | 展示 Coupon Balance、Withdrawal Balance、消息和 Profile；本页不重复定义 Top 逻辑。 |
| Global One Line Notice | 有维护公告时显示在 Top 下方。 |
| Daily Record | 同属 Coupon Mgmt.，用于日维度汇总记录；两个子页面筛选条件互不强制同步。 |
4. 页面组成
| 区域 | UI 表现 | 对应功能说明 |
|---|---|---|
| 面包屑与页签 | Home > Coupon Management，Player Record 高亮，旁边是 Daily Record | 页签导航 |
| 查询与动作区 | Search for transaction、Search、Filter、Send Coupons、Coupon Redeem | 查询与动作 |
| 条件 chips | 查询后在标题下方显示日期、品牌、Member / Partner 等条件 | 条件 chips |
| 汇总卡片 | Release Amount、Used amount、Release Coupon Partner、Number of Used Players | 汇总卡片 |
| Player Record 表格 | 宽表格、复选框、状态标签、Total 行、横向滚动条 | Player Record 表格 |
| Filter 抽屉 | Date/Time、Brand、Status、Member ID、Partner ID、Sender、Worker、Include Sub-Partner | Filter 抽屉 |
| 分页区 | Showing 1 to 10 of 100 Entries、10 per page、页码 | 分页与滚动 |
5. 功能说明
5.1 页签导航
| 项目 | 说明 |
|---|---|
| Player Record | 默认选中，展示玩家明细记录。 |
| Daily Record | 点击后进入 Daily Record，查看日维度优惠券汇总记录。 |
| 切换规则 | 切换到 Daily Record 时，Player Record 的搜索词、筛选条件、分页和横向滚动状态在当前会话内保留。 |
5.2 查询与动作
| 元素 | 说明 |
|---|---|
| Search 输入框 | 占位文案为 Search for transaction。输入后点击 Search 或按回车提交查询。 |
| Search 按钮 | 对当前 Player Record 执行显式查询，并将结果回到第一页。 |
| Filter 按钮 | 打开右侧 Filters 抽屉；抽屉条件点击 Apply 后才生效。 |
| Send Coupons | 进入发券流程。当前 Figma 只确认入口，不定义完整表单。 |
| Coupon Redeem | 进入核销 / 兑换流程。当前 Figma 只确认入口，不定义后续状态。 |
5.3 Filter 抽屉
| 字段 | UI 表现 | 规则 |
|---|---|---|
| Date/Time | 带日历图标，展开日期范围面板，支持时间、Clear 和 Apply | 选择后回填输入框；是否必填仍待确认 |
| Brand | 手风琴复选列表，含 All Brands、IKEA、W365、Oh my God、The King+ | All Brands 与具体品牌互斥 |
| Status | 手风琴复选列表，含 All、Active、Collect、Expired、Redeem、Used | 状态词表需与表格状态统一 |
| Member ID | 文本输入框 | 按会员编号精确过滤 |
| Partner ID | 文本输入框 | 按代理编号精确过滤 |
| Sender | Search Sender 输入框 | 按发券人过滤 |
| Worker | Search Worker 输入框 | 按处理人过滤 |
| Include Sub-Partner | 独立复选框，截图中默认勾选 | 勾选后纳入下级代理数据 |
| Clear all | 抽屉头部操作 | 清空抽屉内条件但不提交 |
| Reset | 抽屉底部操作 | 恢复 Player Record 默认筛选 |
| Apply | 抽屉底部主操作 | 提交当前条件，刷新卡片、表格、Total 行和分页 |
5.4 条件 chips
| 项目 | 说明 |
|---|---|
| 展示位置 | 标题与汇总卡片之间。 |
| 展示内容 | 日期范围、品牌、Member ID、Partner ID 等已提交条件。 |
| 移除方式 | 点击单个 chip 的关闭图标后，移除该条件并立即刷新结果。 |
| 顺序 | 日期范围优先，其次是枚举类条件，再到文本条件。 |
5.5 汇总卡片
| 卡片 | 说明 |
|---|---|
| Release Amount | 当前结果范围内的发放金额汇总。 |
| Used amount | 当前结果范围内的已使用金额汇总。 |
| Release Coupon Partner | 当前结果范围内发生发券的代理数量。 |
| Number of Used Players | 当前结果范围内使用过优惠券的会员数量。 |
| 涨跌标记 | 绿色百分比胶囊，比较基线未在截图中明确，必须与当前条件范围一致。 |
5.6 Player Record 表格
| 列 / 元素 | 说明 |
|---|---|
| 选择列 | 表头与每行都有复选框；当前无批量动作截图，批量用途待确认。 |
| Issue Time | 记录发放时间。 |
| Sender | 发券人账号或用户名。 |
| Sender Stage | 发券人层级。 |
| Member ID | 会员编号。 |
| Brand | 记录所属品牌。 |
| Partner ID | 代理编号。 |
| Partner Code | 代理码。 |
| Coupon Amount | 优惠券金额。 |
| Start Time / End Time | 优惠券生效与截止时间。 |
| Valid Period | 有效期文案，例如 30 Days、15th。 |
| Status | 彩色胶囊状态。截图出现 Used、Issue、Expired、Redeem、Collect。 |
| Usage Time | 使用时间。 |
| Redeem Time | 核销或兑换时间。 |
| Memo | 备注。 |
| Worker | 处理人。 |
| Edit | 行级入口按钮；当前只确认按钮，不定义编辑表单。 |
| Total 行 | 表格底部固定显示 Total，无汇总值字段使用 -。 |
5.7 分页与横向滚动
| 项目 | 说明 |
|---|---|
| 横向滚动条 | 表格下方独立紫色滚动条，用于查看右侧列。 |
| 计数文案 | 左下角显示 Showing 1 to 10 of 100 Entries。 |
| 分页大小 | 右下角提供 10 per page 选择器。 |
| 页码控件 | 包含 Previous、页码、...、Next。切换页码时保留当前筛选。 |
6. 业务规则
- Search、Filter、汇总卡片、表格、Total 行和分页必须使用同一结果范围。
- 任意搜索、筛选或页签切换后，当前页签结果回到第 1 页。
All Brands与具体品牌互斥；选择具体品牌后自动取消All Brands。Include Sub-Partner只扩大当前账号权限范围内的下级代理数据。- 条件 chips 必须真实反映已提交条件；清除 chip 后应立即刷新结果。
- 横向滚动不改变查询条件、分页状态或汇总卡片数值。
Send Coupons、Coupon Redeem、Edit必须受权限控制。
7. 异常与空态
| 场景 | 处理 |
|---|---|
| 查询无结果 | 保留卡片、筛选条件和 chips，表格主体显示空态，Total 行保留结构。 |
| 抽屉选项加载失败 | 保留当前列表结果，在抽屉内显示重试提示。 |
| 无品牌权限 | 禁用 Brand 区域，并提示当前账号无可选品牌。 |
| 搜索 / 筛选失败 | 保留上一次成功结果并提示重试，不展示模拟数据。 |
8. 开放问题
Player Record 需确认项
- Status 筛选里出现
Active，但表格状态为Issue，需要统一状态词表。 - Date/Time 有必填星号，需要确认是否强制日期范围，以及默认日期范围。
- 表格复选框缺少批量动作，需要确认用途。
- Send Coupons、Coupon Redeem、Edit 缺少后续流程截图。
9. 验收标准
- 从 Coupon Mgmt. 进入时默认打开 Player Record。
- Player Record 必须展示完整筛选抽屉、4 张汇总卡片、宽表格、Total 行、横向滚动条和分页。
- Apply、Search 和 chip 删除后，卡片、表格、Total 行、计数文案和分页同步刷新。
- 切换到 Daily Record 再返回时，Player Record 的查询上下文在当前会话内保留。
- 无权限用户看不到或无法点击 Send Coupons、Coupon Redeem、Edit。