# 资金概览 — 功能需求说明

> 本文档在《资金概览功能需求-草稿》基础上整理，并关联 **《关联需求分析.md》** v1.6、平台侧 **《订单管理功能需求》** v1.0.1、**《支付流程》**、《商户管理功能需求》** v1.5、**《店铺管理功能需求》** v1.3.5、**《提现审核功能需求》** v1.0、《账务管理.md》** v1.0，以及商家侧 **《资金概览功能需求》** v1.0、《提现管理功能需求》** v1.0、《账户管理功能需求》** v1.0 ** 做边界与流程对齐。  
> 范围：**平台管理端 · 财务管理 · 资金概览** 对 **全平台** 店铺 **虚拟资金汇总**、**店铺余额排行** 及 **资金变动明细** 的 **只读展示**；**不含** 提现审核、手工调账、商家账户维护。  
> **说明：** 本文档 **仅描述功能需求与业务规则**；不涉及数据库结构、接口定义及技术实现细节。  
> **命名区分：** **平台 · 资金概览** 为 **全平台只读汇总 + 排行 + 代查流水**；**商家 · 资金概览** 为 **单店** 视图；**提现审核** 为 **单据作业**。

---

## 1. 模块定位

### 1.1 业务目标

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

- 查看 **全平台** **资金总览**：**总余额**、**待结算总额**、**冻结总额**；
- 浏览 **店铺余额排行**：按店铺展示 **可用余额、待结算、冻结** 及 **店铺基础信息**，支持 **列排序**；
- 对任意店铺 **查看资金日志**：浏览 **收支变动明细**，并按 **店铺名称、变动时间** **检索**；
- 与 **提现审核、商家财务模块、订单链** 协作：本模块 **只读**；**审核提现、商家发起提现** 须至 **对应专册**。

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

| 能力 | 说明 |
|------|------|
| **提现审核（通过/驳回）** | 见 **提现审核** |
| **商家提交提现 / 维护收款账户** | 见 **商家 · 提现管理 / 账户管理** |
| **商家端单店资金概览** | 见 **商家 · 资金概览**（单店视角） |
| **手工调账、手续费、分账** | **非本期** |
| **C 端支付、退款执行** | 见 **支付/退款** 专册 |
| **修改店铺余额/冻结** | **禁止** |
| **导出 / 打印** | **非本期**（草稿 **未要求**） |

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

| 草稿条目 | 定稿处理 |
|----------|----------|
| §1 所有店铺总余额三块 | §4 |
| §2（1）店铺余额排行列表 | §5 |
| §2（2）查看资金日志 + 明细 + 高级检索 | §6 |
| §3 异常返回 | **不纳入** |
| §4 技术栈 | **不纳入** |

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

```text
【用户链 · 订单】支付 → 待结算 → 确认收货 → 订单收支（余额↑）
【商家 · 提现管理】提交 → 余额提现（余额↓ 冻结↑）
【平台 · 提现审核】通过/驳回 → 提现完成 / 提现驳回
            ↓
【本模块 · 只读展示】
    全平台总览（总余额 / 待结算总额 / 冻结总额）
    店铺余额排行
    店铺资金变动明细（可检索）
```

| 关联模块 | 关系 | 边界说明 |
|----------|------|----------|
| **商家 · 资金概览** | **口径一致** | 单店指标/流水 **同名同义**；本模块 **全平台聚合** |
| **提现审核** | **并列** | 审核 **写** 流水；本模块 **只读** 感知结果 |
| **店铺管理** | **展示引用** | 排行展示 **店名、LOGO、状态、开店时间** |
| **商户管理** | 间接 | **主体结算账户** ≠ 店铺虚拟余额 |
| **平台 · 订单管理** | **口径一致** | 待结算/结算时点与 **O7** **一致** |
| **账务管理** | **规则一致** | 订单↔余额↔提现 **协作链** 见专册 |

### 1.4 数据范围

- **纳入：** **全平台** 全部 **已入驻** 店铺的 **实时资金指标** 与 **已产生** 的资金变动流水；
- **排行默认：** **店铺管理** 中 **未逻辑删除** 的店铺（含 **开业、停业**）；
- **已逻辑删除店铺：** **仍纳入** 排行与流水 **若存在** 历史余额或流水（**状态标识** 已删除）；**无** 资金且已删店 **可不展示** 或 **展示为 0**（与 UI **一致** 即可）；
- **排除：** **非本平台** 外部账户；**尚未发生** 的变动（**无** 预生成流水）。

### 1.5 使用端与角色

