# 提现管理 — 功能需求说明

> 本文档在《提现管理功能需求-草稿》基础上整理，并关联 **《关联需求分析.md》** v1.6、平台侧 **《订单管理功能需求》** v1.0.1、**《支付流程》**、《商户管理功能需求》** v1.5、**《店铺管理功能需求》** v1.3.5、**《提现审核功能需求》** v1.0，以及商家侧 **《资金概览功能需求》** v1.0、《账户管理功能需求-草稿》、《商家端店铺上下文接口说明》** 做边界与流程对齐。  
> 范围：**店铺经营管理端 · 财务中心 · 提现管理** 对 **当前店铺** **提现申请提交** 与 **提现记录** 浏览；**不含** 平台审核操作、收款账户维护、资金概览汇总只读页。  
> **说明：** 本文档 **仅描述功能需求与业务规则**；不涉及数据库结构、接口定义及技术实现细节。  
> **命名区分：** **提现状态**（待审核 / 审核不通过 / 提现完成）为本模块 **单据状态**；**资金流水 · 变动原因** 中 **提现驳回** 与 **审核不通过** **语义等价**（见 §3.3）。

---

## 1. 模块定位

### 1.1 业务目标

在农资商城 **店铺经营管理端（Web）· 财务中心** 提供 **提现管理** 能力，使 **店铺管理员**（商户经营账号及已授权子管理员）能够：

- 填写 **提现账户**（从 **账户管理** 已添加账户中选择）、**提现金额**、**备注**，**提交提现申请**；
- 提交成功后 **自动生成提现编号**，单据进入 **待审核**；
- 浏览 **当前店铺** **提现记录** 列表，查看 **提现处理说明**（平台审核后回写）；
- 按 **申请时间、提现状态** **高级检索** 历史记录；
- 与 **资金概览** 协作：提交/审核结果 **同步** **收支概况** 流水与 **冻结/余额** 指标。

**不包含（本期或与它模块分工）：**

| 能力 | 说明 |
|------|------|
| **维护收款账户** | 见 **账户管理** |
| **平台审核通过/驳回** | 见 **平台 · 提现审核** |
| **资金概览只读汇总** | 见 **资金概览** |
| **撤销待审核申请** | **非本期** |
| **微信/银行自动打款** | **非本期** |
| **手续费扣除** | **非本期** |
| **导出 / 打印** | **非本期** |
| **C 端买家操作** | **不可** 访问 |

### 1.2 与草稿的对应关系

| 草稿条目 | 定稿处理 |
|----------|----------|
| §1 提现表单 + 自动生成编号 | §6 |
| §2 提现记录列表 + 高级检索 | §5 |
| §3 按当前店铺查询 | §1.4、§2.8 |
| §4 店铺上下文 | §2.8、§11 |
| §5 异常返回 | **不纳入** |
| §6 技术栈 | **不纳入** |

### 1.3 在财务链中的位置

```text
【账户管理】维护收款账户
    ↓
【资金概览】可用余额 > 0
    ↓
【本模块 · 提现管理】提交申请
    → 生成提现编号 → 待审核
    → 资金流水：余额提现（余额↓ 冻结↑）
    ↓
【平台 · 提现审核】通过 / 驳回 + 处理说明
    → 提现完成 / 审核不通过
    → 流水：提现完成 / 提现驳回
    ↓
【本模块 · 提现记录】同步状态与处理说明
【资金概览】同步流水与指标
```

| 关联模块 | 关系 | 边界说明 |
|----------|------|----------|
| **账户管理** | **上游依赖** | 提交时 **须** 选择 **本店已添加** 账户 |
| **资金概览** | **下游展示** | 提交/审核写流水；本模块 **不** 改概览页逻辑 |
| **平台 · 提现审核** | **下游审核** | 本模块 **唯一** 商家提交入口；审核 **唯一** 在平台 |
| **全部订单** | **间接** | **可用余额** 来自 **订单收支**（O7 确认收货） |
| **店铺管理** | 间接 | **删店** 前须处理 **待审核提现**（产品建议） |

