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

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();
     }
 }
+
+
+
+