# 账户管理 — 功能需求说明

> 本文档在《账户管理功能需求-草稿》基础上整理，并关联 **《关联需求分析.md》** v1.6、平台侧 **《订单管理功能需求》** v1.0.1、**《支付流程》**、《商户管理功能需求》** v1.5、**《店铺管理功能需求》** v1.3.5、**《提现审核功能需求》** v1.0、《账务管理.md》** v1.0，以及商家侧 **《资金概览功能需求》** v1.0、《提现管理功能需求》** v1.0、《商家端店铺上下文接口说明》** 做边界与流程对齐。  
> 范围：**店铺经营管理端 · 财务中心 · 账户管理** 对 **当前店铺** **提现收款账户** 的 **列表、添加、编辑、删除**；**不含** 提现申请、平台审核、资金余额操作。  
> **说明：** 本文档 **仅描述功能需求与业务规则**；不涉及数据库结构、接口定义及技术实现细节。  
> **命名区分：** **账户管理** 维护 **店铺级提现收款账户**；平台 **商户管理 · 结算账户** 为 **商户主体资料**；C 端 **微信支付** 为 **平台代收渠道**，三者 **不可混用**（见 §2.3、§2.4）。

---

## 1. 模块定位

### 1.1 业务目标

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

- 浏览 **当前店铺** 已添加的 **全部提现收款账户**；
- **添加** 收款账户：支持 **银行卡、支付宝、微信** 三种 **收款方式**；
- **编辑**、**删除** 已有账户；
- 为 **提现管理** 提供 **可选账户来源**（商家发起提现时 **须** 从此处维护的账户中选择）；
- 与 **资金概览** 协作：概览区 **只读展示** 本店 **银行卡** 数量（**不含** 支付宝/微信计数，与资金概览专册 **一致**）。

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

| 能力 | 说明 |
|------|------|
| **提交提现 / 查看提现记录** | 见 **提现管理** |
| **平台审核 / 打款** | 见 **平台 · 提现审核** |
| **可用余额、待结算、收支流水** | 见 **资金概览** |
| **平台代维商家收款账户** | **平台管理端** **无** 本菜单 |
| **C 端买家绑定账户** | **不可** 访问 |
| **微信/银行实名认证 API 对接** | **非本期** |
| **设置默认提现账户** | 草稿 **未要求**；**非本期** |
| **导出 / 打印** | **非本期** |

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

| 草稿条目 | 定稿处理 |
|----------|----------|
| §1 显示所有已添加账户 | §4 |
| §2 添加银行卡/支付宝/微信 | §5、§3.2 |
| §3 编辑、删除 | §6、§7 |
| §4 按当前店铺查询 | §1.4、§2.8 |
| §5 店铺上下文 | §2.8、§11 |
| §6 异常返回 | **不纳入** |
| §7 技术栈 | **不纳入** |

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

```text
【本模块 · 账户管理】
    添加/维护 银行卡 · 支付宝 · 微信 收款账户
            ↓
【提现管理】提交提现 → 选择本模块账户 → 生成提现单（账户快照）
            ↓
【平台 · 提现审核】按快照账号打款 → 通过/驳回
            ↓
【资金概览】只读：银行卡数量；收支流水（与账户无直接编辑关系）
```

| 关联模块 | 关系 | 边界说明 |
|----------|------|----------|
| **提现管理** | **下游消费** | 提现 **唯一** 账户来源；**无账户不可提现** |
| **平台 · 提现审核** | **间接只读** | 展示 **申请时账户快照**；**不可** 在本模块改商家账户 |
| **资金概览** | **只读引用** | 统计 **银行卡** 条数；**不** 在本模块改余额 |
| **平台 · 商户管理** | **概念区分** | 商户 **主体结算账户** ≠ 本模块 **店铺提现账户** |
| **平台 · 微信支付入驻** | **独立** | C 端 **代收** 与 **提现打款账户** **分离** |
| **全部订单** | **无直接** | 订单结算入 **可用余额**；**不经** 本模块 |

### 1.4 数据范围

- **纳入：** 请求上下文 **当前店铺** 下 **全部未删除** 的收款账户；
- **排除：** 其他店铺账户；**已逻辑删除** 账户（列表 **不展示**，历史提现 **快照仍保留**）；
- **上下文：** 页头展示 **当前店铺名称**（只读）；切换店铺后 **整页刷新**。

### 1.5 使用端与角色

