财务管理

doc/店铺后台/财务中心/提现管理/提现管理前端技术方案.md

@@ -0,0 +1,217 @@
+# 提现管理 — 前端技术方案
+
+> **依据：** 《提现管理功能需求.md》v1.0、《提现管理技术方案.md》v1.0  
+> **前端规范：** `doc/前端设计/前端设计.md`  
+> **范围：** 仅 **ruoyi-ui 商家端** **提交提现**、**提现记录列表与检索**、提交区 **可用余额** 辅助展示；**不含** 平台审核、账户 CRUD、资金概览页。  
+> **实现状态：** `index.vue`、`api/agri/seller/finance/withdraw.js` **已按 v1.0 落地**；待菜单配置及 `/agri/seller/finance/withdraw` 联调。
+
+---
+
+## 1. 技术栈与写法约定
+
+| 项 | 说明 |
+|----|------|
+| 框架 | Vue 2 + Element UI |
+| 请求 | `@/utils/request` + `sellerShopHeaders()` 携带 **`X-Shop-Id`** |
+| 参考页面 | `agri/seller/stock/inbound/index.vue`（日期检索）、`agri/seller/finance/payAccount/index.vue`（财务模块） |
+| 布局 | 提交 `el-card` + `<br/>` + 检索 `el-card` + `<br/>` + 列表 `el-card` + `border` 表格 |
+| 账户下拉 | 复用 `@/api/agri/seller/finance/payAccount.js` → `listSellerPayAccountOptions` |
+| 店铺切换 | **仅 Navbar**；业务页禁止展示店铺选择器 |
+
+---
+
+## 2. 业务要点（前端需体现）
+
+| 项 | 说明 |
+|----|------|
+| 唯一提交入口 | 本页 **POST submit**；无撤销/改待审单 |
+| 账户来源 | **账户管理** `GET /payAccount/options`；无账户时提示先添加 |
+| 可用余额 | `GET /balance`；提交前校验 **≤ availableBalance** |
+| 提现状态 | `1` 待审核 / `2` 审核不通过 / `3` 提现完成 |
+| 处理说明 | 待审核展示 **—**；终态只读展示 `processRemark` |
+| 账户摘要 | 列表优先 `accountSummary`；兜底拼接类型+脱敏+姓名 |
+| 检索 | 申请时间区间 + 提现状态下拉 |
+
+---
+
+## 3. 文件清单
+
+| 类型 | 路径 | 说明 |
+|------|------|------|
+| 页面 | `ruoyi-ui/src/views/agri/seller/finance/withdraw/index.vue` | 提交区 + 检索 + 记录列表 |
+| API | `ruoyi-ui/src/api/agri/seller/finance/withdraw.js` | list、balance、submit |
+| 协作 API | `api/agri/seller/finance/payAccount.js` | options 下拉 |
+| 店铺上下文 | `api/agri/seller/context.js` + `utils/sellerShop.js` | X-Shop-Id |
+
+**组件 name（keep-alive）：** `AgriSellerFinanceWithdraw`
+
+**不提供：** 撤销待审核、修改待审单、页内添加账户、导出、按编号检索。
+
+---
+
+## 4. 菜单与路由
+
+| 菜单名称 | 组件路径 | 路由 path（建议） | 权限标识 |
+|----------|----------|-------------------|----------|
+| 提现管理 | `agri/seller/finance/withdraw/index` | `seller/finance/withdraw` | `agri:seller:finance:withdraw:list` |
+
+**上级菜单：** 店铺经营管理端 → **财务中心**
+
+| 按钮权限 | 标识 | 页面落点 |
+|----------|------|----------|
+| 列表 + 余额 | `agri:seller:finance:withdraw:list` | 记录列表、可用余额 |
+| 提交提现 | `agri:seller:finance:withdraw:submit` | 「提交提现」 |
+
+---
+
+## 5. 页面结构（与代码一致）
+
+```text
+提现管理 index.vue
+├── 提交提现 submit-card
+│   ├── 可用店铺余额（GET /balance）
+│   ├── 无账户 warning 提示
+│   ├── 提现账户 accountId（options 下拉）
+│   ├── 提现金额 withdrawAmount（>0，两位小数）
+│   ├── 备注 remark（选填，≤200 字）
+│   └── 提交 / 重置
+├── <br/>
+├── 检索区 search-card
+│   ├── 申请时间 daterange → beginApplyTime / endApplyTime
+│   ├── 提现状态 withdrawStatus
+│   └── 搜索 / 重置
+├── <br/>
+└── 提现记录 table-card
+    ├── el-table border
+    │   ├── 提现编号 withdrawNo
+    │   ├── 申请时间 applyTime
+    │   ├── 提现账户 accountSummary
+    │   ├── 提现金额 withdrawAmount
+    │   ├── 备注 remark
+    │   ├── 提现状态 withdrawStatusText（tag）
+    │   └── 提现处理说明 processRemark
+    └── pagination
+```
+
+---
+
+## 6. 提交提现
+
+### 6.1 接口
+
+**GET** `/balance` → `{ availableBalance }`
+
+**POST** `/submit`
+
+```json
+{
+  "accountId": 1,
+  "withdrawAmount": 100.00,
+  "remark": "选填"
+}
+```
+
+**成功：** `msgSuccess('提交成功')` → 刷新余额与列表、重置表单。
+
+### 6.2 前端校验
+
+| 规则 | 说明 |
+|------|------|
+| 未选账户 | 「请选择提现账户」 |
+| 金额空或 ≤0 | 「请输入有效的提现金额」 |
+| 超过余额 | 「提现金额不能超过可用余额」 |
+| 备注 | maxlength 200 |
+
+后端另校验账户有效性、余额并发（FOR UPDATE）。
+
+---
+
+## 7. 提现记录列表
+
+### 7.1 接口
+
+**GET** `/list?pageNum=&pageSize=&withdrawStatus=&beginApplyTime=&endApplyTime=`
+
+| 参数 | 说明 |
+|------|------|
+| beginApplyTime | `yyyy-MM-dd` 开始（含 00:00:00） |
+| endApplyTime | `yyyy-MM-dd` 结束（含 23:59:59） |
+| withdrawStatus | 空=全部；`1`/`2`/`3` |
+
+> **联调说明：** 后端 `SellerWithdrawQuery` 须包含 `beginApplyTime`、`endApplyTime` 字段，与 Mapper XML 一致；前端已按平铺 Query 传参。
+
+### 7.2 状态展示
+
+| withdrawStatus | 文案 | Tag |
+|----------------|------|-----|
+| `1` | 待审核 | warning |
+| `2` | 审核不通过 | danger |
+| `3` | 提现完成 | success |
+
+---
+
+## 8. 店铺上下文（X-Shop-Id）
+
+| 步骤 | 说明 |
+|------|------|
+| `created` | `GET /agri/seller/context` → `setSellerShopContext` |
+| 全部 API | `sellerShopHeaders()` |
+| Navbar 切店 | `location.reload()` 整页刷新 |
+
+---
+
+## 9. API 封装
+
+**模块：** `@/api/agri/seller/finance/withdraw.js`
+
+| 方法 | HTTP | 路径 | 权限 |
+|------|------|------|------|
+| `listSellerWithdraws` | GET | `/list` | withdraw:list |
+| `getSellerWithdrawBalance` | GET | `/balance` | withdraw:list |
+| `submitSellerWithdraw` | POST | `/submit` | withdraw:submit |
+
+---
+
+## 10. 空状态与错误提示
+
+| 场景 | 文案 |
+|------|------|
+| 无收款账户 | warning：请先至账户管理添加 |
+| 记录无数据 | 「暂无提现记录」 |
+| 检索无结果 | 「未找到符合条件的提现记录」 |
+| 提交成功 | 「提交成功」 |
+| 后端账户无效 | 「提现账户不存在或已删除」 |
+
+---
+
+## 11. 与兄弟模块边界（前端）
+
+| 模块 | 关系 |
+|------|------|
+| **账户管理** | options 下拉；无 inline 添加 |
+| **资金概览** | 提交后写「余额提现」流水；本页只读余额 |
+| **平台提现审核** | 审核结果回写状态与处理说明 |
+
+---
+
+## 12. 联调检查清单
+
+- [ ] 菜单挂载 `agri/seller/finance/withdraw/index`
+- [ ] 无账户时不可提交并提示
+- [ ] 提交成功生成待审核记录
+- [ ] 超余额提交被后端拒绝
+- [ ] 日期区间、状态筛选生效
+- [ ] 平台审核后列表状态与处理说明更新
+- [ ] Navbar 切店后数据刷新
+
+---
+
+## 13. 版本记录
+
+| 版本 | 说明 |
+|------|------|
+| **v1.0** | 首版：提交区 + 记录检索 + API 封装；对齐需求 v1.0 |
+
+---
+
+*文档版本：v1.0 · 依据《提现管理功能需求.md》v1.0、《提现管理技术方案.md》v1.0*

