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

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