| 端 | 可操作角色 | 能力 |
|----|------------|------|
| **店铺经营管理端** | **商户经营账号** | 列表、**添加**、**编辑**、**删除** |
| **店铺经营管理端** | 员工（子管理员） | 由 **角色管理** 决定菜单与按钮 |
| **平台管理端** | 平台管理员 | **无** 本菜单 |
| **C 端** | 买家/访客 | **不可** 访问 |

---

## 2. 关联需求分析

### 2.1 与《关联需求分析》— 供给链与经营账号

| 关联点 | 定稿 |
|--------|------|
| 供给链 | 须 **店铺** 已存在方可维护 **本店** 账户 |
| §9.1 经营账号 | 列表与写操作 **仅当前店铺** |
| 商户冻结/注销 | **不自动** 删除或清空本店账户；**不阻断** 平台对 **已提交提现** 的审核 |
| 店铺停业 | **不自动** 删除账户；停业 **不影响** 已有账户 **只读** 与 **待审提现快照** |

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

| 项 | 定稿 |
|----|------|
| C 端支付 | 资金入 **平台商户号**；**不经** 本模块账户 |
| 提现打款 | 平台审核通过后，运营向 **本模块维护的账户** **线下/渠道打款**（**非** 系统自动路由） |
| 微信入驻 | **店铺微信支付入驻** 与 **提现收款账户** **独立维护** |

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

| 项 | 定稿 |
|----|------|
| 商户结算账户 | 平台 **商户经营信息 · 结算账户** 为 **主体级** 入驻资料 |
| 本模块账户 | **店铺级** **提现收款账户**；**一店多账户**（银行卡/支付宝/微信 **可并存**） |
| 同名不同义 | UI/文案 **须区分**「入驻结算账户」与「提现收款账户」，**避免** 商家混淆 |
| 删店 | 店铺 **逻辑删除** 后 **不可** 再 **添加/编辑** 账户（登录/上下文拦截）；**历史账户** 与 **已提交提现快照** **另约定** 留存 |
| 多店 | 经营账号 **切换店铺** 后，账户列表 **仅展示所选店铺** 数据 |

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

| 项 | 定稿 |
|----|------|
| 平台列表 · 提现账号 | 展示 **申请时快照**（类型 + 脱敏账号 + 姓名），**非** 实时读本模块 |
| 账户变更 | 提现 **提交后** 商家 **编辑/删除** 该账户 **不影响** 待审/终态 **已提交单** |
| 平台权限 | 平台 **不可** 增删改商家 **账户管理** 数据 |
| 打款依据 | 运营 **以快照账号** 为打款目标；若账户已删改，**以快照为准** |

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

| 项 | 定稿 |
|----|------|
| 前置条件 | **须** 在本模块 **至少添加一个** 有效账户后，方可至 **提现管理** 提交 |
| 选择方式 | 提现表单 **下拉/选择** **本店未删除** 账户 |
| 快照 | **提交成功** 时 **固化** 账户摘要；详见提现管理 **WD-A7** |
| 页内添加 | 提现管理 **不可** inline 添加账户；**须** 跳转或菜单进入 **本模块** |
| 无账户提示 | 提现侧提示 **请先添加收款账户**；本模块承担 **维护职责** |

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

| 项 | 定稿 |
|----|------|
| 概览 · 银行卡数量 | 统计本模块 **收款方式=银行卡** 的 **未删除** 账户 **条数** |
| 支付宝/微信 | **不计入** 概览「银行卡数量」（与资金概览 **FIN-A9** **一致**） |
| 余额/流水 | 本模块 **不展示、不修改** 可用余额与收支流水 |
| 跳转 | 概览 **引导添加银行卡** 可 **可选** 链至本模块（**非本期** 深链 **不做** 亦 **可**） |

### 2.7 与平台《账务管理.md》/ 订单链（间接）

| 项 | 定稿 |
|----|------|
| 订单结算 | **确认收货** 增加 **可用余额**；**不** 在本模块体现 |
| 提现消费余额 | 提现 **不绑定** 具体订单；账户 **仅** 作为 **打款目标** |
| 退款/关单 | **非本期** 冲正规则 **不涉及** 本模块 |

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

| 项 | 定稿 |
|----|------|
| 数据隔离 | 列表、添加、编辑、删除 **仅当前店铺** |
| 默认店铺 | 经营账号 **默认最早有效店铺**；员工 **绑定店铺** |
| 切换店铺 | 切换后 **整页刷新** 账户列表 |

---

## 3. 业务概念与账户类型

### 3.1 核心概念

