Member List
Customer Mgmt. Member List 子页面 PRD，覆盖会员列表、筛选抽屉、空态、选中态、Member Detail 弹窗和 Send Coupon 发券流程。
Member List 是 Customer Mgmt. 的默认子页面。运营、客服、产品、开发和 QA 主要用它查询会员、打开 Member Detail、筛选会员，并对选中会员或符合条件的会员发放优惠券。
1. 页面摘要
| 项目 | 说明 |
|---|---|
| 页面性质 | 可查询、可查看详情、可触发发券的客户管理页 |
| 核心动作 | 搜索会员、筛选会员、查看 9 类会员详情、勾选会员、By Player / By Condition 发券 |
| 数据范围 | 当前账号有权限查看和操作的品牌、Partner 与会员 |
| 当前状态 | Member List、Member Detail 和 Send Coupon 主链路已定义；搜索字段、Status / Order、部分空态和发券结果态仍待确认 |
2. 需求状态
| 状态 | 内容 |
|---|---|
Confirmed | Member List 与 Partner List 是独立子页面；Member Detail 绑定当前会员；发券前必须校验 Coupon Balance、目标会员、金额和领取期限；发券成功后进入 Coupon Mgmt. 记录。 |
Inferred from Figma | 搜索框占位 Search for transaction 暂不作为正式搜索范围；FP 暂解释为设备 / 浏览器指纹；表头全选暂只影响当前页。 |
Open Question | 搜索字段、Status / Order 选项、FP 业务含义、详情页状态、发券成功/失败态和右侧完整列名，见 开放问题。 |
3. 页面目标
| 项目 | 定义 |
|---|---|
| 页面类型 | Feature Page PRD |
| 所属模块 | Customer Mgmt. |
| 默认页签 | Member List |
| 主要任务 | 查看会员宽表、搜索会员、筛选会员、打开 Member Detail、勾选会员并发券 |
| 数据范围 | 当前账号可查看和可操作的品牌、Partner 与会员 |
| 关联页面 | Coupon Mgmt. 记录优惠券发放和领取结果 |
核心规则摘要
Member List 表格、Member Detail 弹窗、筛选结果、选中会员和 Send Coupon 表单必须使用同一权限数据范围。发券前必须校验会员可见性、Coupon Balance、金额、领取期限和最终确认。
4. Figma 参考稿
页面状态 Figma 截图
Customer Mgmt.
展示 Member List 默认态：Customer Management 标题、搜索、Filter、Send Coupons、会员宽表、横向滚动条和分页。
查询无结果时保留表头和横向滚动条，表格中部显示 No Data。
勾选会员行后行背景高亮，Send Coupons 按钮进入可对已选会员发券的状态。
表格行选中后，Send Coupons 按钮显示为选中态颜色，表示将以已选会员作为发券目标。
页面状态 Figma 截图
Customer Mgmt.
Filter 浮层包含 Date/Time、Brand、Partner ID、Member ID、Depositor Name、Status、Order、Reset 和 Apply。
Date/Time 展开双月日期时间选择器，支持快捷范围、左右月份、时间输入、Clear 和 Apply。
日期选择器快捷项展开，包含 Today、Yesterday、Last 7 Days、Last 30 Days、Last Month、Last 3 Months。
Brand 展开为复选列表，包含 All Brands、IKEA、W365、Oh my God、The King +。
Partner ID 支持多选 chip，列表标题为 Partner Code (456)，选项按 Partner Code 展示并带滚动条。
Member ID 与 Depositor Name 已填写示例值，等待 Apply 提交。
页面状态 Figma 截图
Customer Mgmt.
点击 Member ID 后打开 Member Details 弹窗，默认进入 Login History，展示登录时间、域名、IP、设备和 FP。
Member Details 的 Deposit 页签展示充值申请金额、Bonus、Event、余额、状态和更新时间。
Member Details 的 Withdrawal 页签展示提现金额、Rolling、Event、余额、状态和更新时间。
USDT Deposit 页签展示 Transaction ID、Coin Amount、KRW Amount、Event、Bonus、汇率、币种和状态。
USDT Withdrawal 页签展示申请时间、处理时间、币额、USDT 金额和状态。
Bonus Status 页签按日期展示 Total Promotion、Sports Bonus、Casino Bonuses、Lost Points、Rebate、Cashback、Coupon 和 Redeem Coupon。
Sports Record 页签展示 Number Of Bets、Total Bet、Total Payout、GGR、GGR %、Bet Profits 和 Average Bet Amount。
Casino Record 页签沿用投注统计表结构，展示投注次数、金额、派彩、GGR 与平均投注。
Slot Record 页签沿用投注统计表结构，展示投注次数、金额、派彩、GGR 与平均投注。
页面状态 Figma 截图
Customer Mgmt.
Send Coupon 弹窗默认选择 By Player，包含 Player ID token、Coupon Amount、Coupon Collection Period、Remarks、Confirm 和 Cancel。
发券前展示最终确认弹窗，包含 Total Player、Coupon Amount 和 Confirm / No, cancel。
By Player 发券表单中 Coupon Collection Period 展开双月日期时间选择器。
最终确认弹窗叠加在 Send Coupon 表单之上，背景继续保持遮罩。
页面状态 Figma 截图
Customer Mgmt.
By Condition 选择 Deposit Amount，表单包含 Player Group、Level、Period Time、Min / Max Deposit Amount、Matching Quantity、Coupon Amount、Collection Period 和 Remarks。
Player Group 下拉展示 Select All、分组标题与大量选项，包含 Coupon Sending、Member Group、Filter Type、会员等级等。
Player Group 下拉高度固定并通过内部滚动查看更多选项。
Player Group 选中多个值后在输入框内显示 tags，并保留下拉菜单。
Player Group 选中项过多时显示首个 tag 与 +3 计数。
点击 Matching Quantity 数字后打开会员列表弹窗，展示 Player ID、Level、复选框、分页、Confirm 和 Cancel。
Filter Type 选择 Inactive 时，表单显示 Off Line Days、Max Deposit Amount、Matching Quantity、Coupon Amount 和 Remarks。
Filter Type 选择 Lose Money 时，表单显示 Deposit Time、Min Lose Amount、Max Lose Amount、Matching Quantity、Coupon Amount 和 Remarks。
5. 页面组成
| 区域 | UI 表现 | 功能说明 |
|---|---|---|
| 面包屑与页签 | Home > Customer Management，页签为 Member List、Partner List | 页签导航 |
| 标题区 | Customer Management 和说明文案 | 默认列表 |
| 操作区 | 搜索框、Search、Filter、Send Coupons | 搜索与操作 |
| 会员表格 | 多选框、会员与资金字段、横向滚动条 | 会员表格 |
| Member Detail 弹窗 | 标题、9 个记录页签、页签表格、弹窗内分页 | Member Detail 弹窗 |
| 筛选抽屉 | Date/Time、Brand、Partner ID、Member ID、Depositor Name、Status、Order | 筛选抽屉 |
| Send Coupon 弹窗 | By Player 与 By Condition 两种模式 | 发券弹窗 |
| 匹配数量弹窗 | Matching Quantity 会员列表 | 匹配数量 |
| 确认弹窗 | Total Player、Coupon Amount、Confirm / No, cancel | 发券确认 |
| 分页区 | Showing 1 to 10 of 100 Entries、10 per page、页码 | 分页 |
6. 功能说明
6.1 页签导航
| 页签 | 说明 |
|---|---|
| Member List | 当前截图覆盖的默认页签，用于会员维度查询、查看 Member Detail 与发券。 |
| Partner List | 独立子页面，详见 Partner List；切换后应进入 Partner 维度管理，不复用 Member List 表格字段。 |
| 切换规则 | 切换页签时保留各自筛选、分页、横向滚动和草稿弹窗状态；有未保存发券表单时需提示确认。 |
6.2 默认列表与空态
默认态展示 Customer Management 标题、搜索与操作按钮、会员宽表、横向滚动条和分页。
| 状态 | UI / 行为 |
|---|---|
| 有数据 | 表格展示 10 行，底部显示横向滚动条和分页。 |
| 无数据 | 保留表头与横向滚动条，中间显示 No Data；分页和计数区仍按当前查询结果刷新。 |
| 选中行 | 行背景变为浅蓝色，复选框选中；Send Coupons 按钮切换为选中态颜色。 |
| 取消选中 | 取消最后一个选中会员后恢复未选中操作态。 |
6.3 搜索与操作
| 元素 | 规则 |
|---|---|
| 搜索框 | 占位文案为 Search for transaction，但不作为正式业务口径；实际搜索范围见开放问题。 |
| Search | 提交搜索词，列表回到第一页，并保留已提交筛选条件。 |
| Filter | 打开右侧浮层筛选抽屉；不改变列表直到点击 Apply。 |
| Send Coupons | 打开发券弹窗；若已勾选会员，默认进入 By Player 并带入已选会员。 |
6.4 会员表格
| 列 / 元素 | 说明 |
|---|---|
| 复选框 | 支持单行选择和表头全选当前页；选中结果用于 By Player 发券。 |
| Member ID | 会员 ID，例如 DAEBAK0001；点击后打开 Member Detail 弹窗。 |
| Brand | 品牌标签，例如 w365、Oh My God、IKEA、The King+，不同品牌使用不同颜色 pill。 |
| Partner ID | 所属 Partner，例如 Daebak_Partner001。 |
| Partner Code | Partner Code，例如 Daebak_Code001。 |
| Depositor Name | 存款人姓名，例如 Kim Cheol Su。 |
| Membership Level | 会员等级，例如 GOLD。 |
| Total Deposit Amount | 总充值金额。 |
| Total Withdrawal Amount | 总提现金额。 |
| Deposit-Withdrawal | 充值减提现。 |
| Total Betting | 横向滚动后可见，总投注金额。 |
表格为宽表结构，横向滚动位置属于当前页签状态；切换分页或刷新数据时应按产品确认是否保留横向滚动位置。点击任意 Member ID 后打开居中 Member Details 弹窗，默认进入 Login History，关闭后返回当前列表状态。
字段完整性状态：
| 范围 | 状态 | 规则 |
|---|---|---|
| 会员表格可见列 | Confirmed from visible columns | 复选框到 Total Betting 可作为当前会员列表字段基线。 |
| 右侧完整列 | Open Question | 部分截图右侧被截断，最右侧列名、顺序和是否进入导出仍需补充右滚截图。 |
| Member Detail 页签字段 | Partially confirmed | 各页签字段列表可作为弹窗内字段基线，但 FP 含义、空态、失败态和右侧列仍需确认。 |
| 发券选择字段 | Confirmed for current flow | 复选框和 Member ID 可用于 By Player 发券上下文；批量跨页选择规则未确认前只按当前页处理。 |
6.5 Member Detail 弹窗
Member Detail 为居中大弹窗，标题格式为 <Member ID> Member Details，右上角有关闭按钮。默认页签为 Login History。
| 公共元素 | 规则 |
|---|---|
| 标题 | 使用当前点击会员 ID，例如 Daebak0001 Member Details。 |
| 默认页签 | 首次打开默认进入 Login History。 |
| 页签集合 | Login History、Deposit、Withdrawal、USDT Deposit、USDT Withdrawal、Bonus Status、Sports Record、Casino Record、Slot Record。 |
| 切换规则 | 所有页签都绑定当前打开会员；切换页签不改变父列表筛选、搜索、滚动、选中与分页。 |
| 关闭方式 | 点击右上角 X 关闭弹窗，返回父列表原位置。 |
| 弹窗内分页 | 底部保留 Showing 1 to 10 of 100 Entries、10 per page 和页码。 |
| 页签 | 表格字段 | 规则 |
|---|---|---|
| Login History | Application Time、Domain、Login IP、Device、FP | Device 使用 PC、MOBILE、TABLET pill；FP 展示浏览器 / 系统指纹字符串。 |
| Deposit | Application Time、Applied Amount、Bonus Amount、Event Name、General Balance、Bonus Balance、Withdrawal Balance、Coupon Balance、Status、Updated Time | Status 使用 Complete、Processing、Failure pill。 |
| Withdrawal | Application Time、Applied Amount、Rolling、Event Name、General Balance、Bonus Balance、Withdrawal Balance、Coupon Balance、Status、Updated Time | 结构与 Deposit 接近，但第二个金额字段改为 Rolling。 |
| USDT Deposit | Application Time、Transaction ID、Coin Amount、KRW Amount、Event Name、Bonus Amount、Exchange Rate、CryptoCurrency、Status、Updated Time | 币种截图中为 USDT，状态沿用 Complete、Processing、Failure。 |
| USDT Withdrawal | Application Time、Processing Time、Coin Amount、USDT Amount、Status | 状态在截图中使用全大写 COMPLETE、PROCESSING、FAILURE。 |
| Bonus Status | Date、Total Promotion、Sports Bonus、Casino Bonuses、Lost Points、Rebate、Cashback、Coupon、Redeem Coupon | 按日展示会员奖金和返点汇总。 |
| Sports Record | Date、Number Of Bets、Total Bet、Total Payout、GGR、GGR %、Bet Profits、Average Bet Amount | 展示体育投注统计汇总。 |
| Casino Record | Date、Number Of Bets、Total Bet、Total Payout、GGR、GGR %、Bet Profits、Average Bet Amount | 字段结构与 Sports Record 一致。 |
| Slot Record | Date、Number Of Bets、Total Bet、Total Payout、GGR、GGR %、Bet Profits、Average Bet Amount | 字段结构与 Sports / Casino Record 一致。 |
6.6 筛选抽屉
点击 Filter 后在右侧打开浮层。筛选项是临时状态，只有点击 Apply 才提交。
| 筛选项 | UI / 行为 |
|---|---|
| Date/Time | 点击输入框展开双月日期时间选择器；支持快捷项 Today、Yesterday、Last 7 Days、Last 30 Days、Last Month、Last 3 Months。 |
| Brand | 多选复选框，包含 All Brands、IKEA、W365、Oh my God、The King +。 |
| Partner ID | 下拉多选，列表标题显示 Partner Code (456)；选中项以 chip 展示，超出以 +1 折叠。 |
| Member ID | 文本输入，示例值 DAEBAK0001。 |
| Depositor Name | 文本输入，示例值 Kim Cheol Su；截图占位文案暂显示 Enter your partner code，需确认是否应改为姓名占位。 |
| Status | 折叠项，具体选项未在截图中展开。 |
| Order | 折叠项，具体排序字段未在截图中展开。 |
| Reset | 清空抽屉临时条件并回到默认值，不立即请求列表。 |
| Apply | 提交筛选条件，关闭或保留抽屉按实现确认；列表回到第一页。 |
6.7 Send Coupon 弹窗
点击 Send Coupons 后打开居中弹窗，背景遮罩变暗。弹窗支持 By Player 和 By Condition 两种模式。
By Player
| 字段 / 操作 | 规则 |
|---|---|
| Player ID | 多选 token 输入，展示头像与名称，例如 Roberta、Micheal、Lana；从表格勾选进入时自动带入。 |
| Coupon Amount | 必填金额，必须大于 0，且总发券金额不得超过 Coupon Balance 与当前账号可用额度。 |
| Coupon Collection Period | 日期范围选择器，支持双月日期、时间、Clear 和 Apply。 |
| Remarks | 可选多行备注。 |
| Confirm | 打开最终确认弹窗，不直接发券。 |
| Cancel / 关闭 | 未提交时关闭弹窗；表单有输入时需提示确认放弃。 |
By Condition
| 字段 / 操作 | 规则 |
|---|---|
| Player Group | 多选下拉，支持 Select All、分组标题和选项；选中后以 chip 展示，过多时以 +3 折叠。 |
| Level | 会员等级下拉，截图未展开，选项需从会员等级配置获取。 |
| Filter Type | 单选 Lose Money、Inactive、Deposit Amount，不同类型显示不同条件字段。 |
| Matching Quantity | 点击数字打开匹配会员列表弹窗；点击右侧小 Confirm 重新计算匹配人数。 |
| Coupon Amount | 必填金额，确认前按匹配人数计算总发券金额。 |
| Remarks | 可选备注。 |
Filter Type 字段变化
| Filter Type | 条件字段 |
|---|---|
| Deposit Amount | Period Time、Min Deposit Amount、Max Deposit Amount、Matching Quantity、Coupon Amount、Collection Period、Remarks。 |
| Inactive | Off Line Days、Max Deposit Amount、Matching Quantity、Coupon Amount、Remarks。 |
| Lose Money | Deposit Time、Min Lose Amount、Max Lose Amount、Matching Quantity、Coupon Amount、Remarks。 |
6.8 Matching Quantity 弹窗
点击 Matching Quantity 数字后打开二级弹窗，展示当前条件匹配的会员。
| 元素 | 规则 |
|---|---|
| 表格列 | 复选框、Player ID、Level。 |
| 默认选择 | 截图中当前页所有行默认选中；取消勾选后不纳入最终发券人数。 |
| 分页 | 显示 Showing 1-10 of 1000 和分页控件。 |
| Confirm | 确认本次人工剔除后的匹配列表，并回填数量。 |
| Cancel / 关闭 | 不保存本次选择变更。 |
6.9 发券确认
点击 Send Coupon 主表单 Confirm 后显示最终确认弹窗。
| 元素 | 说明 |
|---|---|
| Total Player | 展示最终发券人数，例如 10。 |
| Coupon Amount | 展示总发券金额，例如 10,000,000.00。 |
| 文案 | Would you like to process with this final step? |
| Confirm | 最终提交发券，成功后刷新列表并写入 Coupon Mgmt. 记录。 |
| No, cancel / 关闭 | 返回发券表单，不提交。 |
6.10 分页
| 项目 | 规则 |
|---|---|
| 计数文案 | Showing 1 to 10 of 100 Entries。 |
| 每页数量 | 默认 10 per page。 |
| 切页 | 保留已提交搜索词和筛选条件；不保留抽屉未 Apply 的临时值。 |
| 全选 | 表头全选只影响当前页，跨页选择需后续确认。 |
7. 主流程
- 用户进入
Customer Mgmt.，默认打开Member List。 - 用户通过搜索框或 Filter 抽屉定位会员。
- 用户可点击
Member ID打开Member Details，在 9 个页签中查看该会员登录、充值、提现、USDT、奖金和投注记录。 - 用户关闭
Member Details后返回原列表状态，并可继续勾选表格行。 - 用户可勾选表格行，再点击
Send Coupons进入 By Player 发券。 - 用户也可直接点击
Send Coupons，切换到 By Condition 后按条件筛选目标会员。 - 系统通过 Matching Quantity 计算目标会员数，用户可查看并调整匹配名单。
- 用户填写 Coupon Amount、领取周期和备注后点击 Confirm。
- 系统展示最终确认弹窗，用户再次确认后才真正发券。
8. 已确认规则
- Member List 只展示当前账号有权限查看的会员；筛选、搜索、Member Detail、发券匹配都不能越权。
- 点击
Member ID打开的 Member Detail 9 个页签都必须绑定同一会员 ID，不允许跨会员串数据。 - Member Detail 默认打开
Login History，关闭后必须回到原列表的搜索、筛选、选中、滚动和分页状态。 - 发券前必须校验 Coupon Balance、单人金额、总金额、会员状态、会员可见性和领取周期。
By Player的目标会员来自表格勾选或 Player ID 输入；重复会员必须去重。By Condition必须先计算 Matching Quantity；条件变化后原匹配数量失效，需要重新计算。- Matching Quantity 弹窗中被取消勾选的会员不得收到本次优惠券。
- 最终确认弹窗中的 Total Player 和 Coupon Amount 必须与提交参数一致。
- 发券成功后必须生成审计记录，并能在 Coupon Mgmt. 对应记录中追踪。
9. 异常与空态
| 场景 | 处理 |
|---|---|
| 查询无结果 | 表格中部显示 No Data，保留表头、横向滚动条和分页区域。 |
| Member Detail 某页签无记录 | 保留标题、页签、表头和分页区，表格区域显示 No Data。 |
| Coupon Balance 不足 | 禁止提交，提示余额不足。 |
| Coupon Amount 为空或小于等于 0 | 禁止进入最终确认。 |
| 未选择 Player 且处于 By Player | 禁止提交，提示选择目标会员。 |
| By Condition 未计算 Matching Quantity | 禁止最终发券，提示先计算匹配人数。 |
| 匹配人数为 0 | 禁止发券，并提示调整条件。 |
| 发券失败 | 保留弹窗和输入内容，提示重试。 |
10. 开放问题
| 问题 | 当前默认处理 | 影响角色 | 是否阻塞上线 | 待确认方 |
|---|---|---|---|---|
| 搜索框实际支持哪些字段 | 暂不按占位文案定稿；建议确认 Member ID、Partner ID、Partner Code、Depositor Name 是否支持 | 运营 / 客服 / 开发 / QA | 是 | 产品 / 运营 |
Filter 抽屉 Status 与 Order 展开项缺失 | 暂只保留入口和字段名，不写具体选项为定稿 | 运营 / 开发 / QA | 是 | 产品 / 设计 |
Depositor Name 占位显示 Enter your partner code | 主规则按 Depositor Name 处理，Figma 文案需修正 | 运营 / 客服 / QA | 否 | 设计 |
Login History 中 FP 的业务含义 | Inferred from Figma：暂解释为浏览器 / 设备指纹字符串 | 客服 / 风控 / 开发 | 是 | 产品 / 风控 |
| Member Detail 各页签无数据、失败、加载态 | 按共享表格空态和错误态处理 | 客服 / 开发 / QA | 否 | 设计 |
| Send Coupon 成功、失败、加载态 | 按共享提交和反馈规则处理；如需定制视觉需补 Figma | 运营 / 开发 / QA | 是 | 产品 / 设计 |
| 表格右侧完整列名被截断 | 不把被遮挡字段当最终列名；补充最右侧截图后确认 | 开发 / QA | 是 | 设计 |
11. 验收标准
- Member List 默认展示会员宽表、搜索、Filter、Send Coupons、横向滚动条和分页。
- 无数据时显示
No Data，页面结构不塌陷。 - 点击任意
Member ID后打开居中Member Details弹窗，标题包含当前会员 ID，默认页签为Login History。 - Member Detail 支持
Login History、Deposit、Withdrawal、USDT Deposit、USDT Withdrawal、Bonus Status、Sports Record、Casino Record、Slot Record共 9 个页签。 - Member Detail 各页签使用对应字段、状态 pill 和弹窗内分页；无记录时显示
No Data。 - 关闭 Member Detail 后，父列表的搜索、筛选、选中、横向滚动和分页保持不变。
- Filter 抽屉支持日期快捷项、日期范围、Brand 多选、Partner ID 多选、Member ID、Depositor Name、Status 和 Order。
- Apply 后按筛选条件刷新列表并回到第一页；Reset 只清空抽屉临时值。
- 勾选会员后行高亮且 Send Coupons 进入选中态。
- Send Coupon By Player 支持带入已选会员、填写金额、领取期限、备注，并在最终确认后提交。
- Send Coupon By Condition 支持
Deposit Amount、Inactive、Lose Money三种匹配方式。 - Matching Quantity 支持查看匹配名单、勾选调整、分页，并回填最终匹配人数。
- 最终发券前必须展示 Total Player、Coupon Amount 和二次确认弹窗。
- 无权限用户不能查看越权会员、Member Detail 或执行 Send Coupons。