doc/店铺后台/财务中心/账户管理/账户管理前端技术方案.md

@@ -0,0 +1,187 @@
+# 账户管理 — 前端技术方案
+
+> **依据：** 《账户管理功能需求.md》v1.0、《账户管理技术方案.md》v1.0  
+> **前端规范：** `doc/前端设计/前端设计.md`  
+> **范围：** 仅 **ruoyi-ui 商家端** 当前店铺 **提现收款账户** 列表、**添加 / 编辑 / 删除**；**不含** 提现提交、平台审核、余额/流水。  
+> **实现状态：** `index.vue`、`api/agri/seller/finance/payAccount.js` **已按 v1.0 落地**；待菜单配置及 `/agri/seller/finance/payAccount` 联调。
+
+---
+
+## 1. 技术栈与写法约定
+
+| 项 | 说明 |
+|----|------|
+| 框架 | Vue 2 + Element UI |
+| 请求 | `@/utils/request` + `sellerShopHeaders()` 携带 **`X-Shop-Id`** |
+| 参考页面 | `agri/seller/employee/index.vue`（CRUD 弹窗）、`agri/seller/finance/overview/index.vue`（财务模块上下文） |
+| 布局 | 列表 `el-card` + `border` 表格 + 分页 |
+| 表单 | `el-dialog` width=520px（`append-to-body`） |
+| 店铺切换 | **仅 Navbar**；业务页禁止展示店铺选择器 |
+
+---
+
+## 2. 业务要点（前端需体现）
+
+| 项 | 说明 |
+|----|------|
+| 账户类型 | `1` 银行卡 / `2` 支付宝 / `3` 微信 |
+| 类型锁定 | **添加时选定**；**编辑不可改类型**（PA-A3） |
+| 列表账号 | 展示后端 **脱敏** 字段 `accountNoMask`，**不展示明文** |
+| 编辑账号 | 列表无明文；编辑须 **重新输入完整账号** |
+| 删除 | 二次确认；逻辑删除；**不影响** 已提交提现快照 |
+| 检索 | **非本期**；仅分页列表 |
+| 与资金概览 | 银行卡类型计入概览「银行卡数量」 |
+
+---
+
+## 3. 文件清单
+
+| 类型 | 路径 | 说明 |
+|------|------|------|
+| 列表页 | `ruoyi-ui/src/views/agri/seller/finance/payAccount/index.vue` | 列表 + 添加/编辑弹窗 |
+| API | `ruoyi-ui/src/api/agri/seller/finance/payAccount.js` | list、options、add、edit、remove |
+| 店铺上下文 | `api/agri/seller/context.js` + `utils/sellerShop.js` | X-Shop-Id |
+
+**组件 name（keep-alive）：** `AgriSellerFinancePayAccount`
+
+**不提供：** 关键词检索、批量删除、默认账户、导出、详情页、页内实名认证。
+
+---
+
+## 4. 菜单与路由
+
+| 菜单名称 | 组件路径 | 路由 path（建议） | 权限标识 |
+|----------|----------|-------------------|----------|
+| 账户管理 | `agri/seller/finance/payAccount/index` | `seller/finance/payAccount` | `agri:seller:finance:payAccount:list` |
+
+**上级菜单：** 店铺经营管理端 → **财务中心**
+
+| 按钮权限 | 标识 | 页面落点 |
+|----------|------|----------|
+| 列表 | `agri:seller:finance:payAccount:list` | 进入页面 |
+| 添加 | `agri:seller:finance:payAccount:add` | 「添加账户」、POST |
+| 编辑 | `agri:seller:finance:payAccount:edit` | 「编辑」、PUT |
+| 删除 | `agri:seller:finance:payAccount:remove` | 「删除」、DELETE |
+
+> `GET /options` 权限为 `agri:seller:finance:withdraw:list`，供 **提现管理** 调用，非本页使用。
+
+---
+
+## 5. 页面结构（与代码一致）
+
+```text
+账户管理 index.vue
+├── 列表区 table-card
+│   ├── 添加账户（权限 add）
+│   ├── right-toolbar（刷新）
+│   ├── el-table border
+│   │   ├── 收款方式 accountTypeText
+│   │   ├── 真实姓名 realName
+│   │   ├── 账号 accountNoMask
+│   │   ├── 添加时间 createTime
+│   │   └── 操作：编辑 | 删除
+│   └── pagination
+└── 添加/编辑弹窗 el-dialog
+    ├── 收款方式 accountType（编辑 disabled）
+    ├── 真实姓名 realName
+    └── 账号 accountNo（标签随类型变化；编辑展示当前脱敏提示）
+```
+
+---
+
+## 6. 表单与校验
+
+### 6.1 字段映射（PayAccountSaveDTO）
+
+| 字段 | 添加 | 编辑 |
+|------|------|------|
+| accountType | 必选 | 只读展示，随 payload 原样提交 |
+| realName | 必填，≤64 | 可改 |
+| accountNo | 必填明文 | 必填明文（重新输入） |
+| accountId | — | 必填 |
+
+### 6.2 前端校验
+
+| 规则 | 说明 |
+|------|------|
+| 收款方式未选 | 「请选择收款方式」 |
+| 姓名为空 | 「请填写真实姓名」 |
+| 账号为空 | 按类型提示（银行卡号/支付宝号/微信号） |
+| 银行卡号 | **纯数字**（`/^\d+$/`） |
+| 支付宝/微信 | 非空即可 |
+
+成功提示：添加「添加成功」、编辑「保存成功」、删除「删除成功」。
+
+---
+
+## 7. 删除确认
+
+**文案：** 确认删除该{类型}账户「{脱敏账号}」吗？删除后不可在提现时选择，已提交的提现单不受影响。
+
+---
+
+## 8. 店铺上下文（X-Shop-Id）
+
+| 步骤 | 说明 |
+|------|------|
+| `created` | `GET /agri/seller/context` → `setSellerShopContext` |
+| 全部 API | `sellerShopHeaders()` |
+| Navbar 切店 | `location.reload()` 整页刷新 |
+
+---
+
+## 9. API 封装
+
+**模块：** `@/api/agri/seller/finance/payAccount.js`
+
+| 方法 | HTTP | 路径 | 权限 |
+|------|------|------|------|
+| `listSellerPayAccounts` | GET | `/list` | payAccount:list |
+| `listSellerPayAccountOptions` | GET | `/options` | withdraw:list |
+| `addSellerPayAccount` | POST | `/` | payAccount:add |
+| `updateSellerPayAccount` | PUT | `/` | payAccount:edit |
+| `delSellerPayAccount` | DELETE | `/{accountId}` | payAccount:remove |
+
+---
+
+## 10. 空状态与错误提示
+
+| 场景 | 文案 |
+|------|------|
+| 列表无数据 | 「暂无收款账户，请先添加」 |
+| 后端类型无效 | 「收款方式无效」 |
+| 账户不存在 | 「收款账户不存在」 |
+
+---
+
+## 11. 与兄弟模块边界（前端）
+
+| 模块 | 关系 |
+|------|------|
+| **提现管理** | 提交前须本模块有账户；下拉调 `GET /options` |
+| **资金概览** | 只读银行卡数量；本页维护后概览刷新可见 |
+| **平台提现审核** | 读提现快照；**不读**本模块实时数据 |
+
+---
+
+## 12. 联调检查清单
+
+- [ ] 菜单挂载 `agri/seller/finance/payAccount/index`
+- [ ] 添加三类账户成功并列表可见
+- [ ] 列表账号为脱敏展示
+- [ ] 编辑时类型不可改、须填完整账号
+- [ ] 删除后列表移除、options 不可选
+- [ ] 权限：无 add/edit/remove 时按钮隐藏
+- [ ] Navbar 切店后列表刷新
+
+---
+
+## 13. 版本记录
+
+| 版本 | 说明 |
+|------|------|
+| **v1.0** | 首版：列表/添加/编辑/删除/API 封装；对齐需求 v1.0 |
+
+---
+
+*文档版本：v1.0 · 依据《账户管理功能需求.md》v1.0、《账户管理技术方案.md》v1.0*