### 1.4 数据范围

- **纳入：** 请求上下文 **当前店铺** 下 **全部已提交** 提现申请；
- **排除：** 其他店铺记录；**未提交** 的表单草稿（**不持久化**）；
- **上下文：** 页头展示 **当前店铺名称**（只读）；切换店铺后 **整页刷新**。

### 1.5 使用端与角色

| 端 | 可操作角色 | 能力 |
|----|------------|------|
| **店铺经营管理端** | **商户经营账号** | **提交提现**、**提现记录** |
| **店铺经营管理端** | 员工（子管理员） | 由 **角色管理** 决定菜单与按钮 |
| **平台管理端** | 平台管理员 | **无** 本菜单；在 **提现审核** 处理 |
| **C 端** | 买家/访客 | **不可** 访问 |

---

## 2. 关联需求分析

### 2.1 与《关联需求分析》— 用户链

| 关联点 | 定稿 |
|--------|------|
| O7 确认收货 | **订单收支** 增加 **可用余额** 后 **方可** 提现 |
| §9.1 经营账号 | 本模块 **仅当前店铺** |
| 商户冻结/注销 | **不自动** 撤销 **待审核** 单；运营在 **平台** 处理 |

### 2.2 与平台《订单管理功能需求》/ 商家《全部订单功能需求》

| 项 | 定稿 |
|----|------|
| 可提现来源 | **已完成** 订单 **实付** 经 **订单收支** 入 **可用余额** |
| 待结算 | **待发货/已发货** 实付 **不计入** 可提现；**不可** 对本模块提现 |
| 退款/关单 | **非本期** 与提现 **联动** |

### 2.3 与平台《支付流程》

| 项 | 定稿 |
|----|------|
| 虚拟余额 | 提现 **扣减** 店铺 **虚拟可提现余额**；**非** 微信 API 实时转账 |
| 打款 | **平台审核通过** 后运营 **线下/渠道打款**；商家 **只读** 结果 |

### 2.4 与商家《资金概览功能需求》v1.0

| 项 | 定稿 |
|----|------|
| 提交成功 | 写 **余额提现**：余额 **−** 申请额、冻结 **+** 申请额 |
| 审核通过 | 写 **提现完成**：余额 **不变**、冻结 **−** 申请额 |
| 审核驳回 | 写 **提现驳回**：余额 **+** 申请额、冻结 **−** 申请额 |
| 业务编号 | 流水 **业务编号** = **提现编号** |
| 校验 | 申请金额 **≤** 当前 **可用店铺余额** |

### 2.5 与平台《提现审核功能需求》v1.0

| 项 | 定稿 |
|----|------|
| 状态 | **待审核 / 审核不通过 / 提现完成** **同名** |
| 编号 | **提现编号** **全平台唯一**；**提交成功** 时生成 |
| 处理说明 | 平台审核后 **回写** 本模块列表 **只读** |
| 写操作 | 商家 **不可** 改 **终态** 单；**不可** 在本模块 **审核** |
| 撤销 | **非本期** |

### 2.6 与商家《账户管理功能需求-草稿》

| 项 | 定稿 |
|----|------|
| 提现账户 | 表单 **下拉/选择** **本店已添加** 账户 |
| 账户类型 | **银行卡 / 支付宝 / 微信** 与 **账户管理** **一致** |
| 快照 | 提交成功 **保存** 账户 **摘要快照**（姓名、账号脱敏、类型）；**后续** 编辑/删除账户 **不影响** 已提交单 |
| 无账户 | **须先** 至 **账户管理** 添加；本模块 **不可**  inline 添加 |

### 2.7 与《商家端店铺上下文接口说明》

| 项 | 定稿 |
|----|------|
| 数据隔离 | 列表、提交 **仅当前店铺** |
| 切换店铺 | 切换后 **整页刷新** |

---

