# 提现汇总 — 功能需求说明

> 本文档在《提现汇总功能需求-草稿》基础上整理，并关联 **《关联需求分析.md》** v1.6、平台侧 **《订单管理功能需求》** v1.0.1、**《支付流程》**、《商户管理功能需求》** v1.5、**《店铺管理功能需求》** v1.3.5、**《提现审核功能需求》** v1.0、《资金概览功能需求》** v1.0、《账务管理.md》** v1.0，以及商家侧 **《提现管理功能需求》** v1.0、《资金概览功能需求》** v1.0、《账户管理功能需求》** v1.0 ** 做边界与流程对齐。  
> 范围：**平台管理端 · 财务管理 · 提现汇总** 对 **全平台** 入驻店铺 **提现情况** 的 **按店汇总展示** 与 **提现明细只读查询**；**不含** 提现审核、商家提交提现、收款账户维护。  
> **说明：** 本文档 **仅描述功能需求与业务规则**；不涉及数据库结构、接口定义及技术实现细节。  
> **命名区分：** **提现汇总** = **按店聚合** + **明细下钻（只读）**；**提现审核** = **逐单审核作业**；**资金概览** = **余额/待结算/冻结** 全平台资金视图。

---

## 1. 模块定位

### 1.1 业务目标

在农资商城 **平台管理端（Web）· 财务管理** 提供 **提现汇总** 能力，使 **平台管理员**（及被授予财务查看权限的角色）能够：

- 浏览 **全平台入驻店铺** 的 **提现汇总列表**：按店展示 **已提现金额、待审核金额** 及 **店铺基础信息**；
- 按 **店铺名称** **检索** 汇总列表；
- 对任意店铺 **查看提现明细**：浏览该店 **全部提现申请** 单据，并按 **申请时间、提现状态** **检索**；
- 与 **提现审核、商家提现管理、资金概览** 协作：本模块 **只读**；**审核通过/驳回** 须至 **提现审核** 专册。

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

| 能力 | 说明 |
|------|------|
| **提现审核（通过/驳回）** | 见 **提现审核** |
| **商家提交提现 / 维护收款账户** | 见 **商家 · 提现管理 / 账户管理** |
| **全平台资金总览（余额/待结算/冻结）** | 见 **平台 · 资金概览** |
| **按提现编号逐单全平台列表（含审核按钮）** | 见 **提现审核**（本模块为 **按店汇总 + 单店明细**） |
| **微信/银行自动打款** | **非本期** |
| **导出 / 打印** | **非本期**（草稿 **未要求**） |
| **修改提现状态或金额** | **禁止** |

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

| 草稿条目 | 定稿处理 |
|----------|----------|
| §1 汇总列表字段 | §5 |
| §2 高级检索（店铺名称） | §5.3 |
| §3（1）查看提现明细 + 字段 + 检索 | §6 |
| §4 汇总入驻平台商户提现情况 | §1.4、§3 |
| §5 异常返回 | **不纳入** |
| §6 技术栈 | **不纳入** |

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

```text
【商家 · 提现管理】提交 → 待审核（余额↓ 冻结↑）
【平台 · 提现审核】通过/驳回 → 提现完成 / 审核不通过
            ↓
【本模块 · 只读汇总】
    按店：已提现金额（完成态合计）
         待审核金额（待审态合计）
    下钻：该店提现明细（全状态单据）
```

| 关联模块 | 关系 | 边界说明 |
|----------|------|----------|
| **提现审核** | **并列 · 数据源一致** | 审核 **写** 状态；本模块 **只读** 感知结果；**不含** 审核操作 |
| **商家 · 提现管理** | **口径一致** | 单店明细与商家 **提现记录** **同源**；状态/字段 **同名** |
| **平台 · 资金概览** | **互补** | 资金概览看 **余额/冻结/流水**；本模块看 **提现单据聚合** |
| **商家 · 资金概览** | **间接** | 待审核对应 **冻结** 部分；本模块 **不展示** 余额/待结算 |
| **店铺管理 / 商户管理** | **展示引用** | 汇总列表 **店名、LOGO** 取 **店铺管理** |
| **账务管理** | **规则一致** | 已提现 = **提现完成** 单据；待审核 = **待审核** 单据 |