doc/店铺后台/财务中心/资金概览/资金概览前端技术方案.md

@@ -0,0 +1,221 @@
+# 资金概览 — 前端技术方案
+
+> **依据：** 《资金概览功能需求.md》v1.0、《资金概览技术方案.md》v1.0  
+> **前端规范：** `doc/前端设计/前端设计.md`  
+> **范围：** 仅 **ruoyi-ui 商家端** 当前店铺 **账户概览**（只读）与 **收支概况流水**（只读分页）；**不含** 提现申请、账户维护、平台审核、导出/筛选。  
+> **实现状态：** `index.vue`、`api/agri/seller/finance/overview.js` **已按 v1.0 落地**；待菜单配置及 `/agri/seller/finance/overview` 联调。
+
+---
+
+## 1. 技术栈与写法约定
+
+| 项 | 说明 |
+|----|------|
+| 框架 | Vue 2 + Element UI |
+| 请求 | `@/utils/request` + `sellerShopHeaders()` 携带 **`X-Shop-Id`** |
+| 参考页面 | `agri/seller/shop/index.vue`（概览 stat-block）、`agri/seller/stock/log/index.vue`（只读列表） |
+| 布局 | 概览 `el-card` + `<br/>` + 流水 `el-card` + `border` 表格 |
+| 店铺切换 | **仅 Navbar**；业务页禁止展示店铺选择器 |
+
+---
+
+## 2. 业务要点（前端需体现）
+
+| 项 | 说明 |
+|----|------|
+| 只读 | **无** 改余额/冻结、发起提现、维护账户 |
+| 概览指标 | 可用余额、待结算、冻结、用户名、银行卡数量 |
+| 待结算 | 后端实时汇总订单，**非** wallet 字段 |
+| 银行卡数 | **仅** 统计银行卡类型（`account_type=1`） |
+| 流水 | 变动时间 **倒序**；四类变动原因与后端文案一致 |
+| 变动展示 | 前端格式化「变更值 + 变更后」（需求 §3.4） |
+| 业务编号 | **只读展示**；跳转订单/提现 **非本期** |
+
+---
+
+## 3. 文件清单
+
+| 类型 | 路径 | 说明 |
+|------|------|------|
+| 页面 | `ruoyi-ui/src/views/agri/seller/finance/overview/index.vue` | 概览 + 收支流水 |
+| API | `ruoyi-ui/src/api/agri/seller/finance/overview.js` | summary、logs |
+| 店铺上下文 | `api/agri/seller/context.js` + `utils/sellerShop.js` | X-Shop-Id |
+
+**组件 name（keep-alive）：** `AgriSellerFinanceOverview`
+
+**不提供：** 检索筛选、导出、业务编号下钻、概览指标下钻、提现/账户入口按钮。
+
+---
+
+## 4. 菜单与路由
+
+| 菜单名称 | 组件路径 | 路由 path（建议） | 权限标识 |
+|----------|----------|-------------------|----------|
+| 资金概览 | `agri/seller/finance/overview/index` | `seller/finance/overview` | `agri:seller:finance:overview:query` |
+
+**上级菜单：** 店铺经营管理端 → **财务中心**
+
+| 按钮权限 | 标识 | 页面落点 |
+|----------|------|----------|
+| 概览 + 流水 | `agri:seller:finance:overview:query` | 进入页面（无分写权限） |
+
+---
+
+## 5. 页面结构（与代码一致）
+
+```text
+资金概览 index.vue
+├── 账户概览 overview-card（v-loading）
+│   ├── 三指标 stat-block
+│   │   ├── 可用店铺余额 availableBalance
+│   │   ├── 待结算金额 pendingSettleAmount
+│   │   └── 冻结金额 frozenAmount
+│   └── el-descriptions border
+│       ├── 用户名 username
+│       └── 银行卡数量 bankAccountCount
+├── <br/>
+└── 收支概况 table-card
+    ├── el-table border（empty-text：暂无收支记录）
+    │   ├── 店铺名称 shopName
+    │   ├── 变动时间 changeTime
+    │   ├── 业务编号 bizNo
+    │   ├── 变动余额资金 balanceChange + balanceAfter
+    │   ├── 变动冻结资金 frozenChange + frozenAfter
+    │   └── 变动原因 changeReasonText
+    └── pagination
+```
+
+---
+
+## 6. 账户概览
+
+### 6.1 接口
+
+**GET** `/agri/seller/finance/overview/summary`
+
+| 字段 | 说明 |
+|------|------|
+| availableBalance | 可用店铺余额 |
+| pendingSettleAmount | 待结算金额 |
+| frozenAmount | 冻结金额 |
+| username | 当前登录用户名 |
+| bankAccountCount | 银行卡条数 |
+
+无 wallet 时余额/冻结后端返回 `0.00`。
+
+### 6.2 金额展示
+
+| 场景 | 规则 |
+|------|------|
+| 概览金额 | `formatMoney`：`¥` + 两位小数 + 千分位 |
+| null | 展示 `—` |
+| 为 0 | **仍展示** `¥0.00` |
+
+---
+
+## 7. 收支概况列表
+
+### 7.1 接口
+
+**GET** `/agri/seller/finance/overview/logs?pageNum=&pageSize=`
+
+**无** 筛选参数（非本期）。
+
+### 7.2 变动列格式化（前端）
+
+```text
+{±change}（余额：{after}）
+{±change}（冻结：{after}）
+```
+
+| 规则 | 说明 |
+|------|------|
+| change 为 0 或 null | 变更值展示 `0` |
+| change > 0 | 前缀 `+` |
+| after | 两位小数 + 千分位（无 ¥） |
+| after 为 null | `—` |
+| 样式 | 正数 `.change-in` 绿色；负数 `.change-out` 红色 |
+
+**示例：**
+
+- 订单收支：`+128.00（余额：1,280.00）` / `0（冻结：200.00）`
+- 余额提现：`−500.00（余额：780.00）` / `+500.00（冻结：700.00）`
+
+### 7.3 变动原因
+
+优先 `changeReasonText`；兜底映射：
+
+| changeReason | 文案 |
+|--------------|------|
+| `1` | 订单收支 |
+| `2` | 余额提现 |
+| `3` | 提现驳回 |
+| `4` | 提现完成 |
+
+---
+
+## 8. 店铺上下文（X-Shop-Id）
+
+| 步骤 | 说明 |
+|------|------|
+| `created` | `GET /agri/seller/context` → `setSellerShopContext` |
+| 全部 API | `sellerShopHeaders()` |
+| Navbar 切店 | `location.reload()` 整页刷新 |
+
+---
+
+## 9. API 封装
+
+**模块：** `@/api/agri/seller/finance/overview.js`
+
+| 方法 | HTTP | 路径 | 权限 |
+|------|------|------|------|
+| `getSellerFundOverviewSummary` | GET | `/summary` | query |
+| `listSellerFundOverviewLogs` | GET | `/logs` | query |
+
+---
+
+## 10. 空状态与错误提示
+
+| 场景 | 文案 |
+|------|------|
+| 流水无数据 | 「暂无收支记录」 |
+| 概览余额为 0 | 仍展示 `¥0.00` |
+| 无银行卡 | 银行卡数量 `0` |
+| 用户名空 | `—` |
+
+---
+
+## 11. 与兄弟模块边界（前端）
+
+| 模块 | 关系 |
+|------|------|
+| **提现管理** | 写操作在提现模块；本页 **无** 提交入口 |
+| **账户管理** | 银行卡维护在账户模块；本页 **只读** 数量 |
+| **全部订单** | 订单收支由确认收货触发；本页 **只读** 流水 |
+| **售后/退款** | 负向流水 **非本期** |
+
+---
+
+## 12. 联调检查清单
+
+- [ ] 菜单挂载 `agri/seller/finance/overview/index`
+- [ ] summary 四块指标与当前店铺一致
+- [ ] 待结算随订单状态变化
+- [ ] 确认收货后出现「订单收支」流水
+- [ ] 提现 submit 后出现「余额提现」流水
+- [ ] 变动列格式符合 §3.4
+- [ ] 分页倒序（最新在前）
+- [ ] Navbar 切店后概览与列表刷新
+
+---
+
+## 13. 版本记录
+
+| 版本 | 说明 |
+|------|------|
+| **v1.0** | 首版：账户概览 + 收支流水分页 + 金额/变动格式化 + API 封装 |
+
+---
+
+*文档版本：v1.0 · 依据《资金概览功能需求.md》v1.0、《资金概览技术方案.md》v1.0*

