1. 维护代码健壮

2. 更新项目结构文档

doc/backend/compat.md

@@ -0,0 +1,39 @@
+# ePay 兼容层
+
+后端同时保留 ePay V1 旧入口和 ePay V2 新接口。兼容层只负责协议适配，不作为后台管理或商户后台的新能力入口。
+
+## 当前实现
+
+| 协议 | 控制器 | 服务 |
+| --- | --- | --- |
+| ePay V1 | `app/http/api/controller/epay/EpayV1Controller.php` | `app/service/payment/epay/EpayV1ProtocolService.php` |
+| ePay V2 | `app/http/api/controller/epay/EpayV2Controller.php` | `app/service/payment/epay/EpayV2ProtocolService.php` |
+
+签名实现：
+
+- `Md5Signer`
+- `RsaSigner`
+- `EpaySignerManager`
+
+## V1 路由
+
+| 方法 | 路径 | 说明 |
+| --- | --- | --- |
+| `ANY` | `/submit.php` | 页面跳转支付 |
+| `POST` | `/mapi.php` | 接口支付 |
+| `ANY` | `/api.php` | 旧版标准 API |
+
+## V2 路由
+
+| 分组 | 路径 |
+| --- | --- |
+| 支付 | `/api/pay/submit`、`/api/pay/create`、`/api/pay/query`、`/api/pay/refund`、`/api/pay/refundquery`、`/api/pay/close`、`/api/pay/{payNo}/callback` |
+| 商户 | `/api/merchant/info`、`/api/merchant/orders` |
+| 转账 | `/api/transfer/submit`、`/api/transfer/query`、`/api/transfer/balance` |
+
+## 关联文档
+
+- [接口总说明](../api/README.md)
+- [收银台与开放接口](../api/cashier.md)
+- [ePay 兼容协议](../api/legacy/epay.md)
+- [后端路由](./routing.md)