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

app/repository/account/balance/MerchantAccountRepository.php

@@ -7,11 +7,15 @@ use app\model\merchant\MerchantAccount;
 
 /**
  * 商户余额账户仓库。
+ *
+ * 封装商户余额账户的单条查询、加锁查询和存在性统计。
  */
 class MerchantAccountRepository extends BaseRepository
 {
     /**
-     * 构造函数，注入对应模型。
+     * 构造方法。
+     *
+     * @return void
      */
     public function __construct()
     {
@@ -20,6 +24,10 @@ class MerchantAccountRepository extends BaseRepository
 
     /**
      * 根据商户 ID 查询余额账户。
+     *
+     * @param int $merchantId 商户ID
+     * @param array $columns 字段列表
+     * @return MerchantAccount|null 账户记录
      */
     public function findByMerchantId(int $merchantId, array $columns = ['*'])
     {
@@ -30,6 +38,10 @@ class MerchantAccountRepository extends BaseRepository
 
     /**
      * 根据商户 ID 加锁查询余额账户。
+     *
+     * @param int $merchantId 商户ID
+     * @param array $columns 字段列表
+     * @return MerchantAccount|null 账户记录
      */
     public function findForUpdateByMerchantId(int $merchantId, array $columns = ['*'])
     {
@@ -41,6 +53,9 @@ class MerchantAccountRepository extends BaseRepository
 
     /**
      * 统计商户是否存在资金账户。
+     *
+     * @param int $merchantId 商户ID
+     * @return int 账户数量
      */
     public function countByMerchantId(int $merchantId): int
     {
@@ -50,3 +65,6 @@ class MerchantAccountRepository extends BaseRepository
     }
 }
 
+
+
+

app/repository/account/ledger/MerchantAccountLedgerRepository.php

@@ -7,11 +7,15 @@ use app\model\merchant\MerchantAccountLedger;
 
 /**
  * 商户余额流水仓库。
+ *
+ * 封装幂等键、追踪号、业务单号和商户维度的流水查询。
  */
 class MerchantAccountLedgerRepository extends BaseRepository
 {
     /**
-     * 构造函数，注入对应模型。
+     * 构造方法。
+     *
+     * @return void
      */
     public function __construct()
     {
@@ -20,6 +24,10 @@ class MerchantAccountLedgerRepository extends BaseRepository
 
     /**
      * 根据幂等键查询流水记录。
+     *
+     * @param string $idempotencyKey 幂等键
+     * @param array $columns 字段列表
+     * @return MerchantAccountLedger|null 流水记录
      */
     public function findByIdempotencyKey(string $idempotencyKey, array $columns = ['*'])
     {
@@ -30,6 +38,10 @@ class MerchantAccountLedgerRepository extends BaseRepository
 
     /**
      * 根据追踪号查询流水记录。
+     *
+     * @param string $traceNo 追踪号
+     * @param array $columns 字段列表
+     * @return MerchantAccountLedger|null 流水记录
      */
     public function findByTraceNo(string $traceNo, array $columns = ['*'])
     {
@@ -41,6 +53,10 @@ class MerchantAccountLedgerRepository extends BaseRepository
 
     /**
      * 查询指定追踪号的流水列表。
+     *
+     * @param string $traceNo 追踪号
+     * @param array $columns 字段列表
+     * @return \Illuminate\Database\Eloquent\Collection<int, MerchantAccountLedger> 流水列表
      */
     public function listByTraceNo(string $traceNo, array $columns = ['*'])
     {
@@ -50,11 +66,12 @@ class MerchantAccountLedgerRepository extends BaseRepository
             ->get($columns);
     }
 
-    /**
-     * 查询商户指定业务类型和业务单号的流水列表。
-     */
     /**
      * 查询指定业务单号的流水列表。
+     *
+     * @param string $bizNo 业务单号
+     * @param array $columns 字段列表
+     * @return \Illuminate\Database\Eloquent\Collection<int, MerchantAccountLedger> 流水列表
      */
     public function listByBizNo(string $bizNo, array $columns = ['*'])
     {
@@ -64,6 +81,15 @@ class MerchantAccountLedgerRepository extends BaseRepository
             ->get($columns);
     }
 
+    /**
+     * 按商户、业务类型和业务单号查询流水列表。
+     *
+     * @param int $merchantId 商户ID
+     * @param int $bizType 业务类型
+     * @param string $bizNo 业务单号
+     * @param array $columns 字段列表
+     * @return \Illuminate\Database\Eloquent\Collection<int, MerchantAccountLedger> 流水列表
+     */
     public function listByMerchantAndBiz(int $merchantId, int $bizType, string $bizNo, array $columns = ['*'])
     {
         return $this->model->newQuery()
@@ -76,3 +102,6 @@ class MerchantAccountLedgerRepository extends BaseRepository
 }
 
 
+
+
+

app/repository/file/FileRecordRepository.php

@@ -6,15 +6,29 @@ use app\common\base\BaseRepository;
 use app\model\file\FileRecord;
 
 /**
- * 文件仓储。
+ * 文件记录仓储。
+ *
+ * 封装文件资产表的基础查询方法。
  */
 class FileRecordRepository extends BaseRepository
 {
+    /**
+     * 构造方法。
+     *
+     * @return void
+     */
     public function __construct()
     {
         parent::__construct(new FileRecord());
     }
 
+    /**
+     * 按 ID 查询文件记录。
+     *
+     * @param int $id 文件记录ID
+     * @param array $columns 字段列表
+     * @return FileRecord|null 文件记录
+     */
     public function findById(int $id, array $columns = ['*']): ?FileRecord
     {
         $model = $this->find($id, $columns);
@@ -22,3 +36,6 @@ class FileRecordRepository extends BaseRepository
         return $model instanceof FileRecord ? $model : null;
     }
 }
+
+
+

app/repository/merchant/base/MerchantGroupRepository.php

@@ -7,11 +7,15 @@ use app\model\merchant\MerchantGroup;
 
 /**
  * 商户分组仓库。
+ *
+ * 封装商户分组启用列表和唯一性检查。
  */
 class MerchantGroupRepository extends BaseRepository
 {
     /**
-     * 构造函数，注入对应模型。
+     * 构造方法。
+     *
+     * @return void
      */
     public function __construct()
     {
@@ -20,6 +24,9 @@ class MerchantGroupRepository extends BaseRepository
 
     /**
      * 获取所有启用的商户分组。
+     *
+     * @param array $columns 字段列表
+     * @return \Illuminate\Database\Eloquent\Collection<int, MerchantGroup> 启用分组列表
      */
     public function enabledList(array $columns = ['*'])
     {
@@ -31,6 +38,10 @@ class MerchantGroupRepository extends BaseRepository
 
     /**
      * 判断分组名称是否已存在。
+     *
+     * @param string $groupName 分组名称
+     * @param int $ignoreId 需要排除的记录ID
+     * @return bool 是否存在
      */
     public function existsByGroupName(string $groupName, int $ignoreId = 0): bool
     {
@@ -45,3 +56,7 @@ class MerchantGroupRepository extends BaseRepository
     }
 }
 
+
+
+
+

app/repository/merchant/base/MerchantPolicyRepository.php

@@ -7,11 +7,15 @@ use app\model\merchant\MerchantPolicy;
 
 /**
  * 商户策略仓库。
+ *
+ * 封装商户策略的基础查询。
  */
 class MerchantPolicyRepository extends BaseRepository
 {
     /**
-     * 构造函数，注入对应模型。
+     * 构造方法。
+     *
+     * @return void
      */
     public function __construct()
     {
@@ -20,6 +24,10 @@ class MerchantPolicyRepository extends BaseRepository
 
     /**
      * 根据商户 ID 查询商户策略。
+     *
+     * @param int $merchantId 商户ID
+     * @param array $columns 字段列表
+     * @return MerchantPolicy|null 策略记录
      */
     public function findByMerchantId(int $merchantId, array $columns = ['*'])
     {
@@ -30,3 +38,7 @@ class MerchantPolicyRepository extends BaseRepository
 }
 
 
+
+
+
+

app/repository/merchant/base/MerchantRepository.php

@@ -6,12 +6,16 @@ use app\common\base\BaseRepository;
 use app\model\merchant\Merchant;
 
 /**
- * 商户仓库。
+ * 商户基础查询仓库。
+ *
+ * 封装按商户号、启用状态等基础条件读取商户记录的方法。
  */
 class MerchantRepository extends BaseRepository
 {
     /**
-     * 构造函数，注入对应模型。
+     * 构造方法。
+     *
+     * @return void
      */
     public function __construct()
     {
@@ -20,6 +24,10 @@ class MerchantRepository extends BaseRepository
 
     /**
      * 根据商户编号查询商户。
+     *
+     * @param string $merchantNo 商户号
+     * @param array $columns 字段列表
+     * @return Merchant|null 商户记录
      */
     public function findByMerchantNo(string $merchantNo, array $columns = ['*']): ?Merchant
     {
@@ -30,6 +38,9 @@ class MerchantRepository extends BaseRepository
 
     /**
      * 获取所有启用的商户。
+     *
+     * @param array $columns 字段列表
+     * @return \Illuminate\Database\Eloquent\Collection<int, Merchant> 启用商户列表
      */
     public function enabledList(array $columns = ['*'])
     {
@@ -41,3 +52,9 @@ class MerchantRepository extends BaseRepository
 }
 
 
+
+
+
+
+
+

app/repository/merchant/credential/MerchantApiCredentialRepository.php

@@ -7,11 +7,15 @@ use app\model\merchant\MerchantApiCredential;
 
 /**
  * 商户 API 凭证仓库。
+ *
+ * 封装商户 API 凭证的单条查询与存在性统计。
  */
 class MerchantApiCredentialRepository extends BaseRepository
 {
     /**
-     * 构造函数，注入对应模型。
+     * 构造方法。
+     *
+     * @return void
      */
     public function __construct()
     {
@@ -20,6 +24,10 @@ class MerchantApiCredentialRepository extends BaseRepository
 
     /**
      * 根据商户 ID 查询 API 凭证。
+     *
+     * @param int $merchantId 商户ID
+     * @param array $columns 字段列表
+     * @return MerchantApiCredential|null 凭证记录
      */
     public function findByMerchantId(int $merchantId, array $columns = ['*']): ?MerchantApiCredential
     {
@@ -30,6 +38,9 @@ class MerchantApiCredentialRepository extends BaseRepository
 
     /**
      * 统计商户是否已开通 API 凭证。
+     *
+     * @param int $merchantId 商户ID
+     * @return int 凭证数量
      */
     public function countByMerchantId(int $merchantId): int
     {
@@ -39,3 +50,6 @@ class MerchantApiCredentialRepository extends BaseRepository
     }
 }
 
+
+
+

app/repository/ops/log/ChannelNotifyLogRepository.php

@@ -7,11 +7,15 @@ use app\model\admin\ChannelNotifyLog;
 
 /**
  * 渠道通知日志仓库。
+ *
+ * 封装通知单号查询与重复通知识别。
  */
 class ChannelNotifyLogRepository extends BaseRepository
 {
     /**
-     * 构造函数，注入对应模型。
+     * 构造方法。
+     *
+     * @return void
      */
     public function __construct()
     {
@@ -20,6 +24,10 @@ class ChannelNotifyLogRepository extends BaseRepository
 
     /**
      * 根据通知单号查询渠道通知日志。
+     *
+     * @param string $notifyNo 通知号
+     * @param array $columns 字段列表
+     * @return ChannelNotifyLog|null 日志记录
      */
     public function findByNotifyNo(string $notifyNo, array $columns = ['*'])
     {
@@ -30,6 +38,12 @@ class ChannelNotifyLogRepository extends BaseRepository
 
     /**
      * 根据渠道、通知类型和业务单号查询重复通知记录。
+     *
+     * @param int $channelId 渠道ID
+     * @param int $notifyType 通知类型
+     * @param string $bizNo 业务单号
+     * @param array $columns 字段列表
+     * @return ChannelNotifyLog|null 日志记录
      */
     public function findDuplicate(int $channelId, int $notifyType, string $bizNo, array $columns = ['*'])
     {
@@ -42,3 +56,7 @@ class ChannelNotifyLogRepository extends BaseRepository
 }
 
 
+
+
+
+

app/repository/ops/log/PayCallbackLogRepository.php

@@ -7,11 +7,15 @@ use app\model\admin\PayCallbackLog;
 
 /**
  * 支付回调日志仓库。
+ *
+ * 封装按支付单号查询回调日志列表。
  */
 class PayCallbackLogRepository extends BaseRepository
 {
     /**
-     * 构造函数，注入对应模型。
+     * 构造方法。
+     *
+     * @return void
      */
     public function __construct()
     {
@@ -20,6 +24,10 @@ class PayCallbackLogRepository extends BaseRepository
 
     /**
      * 根据支付单号查询回调日志列表。
+     *
+     * @param string $payNo 支付单号
+     * @param array $columns 字段列表
+     * @return \Illuminate\Database\Eloquent\Collection<int, PayCallbackLog> 回调日志列表
      */
     public function listByPayNo(string $payNo, array $columns = ['*'])
     {
@@ -31,3 +39,7 @@ class PayCallbackLogRepository extends BaseRepository
 }
 
 
+
+
+
+

app/repository/ops/stat/ChannelDailyStatRepository.php

@@ -7,11 +7,15 @@ use app\model\admin\ChannelDailyStat;
 
 /**
  * 通道日统计仓库。
+ *
+ * 封装按通道和日期读取日统计记录。
  */
 class ChannelDailyStatRepository extends BaseRepository
 {
     /**
-     * 构造函数，注入对应模型。
+     * 构造方法。
+     *
+     * @return void
      */
     public function __construct()
     {
@@ -20,6 +24,11 @@ class ChannelDailyStatRepository extends BaseRepository
 
     /**
      * 根据通道和日期查询统计记录。
+     *
+     * @param int $channelId 渠道ID
+     * @param string $statDate 统计日期
+     * @param array $columns 字段列表
+     * @return ChannelDailyStat|null 统计记录
      */
     public function findByChannelAndDate(int $channelId, string $statDate, array $columns = ['*'])
     {
@@ -31,3 +40,7 @@ class ChannelDailyStatRepository extends BaseRepository
 }
 
 
+
+
+
+

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
     }
 }
 
+
+
+
+

app/repository/system/config/SystemConfigRepository.php

@@ -11,10 +11,17 @@ use app\model\system\SystemConfig;
 class SystemConfigRepository extends BaseRepository
 {
     /**
-     * 构造函数，注入对应模型。
+     * 构造方法。
+     *
+     * @return void
      */
     public function __construct()
     {
         parent::__construct(new SystemConfig());
     }
 }
+
+
+
+
+

app/repository/system/user/AdminUserRepository.php

@@ -7,11 +7,15 @@ use app\model\admin\AdminUser;
 
 /**
  * 管理员账号仓库。
+ *
+ * 封装管理员用户名查询等基础读方法。
  */
 class AdminUserRepository extends BaseRepository
 {
     /**
-     * 构造函数，注入对应模型。
+     * 构造方法。
+     *
+     * @return void
      */
     public function __construct()
     {
@@ -20,6 +24,10 @@ class AdminUserRepository extends BaseRepository
 
     /**
      * 根据用户名查询管理员。
+     *
+     * @param string $username 用户名
+     * @param array $columns 字段列表
+     * @return AdminUser|null 管理员记录
      */
     public function findByUsername(string $username, array $columns = ['*']): ?AdminUser
     {
@@ -30,3 +38,7 @@ class AdminUserRepository extends BaseRepository
 }
 
 
+
+
+
+