ruoyi-ui/src/api/agri/seller/finance/overview.js

@@ -0,0 +1,21 @@
+import request from '@/utils/request'
+import { sellerShopHeaders } from '@/utils/sellerShop'
+
+// 账户概览
+export function getSellerFundOverviewSummary() {
+  return request({
+    url: '/agri/seller/finance/overview/summary',
+    method: 'get',
+    headers: sellerShopHeaders()
+  })
+}
+
+// 收支概况流水
+export function listSellerFundOverviewLogs(query) {
+  return request({
+    url: '/agri/seller/finance/overview/logs',
+    method: 'get',
+    params: query,
+    headers: sellerShopHeaders()
+  })
+}

ruoyi-ui/src/api/agri/seller/finance/payAccount.js

@@ -0,0 +1,50 @@
+import request from '@/utils/request'
+import { sellerShopHeaders } from '@/utils/sellerShop'
+
+// 收款账户列表
+export function listSellerPayAccounts(query) {
+  return request({
+    url: '/agri/seller/finance/payAccount/list',
+    method: 'get',
+    params: query,
+    headers: sellerShopHeaders()
+  })
+}
+
+// 提现可选账户（供提现管理协作）
+export function listSellerPayAccountOptions() {
+  return request({
+    url: '/agri/seller/finance/payAccount/options',
+    method: 'get',
+    headers: sellerShopHeaders()
+  })
+}
+
+// 添加收款账户
+export function addSellerPayAccount(data) {
+  return request({
+    url: '/agri/seller/finance/payAccount',
+    method: 'post',
+    data: data,
+    headers: sellerShopHeaders()
+  })
+}
+
+// 编辑收款账户
+export function updateSellerPayAccount(data) {
+  return request({
+    url: '/agri/seller/finance/payAccount',
+    method: 'put',
+    data: data,
+    headers: sellerShopHeaders()
+  })
+}
+
+// 删除收款账户
+export function delSellerPayAccount(accountId) {
+  return request({
+    url: '/agri/seller/finance/payAccount/' + accountId,
+    method: 'delete',
+    headers: sellerShopHeaders()
+  })
+}

ruoyi-ui/src/api/agri/seller/finance/withdraw.js

@@ -0,0 +1,31 @@
+import request from '@/utils/request'
+import { sellerShopHeaders } from '@/utils/sellerShop'
+
+// 提现记录列表
+export function listSellerWithdraws(query) {
+  return request({
+    url: '/agri/seller/finance/withdraw/list',
+    method: 'get',
+    params: query,
+    headers: sellerShopHeaders()
+  })
+}
+
+// 可用余额（提交页辅助）
+export function getSellerWithdrawBalance() {
+  return request({
+    url: '/agri/seller/finance/withdraw/balance',
+    method: 'get',
+    headers: sellerShopHeaders()
+  })
+}
+
+// 提交提现申请
+export function submitSellerWithdraw(data) {
+  return request({
+    url: '/agri/seller/finance/withdraw/submit',
+    method: 'post',
+    data: data,
+    headers: sellerShopHeaders()
+  })
+}

ruoyi-ui/src/views/agri/seller/finance/overview/index.vue

