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

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