Withdrawal Record
Withdrawal Record 提现记录 PRD，覆盖搜索、筛选面板、记录列表、状态核对和分页查询。
Withdrawal Record 是代理商后台的提现结果查询页，用于按时间、品牌、状态和银行核对提现申请处理结果。当前 Figma 主要覆盖列表页和右侧筛选面板；详情页和完整列顺序以本页字段模型和业务规则为准。
页面摘要
| 项目 | 说明 |
|---|---|
| 页面性质 | 只读提现记录查询页，不发起提现、不审批、不撤销 |
| 核心动作 | 搜索提现记录，按 Date/Time、Brand、Status、Bank 筛选，核对金额、银行和状态 |
| 数据范围 | 当前登录账号有权限查看的提现申请和处理结果 |
| 当前状态 | 列表、筛选、状态、分页和异常兜底已定义；详情页、搜索字段和完整列顺序以本页字段模型和业务规则为准 |
参考区
页面状态 Figma 截图
Withdrawal Record
右侧 Filters 面板从 Date/Time 必填项开始；点击输入框后展开双月日期时间范围选择器，包含 Clear 和 Apply。
截图说明只作为 Figma 证据摘要，不作为字段定义；字段口径、完整列、导出和权限规则以字段模型章节为准。
Brand 使用多选折叠面板；真实可选项按当前账号品牌权限和当前结果集返回。
截图说明只作为 Figma 证据摘要，不作为字段定义；字段口径、完整列、导出和权限规则以字段模型章节为准。
Status 使用多选折叠面板；筛选项与列表状态标签保持同一词表。
截图说明只作为 Figma 证据摘要，不作为字段定义；字段口径、完整列、导出和权限规则以字段模型章节为准。
Bank 使用多选折叠面板；真实银行选项来自当前结果集和当前账号可见权限。
截图说明只作为 Figma 证据摘要，不作为字段定义；字段口径、完整列、导出和权限规则以字段模型章节为准。
全局依赖
| 全局模块 | 说明 |
|---|---|
| Top | 页面顶部的会员汇总、余额、提现入口、消息入口和 Profile 由 Top 统一提供。Withdrawal Record 的筛选和分页不改变 Top 的展示口径。 |
| Global One Line Notice | 页面上方红色横幅属于全局公告模块，不属于 Withdrawal Record 页面本身。 |
| Withdrawal Request | Top 中的 Withdrawal Request 按钮打开提现申请弹窗；Withdrawal Record 只负责查询和核对结果，不负责发起申请。 |
| 共享规则 | 语言、权限、查询反馈、表单按钮、分页和异常处理必须遵守共享规则。 |
功能规则
| 区域 | UI 表现 | 对应功能规则 |
|---|---|---|
| 页面上下文 | Home > Withdrawal Record 面包屑、标题、副标题 | 页面上下文 |
| 搜索区 | Search for transaction 输入框、Search 按钮、Filter 按钮 | 搜索与筛选入口 |
| 筛选面板 | 右侧 Filters 面板、Clear all、Date/Time、Brand、Status、Bank、Reset、Apply | 筛选面板 |
| 记录列表 | Creation Time、Update Time、Brand、Applied Amount、Account Holder、Bank、Account Number、Status、System MSG / Refusal Reason | 记录列表 |
| 分页区 | 10 per page 下拉、页码、Previous、Next | 分页 |
功能地图
页面上下文
Withdrawal Record 在内容区内以标准业务页形式展示，用于帮助财务或代理商管理员快速定位某笔提现申请的处理状态。
| 项目 | 说明 |
|---|---|
| 面包屑 | 页面顶部展示 Home > Withdrawal Record，用于提示当前层级。 |
| 标题 | 页面主标题为 Withdrawal Record。 |
| 副标题 | 使用说明文案 View and track all user withdrawal requests and transaction details.。 |
| 页面边界 | 本页为只读查询页，不在本页执行提现申请、审批、撤销或编辑。 |
搜索与筛选入口
列表右上角提供关键词搜索和筛选面板入口。
| 控件 | 规则 |
|---|---|
| 搜索输入框 | 占位文案为 Search for transaction。当前 PRD 将其定义为“按提现交易标识搜索”的关键词输入框，精确匹配优先。 |
Search 按钮 | 点击后按“当前关键词 + 已生效筛选条件”刷新列表，并回到第 1 页。 |
| 回车行为 | 在搜索输入框按 Enter 等价于点击 Search。 |
Filter 按钮 | 打开或关闭右侧筛选面板；打开面板本身不触发查询。 |
| 状态保留 | 用户关闭面板或翻页后，已输入关键词和已生效筛选条件必须保留。 |
筛选面板
筛选面板用于组合限定当前提现记录结果集。
| 元素 | 规则 |
|---|---|
| 面板标题 | 固定显示 Filters。 |
Clear all | 只清空面板内当前未提交的筛选草稿值，不立即刷新列表。 |
| 折叠分组 | Brand、Status、Bank 使用折叠分组；同一时间可展开一个或多个分组。 |
Reset | 恢复页面默认查询条件，刷新默认列表，并回到第 1 页。 |
Apply | 以“当前面板值 + 当前搜索关键词”刷新列表，并回到第 1 页。 |
| 关闭规则 | 点击面板外区域或再次点击 Filter 可关闭面板；未点击 Apply 时，不应修改当前结果集。 |
如果产品最终保留 Clear all 和 Reset 两套清空动作，必须让两者语义稳定且不重复；当前 PRD 以“草稿清空”和“恢复默认查询”区分两者职责。
Date/Time
Date/Time 是筛选面板的顶部字段，截图中带红色 * 标识。
| 项目 | 规则 |
|---|---|
| 输入框状态 | 未选择时展示 Please select a date range；已选择时展示 YYYY/MM/DD - YYYY/MM/DD。 |
| 选择器样式 | 点击后打开双月日期时间范围选择器，包含左右月份、日期网格和时间输入。 |
| 时间精度 | 选择器展示到秒，默认示例为 00 : 00 : 00。 |
选择器 Clear | 清空当前日期时间草稿值，不刷新列表。 |
选择器 Apply | 将当前日期时间草稿写回输入框，不直接刷新列表；列表刷新以面板底部 Apply 为准。 |
| 非法范围 | 开始时间不得晚于结束时间；非法时阻止生效并给出明确提示。 |
Brand
Brand 用于按品牌范围查看提现记录。
| 项目 | 规则 |
|---|---|
| 选项来源 | 只展示当前账号有权限查看的品牌。 |
| 选择方式 | 多选。 |
All Brands | 默认全选态；勾选具体品牌后不再保留 All Brands。 |
| 多品牌逻辑 | 同一分类内多选按 OR 处理，即命中任一品牌即可入列表。 |
| 空数据处理 | 没有可见品牌时，分组禁用或只保留 All Brands 占位。 |
Status
Status 用于按提现处理阶段筛选记录。
| 状态值 | 说明 |
|---|---|
Complete | 提现处理成功，记录已完成。 |
Processing | 提现正在处理中。 |
Refusal | 提现被拒绝，必须能看到拒绝原因。 |
Waiting | 提现已提交但尚未进入处理完成态。 |
Cancelled | 提现由用户或系统取消。 |
All | 不限制状态。 |
状态筛选支持多选；同一分类内多选按 OR 处理。筛选名称、列表标签名称和导出字段名称必须完全一致，不能一处写 Cancel、另一处写 Cancelled。
Bank
Bank 用于按收款银行筛选提现记录。
| 项目 | 规则 |
|---|---|
| 选项来源 | 优先展示当前结果集内存在的银行，并受账号权限限制。 |
| 选择方式 | 多选。 |
All | 默认全选态；勾选具体银行后不再保留 All。 |
| 银行文案 | 使用统一银行名称，不允许同一银行在不同页面出现多个拼写版本。 |
记录列表表格级定义
当前 Figma 展示的是标准表格列表，不包含行内编辑或批量操作。
| 项目 | 定义 |
|---|---|
| 行粒度 | 每一行代表一笔提现申请或提现处理记录。 |
| 汇总粒度 | 当前页面不展示汇总卡或 Total 行。 |
| 默认排序 | 默认按 Update Time 倒序展示；没有 Update Time 时按 Creation Time 倒序展示。 |
| 数据范围 | 受关键词、Date/Time、Brand、Status、Bank 和当前账号权限限制。 |
| 父子 / 展开关系 | 当前列表没有行展开；本页默认不提供单条详情页或详情抽屉。 |
| 导出关系 | 当前不提供导出入口；若后续新增导出入口，按当前已生效筛选和字段模型导出，并按权限脱敏；选择列、操作列、按钮入口、内部字段和未纳入字段模型的字段不导出。 |
记录列表字段模型
| 字段 | 所在区域 | 定义 / 口径 | 展示规则 | 导出 | 备注 |
|---|---|---|---|---|---|
| Creation Time | 记录列表 | 提现申请创建时间。 | 使用统一日期时间格式。 | 不导出 | 默认排序字段候选。 |
| Update Time | 记录列表 | 最近一次状态更新时间。 | 使用统一日期时间格式。 | 不导出 | 可作为最新记录排序字段候选。 |
| Brand | 记录列表 | 该笔提现所属品牌。 | 品牌文本或标签展示。 | 不导出 | 只能展示授权品牌。 |
| Applied Amount | 记录列表 | 用户申请提现金额。 | 金额格式展示。 | 不导出 | 币种和小数规则需统一。 |
| Account Holder | 记录列表 | 收款账户持有人姓名。 | 按权限展示或脱敏。 | 不导出 | 敏感信息遵守共享规则。 |
| Bank | 记录列表 | 收款银行名称。 | 使用统一银行名称。 | 不导出 | 与 Bank 筛选词表一致。 |
| Account Number | 记录列表 | 收款账号。 | 对无完整权限用户可做脱敏展示。 | 不导出 | 导出必须同步脱敏。 |
| Status | 记录列表 | 当前提现处理状态。 | 使用颜色标签；名称必须和状态筛选一致。 | 不导出 | 状态词表需统一 Cancel / Cancelled。 |
| System MSG / Refusal Reason | 记录列表 | 系统返回的处理说明；拒绝或取消时承载拒绝 / 取消原因，例如 Insufficient Balance。 | Refusal / Cancelled 展示完整原因；其他状态默认显示 -，如后端返回处理中说明可展示短文本。 | 不导出 | 旧稿中的 System MSG 与本字段合并；原因文本过长时截断并提供完整查看方式。 |
| 右侧可能存在列 | 表格右侧区域 | 右侧完整列名和顺序以字段模型为准。 | 不能把当前截图当完整字段清单。 | 不导出 | 以当前字段模型为准。 |
分页
| 控件 | 规则 |
|---|---|
| 每页条数 | 右下角下拉默认显示 10 per page。 |
| 页码切换 | 点击页码、Previous、Next 切换结果页。 |
| 条数切换 | 改变每页条数后回到第 1 页。 |
| 条件继承 | 翻页时保留当前关键词和已生效筛选条件。 |
| 结果提示 | 列表下方展示 Showing 1 to 10 of 100 Entries 类结果区间说明。 |
业务流程
Search，或先点击 Filter 打开右侧筛选面板。Date/Time、Brand、Status、Bank 中选择条件，并点击面板底部 Apply。Status 和 System MSG / Refusal Reason 核对处理结果，必要时继续翻页或切换每页条数。业务规则
-
Withdrawal Record 是只读结果页，不提供新增、编辑、审批、撤销或删除动作。
-
搜索关键词、筛选条件、分页和每页条数共同作用于同一份结果集，不能分别命中不同数据口径。
-
Brand、Status、Bank三类筛选之间按 AND 处理；同类多选按 OR 处理。 -
System MSG / Refusal Reason至少对Refusal状态必填；Cancelled如果存在业务原因，也应展示明确取消原因。 -
查询结果只允许出现当前账号有权限查看的品牌和提现记录。
-
从其他页面返回 Withdrawal Record 时，应尽量保留用户上次已生效的关键词、筛选条件和分页上下文。
-
本页不展示独立汇总卡或金额统计区；页面核心任务是记录查询与状态核对。
-
Date/Time标签带红色*，本页默认作为必填筛选，默认范围使用共享最近周期。 -
搜索框默认匹配 Withdrawal Transaction ID、Order ID 和内部记录编号；这些字段未展示时仍可作为后台搜索字段。
-
Withdrawal Record 默认不包含单条详情查看；本页只负责只读列表查询。
-
完整列顺序以字段模型为准；
System MSG / Refusal Reason默认只在拒绝或取消态显示，其他状态有后端处理说明时可展示短文本。 -
状态命名不得同时出现
Cancel和Cancelled两种写法；上线前必须统一成同一词表。
页面特例
| 场景 | 处理 |
|---|---|
| 无查询结果 | 保留搜索区、筛选区、表头和分页容器，列表区展示空态说明。 |
| 日期范围非法 | 阻止筛选生效，在 Date/Time 附近展示可修正的错误提示。 |
| 查询失败 | 保留当前关键词、已生效筛选条件和上一成功列表，提示用户重试。 |
| 品牌 / 银行选项为空 | 分组禁用或只展示 All 占位，不能展示无权限选项。 |
| 拒绝原因过长 | 列表允许截断展示，但必须提供可读完整值的方式。 |
| 网络异常 | 不清空当前输入和草稿条件，允许用户继续 Search 或 Apply 重试。 |