@@ -0,0 +1,287 @@
+<template>
+  <div class="app-container">
+    <!-- 账户概览 -->
+    <el-card shadow="never" class="overview-card" v-loading="summaryLoading">
+      <div slot="header" class="card-header">
+        <span class="card-title">账户概览</span>
+      </div>
+      <el-row :gutter="24" class="stats-row">
+        <el-col :xs="24" :sm="8">
+          <div class="stat-block stat-block-primary">
+            <div class="stat-value">{{ formatMoney(summary.availableBalance) }}</div>
+            <div class="stat-label">可用店铺余额</div>
+            <div class="stat-tip">订单结算完成、可发起提现的金额</div>
+          </div>
+        </el-col>
+        <el-col :xs="24" :sm="8">
+          <div class="stat-block">
+            <div class="stat-value">{{ formatMoney(summary.pendingSettleAmount) }}</div>
+            <div class="stat-label">待结算金额</div>
+            <div class="stat-tip">已支付未完成订单实付合计，确认收货后转入余额</div>
+          </div>
+        </el-col>
+        <el-col :xs="24" :sm="8">
+          <div class="stat-block">
+            <div class="stat-value">{{ formatMoney(summary.frozenAmount) }}</div>
+            <div class="stat-label">冻结金额</div>
+            <div class="stat-tip">提现审核中临时冻结的金额</div>
+          </div>
+        </el-col>
+      </el-row>
+      <el-descriptions :column="2" border size="medium" class="account-info">
+        <el-descriptions-item label="用户名">{{ displayText(summary.username) }}</el-descriptions-item>
+        <el-descriptions-item label="银行卡数量">
+          {{ summary.bankAccountCount != null ? summary.bankAccountCount : '—' }}
+        </el-descriptions-item>
+      </el-descriptions>
+    </el-card>
+
+    <br/>
+
+    <!-- 收支概况 -->
+    <el-card shadow="never" class="table-card">
+      <div slot="header" class="card-header">
+        <span class="card-title">收支概况</span>
+      </div>
+
+      <el-table border v-loading="loading" :data="logList" :empty-text="emptyTableText">
+        <el-table-column label="店铺名称" align="center" prop="shopName" min-width="120" :show-overflow-tooltip="true">
+          <template slot-scope="scope">
+            <span>{{ scope.row.shopName || '—' }}</span>
+          </template>
+        </el-table-column>
+        <el-table-column label="变动时间" align="center" width="160">
+          <template slot-scope="scope">
+            <span>{{ parseTime(scope.row.changeTime) || '—' }}</span>
+          </template>
+        </el-table-column>
+        <el-table-column label="业务编号" align="center" prop="bizNo" min-width="160" :show-overflow-tooltip="true">
+          <template slot-scope="scope">
+            <span>{{ scope.row.bizNo || '—' }}</span>
+          </template>
+        </el-table-column>
+        <el-table-column label="变动余额资金" align="center" min-width="180">
+          <template slot-scope="scope">
+            <span :class="changeClass(scope.row.balanceChange)">
+              {{ formatFundChange(scope.row.balanceChange, scope.row.balanceAfter, '余额') }}
+            </span>
+          </template>
+        </el-table-column>
+        <el-table-column label="变动冻结资金" align="center" min-width="180">
+          <template slot-scope="scope">
+            <span :class="changeClass(scope.row.frozenChange)">
+              {{ formatFundChange(scope.row.frozenChange, scope.row.frozenAfter, '冻结') }}
+            </span>
+          </template>
+        </el-table-column>
+        <el-table-column label="变动原因" align="center" width="110">
+          <template slot-scope="scope">
+            <span>{{ scope.row.changeReasonText || changeReasonLabel(scope.row.changeReason) }}</span>
+          </template>
+        </el-table-column>
+      </el-table>
+
+      <pagination v-show="total > 0" :total="total" :page.sync="queryParams.pageNum" :limit.sync="queryParams.pageSize" @pagination="getList" />
+    </el-card>
+  </div>
+</template>
+
+<script>
+import {
+  getSellerFundOverviewSummary,
+  listSellerFundOverviewLogs
+} from "@/api/agri/seller/finance/overview"
+import { getSellerContext } from "@/api/agri/seller/context"
+import { setSellerShopContext } from "@/utils/sellerShop"
+
+const CHANGE_REASON_MAP = {
+  "1": "订单收支",
+  "2": "余额提现",
+  "3": "提现驳回",
+  "4": "提现完成"
+}
+
+export default {
+  name: "AgriSellerFinanceOverview",
+  data() {
+    return {
+      summaryLoading: false,
+      loading: false,
+      total: 0,
+      summary: {},
+      logList: [],
+      queryParams: {
+        pageNum: 1,
+        pageSize: 10
+      }
+    }
+  },
+  computed: {
+    emptyTableText() {
+      return "暂无收支记录"
+    }
+  },
+  created() {
+    this.initPage()
+  },
+  methods: {
+    /** 初始化：加载店铺上下文后拉概览与流水 */
+    initPage() {
+      this.loadShopContext().then(() => {
+        this.loadSummary()
+        this.getList()
+      }).catch(() => {
+        this.loadSummary()
+        this.getList()
+      })
+    },
+    /** 加载商家端当前店铺上下文 */
+    loadShopContext() {
+      return getSellerContext().then(response => {
+        const data = response.data || {}
+        if (data.shopId != null) {
+          setSellerShopContext(data.shopId, data.shopName)
+        }
+      })
+    },
+    /** 查询账户概览 */
+    loadSummary() {
+      this.summaryLoading = true
+      getSellerFundOverviewSummary().then(response => {
+        this.summary = response.data || {}
+        this.summaryLoading = false
+      }).catch(() => {
+        this.summaryLoading = false
+      })
+    },
+    /** 查询收支流水列表 */
+    getList() {
+      this.loading = true
+      listSellerFundOverviewLogs(this.queryParams).then(response => {
+        this.logList = response.rows || []
+        this.total = response.total || 0
+        this.loading = false
+      }).catch(() => {
+        this.loading = false
+      })
+    },
+    /** 空值展示占位 */
+    displayText(value) {
+      if (value === null || value === undefined || String(value).trim() === "") {
+        return "—"
+      }
+      return value
+    },
+    /** 金额格式化：¥ + 两位小数 + 千分位 */
+    formatMoney(val) {
+      if (val == null || val === "") {
+        return "—"
+      }
+      const num = Number(val)
+      if (isNaN(num)) {
+        return "—"
+      }
+      const fixed = num.toFixed(2)
+      const parts = fixed.split(".")
+      parts[0] = parts[0].replace(/\B(?=(\d{3})+(?!\d))/g, ",")
+      return "¥" + parts.join(".")
+    },
+    /** 变动后金额（不带货币符号，带千分位） */
+    formatAfterAmount(val) {
+      if (val == null || val === "") {
+        return "—"
+      }
+      const num = Number(val)
+      if (isNaN(num)) {
+        return "—"
+      }
+      const fixed = num.toFixed(2)
+      const parts = fixed.split(".")
+      parts[0] = parts[0].replace(/\B(?=(\d{3})+(?!\d))/g, ",")
+      return parts.join(".")
+    },
+    /** 变动值（带 +/- 符号） */
+    formatChangeValue(change) {
+      if (change == null || change === "") {
+        return "0"
+      }
+      const num = Number(change)
+      if (isNaN(num) || num === 0) {
+        return "0"
+      }
+      const sign = num > 0 ? "+" : ""
+      return sign + num.toFixed(2)
+    },
+    /** 变动列展示：变更值 + 变更后 */
+    formatFundChange(change, after, label) {
+      const changeStr = this.formatChangeValue(change)
+      const afterStr = this.formatAfterAmount(after)
+      return `${changeStr}（${label}：${afterStr}）`
+    },
+    /** 正负变动样式 */
+    changeClass(change) {
+      if (change == null || change === "" || Number(change) === 0) {
+        return ""
+      }
+      return Number(change) > 0 ? "change-in" : "change-out"
+    },
+    /** 变动原因文案兜底 */
+    changeReasonLabel(reason) {
+      return CHANGE_REASON_MAP[reason] || "—"
+    }
+  }
+}
+</script>
+
+<style scoped lang="scss">
+.card-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+}
+.card-title {
+  font-weight: 600;
+  font-size: 15px;
+}
+.stats-row {
+  margin-bottom: 16px;
+}
+.stat-block {
+  padding: 16px;
+  border: 1px solid #ebeef5;
+  border-radius: 4px;
+  min-height: 120px;
+  background: #fafafa;
+  margin-bottom: 12px;
+}
+.stat-block-primary {
+  background: #f0f9eb;
+  border-color: #e1f3d8;
+}
+.stat-value {
+  font-size: 28px;
+  font-weight: 600;
+  color: #303133;
+  line-height: 1.2;
+  margin-bottom: 8px;
+}
+.stat-label {
+  font-size: 14px;
+  color: #606266;
+  margin-bottom: 4px;
+}
+.stat-tip {
+  font-size: 12px;
+  color: #909399;
+  line-height: 1.5;
+}
+.account-info {
+  margin-top: 4px;
+}
+.change-in {
+  color: #67c23a;
+}
+.change-out {
+  color: #f56c6c;
+}
+</style>

ruoyi-ui/src/views/agri/seller/finance/payAccount/index.vue

