1. 维护代码健壮

2. 更新项目结构文档

doc/backend/services.md

@@ -0,0 +1,51 @@
+# 后端服务层
+
+服务层承载业务规则，控制器只负责入口、参数和响应包装。
+
+## 目录职责
+
+| 目录 | 主要职责 |
+| --- | --- |
+| `account/funds`、`account/ledger` | 商户账户、余额和资金流水 |
+| `bootstrap` | 启动期初始化 |
+| `file`、`file/storage` | 文件资产、上传、导入、预览、下载和存储驱动 |
+| `merchant` | 商户主体、总览、分组、策略、API 凭证 |
+| `merchant/auth` | 商户后台登录认证 |
+| `merchant/portal` | 商户后台资料、通道、路由预览、订单资金查询 |
+| `ops/log`、`ops/stat` | 通道通知、支付回调、商户通知任务和通道日统计 |
+| `payment/cashier` | 收银台上下文、确认支付、支付单展示 |
+| `payment/config` | 支付方式、插件、插件配置、通道、轮询组、绑定 |
+| `payment/epay` | ePay V1/V2 协议、MD5/RSA 签名 |
+| `payment/order` | 支付单、退款单、费用、派单、回调、生命周期 |
+| `payment/runtime` | 路由解析、插件装配、商户通知、运行时维护 |
+| `payment/settlement` | 清算单和清算生命周期 |
+| `payment/trace` | 交易追踪与报表 |
+| `payment/transfer` | 转账能力 |
+| `system/access`、`system/config`、`system/user` | 管理员认证、系统配置、管理员用户 |
+
+## 命名规则
+
+- `*Service`：对外门面。
+- `*QueryService`：查询与展示拼装。
+- `*CommandService`：写入、修改、删除。
+- `*LifecycleService`：状态流转。
+- `*CallbackService`：第三方回调。
+- `*SyncService`：同步、扫描、刷新。
+- `*SupportService`：业务辅助能力。
+
+## 关键服务
+
+- 支付：`PayOrderService`、`PayOrderLifecycleService`、`PayOrderChannelDispatchService`
+- 退款：`RefundService`、`RefundCreationService`、`RefundLifecycleService`
+- 清算：`SettlementService`、`SettlementLifecycleService`
+- 路由与插件：`PaymentRouteService`、`PaymentRouteResolverService`、`PaymentPluginManager`
+- 收银台：`CashierService`
+- 通知：`NotifyService`、`MerchantNotifyDispatcherService`
+- 商户：`MerchantService`、`MerchantPortalService`、`MerchantApiCredentialService`
+- 文件：`FileRecordService`、`StorageManager`
+
+## 维护要求
+
+- 查询和写入不要混在一个越来越胖的类里。
+- 回调、路由解析、插件装配、通知重试要保持独立职责。
+- `SupportService` 只放有业务含义的复用逻辑，不做基础工具的空转发。