| 端 | 可操作角色 | 能力 |
|----|------------|------|
| **平台管理端** | 平台管理员 / 财务运营 | 总览、排行、**查看资金日志** |
| **店铺经营管理端** | 商户经营账号 | **无** 本菜单；见 **商家 · 资金概览** |
| **C 端** | 买家/访客 | **不可** 访问 |

---

## 2. 关联需求分析

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

| 编号 / 关联点 | 平台规则 | 本模块体现 |
|---------------|----------|------------|
| **O-P4 / O4** | 支付成功 → **待发货** | 店铺 **待结算↑**；**总待结算** 同步；**不** 增 **总余额** |
| **O7** | 确认收货 → **已完成** | 产生 **订单收支** 流水；店铺 **待结算↓、余额↑** |
| **O8** | 待支付关闭 | **无** 待结算、**无** 流水 |
| **O10** | 未完成含待发货/已发货 | **待结算** 仅 **已支付未完成** 订单 |
| 供给链 | 须 **商户+店铺** 存在 | 排行 **关联** 已建档店铺 |

### 2.2 与平台《订单管理功能需求》

| 项 | 定稿 |
|----|------|
| 待结算口径 | **待发货 + 已发货** 且 **已支付** 订单 **实付合计**（**按店铺** 汇总后 **全平台加总**） |
| 结算时点 | **仅** **已完成**（O7）产生 **订单收支** |
| 实付金额 | 与商家端 **同一** `pay_amount` 口径 |
| 本模块 | **不操作** 订单；**只读** 汇总与流水 |

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

| 项 | 定稿 |
|----|------|
| C 端代收 | 资金入 **平台商户号**；店铺余额为 **虚拟账** |
| 总余额 | **全平台** **可用店铺余额** 之和；**非** 微信商户号 **实时余额** |
| 提现完成 | 资金 **离开** 店铺虚拟账；**总余额** 在 **商家侧** 已扣减后 **体现** |
| 退款 | **非本期** 是否在流水/总览 **冲减** |

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

| 项 | 定稿 |
|----|------|
| 排行 · 店铺名称/LOGO | 取 **店铺管理** 当前展示信息 |
| 排行 · 店铺状态 | **开业 / 停业**；已逻辑删除 **另标识** |
| 排行 · 开店时间 | 店铺 **创建/开店** 时间（与 **店铺管理** 一致） |
| 商户主体结算账户 | **不** 在本模块展示或汇总 |
| 删店 | 删店 **不自动** 清零虚拟余额展示；**历史流水** **仍可查** |
| 停业 | **不隐藏** 排行行；指标 **仍实时** 汇总 |

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

| 项 | 定稿 |
|----|------|
| 分工 | **提现审核** = 单据作业；**本模块** = 汇总/排行/流水 **只读** |
| 流水 | 审核 **通过/驳回** 写 **提现完成 / 提现驳回**；本模块 **可见** |
| 待审核冻结 | **冻结总额** 含 **各店** 待审提现 **冻结** 部分 |
| 跳转 | 排行/流水 **至** 提现审核 **非本期**（草稿 **未要求**） |

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

| 项 | 定稿 |
|----|------|
| 指标同名 | **可用店铺余额**（排行列「店铺余额」）/ **待结算** / **冻结** **口径一致** |
| 变动原因 | **四类同名**：订单收支 / 余额提现 / 提现驳回 / 提现完成 |
| 流水字段 | 明细列与商家 **收支概况** **对齐**（§6.1） |
| 差异 | 商家 **单店 + 账户信息**；平台 **全平台汇总 + 多店排行 + 按店名检索** |
| 写操作 | 商家端 **无** 写；平台端 **亦无** 写 |

### 2.7 与商家《提现管理》《账户管理》

| 项 | 定稿 |
|----|------|
| 余额提现等流水 | 商家 **提交/审核** 触发；平台 **只读** |
| 收款账户 | **不** 在本模块展示；打款目标见 **提现审核** 快照 |
| 业务编号 | 流水 **订单编号 / 提现编号** 与商家端 **同源** |

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

| 项 | 定稿 |
|----|------|
| 订单结算 | **确认收货** 唯一 **订单收支** 入口；排行/总览 **只读** 结果 |
| 提现与订单 | **无** 绑定；**总余额** 为 **各店可用余额** 之和 |
| 非本期 | 退款/关单 **不** 在本模块 **单独** 定规则 |

---

## 3. 资金概念与口径

### 3.1 核心概念

| 概念 | 说明 |
|------|------|
| **总余额** | **全平台** 各店铺 **可用店铺余额** 之和（草稿「总余额」） |
| **待结算总额** | **全平台** 各店铺 **待结算金额** 之和 |
| **冻结总额** | **全平台** 各店铺 **冻结金额** 之和 |
| **店铺余额** | 单店 **可用店铺余额**（排行列；**可提现** 的 **已结算** 金额） |
| **待结算金额** | 单店 **已支付未完成** 订单 **实付合计** |
| **冻结金额** | 单店 **提现审核中** 冻结合计 |
| **资金变动明细** | 店铺 **余额/冻结** 变动流水；**只读** |

