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

> 本文档在《资金概览功能需求-草稿》基础上整理，并关联 **《关联需求分析.md》** v1.6、平台侧 **《订单管理功能需求》** v1.0.1、**《支付流程》**、《商户管理功能需求》** v1.5、**《店铺管理功能需求》** v1.3.5，以及商家侧 **《全部订单功能需求》** v1.0、《发货管理功能需求》** v1.2、《售后管理功能需求》** v1.0、《提现管理功能需求-草稿》、《账户管理功能需求-草稿》、《商家端店铺上下文接口说明》** 做边界与流程对齐。  
> 范围：**店铺经营管理端 · 财务中心 · 资金概览** 对 **当前店铺** **账户资金快照** 的 **只读展示** 与 **收支流水** 浏览；**不含** 提现申请、收款账户维护、平台代审提现。  
> **说明：** 本文档 **仅描述功能需求与业务规则**；不涉及数据库结构、接口定义及技术实现细节。  
> **命名区分：** **资金概览** 为 **读-only 汇总 + 流水**；**提现管理** 为 **提现申请与记录**；**账户管理** 为 **收款账户维护** 的并列子模块。

---

## 1. 模块定位

### 1.1 业务目标

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

- 查看 **当前店铺** **账户概览**：**可用店铺余额**、**待结算金额**、**冻结金额**、**账户信息**（登录用户名、已添加 **银行卡** 数量）；
- 浏览 **收支概况** 流水列表：每笔 **余额** / **冻结** 变动及 **变动原因**、**业务编号**（订单编号 / 提现编号）、**变动时间**；
- 理解 **订单完成结算** 与 **提现冻结/释放** 对店铺资金的影响，用于 **对账与经营决策**；
- 与 **提现管理、账户管理、全部订单** 协作：本模块 **只读展示**；**发起提现、维护账户** 须至 **对应专册**。

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

| 能力 | 说明 |
|------|------|
| **提交提现申请** | 见 **提现管理** |
| **维护收款账户** | 见 **账户管理**（银行卡 / 支付宝 / 微信） |
| **平台审核提现** | **平台管理端** 专册（草稿 **未建设**）；本模块 **只读** 感知结果 |
| **C 端支付、退款执行** | 见 **支付/退款** 专册；本模块 **不操作** 支付渠道 |
| **订单发货、物流** | 见 **全部订单 / 发货管理** |
| **手工调账、手续费、分账** | **非本期** |
| **平台代查商家资金** | **平台管理端** **无** 本菜单（商家端 **单店** 视图） |
| **导出 / 打印流水** | **非本期** |

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

| 草稿条目 | 定稿处理 |
|----------|----------|
| §1 账户概览四块 | §4 |
| §2 收支概况列表与四种变动原因 | §3、§5、§6 |
| §3 按当前店铺查询 | §1.4、§2.8 |
| §4 店铺上下文 | §2.8、§11 |
| §5 异常返回 | **不纳入** |
| §6 技术栈 | **不纳入** |

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

```text
【用户链 · 订单】
    C 端下单 → 支付成功 → 待发货/已发货（待结算）
            → 买家确认收货 → 已完成（订单收支 · 入余额）
            ↓
【本模块 · 只读展示】
    账户概览（余额 / 待结算 / 冻结 / 账户信息）
    收支概况流水
            ↓
【并列 · 写操作】
    提现管理 · 提交提现 → 余额提现（余额↓ 冻结↑）
            → 平台审核 → 提现完成 / 提现驳回
    账户管理 · 维护提现收款账户
```

| 关联模块 | 关系 | 边界说明 |
|----------|------|----------|
| **全部订单 / 发货管理** | **上游触发** | **已完成** 订单触发 **订单收支**；**待发货/已发货** 计入 **待结算** |
| **提现管理** | **上游写入** | 提现申请/审核结果 → **余额提现 / 提现驳回 / 提现完成** 流水 |
| **账户管理** | **并列只读引用** | 概览区展示 **银行卡数量**；**添加账户** 须至 **账户管理** |
| **售后管理** | **间接** | 退款 **不自动** 写本模块流水（**非本期** 扣减规则另册） |
| **平台 · 订单管理** | 规则一致 | **O7** 确认收货 → 已完成 → **结算时点** 与平台 **一致** |
| **平台 · 支付流程** | 间接 | C 端 **平台代收**；店铺 **虚拟余额** 与 **微信到账** **分层**（§2.4） |