## 3. 业务概念与状态

### 3.1 核心概念

| 概念 | 说明 |
|------|------|
| **提现申请** | 商家 **一次** 提现 **单据** |
| **提现编号** | 系统生成；**全平台唯一** |
| **提现金额** | **正数**；**两位小数**；单位 **元** |
| **提现账户** | **账户管理** 中 **已添加** 的收款账户 |
| **备注** | 商家 **选填** 说明 |
| **提现处理说明** | 平台审核填写；**待审核** 时 **—** |

### 3.2 提现状态（单据）

| 状态 | 含义 | 商家可操作 |
|------|------|------------|
| **待审核** | 已提交，等待平台 | **只读** |
| **审核不通过** | 平台驳回 | **只读**；可 **新单** 再提 |
| **提现完成** | 平台审核通过 | **只读** |

### 3.3 与资金流水「变动原因」映射

| 提现状态 | 资金流水 · 变动原因 | 发生时机 |
|----------|---------------------|----------|
| （提交后） | **余额提现** | 本模块 **提交成功** |
| **审核不通过** | **提现驳回** | 平台 **驳回** |
| **提现完成** | **提现完成** | 平台 **通过** |

### 3.4 状态流转

```text
【本模块】提交成功 → 待审核（已写余额提现）

【平台 · 提现审核】
    ├── 通过 → 提现完成 → 提现完成流水
    └── 驳回 → 审核不通过 → 提现驳回流水

终态不可修改；驳回后可新单提交
```

---

## 4. 功能结构

```text
提现管理（商家 · 财务中心）
├── 提交提现（表单）
└── 提现记录（列表 + 高级检索）
```

---

## 5. 提现记录列表

### 5.1 列表字段

| 列名 | 说明 |
|------|------|
| **提现编号** | 系统唯一编号 |
| **申请时间** | 提交成功时间；**yyyy-MM-dd HH:mm:ss** |
| **提现账户** | 申请时账户 **摘要**（类型 + 脱敏账号 + 姓名） |
| **提现金额** | **两位小数**；单位 **元** |
| **备注** | 商家填写；无则 **—** |
| **提现状态** | **待审核 / 审核不通过 / 提现完成** |
| **提现处理说明** | 平台审核后；**待审核** 时 **—** |

**默认排序：** **申请时间倒序**。

### 5.2 分页

| 项 | 定稿 |
|----|------|
| 分页 | **支持** |
| 空列表 | 空态 + 友好提示 |

### 5.3 高级检索（与草稿一致）

| 条件 | 类型 | 说明 |
|------|------|------|
| **申请时间** | 日期区间 | **开始**～**结束**（含边界） |
| **提现状态** | 下拉 | **全部** / **待审核** / **审核不通过** / **提现完成** |

草稿 §2「审核不通过/提现完成」定稿扩展为 **含待审核、全部**，与 **平台 · 提现审核** **一致**。

**操作按钮：** **搜索**、**重置**。

---

## 6. 提交提现

### 6.1 入口与表单

| 字段 | 必填 | 说明 |
|------|------|------|
| **提现账户** | 是 | 从 **本店已添加** 账户 **选择** |
| **提现金额** | 是 | **> 0**；**≤ 可用店铺余额**；**两位小数** |
| **备注** | 否 | 多行文本；**最多 200 字** |

**展示辅助（建议）：** 当前 **可用店铺余额**（只读，来自 **资金概览** 口径）。

### 6.2 提交前校验

| 规则 | 说明 |
|------|------|
| 账户有效 | 所选账户 **属于当前店铺** 且 **未删除** |
| 金额 | **> 0** 且 **≤ 可用店铺余额** |
| 余额 | **可用店铺余额** 以 **实时** 汇总为准 |
| 并发 | 多笔 **待审核** **允许**；冻结为 **各笔之和** |

### 6.3 提交后

