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