Player Record
Coupon Mgmt. Player Record 子页面 PRD，覆盖玩家优惠券明细、筛选抽屉、查询结果、汇总卡片和发券入口。
Player Record 是 Coupon Mgmt. 的默认子页面，用于按玩家维度追踪优惠券发放、使用、核销和处理记录。
页面摘要
| 项目 | 说明 |
|---|---|
| 页面性质 | 玩家维度优惠券记录查询页，定义发券和核销入口；当前页不承载完整发券或核销提交表单 |
| 核心动作 | 搜索玩家优惠券记录，组合筛选，核对汇总卡、宽表格和 Total 行 |
| 数据范围 | 当前账号有权限查看的品牌、下级代理、会员和玩家优惠券记录 |
| 当前状态 | 查询、筛选、汇总卡、宽表格和分页已定义；Date/Time 必填，表格选择只用于当前页操作，发券和核销表单由对应流程承接 |
参考区
页面状态 Figma 截图
Coupon Mgmt.
Player Record 默认态展示左半区列：Issue Time、Sender、Sender Stage、Member ID、Brand、Partner ID、Partner Code、Coupon Amount、Start Time。
截图说明只作为 Figma 证据摘要，不作为字段定义；字段口径、完整列、导出和权限规则以字段模型章节为准。
同一张宽表的右半区列：End Time、Valid Period、Status、Usage Time、Redeem Time、Memo、Worker、Edit，并确认底部总计行、横向滚动条和分页。
截图说明只作为 Figma 证据摘要，不作为字段定义；字段口径、完整列、导出和权限规则以字段模型章节为准。
页面状态 Figma 截图
Coupon Mgmt.
Filter 抽屉打开后，Date/Time 字段展开双月日期范围选择器，支持时间选择、Clear 和 Apply。
截图说明只作为 Figma 证据摘要，不作为字段定义；字段口径、完整列、导出和权限规则以字段模型章节为准。
Brand 手风琴展开后显示 All Brands、IKEA、W365、Oh my God、The King+ 复选列表，用于组合品牌范围。
截图说明只作为 Figma 证据摘要，不作为字段定义；字段口径、完整列、导出和权限规则以字段模型章节为准。
Status 手风琴展开后显示 All、Active、Collect、Expired、Redeem、Used 选项；截图同时保留 Date/Time 与 Brand 折叠态。
截图说明只作为 Figma 证据摘要，不作为字段定义；字段口径、完整列、导出和权限规则以字段模型章节为准。
Member / Partner 筛选态展示完整抽屉高度：Date/Time、Brand、Status 折叠，Member ID、Partner ID、Sender、Worker 输入框和 Include Sub-Partner 复选框可见。
截图说明只作为 Figma 证据摘要，不作为字段定义；字段口径、完整列、导出和权限规则以字段模型章节为准。
页面状态 Figma 截图
Coupon Mgmt.
查询或筛选生效后，在标题下方显示条件 chips，并同步刷新汇总卡片和记录表。当前导出图仍高亮 Player Record，需结合 PRD 说明理解为记录查询结果态。
截图说明只作为 Figma 证据摘要，不作为字段定义；字段口径、完整列、导出和权限规则以字段模型章节为准。
全局依赖
| 全局模块 | 说明 |
|---|---|
| Top | 展示 Coupon Balance、Withdrawal Balance、消息和 Profile；本页不重复定义 Top 逻辑。 |
| Global One Line Notice | 有维护公告时显示在 Top 下方。 |
| Daily Record | 同属 Coupon Mgmt.，用于日维度汇总记录；两个子页面筛选条件互不强制同步。 |
功能规则
| 区域 | 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、页码 | 分页与滚动 |
功能地图
页签导航
| 项目 | 说明 |
|---|---|
| Player Record | 默认选中，展示玩家明细记录。 |
| Daily Record | 点击后进入 Daily Record，查看日维度优惠券汇总记录。 |
| 切换规则 | 切换到 Daily Record 时，Player Record 的搜索词、筛选条件、分页和横向滚动状态在当前会话内保留。 |
查询与动作
| 元素 | 说明 |
|---|---|
| Search 输入框 | 占位文案为 Search for transaction。输入后点击 Search 或按回车提交查询。 |
| Search 按钮 | 对当前 Player Record 执行显式查询，并将结果回到第一页。 |
| Filter 按钮 | 打开右侧 Filters 抽屉；抽屉条件点击 Apply 后才生效。 |
| Send Coupons | 进入发券流程；默认使用当前勾选玩家作为发券对象，未勾选时需要先选择对象。 |
| Coupon Redeem | 进入核销 / 兑换流程；默认要求先选择一条可核销优惠券记录。 |
Filter 抽屉
| 字段 | UI 表现 | 规则 |
|---|---|---|
| Date/Time | 带日历图标，展开日期范围面板，支持时间、Clear 和 Apply | 选择后回填输入框；Date/Time 为必填筛选，默认使用共享最近周期 |
| 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 行和分页 |
条件 chips
| 项目 | 说明 |
|---|---|
| 展示位置 | 标题与汇总卡片之间。 |
| 展示内容 | 日期范围、品牌、Member ID、Partner ID 等已提交条件。 |
| 移除方式 | 点击单个 chip 的关闭图标后，移除该条件并立即刷新结果。 |
| 顺序 | 日期范围优先，其次是枚举类条件，再到文本条件。 |
汇总卡片
| 卡片 | 说明 |
|---|---|
| Release Amount | 当前结果范围内的发放金额汇总。 |
| Used amount | 当前结果范围内的已使用金额汇总。 |
| Release Coupon Partner | 当前结果范围内发生发券的代理数量。 |
| Number of Used Players | 当前结果范围内使用过优惠券的会员数量。 |
| 涨跌标记 | 绿色百分比胶囊，默认对比当前筛选范围的上一等长周期；无上一周期数据时显示 -。 |
Player Record 表格级定义
| 项目 | 定义 |
|---|---|
| 行粒度 | 每一行代表一张优惠券发放、领取、使用或核销记录。 |
| 汇总粒度 | Total 行汇总当前筛选范围内有金额意义的字段；无汇总意义字段展示 -。 |
| 默认排序 | 默认按 Issue Time 倒序。 |
| 数据范围 | 受当前页签、Search、Filter、品牌、Member ID、Partner ID、Include Sub-Partner 和权限范围限制。 |
| 父子 / 展开关系 | 无展开子行；Edit 只作为入口，编辑表单字段按后续表单 PRD 补充。 |
| 导出关系 | Excel Download 只导出当前筛选、当前表格 / 弹窗层级的字段模型，并按权限脱敏；选择列、操作列、按钮入口、内部字段和未纳入字段模型的字段不导出。 |
Player Record 字段模型
| 字段 | 所在区域 | 定义 / 口径 | 展示规则 | 导出 | 备注 |
|---|---|---|---|---|---|
| Selection | 表格行首 | 行选择控件。 | 表头和行均显示复选框。 | 不导出 | 默认只支持当前页选择；没有批量操作入口时隐藏选择列。 |
Issue Time | Player Record 表格 | 优惠券发放时间。 | 统一时间格式。 | 按权限导出 | 建议作为默认排序候选字段。 |
Sender | Player Record 表格 | 发券人账号或用户名。 | 文本展示。 | 按权限导出 | 默认展示发券管理员或代理账号。 |
Sender Stage | Player Record 表格 | 发券人层级。 | 文本展示。 | 按权限导出 | 层级词表使用 Step 1, Step 2 等 Partner 层级命名。 |
Member ID | Player Record 表格 | 接收或使用优惠券的会员编号。 | 文本展示。 | 按权限导出 | 受权限范围限制。 |
Brand | Player Record 表格 | 记录所属品牌。 | 品牌名称或标签。 | 按权限导出 | 与筛选品牌一致。 |
Partner ID | Player Record 表格 | 会员归属代理编号。 | 文本展示。 | 按权限导出 | Include Sub-Partner 会影响可见范围。 |
Partner Code | Player Record 表格 | 会员归属代理码。 | 文本展示。 | 按权限导出 | 默认与 Partner ID 一一对应；如存在多码归属，以记录生成时的归属码为准。 |
Coupon Amount | Player Record 表格 | 优惠券金额。 | 金额格式。 | 按权限导出 | 参与 Total 行汇总。 |
Start Time / End Time | Player Record 表格 | 优惠券生效与截止时间。 | 统一时间格式。 | 按权限导出 | 与 Valid Period 需可对账。 |
Valid Period | Player Record 表格 | 有效期文案。 | 示例 30 Days、15th。 | 按权限导出 | 默认由 Start Time / End Time 或券配置有效期生成。 |
Status | Player Record 表格 | 优惠券当前状态。 | 彩色标签；可见值包括 Used、Issue、Expired、Redeem、Collect。 | 按权限导出 | 默认流转为 Issue / Active -> Collect / Redeem / Used / Expired。 |
Usage Time | Player Record 表格 | 优惠券使用时间。 | 未使用时展示 -。 | 按权限导出 | 与 Status 对应关系保持一致。 |
Redeem Time | Player Record 表格 | 核销或兑换时间。 | 未核销时展示统一空值。 | 按权限导出 | 仅在已核销或已兑换状态展示时间，其他状态显示 -。 |
Memo | Player Record 表格 | 备注。 | 过长时截断。 | 按权限导出 | 权限不足时按敏感字段规则脱敏。 |
Worker | Player Record 表格 | 处理人。 | 文本展示。 | 按权限导出 | 受操作权限影响。 |
Edit | Player Record 表格 | 行级编辑入口。 | 按钮展示。 | 不导出 | 当前不定义编辑表单。 |
Total 行 | 表格底部 | 当前筛选范围的汇总行。 | 不参与汇总的字段显示 -。 | 按权限导出 | 是否跨分页汇总按后端返回口径处理。 |
分页与横向滚动
| 项目 | 说明 |
|---|---|
| 横向滚动条 | 表格下方独立紫色滚动条，用于查看右侧列。 |
| 计数文案 | 左下角显示 Showing 1 to 10 of 100 Entries。 |
| 分页大小 | 右下角提供 10 per page 选择器。 |
| 页码控件 | 包含 Previous、页码、...、Next。切换页码时保留当前筛选。 |
业务规则
-
Search、Filter、汇总卡片、表格、Total 行和分页必须使用同一结果范围。
-
任意搜索、筛选或页签切换后，当前页签结果回到第 1 页。
-
All Brands与具体品牌互斥；选择具体品牌后自动取消All Brands。 -
Include Sub-Partner只扩大当前账号权限范围内的下级代理数据。 -
条件 chips 必须真实反映已提交条件；清除 chip 后应立即刷新结果。
-
横向滚动不改变查询条件、分页状态或汇总卡片数值。
-
Send Coupons、Coupon Redeem、Edit必须受权限控制。 -
状态词表使用统一优惠券状态字典：筛选
Active对应有效券记录，表格Issue暂按已发放状态处理。 -
Date/Time 按必填筛选处理，默认使用系统配置的最近周期。
-
表格复选框仅用于当前页批量动作；没有批量动作时隐藏选择列。
-
Send Coupons 使用当前页已选玩家；Coupon Redeem 仅处理单条可核销记录；Edit 仅允许修改备注和业务补充字段，三类操作都必须校验权限并写审计记录。
页面特例
| 场景 | 处理 |
|---|---|
| 查询无结果 | 保留卡片、筛选条件和 chips，表格主体显示空态，Total 行保留结构。 |
| 抽屉选项加载失败 | 保留当前列表结果，在抽屉内显示重试提示。 |
| 无品牌权限 | 禁用 Brand 区域，并提示当前账号无可选品牌。 |
| 搜索 / 筛选失败 | 保留上一次成功结果并提示重试，不展示模拟数据。 |