| 概念 | 说明 |
|------|------|
| **收款账户** | 商家用于 **接收提现打款** 的 **店铺级** 账户记录 |
| **收款方式** | **银行卡 / 支付宝 / 微信** 三选一（添加/编辑时 **不可** 变更类型，须 **删后重加**） |
| **真实姓名** | 账户 **持有人姓名**；须与 **收款方式** 要求 **一致** |
| **账号** | 银行卡号 / 支付宝号 / 微信号（依类型） |
| **已添加账户** | 本店 **未删除** 的全部账户；**提现可选** 范围 |

### 3.2 收款方式与表单字段（与草稿一致）

| 收款方式 | 表单字段 | 必填 |
|----------|----------|------|
| **银行卡** | 收款方式、真实姓名、银行卡号 | 全部必填 |
| **支付宝** | 收款方式、真实姓名、支付宝号 | 全部必填 |
| **微信** | 收款方式、真实姓名、微信号 | 全部必填 |

**定稿补充：**

- **收款方式** 在添加时 **选定**；保存后 **编辑不可改类型**（防歧义；若需换类型 **删除后重新添加**）。
- 同一店铺 **允许** 添加 **多条** 账户；**允许** 同类型 **多条**（如多张银行卡）。
- **默认账户** 草稿 **未要求**；**非本期**。

### 3.3 展示与脱敏（功能口径）

列表及 **提现管理下拉** 展示时，**账号** 须 **脱敏**（如银行卡 **尾号**、支付宝/微信 **中间掩码**）；**真实姓名** **完整展示**（商家 **本人** 查看 **本店** 数据）。

> **平台 · 提现审核** 列表展示 **申请快照**，规则与 **提现管理** **一致**，**数据源** 为 **快照** 而非 **实时** 读本模块。

---

## 4. 账户列表

### 4.1 列表字段

| 列名 | 说明 |
|------|------|
| **收款方式** | 银行卡 / 支付宝 / 微信 |
| **真实姓名** | 持有人姓名 |
| **账号** | 依类型展示；**脱敏** |
| **添加时间** | 首次创建时间；格式 **yyyy-MM-dd HH:mm:ss** |
| **操作** | **编辑**、**删除** |

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

### 4.2 分页与空态

| 项 | 定稿 |
|----|------|
| 分页 | **支持** 分页（与商家端列表 **通用规范** 一致） |
| 空列表 | 空态 + 友好提示（如「暂无收款账户，请先添加」） |
| 检索 | 草稿 **未要求** 关键词检索；**非本期** |

### 4.3 能力边界

| 能力 | 定稿 |
|------|------|
| 查看详情页 | **非本期**；列表 + 编辑弹窗 **足够** |
| 批量删除 | **非本期** |
| 启用/停用 | 草稿 **无**；**不做** 独立停用态；**删除** 即 **不可再选** |

---

## 5. 添加账户

### 5.1 入口与表单

**入口：** 列表页 **「添加账户」** → 弹窗/抽屉（与商家端 **通用表单** 一致）。

**流程：** 先选 **收款方式** → 展示对应字段（§3.2）。

### 5.2 提交前校验

| 规则 | 说明 |
|------|------|
| 收款方式 | **须** 为 **银行卡 / 支付宝 / 微信** 之一 |
| 真实姓名 | **非空**；长度 **合理**（建议 ≤64 字，与 UI 一致） |
| 账号 | **非空**；格式 **基本合法**（如银行卡 **纯数字**；支付宝/微信 **非空字符串**） |
| 店铺上下文 | **当前店铺** 有效且 **未逻辑删除** |
| 重复 | **非本期** 强制 **全平台唯一**；同店 **允许** 同账号 **多条** **不做** 硬性唯一（除非产品 **另定**） |

### 5.3 提交后

```text
校验通过
    → 保存为本店收款账户
    → 列表刷新可见
    → 提现管理 · 账户下拉 可选
    → 资金概览 · 银行卡数量（若为银行卡）+1
    → 提示添加成功
```

---

## 6. 编辑账户

### 6.1 入口与可改字段

**入口：** 列表行 **「编辑」**。

| 字段 | 可编辑 |
|------|--------|
| 收款方式 | **否**（定稿 §3.2） |
| 真实姓名 | **是** |
| 账号 | **是** |

### 6.2 校验与影响范围

- 校验规则 **同添加**（§5.2）。
- **已提交提现单**（含 **待审核**）所引用的 **账户快照不受影响**。
- **此后** 新发起的提现 **使用编辑后** 的信息生成 **新快照**。
- **待审核提现** **不自动** 同步为新账号；运营 **仍以原快照** 打款（与平台提现审核 **一致**）。

### 6.3 提交后

```text
校验通过 → 更新账户 → 列表刷新 → 提示保存成功
```

---

## 7. 删除账户

### 7.1 入口与确认