@@ -0,0 +1,318 @@
+<template>
+  <div class="app-container">
+    <!-- 列表区 -->
+    <el-card shadow="never" class="table-card">
+      <div slot="header" class="card-header">
+        <span class="card-title">收款账户</span>
+      </div>
+
+      <el-row :gutter="10" class="mb8">
+        <el-col :span="1.5">
+          <el-button
+            type="primary"
+            plain
+            icon="el-icon-plus"
+            size="mini"
+            @click="handleAdd"
+            v-hasPermi="['agri:seller:finance:payAccount:add']"
+          >添加账户</el-button>
+        </el-col>
+        <right-toolbar :showSearch="false" @queryTable="getList"></right-toolbar>
+      </el-row>
+
+      <el-table border v-loading="loading" :data="accountList" :empty-text="emptyTableText">
+        <el-table-column label="收款方式" align="center" width="100">
+          <template slot-scope="scope">
+            <span>{{ scope.row.accountTypeText || accountTypeLabel(scope.row.accountType) }}</span>
+          </template>
+        </el-table-column>
+        <el-table-column label="真实姓名" align="center" prop="realName" width="120" :show-overflow-tooltip="true">
+          <template slot-scope="scope">
+            <span>{{ scope.row.realName || '—' }}</span>
+          </template>
+        </el-table-column>
+        <el-table-column label="账号" align="center" min-width="180" :show-overflow-tooltip="true">
+          <template slot-scope="scope">
+            <span>{{ scope.row.accountNoMask || '—' }}</span>
+          </template>
+        </el-table-column>
+        <el-table-column label="添加时间" align="center" width="160">
+          <template slot-scope="scope">
+            <span>{{ parseTime(scope.row.createTime) || '—' }}</span>
+          </template>
+        </el-table-column>
+        <el-table-column label="操作" align="center" width="140" fixed="right">
+          <template slot-scope="scope">
+            <el-button size="mini" type="text" icon="el-icon-edit" @click="handleUpdate(scope.row)" v-hasPermi="['agri:seller:finance:payAccount:edit']">编辑</el-button>
+            <el-button size="mini" type="text" icon="el-icon-delete" @click="handleDelete(scope.row)" v-hasPermi="['agri:seller:finance:payAccount:remove']">删除</el-button>
+          </template>
+        </el-table-column>
+      </el-table>
+
+      <pagination v-show="total > 0" :total="total" :page.sync="queryParams.pageNum" :limit.sync="queryParams.pageSize" @pagination="getList" />
+    </el-card>
+
+    <!-- 添加/编辑弹窗 -->
+    <el-dialog :title="title" :visible.sync="open" width="520px" append-to-body @close="cancel">
+      <el-form ref="form" :model="form" :rules="rules" label-width="100px" size="small">
+        <el-form-item label="收款方式" prop="accountType">
+          <el-radio-group v-model="form.accountType" :disabled="isEdit" @change="handleAccountTypeChange">
+            <el-radio v-for="item in accountTypeOptions" :key="item.value" :label="item.value">{{ item.label }}</el-radio>
+          </el-radio-group>
+        </el-form-item>
+        <el-form-item label="真实姓名" prop="realName">
+          <el-input v-model="form.realName" placeholder="请输入真实姓名" maxlength="64" show-word-limit />
+        </el-form-item>
+        <el-form-item :label="accountNoLabel" prop="accountNo">
+          <el-input v-model="form.accountNo" :placeholder="accountNoPlaceholder" maxlength="128" />
+          <p v-if="isEdit && form.accountNoMask" class="form-tip">当前账号：{{ form.accountNoMask }}（修改请填写完整账号）</p>
+        </el-form-item>
+      </el-form>
+      <div slot="footer" class="dialog-footer">
+        <el-button type="primary" @click="submitForm">确 定</el-button>
+        <el-button @click="cancel">取 消</el-button>
+      </div>
+    </el-dialog>
+  </div>
+</template>
+
+<script>
+import {
+  listSellerPayAccounts,
+  addSellerPayAccount,
+  updateSellerPayAccount,
+  delSellerPayAccount
+} from "@/api/agri/seller/finance/payAccount"
+import { getSellerContext } from "@/api/agri/seller/context"
+import { setSellerShopContext } from "@/utils/sellerShop"
+
+const ACCOUNT_TYPE_MAP = {
+  "1": "银行卡",
+  "2": "支付宝",
+  "3": "微信"
+}
+
+export default {
+  name: "AgriSellerFinancePayAccount",
+  data() {
+    const validateAccountNo = (rule, value, callback) => {
+      if (!value || !String(value).trim()) {
+        callback(new Error(this.accountNoRequiredMsg))
+        return
+      }
+      if (this.form.accountType === "1" && !/^\d+$/.test(String(value).trim())) {
+        callback(new Error("请输入正确的银行卡号"))
+        return
+      }
+      callback()
+    }
+    return {
+      loading: false,
+      total: 0,
+      accountList: [],
+      queryParams: {
+        pageNum: 1,
+        pageSize: 10
+      },
+      open: false,
+      title: "",
+      isEdit: false,
+      form: {},
+      accountTypeOptions: [
+        { value: "1", label: "银行卡" },
+        { value: "2", label: "支付宝" },
+        { value: "3", label: "微信" }
+      ],
+      rules: {
+        accountType: [{ required: true, message: "请选择收款方式", trigger: "change" }],
+        realName: [{ required: true, message: "请填写真实姓名", trigger: "blur" }],
+        accountNo: [{ validator: validateAccountNo, trigger: "blur" }]
+      }
+    }
+  },
+  computed: {
+    emptyTableText() {
+      return "暂无收款账户，请先添加"
+    },
+    accountNoLabel() {
+      if (this.form.accountType === "1") {
+        return "银行卡号"
+      }
+      if (this.form.accountType === "2") {
+        return "支付宝号"
+      }
+      if (this.form.accountType === "3") {
+        return "微信号"
+      }
+      return "账号"
+    },
+    accountNoPlaceholder() {
+      if (this.form.accountType === "1") {
+        return "请输入银行卡号"
+      }
+      if (this.form.accountType === "2") {
+        return "请输入支付宝号"
+      }
+      if (this.form.accountType === "3") {
+        return "请输入微信号"
+      }
+      return "请先选择收款方式"
+    },
+    accountNoRequiredMsg() {
+      if (this.form.accountType === "1") {
+        return "请填写银行卡号"
+      }
+      if (this.form.accountType === "2") {
+        return "请填写支付宝号"
+      }
+      if (this.form.accountType === "3") {
+        return "请填写微信号"
+      }
+      return "请填写账号"
+    }
+  },
+  created() {
+    this.initPage()
+  },
+  methods: {
+    accountTypeLabel(type) {
+      return ACCOUNT_TYPE_MAP[type] || "—"
+    },
+    /** 初始化：加载店铺上下文后拉列表 */
+    initPage() {
+      this.loadShopContext().then(() => {
+        this.getList()
+      }).catch(() => {
+        this.getList()
+      })
+    },
+    /** 加载商家端当前店铺上下文 */
+    loadShopContext() {
+      return getSellerContext().then(response => {
+        const data = response.data || {}
+        if (data.shopId != null) {
+          setSellerShopContext(data.shopId, data.shopName)
+        }
+      })
+    },
+    /** 查询账户列表 */
+    getList() {
+      this.loading = true
+      listSellerPayAccounts(this.queryParams).then(response => {
+        this.accountList = response.rows || []
+        this.total = response.total || 0
+        this.loading = false
+      }).catch(() => {
+        this.loading = false
+      })
+    },
+    /** 重置表单 */
+    reset() {
+      this.form = {
+        accountId: undefined,
+        accountType: "1",
+        realName: undefined,
+        accountNo: undefined,
+        accountNoMask: undefined
+      }
+      this.isEdit = false
+      if (this.$refs.form) {
+        this.resetForm("form")
+      }
+    },
+    /** 打开添加弹窗 */
+    handleAdd() {
+      this.reset()
+      this.title = "添加账户"
+      this.open = true
+    },
+    /** 打开编辑弹窗 */
+    handleUpdate(row) {
+      this.reset()
+      this.isEdit = true
+      this.title = "编辑账户"
+      this.form = {
+        accountId: row.accountId,
+        accountType: row.accountType,
+        realName: row.realName,
+        accountNo: undefined,
+        accountNoMask: row.accountNoMask
+      }
+      this.open = true
+    },
+    /** 切换收款方式时清空账号校验 */
+    handleAccountTypeChange() {
+      this.form.accountNo = undefined
+      this.$nextTick(() => {
+        if (this.$refs.form) {
+          this.$refs.form.clearValidate("accountNo")
+        }
+      })
+    },
+    /** 提交添加/编辑 */
+    submitForm() {
+      this.$refs.form.validate(valid => {
+        if (!valid) {
+          return
+        }
+        const payload = {
+          accountType: this.form.accountType,
+          realName: String(this.form.realName).trim(),
+          accountNo: String(this.form.accountNo).trim()
+        }
+        if (this.form.accountId != null) {
+          payload.accountId = this.form.accountId
+          updateSellerPayAccount(payload).then(() => {
+            this.$modal.msgSuccess("保存成功")
+            this.open = false
+            this.getList()
+          })
+        } else {
+          addSellerPayAccount(payload).then(() => {
+            this.$modal.msgSuccess("添加成功")
+            this.open = false
+            this.getList()
+          })
+        }
+      })
+    },
+    /** 删除账户 */
+    handleDelete(row) {
+      const name = row.accountTypeText || this.accountTypeLabel(row.accountType)
+      const mask = row.accountNoMask || ""
+      this.$modal.confirm(`确认删除该${name}账户「${mask}」吗？删除后不可在提现时选择，已提交的提现单不受影响。`).then(() => {
+        return delSellerPayAccount(row.accountId)
+      }).then(() => {
+        this.$modal.msgSuccess("删除成功")
+        this.getList()
+      }).catch(() => {})
+    },
+    /** 关闭弹窗 */
+    cancel() {
+      this.open = false
+      this.reset()
+    }
+  }
+}
+</script>
+
+<style scoped lang="scss">
+.card-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+}
+.card-title {
+  font-weight: 600;
+  font-size: 15px;
+}
+.mb8 {
+  margin-bottom: 8px;
+}
+.form-tip {
+  margin: 6px 0 0;
+  font-size: 12px;
+  color: #909399;
+  line-height: 1.5;
+}
+</style>