### 3.2 汇总恒等式（单店 · 与商家端一致）

对 **任意店铺**：

```text
待结算金额 + 可用店铺余额 + 冻结金额
    = 已支付且尚未因「提现完成」离开平台的资金总量（虚拟账口径）
```

**全平台总览：**

```text
待结算总额 = Σ 各店待结算金额
总余额     = Σ 各店可用店铺余额
冻结总额   = Σ 各店冻结金额
```

> **已提现完成** 金额 **不再** 计入 **总余额** 与 **冻结总额**。**退款冲正、手续费** **非本期**。

### 3.3 变动原因（与商家端一致）

| 变动原因 | 触发来源 | 余额 | 冻结 |
|----------|----------|------|------|
| **订单收支** | 订单 **已完成**（确认收货） | **+** 实付 | 不变 |
| **余额提现** | 商家 **提交** 提现成功 | **−** 申请额 | **+** 申请额 |
| **提现驳回** | 平台 **驳回** 提现 | **+** 申请额 | **−** 申请额 |
| **提现完成** | 平台 **审核通过** | 不变 | **−** 申请额 |

### 3.4 变动展示格式（明细列表）

与商家 **资金概览** §3.4 **一致**：

| 列 | 展示规则 |
|----|----------|
| **变动余额资金** | **变更值**（±）+ **变更后余额** |
| **变动冻结资金** | **变更值**（±）+ **变更后冻结** |

---

## 4. 全平台资金总览

### 4.1 概览区块（与草稿 §1 一致）

| 指标 | 说明 |
|------|------|
| **总余额** | 全平台 **可用店铺余额** 合计；**实时** |
| **待结算总额** | 全平台 **待结算** 合计 |
| **冻结总额** | 全平台 **冻结** 合计 |

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

### 4.2 联动规则

| 事件（平台视角） | 总余额 | 待结算总额 | 冻结总额 |
|------------------|--------|------------|----------|
| 任店支付成功 | — | **+** 该单实付 | — |
| 任店确认收货 | **+** 实付 | **−** 该单实付 | — |
| 任店提交提现 | **−** 申请额 | — | **+** 申请额 |
| 任店提现驳回 | **+** 申请额 | — | **−** 申请额 |
| 任店提现完成 | — | — | **−** 申请额 |

### 4.3 能力边界

| 能力 | 定稿 |
|------|------|
| 页内改余额 | **禁止** |
| 页内审核提现 | **非本期**（见 **提现审核**） |
| 点击总览下钻 | **非本期** |

---

## 5. 店铺余额排行

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

| 列名 | 说明 |
|------|------|
| **店铺名称** | 当前店铺名称 |
| **店铺 LOGO** | 店铺头像/LOGO |
| **店铺状态** | **开业 / 停业**；已逻辑删除 **另标识** |
| **店铺余额** | 该店 **可用店铺余额** |
| **待结算金额** | 该店待结算 |
| **冻结金额** | 该店冻结 |
| **开店时间** | 与 **店铺管理** 一致 |
| **操作** | **查看资金日志** |

**默认排序：** 建议 **店铺余额降序**（产品可 **默认** 任一列；**须支持** 用户切换）。

### 5.2 列排序（与草稿一致）

| 列 | 排序 |
|----|------|
| **店铺余额** | 支持 **升序 / 降序** **整体切换** |
| **待结算金额** | 同上 |
| **冻结金额** | 同上 |

> **定稿：** 「整体升降序切换」= 点击列头 **切换** 该列 **升序/降序**；**同时** 仅 **一列** 生效（与平台列表 **通用规范** 一致）。

### 5.3 分页

| 项 | 定稿 |
|----|------|
| 分页 | **支持** 分页 |
| 空列表 | 空态 + 友好提示 |
| 店铺名称关键词检索 | 草稿 **未要求** 排行检索；**非本期** |

---

## 6. 查看资金日志

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

**入口：** 排行行 **「查看资金日志」** → 抽屉/弹窗/子页。

**默认范围：** **当前行店铺** 的全部资金变动明细。

| 列名 | 说明 |
|------|------|
| **店铺名称** | 流水所属店铺（单店入口时 **固定** 为当前店；检索 **跨店** 时 **展示** 各行店名） |
| **变动时间** | **yyyy-MM-dd HH:mm:ss** |
| **业务编号** | **订单编号** 或 **提现编号** |
| **变动余额资金** | 见 §3.4 |
| **变动冻结资金** | 见 §3.4 |
| **变动原因** | **订单收支 / 余额提现 / 提现驳回 / 提现完成** |

