1. 维护代码健壮

2. 更新项目结构文档

doc/frontend/menu.md

@@ -0,0 +1,146 @@
+# 菜单说明
+
+> 真实菜单以 [`../../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 凭证与商户后台登录彻底分离