mpay_v2_webman/doc/backend/routing.md

后端路由

后端只使用显式路由。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

流转

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 到控制器方法的绑定。