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

app/http/mer/controller/system/AuthController.php

@@ -10,14 +10,28 @@ use support\Response;
 
 /**
  * 商户认证控制器。
+ *
+ * @property MerchantAuthService $merchantAuthService 商户认证服务
  */
 class AuthController extends BaseController
 {
+    /**
+ * 构造方法。
+     *
+     * @param MerchantAuthService $merchantAuthService 商户认证服务
+     * @return void
+     */
     public function __construct(
         protected MerchantAuthService $merchantAuthService
     ) {
     }
 
+    /**
+     * 商户登录。
+     *
+     * @param Request $request 请求对象
+     * @return Response 响应对象
+     */
     public function login(Request $request): Response
     {
         $data = $this->validated($request->all(), AuthValidator::class, 'login');
@@ -30,6 +44,12 @@ class AuthController extends BaseController
         ));
     }
 
+    /**
+     * 商户退出登录。
+     *
+     * @param Request $request 请求对象
+     * @return Response 响应对象
+     */
     public function logout(Request $request): Response
     {
         $token = trim((string) ($request->header('authorization', '') ?: $request->header('x-merchant-token', '')));
@@ -45,7 +65,10 @@ class AuthController extends BaseController
     }
 
     /**
-     * 获取当前登录商户的信息
+     * 获取当前登录商户信息。
+     *
+     * @param Request $request 请求对象
+     * @return Response 响应对象
      */
     public function profile(Request $request): Response
     {
@@ -59,3 +82,8 @@ class AuthController extends BaseController
     }
 }
 
+
+
+
+
+

app/http/mer/controller/system/SystemController.php

@@ -9,22 +9,47 @@ use support\Response;
 
 /**
  * 商户后台系统数据控制器。
+ *
+ * @property SystemBootstrapService $systemBootstrapService 系统引导服务
  */
 class SystemController extends BaseController
 {
+    /**
+ * 构造方法。
+     *
+     * @param SystemBootstrapService $systemBootstrapService 系统引导服务
+     * @return void
+     */
     public function __construct(
         protected SystemBootstrapService $systemBootstrapService
     ) {
     }
 
+    /**
+     * 获取系统菜单树
+     *
+     * @param Request $request 请求对象
+     * @return Response 响应对象
+     */
     public function menuTree(Request $request): Response
     {
         return $this->success($this->systemBootstrapService->getMenuTree('merchant'));
     }
 
+    /**
+     * 获取系统字典项
+     *
+     * @param Request $request 请求对象
+     * @return Response 响应对象
+     */
     public function dictItems(Request $request): Response
     {
         return $this->success($this->systemBootstrapService->getDictItems((string) $request->get('code', '')));
     }
 }
 
+
+
+
+
+