### 1.4 数据范围

- **纳入：** 请求上下文 **当前店铺** 下 **全部已产生** 的资金流水及 **实时汇总** 指标；
- **排除：** 其他店铺资金；**尚未发生** 的变动（无预生成流水）；
- **上下文：** 页头展示 **当前店铺名称**（只读）；切换店铺后 **整页刷新**。

### 1.5 使用端与角色

| 端 | 可操作角色 | 能力 |
|----|------------|------|
| **店铺经营管理端** | **商户经营账号** | 概览、收支流水 **只读** |
| **店铺经营管理端** | 员工（子管理员） | 由 **角色管理** 决定菜单是否可见 |
| **平台管理端** | 平台管理员 | **无** 本模块（审核提现 **另册**） |
| **C 端** | 买家/访客 | **不可** 访问 |

---

## 2. 关联需求分析

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

| 编号 / 关联点 | 平台规则 | 本模块体现 |
|---------------|----------|------------|
| **O-P4 / O4** | 支付成功 **扣库存**；订单 → **待发货** | **不** 即时增加 **可用余额**；计入 **待结算** |
| **O7** | **买家确认收货** → **已完成** | 触发 **订单收支**；**待结算** 减少、**可用余额** 增加 |
| **O8** | 待支付超时 → **已关闭** | **未支付** → **无** 待结算、**无** 订单收支 |
| **O10** | 未完成 = 待支付 + 待发货 + 已发货 | **待结算** 仅含 **已支付未完成**（**待发货 + 已发货**） |
| **O11** | 累计消费仅 **已完成** | 与 **订单收支** **同一完成时点**；本模块 **不维护** 会员统计 |
| **§9.1 经营账号** | 登录后 **切换当前店铺** | 概览与流水 **仅当前店铺** |

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

| 项 | 定稿 |
|----|------|
| 结算触发 | **仅** 订单 **已完成**（**买家确认收货**，O7）产生 **订单收支** |
| 待结算口径 | **待发货 + 已发货** 且 **已支付成功** 的订单 **实付金额** 合计 |
| 待支付 | **不计入** 待结算；**不产生** 收支流水 |
| 已关闭 | **待支付关闭** → **从未** 进入待结算；**已支付关闭** 的退款/冲正 **另册**，**非本期** 流水 |
| 订单编号 | 收支流水 **业务编号** 展示 **订单编号**；**全平台唯一** |
| 商家端 | 商家 **发货/物流** **不改变** 结算时点；**只读** 感知订单状态变化 |

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

| 项 | 定稿 |
|----|------|
| 本期 C 端 | **平台代收**（`wechat.pay.mch-id`）；资金 **先入平台商户号** |
| 店铺余额 | 商家端 **可用店铺余额** 为 **平台内虚拟账户** 口径，表示 **可提现** 的 **已结算** 金额 |
| 与微信到账 | **提现完成** 后资金 **离开** 店铺虚拟余额至 **商家绑定账户**；**不等同** 每笔订单 **实时** 到微信商户号 |
| 商户入驻/分账 | **非本期** C 端路由；**不改变** 本模块 **待结算→余额** 规则 |
| 退款 | 支付渠道退款 **另册**；**非本期** 是否在流水 **冲减** |

### 2.4 与平台《商户管理功能需求》/ 《店铺管理功能需求》

| 项 | 定稿 |
|----|------|
| 商户结算银行 | 平台 **商户经营信息** 中的 **结算账户** 为 **主体级** 资料；**不同于** 商家 **账户管理** 的 **提现收款账户** |
| 店铺归属 | 资金 **按店铺** 隔离；**一店一账** 虚拟余额 |
| 删店 O10 | 存在 **待结算** 或 **未完成订单** 时 **不可删店**；**冻结中提现** 处理 **另册** |
| 店铺停业 | **不自动** 清空余额；**禁止新下单** **不影响** 已有 **待结算/余额** 展示 |

### 2.5 与商家《提现管理功能需求-草稿》

