Coupon Mgmt.
Coupon Mgmt. 模块 PRD，总览 Player Record 与 Daily Record 的职责、全局依赖和跨页面规则。
Coupon Mgmt. 是代理商系统的优惠券记录与操作模块。它不再作为单一页面维护，而是拆分为 Player Record 和 Daily Record 两个子页面，分别承载玩家明细记录和日维度汇总记录。
页面摘要
| 项目 | 说明 |
|---|---|
| 页面性质 | Coupon Mgmt. 模块总览页，只定义模块边界和子页面阅读路径 |
| 核心动作 | 区分 Player Record 与 Daily Record 的职责，确认发券、核销和记录查询入口 |
| 数据范围 | 当前账号有权限查看的品牌、下级代理、会员和优惠券记录 |
| 当前状态 | 两个子页面已拆分；完整发券、核销、移动端和批量能力仍需在子页面或后续 PRD 中确认 |
需求状态
| 状态 | 内容 |
|---|---|
Confirmed | Coupon Mgmt. 拆分为 Player Record 与 Daily Record；模块首页不直接维护优惠券规则，具体表格和操作规则由子页面承担。 |
Inferred from Figma | 发券与核销在 Player Record 中作为入口存在，但完整表单、成功失败和权限流程不能从当前总览页推断为定稿。 |
Open Question | 发券、核销、批量动作、移动端和跨子页面筛选继承规则仍待确认，见 开放问题。 |
1. 模块定位
| 项目 | 定义 |
|---|---|
| 模块类型 | Module PRD |
| 默认入口 | 进入 Coupon Mgmt. 后默认打开 Player Record |
| 核心职责 | 查询优惠券发放、领取、使用、核销和日维度汇总记录 |
| 不承担职责 | 不在模块首页直接编辑优惠券规则；发券与核销流程由子页面入口进入独立流程 |
| 数据范围 | 当前账号有权限查看的品牌、下级代理、会员和优惠券记录 |
2. 子页面结构
| 子页面 | 页面类型 | 核心职责 | 文档入口 |
|---|---|---|---|
| Player Record | Feature Page PRD | 查看玩家维度的优惠券发放、使用、核销和处理记录 | Player Record |
| Daily Record | Feature Page PRD | 按日期查看优惠券数量、金额、余额和兑换方式汇总 | Daily Record |
3. 全局依赖
| 全局模块 | 使用规则 |
|---|---|
| Top | 展示会员汇总、Coupon Balance、Withdrawal Balance、消息入口和 Profile；Coupon Balance 必须与本模块发券可用余额口径一致。 |
| Global One Line Notice | 有有效高优先级公告时展示在 Top 下方，无公告时隐藏且不占位。 |
| 共享规则 | 语言、权限、会话、表单、反馈和视觉基线必须服从共享规则。 |
4. 阅读路径
先阅读 Top 和 Global One Line Notice，确认登录后全局顶部区域的统一口径。
阅读 Player Record，确认默认页签、玩家明细宽表、完整 Filter 抽屉和发券 / 核销入口。
阅读 Daily Record，确认 Daily Coupon Records 的日维度表格、Redeem Method 筛选和查询规则。
5. 模块规则
- Coupon Mgmt. 的左侧菜单必须在模块下展示 Player Record 和 Daily Record 两个子页面。
- 从侧边栏点击
Coupon Mgmt.时，默认进入 Player Record。 - 两个子页面共享 Top、One Line Notice、面包屑和权限范围，但各自维护独立的搜索词、筛选条件、分页和横向滚动状态。
- 搜索、筛选、汇总卡片、表格、总计行和分页必须使用同一数据范围，不允许汇总值与列表结果脱节。
Include Sub-Partner只扩大当前账号权限内的下级代理数据范围，不改变权限边界。Send Coupons、Coupon Redeem和行级Edit必须按权限显示或禁用，不能展示不可执行的假入口。
6. 开放问题
Coupon Mgmt. 仍需后续补图的流程
- Send Coupons 只有入口按钮，缺少发券表单、确认弹窗、成功态和失败态。
- Coupon Redeem 只有入口按钮，缺少核销输入、校验、确认和结果反馈。
- Player Record 行级 Edit 只有按钮，缺少编辑弹窗、可编辑字段和保存限制。
- Daily Record 右侧部分表头被 Filter 抽屉遮挡，需要补充无抽屉态或横向滚动到右侧的截图，确认
After Balance和Redeem Method等列名。