Files
mpay_v2_webman/doc/frontend/menu.md
技术老胡 0e5de50337 1. 维护代码健壮
2. 更新项目结构文档
2026-04-27 16:20:41 +08:00

147 lines
4.0 KiB
Markdown

# 菜单说明
> 真实菜单以 [`../../mpay/config/menu.php`](../../mpay/config/menu.php) 为准;稳定口径见 [`../standards.md`](../standards.md)。
这份文档只说明当前页面和菜单职责,不重复项目事实。
## 1. 管理后台当前菜单
```text
管理后台
├─ 首页
├─ 商户管理
│ ├─ 商户列表
│ └─ 商户分组
├─ 通道中心
│ ├─ 支付方式
│ ├─ 支付插件
│ ├─ 插件配置
│ ├─ 通道列表
│ └─ 通道日统计
├─ 路由中心
│ ├─ 轮询组
│ ├─ 路由编排
│ └─ 路由预览
├─ 交易中心
│ ├─ 支付订单
│ ├─ 退款订单
│ ├─ 清算订单
│ ├─ 通道通知日志
│ └─ 支付回调日志
├─ 资金中心
│ ├─ 资金账户
│ └─ 资金流水
├─ 系统管理
│ ├─ 管理员用户
│ └─ 系统配置
└─ 文件中心
└─ 文件管理
```
## 2. 商户后台当前菜单
```text
商户后台
├─ 首页
├─ 通道中心
│ ├─ 我的通道
│ ├─ 路由预览
│ └─ 商户 API 凭证
├─ 交易中心
│ ├─ 支付订单
│ ├─ 退款订单
│ └─ 清算记录
├─ 资金中心
│ ├─ 可提现余额
│ └─ 余额流水
└─ 基础设置
├─ 商户资料
└─ 登录认证
```
## 3. 页面职责
### 3.1 商户管理
| 页面 | 当前职责 |
|---|---|
| 商户列表 | 商户主体资料维护 + 通过操作台抽屉查看接入、商户 API 凭证、资金等摘要 |
| 商户分组 | 商户分组主数据维护,是路由绑定的输入条件 |
说明:
- 不再单独暴露“商户用户”页面
- 商户更多能力通过商户列表内的操作台处理
### 3.2 通道中心
| 页面 | 当前职责 |
|---|---|
| 支付方式 | 支付方式字典维护 |
| 支付插件 | 扫描插件类并同步插件定义 |
| 插件配置 | 维护插件初始化配置 |
| 通道列表 | 维护平台通道和商户自有通道 |
| 通道日统计 | 查看通道健康度、成功率、耗时等 |
### 3.3 路由中心
| 页面 | 当前职责 |
|---|---|
| 轮询组 | 维护轮询组本身,并在组内编排候选通道 |
| 路由编排 | 维护“商户分组 + 支付方式 -> 轮询组”的绑定关系 |
| 路由预览 | 按真实链路预览某次支付会命中哪个通道 |
当前路由模式:
- 顺序依次轮询
- 权重随机轮询
- 默认启用通道
### 3.4 交易中心
| 页面 | 当前职责 |
|---|---|
| 支付订单 | 平台支付单查询、详情、回调和状态跟踪 |
| 退款订单 | 退款单查询、退款推进和退款结果跟踪 |
| 清算订单 | 平台代收清算批次、明细和结算结果查看 |
| 通道通知日志 | 查看通道侧通知记录和失败原因 |
| 支付回调日志 | 查看支付回调记录和幂等处理结果 |
### 3.5 资金中心
| 页面 | 当前职责 |
|---|---|
| 资金账户 | 商户账户余额、冻结余额、可用余额查看 |
| 资金流水 | 商户账户入账、出账、冻结、解冻流水查看 |
### 3.6 系统管理
| 页面 | 当前职责 |
|---|---|
| 管理员用户 | 平台管理员账号维护 |
| 系统配置 | 平台级配置维护与同步 |
### 3.7 文件中心
| 页面 | 当前职责 |
|---|---|
| 文件管理 | 统一管理图片、证书、文本和其他附件,支持本地存储和对象存储切换 |
### 3.8 商户后台
| 页面 | 当前职责 |
|---|---|
| 我的通道 | 只读查看当前商户可见通道 |
| 路由预览 | 输入支付方式和金额,查看当前商户会命中的通道 |
| 商户 API 凭证 | 查看当前商户的商户 API 凭证相关信息 |
| 商户资料 | 维护联系人与结算信息 |
| 登录认证 | 修改登录密码,查看登录相关信息 |
## 4. 口径差异
- 轮询组已从“通道中心”移动到“路由中心”
- 商户管理不再拆“商户用户”
- 商户更多能力仍收在列表页内的操作台
- 商户后台登录已改为“商户号 + 密码”
- 商户 API 凭证与商户后台登录彻底分离