| 项 | 定稿 |
|----|------|
| 写入口 | **提现申请** 在 **提现管理**；本模块 **无** 提交按钮 |
| 流水 | 申请成功 → **余额提现**；审核 **驳回** → **提现驳回**；审核 **通过并打款** → **提现完成** |
| 业务编号 | 流水 **业务编号** 展示 **提现编号** |
| 冻结 | **余额提现** 将申请金额 **转入冻结**；**驳回/完成** **释放** 对应冻结 |
| 列表 | **提现记录** 明细字段见 **提现管理**；本模块 **收支概况** 为 **资金维度** 汇总流水 |

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

| 项 | 定稿 |
|----|------|
| 概览 · 账户信息 | 展示 **当前登录用户名**（经营账号 **登录名**） |
| 概览 · 银行卡数量 | **当前店铺** 在 **账户管理** 中 **已添加** 的 **银行卡** 账户 **条数**（**不含** 支付宝/微信 **计数**，与草稿 **「银行卡数量」** 一致） |
| 维护 | **添加/编辑/删除** 账户 **不在** 本模块；可 **引导跳转** **账户管理**（**非本期** 深链可选） |

### 2.7 与商家《售后管理功能需求》

| 项 | 定稿 |
|----|------|
| 售后完结 | **不自动** 写 **收支概况** |
| 退货退款 | 资金退回 **支付/退款** 专册；**非本期** 是否在流水 **体现** |
| 已结算订单售后 | **扣减余额** 或 **负向流水** **非本期**；产品 **须** 与退款专册 **一并建设** |

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

| 项 | 定稿（功能口径） |
|----|------------------|
| 数据隔离 | 概览、流水 **仅当前店铺** |
| 默认店铺 | 经营账号 **默认最早有效店铺**；员工 **绑定店铺** |
| 切换店铺 | 切换后 **整页刷新** 概览与流水 |
| 跨店 | **禁止** 查看其他店铺资金 |

---

## 3. 资金概念与口径

### 3.1 核心概念

| 概念 | 说明 |
|------|------|
| **可用店铺余额** | **已结算**、**可发起提现** 的金额；对应草稿「订单结算完成的入账金额」 |
| **待结算金额** | **已支付** 且 **未完成**（**待发货 + 已发货**）订单的 **实付金额** 合计；**确认收货** 后 **自动** 转入 **可用余额** |
| **冻结金额** | **提现审核中** 被 **临时冻结** 的金额合计（**不含** 已完成的提现） |
| **收支概况** | **余额** 与 **冻结** 的 **变动流水**；**只读**、**不可删改** |
| **业务编号** | **订单编号** 或 **提现编号**；用于 **关联溯源** |
| **实付金额** | 订单 **买家实际支付** 金额（含运费等 **以订单快照为准**）；**待结算** 与 **订单收支** **同一口径** |

### 3.2 账户恒等式（功能口径）

任意时刻，对 **当前店铺**：

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

> **说明：** 上式为 **产品理解用** 恒等式；**已提现完成** 的金额 **不再** 计入 **可用余额** 与 **冻结**。**退款冲正、手续费** 等 **非本期** 扩展项 **另版** 补充。

### 3.3 变动原因（定稿 · 与草稿一致）

| 变动原因 | 触发来源 | 余额资金 | 冻结资金 |
|----------|----------|----------|----------|
| **订单收支** | 订单 **已完成**（确认收货） | **增加**（+实付金额） | **不变** |
| **余额提现** | **提现管理** 提交申请成功 | **减少**（−申请金额） | **增加**（+申请金额） |
| **提现驳回** | 平台/审核 **驳回** 提现 | **增加**（+原冻结金额） | **减少**（释放至 **0 增量对应部分**） |
| **提现完成** | 平台/审核 **打款完成** | **不变** | **减少**（释放对应冻结） |

> **命名定稿：** 列表、筛选、流水 **统一采用上表四类名称**；**不可** 与 **提现管理** 状态文案 **混用** 为 **不同语义**（如「审核不通过」**展示** 可映射为 **提现驳回**）。

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

与草稿「变更值 + 变更后」一致，建议：

