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

app/http/mer/controller/trade/PayOrderController.php

@@ -12,11 +12,16 @@ use support\Response;
  * 商户后台支付订单控制器。
  *
  * 商户后台只能看到当前登录商户自己的支付订单。
+ *
+ * @property PayOrderService $payOrderService 支付订单服务
  */
 class PayOrderController extends BaseController
 {
     /**
-     * 构造函数，注入支付订单服务。
+     * 构造方法。
+     *
+     * @param PayOrderService $payOrderService 支付订单服务
+     * @return void
      */
     public function __construct(
         protected PayOrderService $payOrderService
@@ -25,6 +30,9 @@ class PayOrderController extends BaseController
 
     /**
      * 查询当前商户的支付订单列表。
+     *
+     * @param Request $request 请求对象
+     * @return Response 响应对象
      */
     public function index(Request $request): Response
     {
@@ -42,3 +50,8 @@ class PayOrderController extends BaseController
     }
 }
 
+
+
+
+
+

app/http/mer/controller/trade/RefundOrderController.php

@@ -11,9 +11,17 @@ use support\Response;
 
 /**
  * 商户后台退款订单控制器。
+ *
+ * @property RefundService $refundService 退款服务
  */
 class RefundOrderController extends BaseController
 {
+    /**
+ * 构造方法。
+     *
+     * @param RefundService $refundService 退款服务
+     * @return void
+     */
     public function __construct(
         protected RefundService $refundService
     ) {
@@ -21,6 +29,9 @@ class RefundOrderController extends BaseController
 
     /**
      * 查询当前商户的退款订单列表。
+     *
+     * @param Request $request 请求对象
+     * @return Response 响应对象
      */
     public function index(Request $request): Response
     {
@@ -39,6 +50,10 @@ class RefundOrderController extends BaseController
 
     /**
      * 查询当前商户的退款订单详情。
+     *
+     * @param Request $request 请求对象
+     * @param string $refundNo 退款单号
+     * @return Response 响应对象
      */
     public function show(Request $request, string $refundNo): Response
     {
@@ -52,6 +67,10 @@ class RefundOrderController extends BaseController
 
     /**
      * 重试当前商户的退款单。
+     *
+     * @param Request $request 请求对象
+     * @param string $refundNo 退款单号
+     * @return Response 响应对象
      */
     public function retry(Request $request, string $refundNo): Response
     {
@@ -70,3 +89,8 @@ class RefundOrderController extends BaseController
     }
 }
 
+
+
+
+
+