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

app/http/admin/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
     {
@@ -36,3 +44,8 @@ class PayOrderController extends BaseController
     }
 }
 
+
+
+
+
+

app/http/admin/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
     {
@@ -33,6 +44,10 @@ class RefundOrderController extends BaseController
 
     /**
      * 查询退款订单详情。
+     *
+     * @param Request $request 请求对象
+     * @param string $refundNo 退款单号
+     * @return Response 响应对象
      */
     public function show(Request $request, string $refundNo): Response
     {
@@ -41,6 +56,10 @@ class RefundOrderController extends BaseController
 
     /**
      * 重试退款。
+     *
+     * @param Request $request 请求对象
+     * @param string $refundNo 退款单号
+     * @return Response 响应对象
      */
     public function retry(Request $request, string $refundNo): Response
     {
@@ -54,3 +73,8 @@ class RefundOrderController extends BaseController
     }
 }
 
+
+
+
+
+

app/http/admin/controller/trade/SettlementOrderController.php

@@ -11,11 +11,16 @@ use support\Response;
 
 /**
  * 清算订单控制器。
+ *
+ * @property SettlementOrderQueryService $settlementOrderQueryService 结算订单查询服务
  */
 class SettlementOrderController extends BaseController
 {
     /**
-     * 构造函数，注入清算订单服务。
+     * 构造方法。
+     *
+     * @param SettlementOrderQueryService $settlementOrderQueryService 结算订单查询服务
+     * @return void
      */
     public function __construct(
         protected SettlementOrderQueryService $settlementOrderQueryService
@@ -24,6 +29,9 @@ class SettlementOrderController extends BaseController
 
     /**
      * 查询清算订单列表。
+     *
+     * @param Request $request 请求对象
+     * @return Response 响应对象
      */
     public function index(Request $request): Response
     {
@@ -40,6 +48,10 @@ class SettlementOrderController extends BaseController
 
     /**
      * 查询清算订单详情。
+     *
+     * @param Request $request 请求对象
+     * @param string $settleNo 结算单号
+     * @return Response 响应对象
      */
     public function show(Request $request, string $settleNo): Response
     {
@@ -51,3 +63,8 @@ class SettlementOrderController extends BaseController
         }
     }
 }
+
+
+
+
+