mirror of
https://gitee.com/technical-laohu/mpay_v2_webman.git
synced 2026-05-09 18:34:26 +08:00
48 lines
1.8 KiB
Markdown
48 lines
1.8 KiB
Markdown
# 后端路由
|
|
|
|
后端只使用显式路由。`config/route.php` 加载三份路由文件后关闭默认路由。
|
|
|
|
## 路由文件
|
|
|
|
| 文件 | 覆盖范围 |
|
|
| --- | --- |
|
|
| `app/route/admin.php` | `/admin` 页面入口、`/adminapi` 管理后台 API |
|
|
| `app/route/mer.php` | `/mer` 页面入口、`/merapi` 商户后台 API |
|
|
| `app/route/api.php` | 收银台页面、收银台 API、ePay V1/V2 与开放 API |
|
|
|
|
## 当前入口
|
|
|
|
| 前缀 | 说明 | 中间件 |
|
|
| --- | --- | --- |
|
|
| `/admin` | 管理后台静态页面入口 | 无业务鉴权 |
|
|
| `/adminapi` | 管理后台接口 | `Cors`，保护接口再走 `AdminAuthMiddleware` |
|
|
| `/mer` | 商户后台静态页面入口 | 无业务鉴权 |
|
|
| `/merapi` | 商户后台接口 | `Cors`，保护接口再走 `MerchantAuthMiddleware` |
|
|
| `/cashier` | 收银台入口页 | 无业务鉴权 |
|
|
| `/payment` | 支付页、中转页、结果页 | 无业务鉴权 |
|
|
| `/api/cashier` | 收银台上下文、确认支付、支付单详情 | `Cors` |
|
|
| `/api/pay` | ePay V2 支付、查询、退款、关闭、通道回调 | `Cors` |
|
|
| `/api/merchant` | ePay V2 商户信息与订单查询 | `Cors` |
|
|
| `/api/transfer` | ePay V2 转账提交、查询、余额 | `Cors` |
|
|
| `/submit.php`、`/mapi.php`、`/api.php` | ePay V1 兼容入口 | `Cors` |
|
|
|
|
## 流转
|
|
|
|
```mermaid
|
|
flowchart LR
|
|
Req[HTTP 请求] --> Route[显式路由]
|
|
Route --> Middleware[中间件]
|
|
Middleware --> Controller[控制器]
|
|
Controller --> Validator[参数校验]
|
|
Validator --> Service[服务层]
|
|
Service --> Repository[仓库层]
|
|
Repository --> Model[模型层]
|
|
Model --> DB[(MySQL)]
|
|
```
|
|
|
|
## 维护要求
|
|
|
|
- 新增接口先改 `app/route/*`，再补对应 `docs/api/*`。
|
|
- 页面兜底路由只返回前端入口，不承载业务逻辑。
|
|
- 业务规则放服务层；路由文件只做 URL 到控制器方法的绑定。
|