1. 维护代码健壮

2. 更新项目结构文档

doc/backend/commands.md

@@ -0,0 +1,41 @@
+# 后端命令
+
+命令默认在 `mpay/` 目录执行。
+
+## Webman 启动
+
+| 命令 | 作用 |
+| --- | --- |
+| `php webman start` | 启动后端 HTTP 服务 |
+| `php webman restart` | 重启后端服务 |
+| `php windows.php` | Windows 开发环境启动 Webman 与自定义进程 |
+| `php start.php start` | 生产/Linux 常见启动入口 |
+
+`payment-runtime` 是自定义进程，不是 Console 命令；它随 Webman 进程启动，负责通知重试、支付超时扫描和支付中订单主动查单。
+
+## 业务命令
+
+| 命令 | 作用 |
+| --- | --- |
+| `php webman mpay:test --all` | 支付、退款、清结算、余额、追踪链路烟雾测试 |
+| `php webman epay:mapi` | ePay V1 `mapi.php` 兼容接口烟雾测试 |
+| `php webman epay:v2-api` | ePay V2 创建、查询、关闭、退款、商户信息等核心 API 烟雾测试 |
+| `php webman epay:mock-chain` | 自动写入 mock 配置并跑 ePay V1/V2 全链路 |
+| `php webman epay:v2-bootstrap` | 生成开发联调用平台和商户 RSA 密钥 |
+| `php webman payment:notify-retry` | 手动重试到期商户通知任务 |
+| `php webman system:config-sync` | 将 `config/system_config.php` 默认配置同步到数据库 |
+| `php webman test` | 基础命令注册检查 |
+
+## 常用参数
+
+- `mpay:test`：`--payment`、`--refund`、`--settlement`、`--balance`、`--trace`、`--all`、`--live`
+- `epay:mapi`：`--live`、`--merchant-id`、`--merchant-no`、`--type`、`--money`、`--refund-trade-no`
+- `epay:v2-api`：`--live`、`--merchant-id`、`--merchant-no`、`--merchant-private-key-file`、`--type`、`--method`、`--money`
+- `epay:mock-chain`：`--only=v1|v2|all`
+- `payment:notify-retry`：`--limit`
+
+## 关联文档
+
+- [后端总说明](./README.md)
+- [支付运行时数据契约](./payment-runtime-contract.md)
+- [ePay 兼容协议](../api/legacy/epay.md)