### 1.4 数据范围

- **纳入：** **全平台** **已入驻** 店铺的 **提现汇总** 与 **已提交** 提现申请明细（含 **待审核、审核不通过、提现完成**）；
- **汇总列表默认：** **店铺管理** 中 **未逻辑删除** 的店铺（含 **开业、停业**）；**从未提现** 的店铺 **仍展示**，金额为 **0**；
- **已逻辑删除店铺：** **仍纳入** 汇总与明细 **若存在** 历史提现单（**状态标识** 已删除）；**无** 提现记录且已删店 **可不展示** 或 **展示为 0**（与 UI **一致** 即可）；
- **排除：** **尚未提交** 的商家端表单草稿；**非本平台入驻** 外部提现。

### 1.5 使用端与角色

| 端 | 可操作角色 | 能力 |
|----|------------|------|
| **平台管理端** | 平台管理员 / 财务运营 | 汇总列表、检索、**查看提现明细** |
| **店铺经营管理端** | 商户经营账号 | **无** 本菜单；见 **商家 · 提现管理** |
| **C 端** | 买家/访客 | **不可** 访问 |

---

## 2. 关联需求分析

### 2.1 与《关联需求分析》— 供给链

| 关联点 | 定稿 |
|--------|------|
| 供给链 | 须 **商户 + 店铺** 已入驻，方有 **可提现余额** 与 **提现单据** |
| 商户冻结/注销 | **不自动** 隐藏或改写汇总；历史单据 **仍可读** |
| 店铺停业 | **不隐藏** 汇总行；**待审核金额** **仍统计** |
| 删店 | 删店 **不可** 新提现；**历史单** **仍可查**（与 **提现审核** **一致**） |

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

| 项 | 定稿 |
|----|------|
| 分工 | **提现审核** = **逐单列表 + 审核**；**本模块** = **按店汇总 + 单店明细只读** |
| 单据同源 | 明细字段、状态、账号快照 **与提现审核列表一致**（§6.1） |
| 待审核 | 本模块 **待审核金额** = 该店 **待审核** 单据 **提现金额之和**；与审核列表 **可交叉核对** |
| 已提现 | 本模块 **已提现金额** = 该店 **提现完成** 单据 **提现金额之和** |
| 审核不通过 | **不计入** 汇总两列；**在明细中展示** |
| 跳转审核 | 明细页 **至** 提现审核 **处理** **非本期**（草稿 **未要求**） |

### 2.3 与平台《资金概览功能需求》v1.0

| 项 | 定稿 |
|----|------|
| 互补 | 资金概览：**总余额 / 待结算 / 冻结**；本模块：**已提现 / 待审核（按店）** |
| 待审核与冻结 | 单店 **待审核金额** **≤** 该店 **冻结金额**（冻结 **仅** 来自 **待审提现**，见 **账务管理**）；**无待审** 时 **待审核金额 = 0** |
| 已提现与余额 | **已提现金额** **不累加** 至 **可用余额**（提交时已扣；完成时 **出账**）；**与余额无简单恒等式** |
| 流水 | 本模块 **不展示** 资金流水；见 **资金概览 · 查看资金日志** |

### 2.4 与平台《商户管理》《店铺管理》

| 项 | 定稿 |
|----|------|
| 店铺名称 / LOGO | 汇总列表取 **店铺管理** **当前** 展示信息 |
| 店铺状态 | **开业 / 停业**；已逻辑删除 **另标识** |
| 商户主体结算账户 | **不** 在本模块展示 |