| 列 | 展示规则 |
|----|----------|
| **变动余额资金** | **变更值**（带 **+ / −** 符号）+ **变更后余额**；无变动时 **变更值展示 0** 或 **—**（与 UI 一致） |
| **变动冻结资金** | **变更值**（带 **+ / −** 符号）+ **变更后冻结**；**不变** 时 **变更值 0** |

**示例：**

- 订单收支：`+128.00（余额：1,280.00）` / `0（冻结：200.00）`
- 余额提现：`−500.00（余额：780.00）` / `+500.00（冻结：700.00）`
- 提现驳回：`+500.00（余额：1,280.00）` / `−500.00（冻结：200.00）`
- 提现完成：`0（余额：780.00）` / `−500.00（冻结：200.00）`

---

## 4. 账户概览

### 4.1 概览区块

| 指标 | 说明 |
|------|------|
| **可用店铺余额** | **当前** 可提现金额；**实时** 刷新 |
| **待结算金额** | **当前** 待结算合计；**随订单状态** 变化 |
| **冻结金额** | **当前** 提现冻结合计 |
| **账户信息 · 用户名** | **当前登录** 经营账号 **登录名** |
| **账户信息 · 银行卡数量** | **账户管理** 中 **银行卡** 类型账户 **条数**；**0** 时 **仍展示** |

**金额格式：** **两位小数**；货币单位 **元**（¥）；**千分位** 可选（与商家端 **通用规范** 一致）。

### 4.2 指标联动规则

| 事件 | 可用余额 | 待结算 | 冻结 |
|------|----------|--------|------|
| 支付成功 | — | **+** 订单实付 | — |
| 确认收货 → 已完成 | **+** 实付 | **−** 该单实付 | — |
| 提交提现 | **−** 申请额 | — | **+** 申请额 |
| 提现驳回 | **+** 申请额 | — | **−** 申请额 |
| 提现完成 | — | — | **−** 申请额 |

### 4.3 能力边界

| 能力 | 定稿 |
|------|------|
| 页内改余额 | **禁止** |
| 页内发起提现 | **非本期**（见 **提现管理**） |
| 页内添加银行卡 | **非本期**（见 **账户管理**） |
| 点击指标下钻 | **非本期**（可后续链至 **全部订单** / **提现管理**） |

---

## 5. 收支概况列表

### 5.1 列表字段

| 列名 | 说明 |
|------|------|
| **店铺名称** | **当前店铺名称**（单店上下文；与草稿一致） |
| **变动时间** | 流水 **生效时间**；格式 **yyyy-MM-dd HH:mm:ss** |
| **业务编号** | **订单编号** 或 **提现编号**；**可点击** 跳转 **非本期** |
| **变动余额资金** | 见 §3.4 |
| **变动冻结资金** | 见 §3.4 |
| **变动原因** | **订单收支 / 余额提现 / 提现驳回 / 提现完成** |

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

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

### 5.2 分页

| 项 | 定稿 |
|----|------|
| 分页 | **支持** 分页（与商家端列表 **通用规范** 一致） |
| 空列表 | 展示 **空态** + 友好提示（如「暂无收支记录」） |

### 5.3 检索与筛选

| 项 | 定稿 |
|----|------|
| 草稿要求 | **未要求** 高级检索 |
| 本期 | **仅** 默认 **时间倒序** 分页列表 |
| 按变动原因 / 时间区间筛选 | **非本期** |

---

## 6. 业务流程

### 6.1 订单结算 → 订单收支

```text
C 端支付成功
    → 订单：待发货（计入待结算，余额不变）
    → 商家发货 → 已发货（仍待结算）
    → C 端买家确认收货（O7）
    → 订单：已完成
    → 系统写入收支概况：变动原因=订单收支
          余额 +实付，冻结不变
    → 待结算减少，可用余额增加
    → 本模块概览与列表刷新可见
```

### 6.2 提现 → 冻结与释放

```text
商家 · 提现管理 → 填写账户/金额 → 提交
    → 校验：申请金额 ≤ 可用店铺余额
    → 写入：余额提现（余额−，冻结+）
    → 本模块列表可见

【审核通过 · 打款完成】
    → 写入：提现完成（余额不变，冻结−）
    → 资金离开可提现余额（虚拟账）

【审核驳回】
    → 写入：提现驳回（余额+，冻结−）
    → 可用余额恢复
```