```text
校验通过
    → 生成提现编号（全平台唯一）
    → 保存账户快照
    → 提现状态 → 待审核
    → 写入资金流水：余额提现（余额−，冻结+）
    → 列表可见；平台 · 提现审核 可见待审
    → 提示提交成功
```

### 6.4 边界

| 场景 | 定稿 |
|------|------|
| 无收款账户 | 提示 **请先添加收款账户**（引导 **账户管理**） |
| 余额不足 | 提示 **提现金额不能超过可用余额** |
| 店铺已删除 | **不可** 新提交（**非本模块** 登录/上下文拦截） |
| 待审核不可撤销 | **非本期** 撤销 |

---

## 7. 端到端流程

### 7.1 主路径

```text
账户管理 · 添加银行卡/支付宝/微信
    → 资金概览 · 确认收货后可用余额 > 0
    → 提现管理 · 选账户、填金额 → 提交
        → 待审核 + 余额提现流水
    → 平台 · 提现审核 · 通过 + 处理说明
        → 提现完成 + 提现完成流水
    → 本模块列表见终态与说明
```

### 7.2 驳回路径

```text
提交 → 待审核
    → 平台驳回 + 处理说明
        → 审核不通过 + 提现驳回流水
    → 可用余额恢复 → 可再次提交 **新单**
```

---

## 8. 权限与菜单

| 项 | 定稿 |
|----|------|
| 菜单路径 | **财务中心 → 提现管理** |
| 权限粒度 | **列表查看**、**提交提现** 可 **分权** |
| 数据权限 | **仅当前店铺** |

---

## 9. 异常与提示（功能口径）

| 场景 | 期望提示（示例） |
|------|------------------|
| 未选账户 | 请选择提现账户 |
| 金额为空或 ≤0 | 请输入有效的提现金额 |
| 超过可用余额 | 提现金额不能超过可用余额 |
| 账户不存在 | 提现账户不存在或已删除 |
| 备注超长 | 备注不能超过200字 |
| 提交成功 | 提交成功 |
| 列表无数据 | 暂无提现记录 |

---

## 10. 非本期与待建设

| 项 | 说明 |
|------|------|
| **撤销待审核** | **非本期** |
| **修改待审核单** | **不做** |
| **手续费** | **非本期** |
| **站内消息通知审核结果** | **非本期** |
| **按提现编号关键词检索** | 草稿 **未要求** |
| **导出** | **非本期** |
| **页内添加账户** | **须** 跳转 **账户管理** |

---

## 11. 业务规则汇总

| 编号 | 规则 |
|------|------|
| **WD-A1** | 本模块为 **当前店铺** 提现 **唯一提交入口** |
| **WD-A2** | **提现编号** 提交成功时生成；**全平台唯一** |
| **WD-A3** | 状态 **三态**：待审核 / 审核不通过 / 提现完成 |
| **WD-A4** | 提交成功写 **余额提现** 流水；**余额↓ 冻结↑** |
| **WD-A5** | 申请金额 **≤ 可用店铺余额** |
| **WD-A6** | 账户须来自 **账户管理** **本店** 有效账户 |
| **WD-A7** | 提交后 **保存账户快照**；后续改账户 **不影响** 已提交单 |
| **WD-A8** | 平台审核结果与 **处理说明** **只读** 回写列表 |
| **WD-A9** | **终态不可改**；驳回后 **新单** 再提 |
| **WD-A10** | 列表字段、检索与 **草稿 §2** **一致**（状态扩展 **待审核/全部**） |
| **WD-A11** | 数据范围 **仅当前店铺** |

---

## 12. 版本记录

| 版本 | 说明 |
|------|------|
| **v1.0** | 首版定稿：对齐草稿 §1～§4；补全提交校验/状态机/流水协作/与资金概览·账户管理·平台提现审核边界；《提现管理功能需求-草稿》**保持不变** |

---

*文档版本：v1.0（定稿）· 关联《关联需求分析.md》v1.6、平台/商家财务相关需求 · 草稿《提现管理功能需求-草稿.md》保持不变。*