### 2.5 与商家《提现管理功能需求》v1.0

| 项 | 定稿 |
|----|------|
| 单店明细 | 与商家 **提现记录** **同一批单据**；**仅视角** 不同（平台 **代查** vs 商家 **本店**） |
| 状态 | **待审核 / 审核不通过 / 提现完成** **同名** |
| 字段 | **申请时间、提现账号、提现金额、备注、提现处理说明** **对齐** |
| 写操作 | 商家 **提交**；本模块 **只读** |

### 2.6 与商家《账户管理功能需求》v1.0

| 项 | 定稿 |
|----|------|
| 提现账号 | 明细 **提现账号** 为 **申请时** 账户 **摘要快照**（类型 + 脱敏账号 + 姓名） |
| 账户变更 | 申请后商家 **编辑/删除** 账户 **不影响** 明细 **已存展示** |

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

| 项 | 定稿 |
|----|------|
| 提交 | 商家写 **余额提现** 流水；**待审核** 期间 **冻结↑** |
| 审核通过 | **提现完成** 流水；**已提现金额** **计入** 本模块汇总 |
| 审核驳回 | **提现驳回** 流水；**不计入** 已提现/待审核汇总列 |
| 业务编号 | 明细 **可关联** 提现编号（与流水 **业务编号** 同源）；草稿明细 **未列** → **非本期** 单独列 |

### 2.8 与《账务管理.md》

| 项 | 定稿 |
|----|------|
| 已提现口径 | **提现完成** 态单据 **提现金额** 累计 |
| 待审核口径 | **待审核** 态单据 **提现金额** 累计 |
| 审核不通过 | 资金 **已退回** 可用余额；**仅明细可见** |
| 订单 | 提现 **不绑定** 订单；汇总 **仅统计提现单** |

---

## 3. 业务概念与汇总口径

### 3.1 核心概念

| 概念 | 说明 |
|------|------|
| **提现汇总（按店）** | 以 **店铺** 为维度，聚合 **已提现金额** 与 **待审核金额** |
| **已提现金额** | 该店 **提现状态 = 提现完成** 的全部单据 **提现金额** 之和 |
| **待审核金额** | 该店 **提现状态 = 待审核** 的全部单据 **提现金额** 之和 |
| **提现明细** | 某店 **全部已提交** 提现申请 **单据列表**（含 **三态**） |
| **提现金额** | 单据 **申请金额**；**正数**；**两位小数**；单位 **元** |

### 3.2 汇总口径（定稿）

| 汇总列 | 计入状态 | 不计入 |
|--------|----------|--------|
| **已提现金额** | **提现完成** | 待审核、审核不通过 |
| **待审核金额** | **待审核** | 提现完成、审核不通过 |

**说明：**

- **审核不通过** 单据 **仅** 在 **提现明细** 中展示，**不进入** 上述两列合计；
- 同一店铺 **多笔** 待审核：**待审核金额** = **各笔之和**；
- 汇总 **实时** 计算（随 **提现审核** 结果 **即时变化**）。

### 3.3 提现状态（明细 · 与提现审核一致）

| 状态 | 含义 | 计入已提现 | 计入待审核 |
|------|------|------------|------------|
| **待审核** | 商家已提交，等待平台 | 否 | **是** |
| **审核不通过** | 平台驳回 | 否 | 否 |
| **提现完成** | 平台审核通过 | **是** | 否 |

### 3.4 与三模块对照

| 维度 | **本模块 · 提现汇总** | **提现审核** | **商家 · 提现管理** |
|------|----------------------|--------------|---------------------|
| 视角 | **按店汇总** + 单店明细 | **全平台逐单** | **单店逐单** |
| 写操作 | **无** | **审核** | **提交** |
| 汇总列 | **已提现 / 待审核** | **无** | **无** |
| 明细检索 | 申请时间、状态 | 申请时间、状态 | 申请时间、状态 |