ruoyi-ui/src/views/agri/seller/finance/withdraw/index.vue

@@ -0,0 +1,438 @@
+<template>
+  <div class="app-container">
+    <!-- 提交提现 -->
+    <el-card shadow="never" class="submit-card" v-loading="balanceLoading">
+      <div slot="header" class="card-header">
+        <span class="card-title">提交提现</span>
+        <span class="balance-tip">可用店铺余额：<strong>{{ formatMoney(availableBalance) }}</strong></span>
+      </div>
+
+      <el-alert
+        v-if="accountOptions.length === 0"
+        title="暂无收款账户，请先在「账户管理」中添加银行卡/支付宝/微信账户后再提交提现"
+        type="warning"
+        :closable="false"
+        show-icon
+        class="mb12"
+      />
+
+      <el-form ref="submitForm" :model="submitForm" :rules="submitRules" label-width="100px" size="small" class="submit-form">
+        <el-row :gutter="24">
+          <el-col :xs="24" :sm="12" :md="8">
+            <el-form-item label="提现账户" prop="accountId">
+              <el-select
+                v-model="submitForm.accountId"
+                placeholder="请选择提现账户"
+                filterable
+                clearable
+                style="width: 100%"
+                :disabled="accountOptions.length === 0"
+              >
+                <el-option
+                  v-for="item in accountOptions"
+                  :key="item.accountId"
+                  :label="item.label || buildAccountLabel(item)"
+                  :value="item.accountId"
+                />
+              </el-select>
+            </el-form-item>
+          </el-col>
+          <el-col :xs="24" :sm="12" :md="8">
+            <el-form-item label="提现金额" prop="withdrawAmount">
+              <el-input-number
+                v-model="submitForm.withdrawAmount"
+                :min="0.01"
+                :precision="2"
+                :step="1"
+                controls-position="right"
+                style="width: 100%"
+                placeholder="请输入提现金额"
+              />
+            </el-form-item>
+          </el-col>
+          <el-col :xs="24" :sm="24" :md="8">
+            <el-form-item label="备注" prop="remark">
+              <el-input
+                v-model="submitForm.remark"
+                type="textarea"
+                :rows="2"
+                placeholder="选填"
+                maxlength="200"
+                show-word-limit
+              />
+            </el-form-item>
+          </el-col>
+        </el-row>
+        <el-form-item>
+          <el-button
+            type="primary"
+            :loading="submitting"
+            :disabled="accountOptions.length === 0"
+            @click="handleSubmit"
+            v-hasPermi="['agri:seller:finance:withdraw:submit']"
+          >提交提现</el-button>
+          <el-button @click="resetSubmitForm">重 置</el-button>
+        </el-form-item>
+      </el-form>
+    </el-card>
+
+    <br/>
+
+    <!-- 检索区 -->
+    <el-card shadow="never" class="search-card">
+      <el-form :model="queryParams" ref="queryForm" size="small" :inline="true" v-show="showSearch" label-width="90px">
+        <el-form-item label="申请时间">
+          <el-date-picker
+            v-model="dateRange"
+            type="daterange"
+            value-format="yyyy-MM-dd"
+            range-separator="至"
+            start-placeholder="开始日期"
+            end-placeholder="结束日期"
+            style="width: 240px"
+          />
+        </el-form-item>
+        <el-form-item label="提现状态" prop="withdrawStatus">
+          <el-select v-model="queryParams.withdrawStatus" placeholder="全部" clearable style="width: 140px">
+            <el-option v-for="item in withdrawStatusOptions" :key="item.value" :label="item.label" :value="item.value" />
+          </el-select>
+        </el-form-item>
+        <el-form-item>
+          <el-button type="primary" icon="el-icon-search" size="mini" @click="handleQuery">搜索</el-button>
+          <el-button icon="el-icon-refresh" size="mini" @click="resetQuery">重置</el-button>
+        </el-form-item>
+      </el-form>
+    </el-card>
+
+    <br/>
+
+    <!-- 提现记录 -->
+    <el-card shadow="never" class="table-card">
+      <div slot="header" class="card-header">
+        <span class="card-title">提现记录</span>
+      </div>
+
+      <el-row :gutter="10" class="mb8">
+        <right-toolbar :showSearch.sync="showSearch" @queryTable="getList"></right-toolbar>
+      </el-row>
+
+      <el-table border v-loading="loading" :data="withdrawList" :empty-text="emptyTableText">
+        <el-table-column label="提现编号" align="center" prop="withdrawNo" min-width="170" :show-overflow-tooltip="true">
+          <template slot-scope="scope">
+            <span>{{ scope.row.withdrawNo || '—' }}</span>
+          </template>
+        </el-table-column>
+        <el-table-column label="申请时间" align="center" width="160">
+          <template slot-scope="scope">
+            <span>{{ parseTime(scope.row.applyTime) || '—' }}</span>
+          </template>
+        </el-table-column>
+        <el-table-column label="提现账户" align="center" min-width="200" :show-overflow-tooltip="true">
+          <template slot-scope="scope">
+            <span>{{ accountSummaryText(scope.row) }}</span>
+          </template>
+        </el-table-column>
+        <el-table-column label="提现金额" align="center" width="110">
+          <template slot-scope="scope">
+            <span>{{ formatMoney(scope.row.withdrawAmount) }}</span>
+          </template>
+        </el-table-column>
+        <el-table-column label="备注" align="center" min-width="120" :show-overflow-tooltip="true">
+          <template slot-scope="scope">
+            <span>{{ scope.row.remark || '—' }}</span>
+          </template>
+        </el-table-column>
+        <el-table-column label="提现状态" align="center" width="110">
+          <template slot-scope="scope">
+            <el-tag size="small" :type="withdrawStatusTag(scope.row.withdrawStatus)">
+              {{ scope.row.withdrawStatusText || withdrawStatusLabel(scope.row.withdrawStatus) }}
+            </el-tag>
+          </template>
+        </el-table-column>
+        <el-table-column label="提现处理说明" align="center" min-width="140" :show-overflow-tooltip="true">
+          <template slot-scope="scope">
+            <span>{{ processRemarkText(scope.row) }}</span>
+          </template>
+        </el-table-column>
+      </el-table>
+
+      <pagination v-show="total > 0" :total="total" :page.sync="queryParams.pageNum" :limit.sync="queryParams.pageSize" @pagination="getList" />
+    </el-card>
+  </div>
+</template>
+
+<script>
+import {
+  listSellerWithdraws,
+  getSellerWithdrawBalance,
+  submitSellerWithdraw
+} from "@/api/agri/seller/finance/withdraw"
+import { listSellerPayAccountOptions } from "@/api/agri/seller/finance/payAccount"
+import { getSellerContext } from "@/api/agri/seller/context"
+import { setSellerShopContext } from "@/utils/sellerShop"
+
+const WITHDRAW_STATUS_MAP = {
+  "1": "待审核",
+  "2": "审核不通过",
+  "3": "提现完成"
+}
+
+const ACCOUNT_TYPE_MAP = {
+  "1": "银行卡",
+  "2": "支付宝",
+  "3": "微信"
+}
+
+export default {
+  name: "AgriSellerFinanceWithdraw",
+  data() {
+    const validateWithdrawAmount = (rule, value, callback) => {
+      if (value == null || value === "") {
+        callback(new Error("请输入有效的提现金额"))
+        return
+      }
+      const num = Number(value)
+      if (isNaN(num) || num <= 0) {
+        callback(new Error("请输入有效的提现金额"))
+        return
+      }
+      const balance = Number(this.availableBalance)
+      if (!isNaN(balance) && num > balance) {
+        callback(new Error("提现金额不能超过可用余额"))
+        return
+      }
+      callback()
+    }
+    return {
+      loading: false,
+      balanceLoading: false,
+      submitting: false,
+      showSearch: true,
+      total: 0,
+      availableBalance: null,
+      accountOptions: [],
+      withdrawList: [],
+      dateRange: [],
+      submitForm: {
+        accountId: undefined,
+        withdrawAmount: undefined,
+        remark: undefined
+      },
+      submitRules: {
+        accountId: [{ required: true, message: "请选择提现账户", trigger: "change" }],
+        withdrawAmount: [{ validator: validateWithdrawAmount, trigger: "blur" }]
+      },
+      queryParams: {
+        pageNum: 1,
+        pageSize: 10,
+        withdrawStatus: undefined,
+        beginApplyTime: undefined,
+        endApplyTime: undefined
+      },
+      withdrawStatusOptions: [
+        { value: "1", label: "待审核" },
+        { value: "2", label: "审核不通过" },
+        { value: "3", label: "提现完成" }
+      ]
+    }
+  },
+  computed: {
+    hasSearchFilter() {
+      return !!(this.queryParams.withdrawStatus || (this.dateRange && this.dateRange.length))
+    },
+    emptyTableText() {
+      return this.hasSearchFilter ? "未找到符合条件的提现记录" : "暂无提现记录"
+    }
+  },
+  created() {
+    this.initPage()
+  },
+  methods: {
+    /** 初始化：加载店铺上下文后拉数据 */
+    initPage() {
+      this.loadShopContext().then(() => {
+        this.loadBalance()
+        this.loadAccountOptions()
+        this.getList()
+      }).catch(() => {
+        this.loadBalance()
+        this.loadAccountOptions()
+        this.getList()
+      })
+    },
+    /** 加载商家端当前店铺上下文 */
+    loadShopContext() {
+      return getSellerContext().then(response => {
+        const data = response.data || {}
+        if (data.shopId != null) {
+          setSellerShopContext(data.shopId, data.shopName)
+        }
+      })
+    },
+    /** 查询可用余额 */
+    loadBalance() {
+      this.balanceLoading = true
+      getSellerWithdrawBalance().then(response => {
+        const data = response.data || {}
+        this.availableBalance = data.availableBalance
+        this.balanceLoading = false
+      }).catch(() => {
+        this.balanceLoading = false
+      })
+    },
+    /** 加载提现账户下拉 */
+    loadAccountOptions() {
+      listSellerPayAccountOptions().then(response => {
+        this.accountOptions = response.data || []
+      }).catch(() => {
+        this.accountOptions = []
+      })
+    },
+    /** 构建查询参数（含申请时间区间） */
+    buildQueryParams() {
+      const params = { ...this.queryParams }
+      if (this.dateRange && this.dateRange.length === 2) {
+        params.beginApplyTime = this.dateRange[0]
+        params.endApplyTime = this.dateRange[1]
+      } else {
+        params.beginApplyTime = undefined
+        params.endApplyTime = undefined
+      }
+      return params
+    },
+    /** 查询提现记录 */
+    getList() {
+      this.loading = true
+      listSellerWithdraws(this.buildQueryParams()).then(response => {
+        this.withdrawList = response.rows || []
+        this.total = response.total || 0
+        this.loading = false
+      }).catch(() => {
+        this.loading = false
+      })
+    },
+    handleQuery() {
+      this.queryParams.pageNum = 1
+      this.getList()
+    },
+    resetQuery() {
+      this.dateRange = []
+      this.resetForm("queryForm")
+      this.queryParams.pageNum = 1
+      this.queryParams.beginApplyTime = undefined
+      this.queryParams.endApplyTime = undefined
+      this.getList()
+    },
+    /** 提交提现 */
+    handleSubmit() {
+      this.$refs.submitForm.validate(valid => {
+        if (!valid) {
+          return
+        }
+        this.submitting = true
+        submitSellerWithdraw({
+          accountId: this.submitForm.accountId,
+          withdrawAmount: Number(this.submitForm.withdrawAmount),
+          remark: this.submitForm.remark ? String(this.submitForm.remark).trim() : undefined
+        }).then(() => {
+          this.$modal.msgSuccess("提交成功")
+          this.resetSubmitForm()
+          this.loadBalance()
+          this.getList()
+          this.submitting = false
+        }).catch(() => {
+          this.submitting = false
+        })
+      })
+    },
+    /** 重置提交表单 */
+    resetSubmitForm() {
+      this.submitForm = {
+        accountId: undefined,
+        withdrawAmount: undefined,
+        remark: undefined
+      }
+      if (this.$refs.submitForm) {
+        this.resetForm("submitForm")
+      }
+    },
+    /** 金额格式化 */
+    formatMoney(val) {
+      if (val == null || val === "") {
+        return "—"
+      }
+      const num = Number(val)
+      if (isNaN(num)) {
+        return "—"
+      }
+      const fixed = num.toFixed(2)
+      const parts = fixed.split(".")
+      parts[0] = parts[0].replace(/\B(?=(\d{3})+(?!\d))/g, ",")
+      return "¥" + parts.join(".")
+    },
+    /** 账户下拉 label 兜底 */
+    buildAccountLabel(item) {
+      const type = item.accountTypeText || ACCOUNT_TYPE_MAP[item.accountType] || ""
+      const mask = item.accountNoMask || ""
+      const name = item.realName || ""
+      return [type, mask, name].filter(Boolean).join(" ")
+    },
+    /** 列表提现账户摘要 */
+    accountSummaryText(row) {
+      if (row.accountSummary) {
+        return row.accountSummary
+      }
+      const type = row.accountTypeText || ACCOUNT_TYPE_MAP[row.accountType] || ""
+      const mask = row.accountNoMask || ""
+      const name = row.accountRealName || ""
+      const text = [type, mask, name].filter(Boolean).join(" ")
+      return text || "—"
+    },
+    /** 处理说明：待审核展示 — */
+    processRemarkText(row) {
+      if (row.withdrawStatus === "1") {
+        return "—"
+      }
+      return row.processRemark || "—"
+    },
+    withdrawStatusLabel(status) {
+      return WITHDRAW_STATUS_MAP[status] || "—"
+    },
+    withdrawStatusTag(status) {
+      const map = { "1": "warning", "2": "danger", "3": "success" }
+      return map[status] || "info"
+    }
+  }
+}
+</script>
+
+<style scoped lang="scss">
+.card-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  flex-wrap: wrap;
+  gap: 8px;
+}
+.card-title {
+  font-weight: 600;
+  font-size: 15px;
+}
+.balance-tip {
+  font-size: 13px;
+  color: #606266;
+  strong {
+    color: #303133;
+    font-size: 15px;
+  }
+}
+.submit-form {
+  max-width: 1200px;
+}
+.mb8 {
+  margin-bottom: 8px;
+}
+.mb12 {
+  margin-bottom: 12px;
+}
+</style>