### 6.3 与兄弟模块协作（商家作业链）

```text
查看还有多少钱可提
    → 本模块 · 可用店铺余额

查看在途订单未入账多少
    → 本模块 · 待结算金额
    → （可选）全部订单 · 待发货/已发货

要去提现
    → 提现管理（本模块无入口按钮则菜单跳转）

要添加银行卡
    → 账户管理

要对账某笔订单是否已入账
    → 本模块 · 搜业务编号（**非本期**）或浏览流水 + 全部订单详情
```

---

## 7. 权限与菜单

| 项 | 定稿 |
|----|------|
| 菜单路径 | **财务中心 → 资金概览**（与 UI 一致） |
| 权限粒度 | **菜单可见**、**概览与流水查看** 可由 **角色管理** 分配；**无** 写操作权限 |
| 数据权限 | **仅当前店铺** |

---

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

| 场景 | 期望表现 |
|------|----------|
| 当前店铺无流水 | 列表空态 + 提示 |
| 可用余额为 0 | **仍展示** 概览指标 |
| 无银行卡 | 银行卡数量 **0** |
| 非当前店铺 | **无权** 查看（与其他财务模块一致） |
| 切换店铺 | 概览与列表 **清空并重新加载** |
| 待结算与订单不一致 | **以系统汇总为准**；商家 **不可** 手工改 |

---

## 9. 店铺上下文（功能口径）

与 **《商家端店铺上下文接口说明》** 一致：

```text
登录 → GET 店铺上下文 → 默认 shopId
    → 请求头携带当前 shopId
    → 本模块概览/流水均按该 shopId 过滤
经营账号切换店铺 → 更新 shopId → 本页刷新
员工账号 → 固定绑定店铺，不可切换
```

---

## 10. 非本期与待建设

| 项 | 说明 |
|------|------|
| **退款 / 售后** 负向流水 | **非本期**；须与 **支付退款** 专册 **一并** 定稿 |
| **手续费 / 佣金** 扣减 | **非本期** |
| **平台手工调账** | **不做** |
| 流水 **导出 / 打印** | **非本期** |
| **按变动原因、时间、业务编号** 检索 | **非本期** |
| 业务编号 **跳转** 订单/提现详情 | **非本期** |
| 概览指标 **点击下钻** | **非本期** |
| **支付宝/微信账户数量** 展示 | 草稿 **仅** 银行卡数量；**非本期** 扩展 |
| 平台端 **代查商家资金** | **不做** |
| **自动分账 / 实时到店铺微信商户号** | **非本期**（见 **支付流程**） |

---

## 11. 业务规则汇总

| 编号 | 规则 |
|------|------|
| **FIN-A1** | 本模块 **只读**；**禁止** 手工改余额/冻结 |
| **FIN-A2** | 数据范围 **仅当前店铺** |
| **FIN-A3** | **待结算** = **已支付** 的 **待发货 + 已发货** 订单 **实付合计** |
| **FIN-A4** | **订单收支** **仅** 在 **已完成**（O7 确认收货）时产生 |
| **FIN-A5** | **支付成功** **不** 直接增加 **可用余额** |
| **FIN-A6** | **余额提现 / 提现驳回 / 提现完成** 与 **提现管理** **成对**；冻结 **对称释放** |
| **FIN-A7** | 变动原因 **四类** 与 §3.3 **同名** |
| **FIN-A8** | 流水 **变更值 + 变更后** 展示；**不可删改** |
| **FIN-A9** | 概览 **银行卡数量** **仅统计银行卡** 类型账户 |
| **FIN-A10** | **C 端平台代收** 与 **店铺虚拟余额** **分层**；**不混淆** 为同一到账时点 |
| **FIN-A11** | 列表默认 **变动时间倒序** |

---

## 12. 版本记录

| 版本 | 说明 |
|------|------|
| **v1.0** | 首版定稿：对齐草稿 §1～§4；补全账户概览/收支流水/四类变动/与订单·支付·提现·账户·售后边界；《资金概览功能需求-草稿》**保持不变** |

---

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