---

## 4. 功能结构

```text
提现汇总（平台 · 财务管理）
├── 店铺提现汇总列表（含店铺名称检索）
└── 查看提现明细（抽屉/弹窗/子页）
        ├── 明细列表
        └── 高级检索：申请时间、提现状态
```

---

## 5. 店铺提现汇总列表

### 5.1 列表字段（与草稿 §1 一致）

| 列名 | 说明 |
|------|------|
| **店铺名称** | 当前店铺名称（**店铺管理**） |
| **店铺 LOGO** | 店铺头像 / LOGO |
| **已提现金额** | 该店 **提现完成** 单据 **金额合计**；无则 **0.00** |
| **待审核金额** | 该店 **待审核** 单据 **金额合计**；无则 **0.00** |
| **操作** | **查看提现明细** |

**金额格式：** **两位小数**；单位 **元**（¥）；**千分位** 可选。

**定稿补充：**

| 列 | 说明 |
|----|------|
| **店铺状态** | 草稿 **未要求** 单独列；可在 **店名旁** 标识 **开业/停业/已删除**（与 **资金概览** 排行 **一致**，**建议**） |
| **默认排序** | 建议 **待审核金额降序**（便于运营 **优先关注** 待处理店）；产品可 **默认** **已提现降序** 或 **店名**；**须支持** 用户切换（**非本期** 列排序若草稿 **未要求** → **非本期**） |

### 5.2 分页

| 项 | 定稿 |
|----|------|
| 分页 | **支持** 分页 |
| 空列表 | 全平台 **无入驻店铺** 时空态；**有店无提现** 时 **仍展示** 店铺行（金额为 **0**） |

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

| 条件 | 类型 | 说明 |
|------|------|------|
| **店铺名称** | 文本模糊 | 筛选 **店铺名称** 含关键词的汇总行 |

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

**非本期：** 按 **商户名称**、**待审核金额区间** 检索（草稿 **未要求**）。

---

## 6. 查看提现明细

### 6.1 入口与明细列表（与草稿 §3（1）一致）

**入口：** 汇总行 **「查看提现明细」** → 抽屉 / 弹窗 / 子页。

**默认范围：** **当前行店铺** 的 **全部** 已提交提现申请（**三态** 均含）。

| 列名 | 说明 |
|------|------|
| **申请时间** | 商家 **提交成功** 时间；**yyyy-MM-dd HH:mm:ss** |
| **店铺名称** | 单据所属店铺（单店入口时 **固定** 为当前店） |
| **提现账号** | **申请时** 收款账户 **摘要**（与 **提现审核** §2.6 **一致**） |
| **提现金额** | **两位小数** |
| **备注** | 商家填写；无则 **—** |
| **提现状态** | **待审核 / 审核不通过 / 提现完成** |
| **提现处理说明** | 平台审核后填写；**待审核** 时 **—** |

**默认排序：** **申请时间倒序**（最新在前）。

**能力：** **只读**；**无** 审核、编辑、删除。

### 6.2 高级检索（与草稿 §3（1）一致）

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

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

**定稿补充：**

- 从 **某店** 入口进入时，**重置** 恢复 **默认该店全部明细**（**仍限** 当前 `shopId`）；
- **店铺名称** 在单店入口 **固定**，**不可** 改为跨店（跨店请回 **汇总列表** 换店）。

### 6.3 分页与空态

| 项 | 定稿 |
|----|------|
| 分页 | **支持** |
| 无单据 | 空态 + 提示（如「暂无提现记录」） |

---

## 7. 端到端流程

### 7.1 平台日常查看

```text
平台 · 财务管理 · 提现汇总
    → 汇总列表：各店已提现 / 待审核对比
    → 可选：按店铺名称检索
    → 某店「查看提现明细」
        → 明细：待审核 / 完成 / 驳回单据
        → 可选：按申请时间、状态检索
```

