更新统一使用 PHPDoc + PSR-19 标准注释

app/repository/payment/config/PaymentChannelRepository.php

@@ -6,12 +6,16 @@ use app\common\base\BaseRepository;
 use app\model\payment\PaymentChannel;
 
 /**
- * 支付通道仓库。
+ * 支付通道基础查询仓库。
+ *
+ * 提供商户通道的启用列表、单条查询和统计概览等基础读方法。
  */
 class PaymentChannelRepository extends BaseRepository
 {
     /**
-     * 构造函数，注入对应模型。
+     * 构造方法。
+     *
+     * @return void
      */
     public function __construct()
     {
@@ -20,6 +24,10 @@ class PaymentChannelRepository extends BaseRepository
 
     /**
      * 查询指定商户启用的支付通道。
+     *
+     * @param int $merchantId 商户ID
+     * @param array $columns 字段列表
+     * @return \Illuminate\Database\Eloquent\Collection<int, PaymentChannel> 启用通道列表
      */
     public function enabledByMerchantId(int $merchantId, array $columns = ['*'])
     {
@@ -32,6 +40,11 @@ class PaymentChannelRepository extends BaseRepository
 
     /**
      * 根据商户 ID 和通道 ID 查询通道。
+     *
+     * @param int $merchantId 商户ID
+     * @param int $channelId 渠道ID
+     * @param array $columns 字段列表
+     * @return PaymentChannel|null 通道记录
      */
     public function findByMerchantAndId(int $merchantId, int $channelId, array $columns = ['*'])
     {
@@ -43,6 +56,10 @@ class PaymentChannelRepository extends BaseRepository
 
     /**
      * 判断通道名称是否已存在。
+     *
+     * @param string $name 通道名称
+     * @param int $ignoreId 需要排除的记录ID
+     * @return bool 是否存在
      */
     public function existsByName(string $name, int $ignoreId = 0): bool
     {
@@ -58,6 +75,9 @@ class PaymentChannelRepository extends BaseRepository
 
     /**
      * 统计商户名下的支付通道概览。
+     *
+     * @param int $merchantId 商户ID
+     * @return object{total_count:int, enabled_count:int, self_count:int} 通道统计概览
      */
     public function summaryByMerchantId(int $merchantId): object
     {
@@ -71,6 +91,9 @@ class PaymentChannelRepository extends BaseRepository
 
     /**
      * 统计商户下的支付通道数量。
+     *
+     * @param int $merchantId 商户ID
+     * @return int 通道数量
      */
     public function countByMerchantId(int $merchantId): int
     {
@@ -79,3 +102,6 @@ class PaymentChannelRepository extends BaseRepository
             ->count();
     }
 }
+
+
+

app/repository/payment/config/PaymentPluginConfRepository.php

@@ -7,11 +7,15 @@ use app\model\payment\PaymentPluginConf;
 
 /**
  * 支付插件配置仓库。
+ *
+ * 封装按插件编码读取最新配置的查询方法。
  */
 class PaymentPluginConfRepository extends BaseRepository
 {
     /**
-     * 构造函数，注入对应模型。
+     * 构造方法。
+     *
+     * @return void
      */
     public function __construct()
     {
@@ -20,6 +24,10 @@ class PaymentPluginConfRepository extends BaseRepository
 
     /**
      * 根据插件编码查询插件配置。
+     *
+     * @param string $pluginCode 插件编码
+     * @param array $columns 字段列表
+     * @return PaymentPluginConf|null 插件配置记录
      */
     public function findByPluginCode(string $pluginCode, array $columns = ['*'])
     {
@@ -31,3 +39,7 @@ class PaymentPluginConfRepository extends BaseRepository
 }
 
 
+
+
+
+

app/repository/payment/config/PaymentPluginRepository.php

@@ -7,11 +7,15 @@ use app\model\payment\PaymentPlugin;
 
 /**
  * 支付插件仓库。
+ *
+ * 封装支付插件字典的查询与启用列表读取。
  */
 class PaymentPluginRepository extends BaseRepository
 {
     /**
-     * 构造函数，注入对应模型。
+     * 构造方法。
+     *
+     * @return void
      */
     public function __construct()
     {
@@ -20,6 +24,10 @@ class PaymentPluginRepository extends BaseRepository
 
     /**
      * 根据插件编码查询支付插件。
+     *
+     * @param string $code 插件编码
+     * @param array $columns 字段列表
+     * @return PaymentPlugin|null 插件记录
      */
     public function findByCode(string $code, array $columns = ['*']): ?PaymentPlugin
     {
@@ -30,6 +38,9 @@ class PaymentPluginRepository extends BaseRepository
 
     /**
      * 获取所有启用的支付插件。
+     *
+     * @param array $columns 字段列表
+     * @return \Illuminate\Database\Eloquent\Collection<int, PaymentPlugin> 启用插件列表
      */
     public function enabledList(array $columns = ['*'])
     {
@@ -41,3 +52,7 @@ class PaymentPluginRepository extends BaseRepository
 }
 
 
+
+
+
+

app/repository/payment/config/PaymentPollGroupBindRepository.php

@@ -7,11 +7,15 @@ use app\model\payment\PaymentPollGroupBind;
 
 /**
  * 商户分组与轮询组绑定仓库。
+ *
+ * 封装路由绑定的启用记录与编排展示查询。
  */
 class PaymentPollGroupBindRepository extends BaseRepository
 {
     /**
-     * 构造函数，注入对应模型。
+     * 构造方法。
+     *
+     * @return void
      */
     public function __construct()
     {
@@ -20,6 +24,11 @@ class PaymentPollGroupBindRepository extends BaseRepository
 
     /**
      * 根据商户分组和支付方式查询启用的绑定关系。
+     *
+     * @param int $merchantGroupId 商户分组ID
+     * @param int $payTypeId 支付类型ID
+     * @param array $columns 字段列表
+     * @return PaymentPollGroupBind|null 绑定记录
      */
     public function findActiveByMerchantGroupAndPayType(int $merchantGroupId, int $payTypeId, array $columns = ['*'])
     {
@@ -32,6 +41,9 @@ class PaymentPollGroupBindRepository extends BaseRepository
 
     /**
      * 查询商户分组下的路由绑定概览。
+     *
+     * @param int $merchantGroupId 商户分组ID
+     * @return \Illuminate\Database\Eloquent\Collection<int, PaymentPollGroupBind> 绑定概览列表
      */
     public function listSummaryByMerchantGroupId(int $merchantGroupId)
     {
@@ -55,3 +67,7 @@ class PaymentPollGroupBindRepository extends BaseRepository
     }
 }
 
+
+
+
+

app/repository/payment/config/PaymentPollGroupChannelRepository.php

@@ -7,11 +7,15 @@ use app\model\payment\PaymentPollGroupChannel;
 
 /**
  * 轮询组与通道编排仓库。
+ *
+ * 封装轮询组下通道编排、默认通道清理等查询与更新。
  */
 class PaymentPollGroupChannelRepository extends BaseRepository
 {
     /**
-     * 构造函数，注入对应模型。
+     * 构造方法。
+     *
+     * @return void
      */
     public function __construct()
     {
@@ -20,6 +24,10 @@ class PaymentPollGroupChannelRepository extends BaseRepository
 
     /**
      * 查询轮询组下的通道编排列表。
+     *
+     * @param int $pollGroupId 轮询分组ID
+     * @param array $columns 字段列表
+     * @return \Illuminate\Database\Eloquent\Collection<int, PaymentPollGroupChannel> 编排列表
      */
     public function listByPollGroupId(int $pollGroupId, array $columns = ['*'])
     {
@@ -32,6 +40,10 @@ class PaymentPollGroupChannelRepository extends BaseRepository
 
     /**
      * 清空轮询组下其他默认通道标记。
+     *
+     * @param int $pollGroupId 轮询分组ID
+     * @param int $ignoreId 需要保留默认标记的记录ID
+     * @return int 受影响行数
      */
     public function clearDefaultExcept(int $pollGroupId, int $ignoreId = 0): int
     {
@@ -47,3 +59,7 @@ class PaymentPollGroupChannelRepository extends BaseRepository
     }
 }
 
+
+
+
+

app/repository/payment/config/PaymentPollGroupRepository.php

@@ -11,7 +11,9 @@ use app\model\payment\PaymentPollGroup;
 class PaymentPollGroupRepository extends BaseRepository
 {
     /**
-     * 构造函数，注入对应模型。
+     * 构造方法。
+     *
+     * @return void
      */
     public function __construct()
     {
@@ -20,6 +22,10 @@ class PaymentPollGroupRepository extends BaseRepository
 
     /**
      * 判断轮询组名称是否已存在。
+     *
+     * @param string $groupName 轮询组名称
+     * @param int $ignoreId 需要排除的记录ID
+     * @return bool 是否存在
      */
     public function existsByGroupName(string $groupName, int $ignoreId = 0): bool
     {
@@ -33,3 +39,7 @@ class PaymentPollGroupRepository extends BaseRepository
         return $query->exists();
     }
 }
+
+
+
+

app/repository/payment/config/PaymentTypeRepository.php

@@ -7,11 +7,15 @@ use app\model\payment\PaymentType;
 
 /**
  * 支付方式字典仓库。
+ *
+ * 封装支付方式启用列表和按编码查询方法。
  */
 class PaymentTypeRepository extends BaseRepository
 {
     /**
-     * 构造函数，注入对应模型。
+     * 构造方法。
+     *
+     * @return void
      */
     public function __construct()
     {
@@ -20,6 +24,9 @@ class PaymentTypeRepository extends BaseRepository
 
     /**
      * 获取所有启用的支付方式。
+     *
+     * @param array $columns 字段列表
+     * @return \Illuminate\Database\Eloquent\Collection<int, PaymentType> 启用支付方式列表
      */
     public function enabledList(array $columns = ['*'])
     {
@@ -31,6 +38,10 @@ class PaymentTypeRepository extends BaseRepository
 
     /**
      * 根据支付方式编码查询字典。
+     *
+     * @param string $code 支付方式编码
+     * @param array $columns 字段列表
+     * @return PaymentType|null 支付方式记录
      */
     public function findByCode(string $code, array $columns = ['*']): ?PaymentType
     {
@@ -41,3 +52,7 @@ class PaymentTypeRepository extends BaseRepository
 }
 
 
+
+
+
+

app/repository/payment/notify/NotifyTaskRepository.php

@@ -7,11 +7,15 @@ use app\model\payment\NotifyTask;
 
 /**
  * 商户通知任务仓库。
+ *
+ * 封装通知单号查询和可重试任务列表。
  */
 class NotifyTaskRepository extends BaseRepository
 {
     /**
-     * 构造函数，注入对应模型。
+     * 构造方法。
+     *
+     * @return void
      */
     public function __construct()
     {
@@ -20,6 +24,10 @@ class NotifyTaskRepository extends BaseRepository
 
     /**
      * 根据通知单号查询通知任务。
+     *
+     * @param string $notifyNo 通知号
+     * @param array $columns 字段列表
+     * @return NotifyTask|null 通知任务记录
      */
     public function findByNotifyNo(string $notifyNo, array $columns = ['*'])
     {
@@ -30,6 +38,10 @@ class NotifyTaskRepository extends BaseRepository
 
     /**
      * 查询可重试的通知任务列表。
+     *
+     * @param int $status 状态
+     * @param array $columns 字段列表
+     * @return \Illuminate\Database\Eloquent\Collection<int, NotifyTask> 可重试任务列表
      */
     public function listRetryable(int $status, array $columns = ['*'])
     {
@@ -41,3 +53,7 @@ class NotifyTaskRepository extends BaseRepository
 }
 
 
+
+
+
+

app/repository/payment/settlement/SettlementItemRepository.php

@@ -7,11 +7,15 @@ use app\model\payment\SettlementItem;
 
 /**
  * 清算明细仓库。
+ *
+ * 封装清算单下的明细列表查询。
  */
 class SettlementItemRepository extends BaseRepository
 {
     /**
-     * 构造函数，注入对应模型。
+     * 构造方法。
+     *
+     * @return void
      */
     public function __construct()
     {
@@ -20,6 +24,10 @@ class SettlementItemRepository extends BaseRepository
 
     /**
      * 查询指定清算单下的明细列表。
+     *
+     * @param string $settleNo 结算单号
+     * @param array $columns 字段列表
+     * @return \Illuminate\Database\Eloquent\Collection<int, SettlementItem> 清算明细列表
      */
     public function listBySettleNo(string $settleNo, array $columns = ['*'])
     {
@@ -31,3 +39,7 @@ class SettlementItemRepository extends BaseRepository
 }
 
 
+
+
+
+

app/repository/payment/settlement/SettlementOrderRepository.php

@@ -7,11 +7,15 @@ use app\model\payment\SettlementOrder;
 
 /**
  * 清算单仓库。
+ *
+ * 封装清算单号、追踪号、清算周期和最近列表查询。
  */
 class SettlementOrderRepository extends BaseRepository
 {
     /**
-     * 构造函数，注入对应模型。
+     * 构造方法。
+     *
+     * @return void
      */
     public function __construct()
     {
@@ -20,6 +24,10 @@ class SettlementOrderRepository extends BaseRepository
 
     /**
      * 根据清算单号查询清算单。
+     *
+     * @param string $settleNo 结算单号
+     * @param array $columns 字段列表
+     * @return SettlementOrder|null 清算单记录
      */
     public function findBySettleNo(string $settleNo, array $columns = ['*'])
     {
@@ -30,6 +38,10 @@ class SettlementOrderRepository extends BaseRepository
 
     /**
      * 根据追踪号查询清算单。
+     *
+     * @param string $traceNo 追踪号
+     * @param array $columns 字段列表
+     * @return SettlementOrder|null 清算单记录
      */
     public function findByTraceNo(string $traceNo, array $columns = ['*'])
     {
@@ -40,6 +52,10 @@ class SettlementOrderRepository extends BaseRepository
 
     /**
      * 根据追踪号查询清结算单列表。
+     *
+     * @param string $traceNo 追踪号
+     * @param array $columns 字段列表
+     * @return \Illuminate\Database\Eloquent\Collection<int, SettlementOrder> 清算单列表
      */
     public function listByTraceNo(string $traceNo, array $columns = ['*'])
     {
@@ -51,6 +67,13 @@ class SettlementOrderRepository extends BaseRepository
 
     /**
      * 根据商户、通道和清算周期查询清算单。
+     *
+     * @param int $merchantId 商户ID
+     * @param int $channelId 渠道ID
+     * @param int $cycleType 周期类型
+     * @param string $cycleKey 周期标识
+     * @param array $columns 字段列表
+     * @return SettlementOrder|null 清算单记录
      */
     public function findByCycle(int $merchantId, int $channelId, int $cycleType, string $cycleKey, array $columns = ['*'])
     {
@@ -64,6 +87,10 @@ class SettlementOrderRepository extends BaseRepository
 
     /**
      * 根据清算单号加锁查询清算单。
+     *
+     * @param string $settleNo 结算单号
+     * @param array $columns 字段列表
+     * @return SettlementOrder|null 清算单记录
      */
     public function findForUpdateBySettleNo(string $settleNo, array $columns = ['*'])
     {
@@ -75,6 +102,10 @@ class SettlementOrderRepository extends BaseRepository
 
     /**
      * 根据追踪号加锁查询清算单。
+     *
+     * @param string $traceNo 追踪号
+     * @param array $columns 字段列表
+     * @return SettlementOrder|null 清算单记录
      */
     public function findForUpdateByTraceNo(string $traceNo, array $columns = ['*'])
     {
@@ -86,6 +117,10 @@ class SettlementOrderRepository extends BaseRepository
 
     /**
      * 查询商户最近清算单列表，用于总览展示。
+     *
+     * @param int $merchantId 商户ID
+     * @param int $limit 限制条数
+     * @return \Illuminate\Database\Eloquent\Collection<int, SettlementOrder> 最近清算单列表
      */
     public function recentByMerchantId(int $merchantId, int $limit = 5)
     {
@@ -104,6 +139,9 @@ class SettlementOrderRepository extends BaseRepository
 
     /**
      * 统计商户下的清算单数量。
+     *
+     * @param int $merchantId 商户ID
+     * @return int 清算单数量
      */
     public function countByMerchantId(int $merchantId): int
     {
@@ -112,3 +150,7 @@ class SettlementOrderRepository extends BaseRepository
             ->count();
     }
 }
+
+
+
+

app/repository/payment/trade/BizOrderRepository.php

@@ -7,11 +7,15 @@ use app\model\payment\BizOrder;
 
 /**
  * 业务订单仓库。
+ *
+ * 封装业务单号、追踪号、商户订单号和加锁查询方法。
  */
 class BizOrderRepository extends BaseRepository
 {
     /**
-     * 构造函数，注入对应模型。
+     * 构造方法。
+     *
+     * @return void
      */
     public function __construct()
     {
@@ -20,6 +24,10 @@ class BizOrderRepository extends BaseRepository
 
     /**
      * 根据业务单号查询业务订单。
+     *
+     * @param string $bizNo 业务单号
+     * @param array $columns 字段列表
+     * @return BizOrder|null 业务订单记录
      */
     public function findByBizNo(string $bizNo, array $columns = ['*'])
     {
@@ -30,6 +38,10 @@ class BizOrderRepository extends BaseRepository
 
     /**
      * 根据追踪号查询业务订单。
+     *
+     * @param string $traceNo 追踪号
+     * @param array $columns 字段列表
+     * @return BizOrder|null 业务订单记录
      */
     public function findByTraceNo(string $traceNo, array $columns = ['*'])
     {
@@ -40,6 +52,11 @@ class BizOrderRepository extends BaseRepository
 
     /**
      * 根据商户 ID 和商户订单号查询业务订单。
+     *
+     * @param int $merchantId 商户ID
+     * @param string $merchantOrderNo 商户订单号
+     * @param array $columns 字段列表
+     * @return BizOrder|null 业务订单记录
      */
     public function findByMerchantAndOrderNo(int $merchantId, string $merchantOrderNo, array $columns = ['*'])
     {
@@ -51,6 +68,10 @@ class BizOrderRepository extends BaseRepository
 
     /**
      * 根据业务单号查询当前有效的业务订单。
+     *
+     * @param string $bizNo 业务单号
+     * @param array $columns 字段列表
+     * @return BizOrder|null 有效业务订单记录
      */
     public function findActiveByBizNo(string $bizNo, array $columns = ['*'])
     {
@@ -62,6 +83,10 @@ class BizOrderRepository extends BaseRepository
 
     /**
      * 根据业务单号加锁查询业务订单。
+     *
+     * @param string $bizNo 业务单号
+     * @param array $columns 字段列表
+     * @return BizOrder|null 业务订单记录
      */
     public function findForUpdateByBizNo(string $bizNo, array $columns = ['*'])
     {
@@ -73,6 +98,10 @@ class BizOrderRepository extends BaseRepository
 
     /**
      * 根据追踪号加锁查询业务订单。
+     *
+     * @param string $traceNo 追踪号
+     * @param array $columns 字段列表
+     * @return BizOrder|null 业务订单记录
      */
     public function findForUpdateByTraceNo(string $traceNo, array $columns = ['*'])
     {
@@ -84,6 +113,11 @@ class BizOrderRepository extends BaseRepository
 
     /**
      * 根据商户 ID 和商户订单号加锁查询业务订单。
+     *
+     * @param int $merchantId 商户ID
+     * @param string $merchantOrderNo 商户订单号
+     * @param array $columns 字段列表
+     * @return BizOrder|null 业务订单记录
      */
     public function findForUpdateByMerchantAndOrderNo(int $merchantId, string $merchantOrderNo, array $columns = ['*'])
     {
@@ -96,6 +130,9 @@ class BizOrderRepository extends BaseRepository
 
     /**
      * 统计商户下的业务订单数量。
+     *
+     * @param int $merchantId 商户ID
+     * @return int 整数结果
      */
     public function countByMerchantId(int $merchantId): int
     {
@@ -105,3 +142,7 @@ class BizOrderRepository extends BaseRepository
     }
 }
 
+
+
+
+

app/repository/payment/trade/PayOrderRepository.php

@@ -6,12 +6,16 @@ use app\common\base\BaseRepository;
 use app\model\payment\PayOrder;
 
 /**
- * 支付单仓库。
+ * 支付单基础查询仓库。
+ *
+ * 封装支付单号、业务单号、追踪号和商户请求号等常用查询方法。
  */
 class PayOrderRepository extends BaseRepository
 {
     /**
-     * 构造函数，注入对应模型。
+     * 构造方法。
+     *
+     * @return void
      */
     public function __construct()
     {
@@ -20,6 +24,10 @@ class PayOrderRepository extends BaseRepository
 
     /**
      * 根据支付单号查询支付单。
+     *
+     * @param string $payNo 支付单号
+     * @param array $columns 字段列表
+     * @return PayOrder|null 支付单记录
      */
     public function findByPayNo(string $payNo, array $columns = ['*'])
     {
@@ -30,6 +38,10 @@ class PayOrderRepository extends BaseRepository
 
     /**
      * 根据追踪号查询支付单。
+     *
+     * @param string $traceNo 追踪号
+     * @param array $columns 字段列表
+     * @return PayOrder|null 支付单记录
      */
     public function findByTraceNo(string $traceNo, array $columns = ['*'])
     {
@@ -40,6 +52,10 @@ class PayOrderRepository extends BaseRepository
 
     /**
      * 根据追踪号查询支付单列表。
+     *
+     * @param string $traceNo 追踪号
+     * @param array $columns 字段列表
+     * @return \Illuminate\Database\Eloquent\Collection<int, PayOrder> 支付单列表
      */
     public function listByTraceNo(string $traceNo, array $columns = ['*'])
     {
@@ -52,6 +68,10 @@ class PayOrderRepository extends BaseRepository
 
     /**
      * 根据业务单号查询支付单列表。
+     *
+     * @param string $bizNo 业务单号
+     * @param array $columns 字段列表
+     * @return \Illuminate\Database\Eloquent\Collection<int, PayOrder> 支付单列表
      */
     public function listByBizNo(string $bizNo, array $columns = ['*'])
     {
@@ -64,6 +84,10 @@ class PayOrderRepository extends BaseRepository
 
     /**
      * 根据业务单号查询最新支付单。
+     *
+     * @param string $bizNo 业务单号
+     * @param array $columns 字段列表
+     * @return PayOrder|null 支付单记录
      */
     public function findLatestByBizNo(string $bizNo, array $columns = ['*'])
     {
@@ -75,6 +99,11 @@ class PayOrderRepository extends BaseRepository
 
     /**
      * 根据商户和渠道请求号查询支付单。
+     *
+     * @param int $merchantId 商户ID
+     * @param string $channelRequestNo 渠道Request号
+     * @param array $columns 字段列表
+     * @return PayOrder|null 支付单记录
      */
     public function findByChannelRequestNo(int $merchantId, string $channelRequestNo, array $columns = ['*'])
     {
@@ -86,6 +115,10 @@ class PayOrderRepository extends BaseRepository
 
     /**
      * 根据支付单号加锁查询支付单。
+     *
+     * @param string $payNo 支付单号
+     * @param array $columns 字段列表
+     * @return PayOrder|null 支付单记录
      */
     public function findForUpdateByPayNo(string $payNo, array $columns = ['*'])
     {
@@ -97,6 +130,10 @@ class PayOrderRepository extends BaseRepository
 
     /**
      * 根据追踪号加锁查询支付单。
+     *
+     * @param string $traceNo 追踪号
+     * @param array $columns 字段列表
+     * @return PayOrder|null 支付单记录
      */
     public function findForUpdateByTraceNo(string $traceNo, array $columns = ['*'])
     {
@@ -108,6 +145,10 @@ class PayOrderRepository extends BaseRepository
 
     /**
      * 根据业务单号加锁查询最新支付单。
+     *
+     * @param string $bizNo 业务单号
+     * @param array $columns 字段列表
+     * @return PayOrder|null 支付单记录
      */
     public function findLatestForUpdateByBizNo(string $bizNo, array $columns = ['*'])
     {
@@ -120,6 +161,10 @@ class PayOrderRepository extends BaseRepository
 
     /**
      * 查询商户最近支付单列表，用于总览展示。
+     *
+     * @param int $merchantId 商户ID
+     * @param int $limit 限制条数
+     * @return \Illuminate\Database\Eloquent\Collection<int, PayOrder> 最近支付单列表
      */
     public function recentByMerchantId(int $merchantId, int $limit = 5)
     {
@@ -141,3 +186,7 @@ class PayOrderRepository extends BaseRepository
     }
 }
 
+
+
+
+

app/repository/payment/trade/RefundOrderRepository.php

@@ -6,12 +6,16 @@ use app\common\base\BaseRepository;
 use app\model\payment\RefundOrder;
 
 /**
- * 退款单仓库。
+ * 退款单基础查询仓库。
+ *
+ * 封装退款单号、业务单号、追踪号、支付单号和商户退款号等常用查询方法。
  */
 class RefundOrderRepository extends BaseRepository
 {
     /**
-     * 构造函数，注入对应模型。
+     * 构造方法。
+     *
+     * @return void
      */
     public function __construct()
     {
@@ -20,6 +24,10 @@ class RefundOrderRepository extends BaseRepository
 
     /**
      * 根据退款单号查询退款单。
+     *
+     * @param string $refundNo 退款单号
+     * @param array $columns 字段列表
+     * @return RefundOrder|null 退款单记录
      */
     public function findByRefundNo(string $refundNo, array $columns = ['*'])
     {
@@ -30,6 +38,10 @@ class RefundOrderRepository extends BaseRepository
 
     /**
      * 根据追踪号查询退款单。
+     *
+     * @param string $traceNo 追踪号
+     * @param array $columns 字段列表
+     * @return RefundOrder|null 退款单记录
      */
     public function findByTraceNo(string $traceNo, array $columns = ['*'])
     {
@@ -40,6 +52,10 @@ class RefundOrderRepository extends BaseRepository
 
     /**
      * 根据追踪号查询退款单列表。
+     *
+     * @param string $traceNo 追踪号
+     * @param array $columns 字段列表
+     * @return \Illuminate\Database\Eloquent\Collection<int, RefundOrder> 退款单列表
      */
     public function listByTraceNo(string $traceNo, array $columns = ['*'])
     {
@@ -51,6 +67,10 @@ class RefundOrderRepository extends BaseRepository
 
     /**
      * 根据业务单号查询退款单列表。
+     *
+     * @param string $bizNo 业务单号
+     * @param array $columns 字段列表
+     * @return \Illuminate\Database\Eloquent\Collection<int, RefundOrder> 退款单列表
      */
     public function listByBizNo(string $bizNo, array $columns = ['*'])
     {
@@ -62,6 +82,11 @@ class RefundOrderRepository extends BaseRepository
 
     /**
      * 根据商户退款单号查询退款单。
+     *
+     * @param int $merchantId 商户ID
+     * @param string $merchantRefundNo 商户退款号
+     * @param array $columns 字段列表
+     * @return RefundOrder|null 退款单记录
      */
     public function findByMerchantRefundNo(int $merchantId, string $merchantRefundNo, array $columns = ['*'])
     {
@@ -73,6 +98,10 @@ class RefundOrderRepository extends BaseRepository
 
     /**
      * 根据支付单号查询退款单。
+     *
+     * @param string $payNo 支付单号
+     * @param array $columns 字段列表
+     * @return RefundOrder|null 退款单记录
      */
     public function findByPayNo(string $payNo, array $columns = ['*'])
     {
@@ -83,6 +112,10 @@ class RefundOrderRepository extends BaseRepository
 
     /**
      * 根据退款单号加锁查询退款单。
+     *
+     * @param string $refundNo 退款单号
+     * @param array $columns 字段列表
+     * @return RefundOrder|null 退款单记录
      */
     public function findForUpdateByRefundNo(string $refundNo, array $columns = ['*'])
     {
@@ -94,6 +127,10 @@ class RefundOrderRepository extends BaseRepository
 
     /**
      * 根据追踪号加锁查询退款单。
+     *
+     * @param string $traceNo 追踪号
+     * @param array $columns 字段列表
+     * @return RefundOrder|null 退款单记录
      */
     public function findForUpdateByTraceNo(string $traceNo, array $columns = ['*'])
     {
@@ -105,6 +142,10 @@ class RefundOrderRepository extends BaseRepository
 
     /**
      * 根据支付单号加锁查询退款单。
+     *
+     * @param string $payNo 支付单号
+     * @param array $columns 字段列表
+     * @return RefundOrder|null 退款单记录
      */
     public function findForUpdateByPayNo(string $payNo, array $columns = ['*'])
     {
@@ -116,6 +157,9 @@ class RefundOrderRepository extends BaseRepository
 
     /**
      * 统计商户下的退款订单数量。
+     *
+     * @param int $merchantId 商户ID
+     * @return int 退款订单数量
      */
     public function countByMerchantId(int $merchantId): int
     {
@@ -125,3 +169,7 @@ class RefundOrderRepository extends BaseRepository
     }
 }
 
+
+
+
+