**默认排序：** 变动时间 **倒序**。

**能力：** **只读**；**无** 编辑、删除、补录。

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

| 条件 | 类型 | 说明 |
|------|------|------|
| **店铺名称** | 文本模糊 | 筛选 **指定店铺** 流水；**可** 与入口默认店 **叠加或覆盖** |
| **变动时间** | 日期区间 | **开始**～**结束**（含边界） |

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

**定稿补充：**

- 从 **某店** 入口进入时，**重置** 恢复 **默认仅该店**；
- **店铺名称** 留空且 **未** 固定单店时，可查 **全平台** 流水（运营 **对账** 场景）；
- **变动原因 / 业务编号** 筛选：草稿 **未要求**；**非本期**。

### 6.3 分页与空态

| 项 | 定稿 |
|----|------|
| 分页 | **支持** |
| 无流水 | 空态 + 提示（如「暂无资金变动记录」） |

---

## 7. 端到端流程

### 7.1 平台日常查看

```text
平台 · 财务管理 · 资金概览
    → 顶部：总余额 / 待结算总额 / 冻结总额
    → 排行：各店余额、待结算、冻结对比
    → 某店「查看资金日志」
        → 明细：订单收支、提现相关流水
        → 可选：按店名、时间检索
```

### 7.2 与提现审核协作

```text
排行发现某店冻结偏高
    → 查看资金日志 → 见「余额提现」记录
    → （另册）提现审核 → 处理待审单
    → 审核后日志新增「提现完成/提现驳回」
    → 返回本模块刷新 → 冻结/总览更新
```

### 7.3 与商家端对账

```text
商家 · 资金概览（单店）与 平台 · 本模块（该店排行+日志）
    → 可用余额 / 待结算 / 冻结 **须一致**
    → 流水 **变动原因、业务编号、金额** **须一致**
    → 平台 **多店汇总** = 各店 **相加**
```

---

## 8. 权限与菜单

| 项 | 定稿 |
|----|------|
| 菜单路径 | **财务管理 → 资金概览** |
| 权限粒度 | **总览查看**、**排行查看**、**资金日志查看** 可 **分权** |
| 数据权限 | **全平台** 店铺；**无** 按商户 **隔离**（平台端） |

---

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

| 场景 | 期望表现 |
|------|----------|
| 全平台无店铺 | 总览 **0**；排行空态 |
| 某店无流水 | 日志空态 |
| 某店无钱包记录 | 店铺余额/冻结 **0**；待结算 **仍** 可按订单汇总 |
| 检索无结果 | 空态 + 提示 |

---

## 10. 非本期与待建设

| 项 | 说明 |
|------|------|
| **手工调账** | **不做** |
| **手续费 / 佣金** | **非本期** |
| **退款负向流水** | **非本期** |
| **排行 · 店铺名称检索** | 草稿 **未要求** |
| **流水 · 变动原因/业务编号检索** | 草稿 **未要求** |
| **导出 / 打印** | **非本期** |
| **业务编号跳转订单/提现** | **非本期** |
| **跳转提现审核** | **非本期** |

---

## 11. 业务规则汇总

| 编号 | 规则 |
|------|------|
| **PF-A1** | 本模块 **只读**；**禁止** 改余额/冻结 |
| **PF-A2** | 数据范围 **全平台** 店铺资金 |
| **PF-A3** | **总余额/待结算总额/冻结总额** = 各店 **对应指标之和** |
| **PF-A4** | 单店 **待结算/余额/冻结** 口径与 **商家 · 资金概览** **一致** |
| **PF-A5** | **变动原因四类** 与商家端 **同名** |
| **PF-A6** | 排行 **店铺余额/待结算/冻结** **可排序** |
| **PF-A7** | **查看资金日志** 明细字段与草稿 **一致** |
| **PF-A8** | 日志检索：**店铺名称 + 变动时间** |
| **PF-A9** | **提现审核** **不写** 本模块；**只读** 其流水结果 |
| **PF-A10** | 排行展示 **店名/LOGO/状态/开店时间** 与 **店铺管理** **一致** |
| **PF-A11** | **C 端平台代收** 与 **店铺虚拟余额** **分层理解** |

---

## 12. 版本记录

| 版本 | 说明 |
|------|------|
| **v1.0** | 首版定稿：对齐草稿 §1～§2；补全全平台总览/店铺排行/资金日志/检索/与商家财务·提现审核·店铺·订单边界；《资金概览功能需求-草稿》**保持不变** |

---

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