### 7.2 与提现审核协作

```text
汇总发现某店待审核金额偏高
    → 查看提现明细 → 确认待审单据
    → （另册）提现审核 → 通过/驳回
    → 返回本模块刷新
        → 待审核金额↓（或归零）
        → 若通过：已提现金额↑
        → 若驳回：明细状态变审核不通过，汇总列不变（驳回不计入两列）
```

### 7.3 与商家端对账

```text
商家 · 提现管理（单店记录）与 平台 · 本模块（该店明细）
    → 同一申请时间、金额、状态、处理说明 **须一致**
    → 商家提交后：平台汇总 **待审核金额** **即时** 增加
    → 平台审核完成后：汇总列 **按 §3.2 规则** 更新
```

### 7.4 典型数值变化

| 事件 | 已提现金额 | 待审核金额 |
|------|------------|------------|
| 商家 **首次提交** 100 元 | 不变 | **+100** |
| 平台 **通过** 该单 | **+100** | **−100** |
| 商家 **再提交** 50 元 | 不变 | **+50** |
| 平台 **驳回** 50 元单 | 不变 | **−50** |
| 店铺 **从未提现** | **0** | **0** |

---

## 8. 权限与菜单

| 项 | 定稿 |
|----|------|
| 菜单路径 | **财务管理 → 提现汇总** |
| 权限粒度 | **汇总查看**、**明细查看** 可 **分权**；v1 **可合并** 为单一 **查询** 权限 |
| 数据权限 | **全平台** 店铺；**无** 按商户 **隔离**（平台端） |

---

## 9. 异常与空态（功能口径）

| 场景 | 期望表现 |
|------|----------|
| 全平台无店铺 | 汇总空态 |
| 有店无提现 | 汇总 **仍展示** 店行；金额 **0**；明细空态 |
| 明细检索无结果 | 空态 + 提示 |
| 已删店有历史单 | 汇总/明细 **仍可查**；**已删除** 标识 |
| 并发审核 | 刷新后汇总 **与最新状态一致**；**不** 在本模块 **审核** |

---

## 10. 非本期与待建设

| 项 | 说明 |
|------|------|
| **明细 · 提现编号列** | 草稿 **未要求**；对账 **建议** 后续 **补充** |
| **汇总列排序** | 草稿 **未要求** |
| **跳转提现审核** | 草稿 **未要求** |
| **导出 / 打印** | **非本期** |
| **按商户维度汇总** | 草稿 **未要求** |
| **手续费 / 实到账** | **非本期** |
| **批量操作** | **非本期** |

---

## 11. 业务规则汇总

| 编号 | 规则 |
|------|------|
| **WS-A1** | 本模块 **只读**；**禁止** 改状态/金额 |
| **WS-A2** | 数据范围 **全平台** 入驻店铺提现 |
| **WS-A3** | **已提现金额** = Σ **提现完成** 单据金额 |
| **WS-A4** | **待审核金额** = Σ **待审核** 单据金额 |
| **WS-A5** | **审核不通过** **不计入** 汇总两列；**明细可见** |
| **WS-A6** | 明细字段、状态与 **提现审核 / 商家提现管理** **一致** |
| **WS-A7** | 汇总 **店名/LOGO** 与 **店铺管理** **一致** |
| **WS-A8** | 明细检索：**申请时间 + 提现状态** |
| **WS-A9** | 汇总检索：**店铺名称** |
| **WS-A10** | **提现审核** **不写** 本模块；**只读** 其单据结果 |
| **WS-A11** | 无提现记录的入驻店 **仍展示**，金额为 **0** |

---

## 12. 版本记录

| 版本 | 说明 |
|------|------|
| **v1.0** | 首版定稿：对齐草稿 §1～§4；补全按店汇总口径/明细/检索/与提现审核·资金概览·商家财务边界；《提现汇总功能需求-草稿》**保持不变** |

---

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