mpay_v2_webman/doc/backend/services.md

后端服务层

服务层承载业务规则，控制器只负责入口、参数和响应包装。

目录职责

目录	主要职责
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 只放有业务含义的复用逻辑，不做基础工具的空转发。