1. 维护代码健壮

2. 更新项目结构文档

doc/backend/README.md

@@ -0,0 +1,72 @@
+# 后端总说明
+
+`mpay` 是支付中台后端服务，基于 Webman。命令默认在 `mpay/` 目录执行。
+
+## 技术栈
+
+- PHP `>=8.1`
+- `workerman/webman-framework ^2.1`
+- MySQL、Redis
+- JWT、Webman validation/cache/event/redis/database
+- OSS/COS SDK 用于对象存储
+
+## 快速启动
+
+```bash
+composer install
+Copy-Item .env.example .env
+php webman start
+```
+
+Windows 开发环境如需启动自定义进程，可使用：
+
+```bash
+php windows.php
+```
+
+## 主要目录
+
+```text
+app/
+  command/      命令与烟雾测试
+  common/       基类、常量、工具、中间件、支付插件
+  http/         admin、mer、api 三类 HTTP 入口
+  model/        数据模型
+  repository/   数据访问
+  route/        显式路由
+  service/      业务服务
+config/         Webman 与业务配置
+public/         静态资源与前端构建产物
+support/        Webman 支撑代码
+```
+
+## 关键入口
+
+- 路由：`config/route.php`、`app/route/admin.php`、`app/route/mer.php`、`app/route/api.php`
+- 支付：`app/service/payment/order/PayOrderService.php`
+- 退款：`app/service/payment/order/RefundService.php`
+- 清算：`app/service/payment/settlement/SettlementService.php`
+- 路由：`app/service/payment/runtime/PaymentRouteService.php`
+- 插件：`app/service/payment/runtime/PaymentPluginManager.php`
+- 商户：`app/service/merchant/MerchantService.php`
+- 商户后台：`app/service/merchant/portal/MerchantPortalService.php`
+- 文件：`app/service/file/FileRecordService.php`
+
+## 常用命令
+
+```bash
+php webman start
+php webman restart
+php webman mpay:test --all
+php webman epay:mapi
+php webman system:config-sync
+```
+
+## 关联文档
+
+- [后端路由](./routing.md)
+- [后端服务层](./services.md)
+- [后端命令](./commands.md)
+- [文件资产](./files.md)
+- [接口总说明](../api/README.md)
+- [部署说明](../deployment/backend.md)