Deposit & Withdrawal Record
Record Inquiry 下的 Deposit & Withdrawal Record 子页面 PRD，覆盖充值提现记录搜索、筛选、条件 chips、汇总卡片、宽表格和分页导出。
Deposit & Withdrawal Record 是 Record Inquiry 的默认子页面，用于查询充值、提现、充值奖金和 rolling 相关记录。
页面摘要
| 项目 | 说明 |
|---|---|
| 页面性质 | 充值提现记录只读查询页，支持宽表、汇总卡和导出 |
| 核心动作 | 搜索充值提现记录，组合筛选，核对汇总卡、表格明细和导出结果 |
| 数据范围 | 当前账号有权限查看的品牌、代理、会员、充值和提现记录 |
| 当前状态 | 查询、筛选、chips、汇总卡、宽表、分页和导出已定义；批量用途和部分筛选口径仍待确认 |
需求状态
| 状态 | 内容 |
|---|---|
Confirmed | Deposit & Withdrawal Record 是 Record Inquiry 默认只读页；筛选、汇总卡、表格、Total 行、分页和导出使用同一条件。 |
Inferred from Figma | 表格复选框暂只表示选择状态；右侧隐藏列通过横向滚动查看。 |
Open Question | Filter 标题、批量用途、单选/多选筛选、完整列、每页条数和移动端状态仍待确认，见 开放问题。 |
1. Figma 原型
页面状态 Figma 截图
Record Inquiry
展示 Deposit & Withdrawal Record 默认页：搜索、筛选入口、Excel Download、4 张汇总卡、宽表格、横向滚动条和分页。
Filter 打开后右侧浮层展示 Date/Time、Brand、Member ID、Partner ID、Phone Number、Deposit/Withdrawal、Status、Include Sub-Partner、Reset 和 Apply。
Date/Time 输入框展开后显示日期范围选择器、月份切换、日期网格、时间输入、Clear 和 Apply。
Brand 下拉显示 All Brands、IKEA、W365、Oh my God、The King+，用于限定充值提现记录的品牌范围。
Deposit/Withdrawal 下拉显示 All、Deposit、Withdrawal，用于在同一列表中区分充值和提现记录。
Status 下拉显示 All、Complete、Processing、Refusal、Waiting、Cancelled；截图同时展示已生效条件 chips。
2. 页面目标
| 项目 | 定义 |
|---|---|
| 页面类型 | Feature Page PRD |
| 所属模块 | Record Inquiry |
| 默认入口 | 从侧边栏点击 Record Inquiry 后默认进入本页 |
| 主要任务 | 搜索充值提现记录、组合筛选、核对 4 张汇总卡、查看宽表格、导出当前结果 |
| 数据范围 | 当前账号有权限查看的品牌、下级代理、会员充值和提现记录 |
| 默认排序 | Apply Time 倒序，最新申请优先 |
关键规则摘要
Deposit & Withdrawal Record 是只读查询页。Search、Filter、条件 chips、汇总卡片、表格、横向滚动、分页和 Excel Download 必须使用同一份已生效结果范围。
3. 全局依赖
| 全局模块 | 说明 |
|---|---|
| Top | 展示会员汇总、余额、提现入口、消息和 Profile；本页筛选不改变 Top 口径。 |
| Global One Line Notice | 页面顶部红色维护公告属于全局公告模块；本页只承接展示位置。 |
| Withdrawal Request | Top 中的 Withdrawal Request 打开提现申请弹窗；本页只查询历史记录。 |
| Promotion Record / Bet History | 同属 Record Inquiry；三个子页面的查询上下文互不强制同步。 |
4. 页面组成
| 区域 | UI 表现 | 对应功能说明 |
|---|---|---|
| 面包屑与子页面导航 | Home > Record Inquiry，Deposit & Withdrawal Record 高亮，旁边是 Promotion Record、Bet History | 子页面导航 |
| 查询与动作区 | Search for transaction、Search、Filter、Excel Download | 查询与动作 |
| 条件 chips | 筛选后在标题下方显示日期、品牌、Member ID、Partner ID 等条件 | 条件 chips |
| 汇总卡片 | Deposit Amount、Withdrawal Amount、Deposit Bonus、Average Rolling | 汇总卡片 |
| Filter 面板 | Date/Time、Brand、Member ID、Partner ID、Phone Number、Deposit/Withdrawal、Status、Include Sub-Partner | Filter 面板 |
| 记录表格 | 复选框、Brand、Apply Time、Player ID、Partner ID、Partner Code、Mobile Phone、Level、金额字段、横向滚动条 | 记录表格 |
| 分页区 | Showing 1-10 of 1000、页码、上一页、下一页 | 分页与横向滚动 |
5. 功能说明
5.1 子页面导航
| 项目 | 说明 |
|---|---|
| Deposit & Withdrawal Record | 默认选中，展示充值提现记录。 |
| Promotion Record | 点击后进入 Promotion Record，查看 Rebate / Cashback 优惠记录。 |
| Bet History | 点击后进入 Bet History，查看投注记录。 |
| 切换规则 | 切换子页面时，不把当前页的 Deposit/Withdrawal、Status 或列定义带入其他子页面；返回本页时尽量保留本页已生效条件。 |
5.2 查询与动作
| 控件 | 规则 |
|---|---|
| Search 输入框 | 占位文案为 Search for transaction。用于按交易标识、会员 ID、代理 ID 或手机号搜索；精确匹配优先。 |
Search | 点击后按“当前关键词 + 已生效筛选条件”刷新本页，并回到第 1 页。 |
Filter | 打开或关闭右侧 Filter 面板；打开面板本身不触发查询。 |
Excel Download | 导出当前已生效结果范围；必须受导出权限控制，并记录导出审计。 |
5.3 Filter 面板
| 字段 / 控件 | UI 表现 | 规则 |
|---|---|---|
| 标题 | 截图中出现 Search Filter 和 Filters 两种文案 | 上线文案统一为 Filters，避免同一面板出现两个标题。 |
| Date/Time | 带日历图标，字段名后有红色 * | 当前定义为必填筛选；选择器内 Apply 只回填输入框，最终查询以面板底部 Apply 为准。 |
| Brand | 下拉选择，默认 All | 选项来自当前账号权限范围；截图展示 All Brands、IKEA、W365、Oh my God、The King+。 |
| Member ID | 文本输入 | 按会员编号过滤；输入值在 chip 中展示。 |
| Partner ID | 文本输入 | 按代理编号过滤；输入值在 chip 中展示。 |
| Phone Number | 文本输入 | 按会员手机号过滤；涉及敏感信息时按权限脱敏。 |
| Deposit/Withdrawal | 下拉选择，默认 All | 选项为 All、Deposit、Withdrawal。 |
| Status | 下拉选择，默认 All | 选项为 All、Complete、Processing、Refusal、Waiting、Cancelled。 |
| Include Sub-Partner | 复选框，截图中默认勾选 | 勾选后纳入当前账号权限范围内的下级代理数据；不能突破权限边界。 |
Reset | 底部次按钮 | 恢复默认查询条件，刷新默认列表，并回到第 1 页。 |
Apply | 底部紫色主按钮 | 提交当前面板条件，刷新汇总卡片、表格、横向滚动和分页，并回到第 1 页。 |
5.4 Date/Time
| 项目 | 规则 |
|---|---|
| 输入框展示 | 已选择时展示 YYYY/MM/DD - YYYY/MM/DD；截图示例为 2025/08/01 - 2025/08/29。 |
| 选择器状态 | 点击 Date/Time 后展开日期范围选择器，包含月份标题、左右切换、日期网格和时间输入。 |
| 时间精度 | 选择器展示到秒，默认示例为 00 : 00 : 00。 |
Clear | 清空当前日期时间草稿值，不刷新列表，也不关闭整个 Filter 面板。 |
日期选择器 Apply | 将日期时间草稿写回输入框，不直接刷新结果；结果刷新以 Filter 面板底部 Apply 为准。 |
| 非法范围 | 开始时间不得晚于结束时间；非法时阻止写回并给出明确提示。 |
5.5 Brand / Type / Status
| 筛选项 | 选项与规则 |
|---|---|
| Brand | All Brands、IKEA、W365、Oh my God、The King+。只展示当前账号有权限查看的品牌。 |
| Deposit/Withdrawal | All、Deposit、Withdrawal。选择 Deposit 只刷新充值记录与充值相关汇总；选择 Withdrawal 只刷新提现记录与提现相关汇总。 |
| Status | All、Complete、Processing、Refusal、Waiting、Cancelled。筛选名称、表格状态、chip 和导出字段必须使用同一词表。 |
5.6 条件 chips
筛选生效后，在标题下方、汇总卡片上方展示已提交条件 chips。
| 项目 | 规则 |
|---|---|
| 展示内容 | 日期范围、品牌、Member ID、Partner ID、Phone Number、Deposit/Withdrawal、Status。 |
| 截图示例 | 2025/08/01~2025/08/29、W365、test101、61001。 |
| 展示顺序 | Date/Time 优先，其次 Brand、文本条件、类型、状态、Include Sub-Partner。 |
| 移除方式 | 点击单个 chip 的关闭图标后，移除该条件并立即刷新结果。 |
5.7 汇总卡片
| 卡片 | 说明 |
|---|---|
| Deposit Amount | 当前结果范围内的充值金额汇总。 |
| Withdrawal Amount | 当前结果范围内的提现金额汇总。 |
| Deposit Bonus | 当前结果范围内的充值奖金汇总。 |
| Average Rolling | 当前结果范围内的平均 Rolling 值。 |
Search、Filter Apply、chip 删除、Reset、翻页或返回本页后，卡片必须与表格结果使用同一查询口径。卡片值不能显示全局总量、缓存总量或未授权品牌数据。
5.8 记录表格
| 列 / 元素 | 说明 |
|---|---|
| 选择列 | 表头与每行展示复选框；当前截图未展示批量动作，批量用途待确认。 |
| Brand | 记录所属品牌，使用品牌色标签。 |
| Apply Time | 充值或提现申请时间。 |
| Player ID | 会员编号。 |
| Partner ID | 所属代理编号。 |
| Partner Code | 代理码。 |
| Mobile Phone | 会员手机号，按权限脱敏。 |
| Level | 会员等级，例如 Bronze。 |
| Deposit Amount | 充值金额。 |
| Deposit Bonus | 充值奖金。 |
| Event Name | 关联活动名称，例如 Casino Firstly 10%。 |
| Withdrawal Amount | 提现金额。 |
| 右侧隐藏列 | 横向滚动可查看更多字段；完整列定义需与最终 Figma 和导出字段一致。 |
字段完整性状态：
| 范围 | 状态 | 规则 |
|---|---|---|
| 已确认可见列 | Confirmed | 从选择列到 Withdrawal Amount 的列可作为当前页面实现和 QA 验收依据。 |
| 右侧隐藏列 | Open Question | 只能说明存在更多列，不能把当前截图裁切结果当作完整列清单。 |
| Excel Download 字段 | Open Question | 导出必须与最终确认的完整列、排序、权限脱敏一致；未确认右侧列前不得视为闭环。 |
5.9 分页与横向滚动
| 控件 | 规则 |
|---|---|
| 横向滚动条 | 位于表格下方，紫色滑块用于查看右侧列。 |
| 结果提示 | 左下角展示 Showing 1-10 of 1000 类结果区间说明。 |
| 页码 | 右下角展示上一页、页码、下一页，当前页紫色高亮。 |
| 翻页 | 点击页码后保留当前关键词和已生效筛选条件。 |
| 每页条数 | 当前截图未展示每页条数选择器；是否需要 10 per page 待确认。 |
6. 业务规则
- 本页只读，不允许直接改变充值、提现或奖金结果。
- Search、Filter、chips、汇总卡片、表格和分页必须使用同一已生效结果范围。
- Date/Time、Brand、Member ID、Partner ID、Phone Number、Deposit/Withdrawal、Status 之间按 AND 处理。
- Brand、Member ID、Partner ID、Phone Number 和 Include Sub-Partner 只能扩大或缩小当前账号已授权范围，不能展示无权限数据。
- 删除 chip、点击 Reset、点击 Apply 或从其他子页面返回后，当前查询应回到第 1 页。
- Excel Download 导出的列、筛选条件、排序和权限口径必须与当前页面一致。
7. 异常与空态
| 场景 | 处理 |
|---|---|
| 查询无结果 | 保留标题、搜索区、Filter、chips、汇总卡片、表头和分页容器，表格主体展示空态说明。 |
| Date/Time 为空 | 当前定义为必填；点击 Apply 时阻止提交并在 Date/Time 附近提示。 |
| 日期范围非法 | 阻止写回或提交，并提示开始时间不能晚于结束时间。 |
| 品牌 / 状态选项加载失败 | 保留当前结果，在下拉中展示失败和重试入口，不能展示无权限选项。 |
| 查询失败 | 保留上一成功结果和当前草稿条件，提示用户重试。 |
| 导出失败 | 不影响当前列表，提示失败原因，并允许重试。 |
| 手机号权限不足 | 表格和导出都必须按权限脱敏或隐藏。 |
8. 开放问题
Deposit & Withdrawal Record 需确认项
- Filter 面板标题在截图中同时出现
Search Filter和Filters，PRD 已统一为Filters，需要设计确认最终文案。 - Date/Time 带必填星号，当前定义为必填；如果业务允许无日期查询，需要补充默认范围和无日期规则。
- Brand、Deposit/Withdrawal、Status 当前按单选下拉定义；如果需要多选，需要补充对应 Figma 状态。
- 表格复选框未展示批量动作，需要确认是否保留选择列。
- Average Rolling 的计算口径、精度和无数据展示需要业务确认。