**入口：** 列表行 **「删除」** → **二次确认**（防误删）。

### 7.2 规则

| 场景 | 定稿 |
|------|------|
| 删除后列表 | **不再展示**；**不可** 在 **提现管理** 下拉 **再选** |
| 历史提现 | **已提交** 提现单 **快照保留**；**不影响** 平台审核与商家 **提现记录** |
| 待审核提现 | **不阻断** 删除；**已选该账户的待审单** **仍以提交时快照** 为准 |
| 最后一账户 | **允许** 删除；删除后 **提现管理** **不可提交**（须 **再添加**） |
| 物理/逻辑 | **逻辑删除**（功能口径）；列表 **不可见** 即可 |

### 7.3 提交后

```text
确认删除 → 账户标记删除 → 列表移除 → 银行卡数量相应减少
```

---

## 8. 端到端流程

### 8.1 主路径（首次提现前）

```text
商家 · 账户管理 · 添加银行卡/支付宝/微信
    → 列表可见
    → 资金概览 · 银行卡数量更新（若适用）
    → 提现管理 · 选择账户 → 填写金额 → 提交
        → 账户快照写入提现单
    → 平台 · 提现审核 · 按快照打款
```

### 8.2 维护路径（已有账户）

```text
编辑账号/姓名 → 仅影响后续新提现
删除账户 → 不可再选；历史/待审提现看快照
再添加新账户 → 提现下拉增加选项
```

### 8.3 与兄弟模块协作

```text
要去提现但没有账户
    → 本模块 · 添加账户
    → 提现管理 · 提交

要看有几张银行卡
    → 资金概览 · 账户信息（只读）
    → 或本模块 · 列表自行统计

平台要打款看哪个号
    → 提现审核 · 提现账号（快照）
    → 非本模块实时数据
```

---

## 9. 权限与菜单

| 项 | 定稿 |
|----|------|
| 菜单路径 | **财务中心 → 账户管理** |
| 权限粒度 | **列表查看**、**添加**、**编辑**、**删除** 可 **分权**（由 **角色管理** 配置） |
| 数据权限 | **仅当前店铺** |

---

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

| 场景 | 期望提示（示例） |
|------|------------------|
| 收款方式未选 | 请选择收款方式 |
| 姓名为空 | 请填写真实姓名 |
| 账号为空 | 请填写账号/卡号 |
| 银行卡号非数字 | 请输入正确的银行卡号 |
| 编辑/删除越权账户 | 账户不存在或无权操作 |
| 添加成功 | 添加成功 |
| 保存成功 | 保存成功 |
| 删除成功 | 删除成功 |
| 列表无数据 | 暂无收款账户 |

---

## 11. 非本期与待建设

| 项 | 说明 |
|------|------|
| **默认提现账户** | **非本期** |
| **账户实名/银行卡四要素校验** | **非本期** |
| **同账号去重** | **非本期**（除非产品 **另定**） |
| **列表关键词检索** | 草稿 **未要求** |
| **导出** | **非本期** |
| **停用/启用** 独立状态 | **不做**；用 **删除** 表达 **不可选** |
| **平台代管商家账户** | **不做** |
| **与商户入驻结算账户自动同步** | **不做** |

---

## 12. 业务规则汇总

| 编号 | 规则 |
|------|------|
| **PA-A1** | 本模块为 **当前店铺** 提现收款账户 **唯一维护入口** |
| **PA-A2** | 收款方式 **三类**：银行卡 / 支付宝 / 微信 |
| **PA-A3** | 添加后 **类型不可改**；换类型须 **删后重加** |
| **PA-A4** | 数据范围 **仅当前店铺** |
| **PA-A5** | **删除** 为逻辑删除；列表 **不展示** 已删账户 |
| **PA-A6** | 删除/编辑 **不影响** 已提交提现 **账户快照** |
| **PA-A7** | **提现管理** 仅可选 **未删除** 本店账户 |
| **PA-A8** | **资金概览** 银行卡数量 **仅统计** 本模块 **银行卡** 类型 |
| **PA-A9** | **不同于** 平台 **商户主体结算账户** |
| **PA-A10** | **不同于** C 端 **微信支付入驻** 配置 |
| **PA-A11** | 列表字段与草稿 §1～§3 **一致**；上下文见 §2.8 |

---

## 13. 版本记录

| 版本 | 说明 |
|------|------|
| **v1.0** | 首版定稿：对齐草稿 §1～§4；补全三类型表单/列表/增删改/快照协作/与提现·资金概览·平台审核·商户结算边界；《账户管理功能需求-草稿》**保持不变** |

---

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