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

app/service/ops/log/ChannelNotifyLogService.php

@@ -9,11 +9,18 @@ use app\repository\ops\log\ChannelNotifyLogRepository;
 
 /**
  * 渠道通知日志查询服务。
+ *
+ * 负责查询渠道通知记录、补充展示字段和还原通知处理状态。
+ *
+ * @property ChannelNotifyLogRepository $channelNotifyLogRepository 渠道通知日志仓库
  */
 class ChannelNotifyLogService extends BaseService
 {
     /**
-     * 构造函数，注入渠道通知日志仓库。
+     * 构造方法。
+     *
+     * @param ChannelNotifyLogRepository $channelNotifyLogRepository 渠道通知日志仓库
+     * @return void
      */
     public function __construct(
         protected ChannelNotifyLogRepository $channelNotifyLogRepository
@@ -22,6 +29,11 @@ class ChannelNotifyLogService extends BaseService
 
     /**
      * 分页查询渠道通知日志。
+     *
+     * @param array $filters 筛选条件
+     * @param int $page 页码
+     * @param int $pageSize 每页条数
+     * @return \Illuminate\Contracts\Pagination\LengthAwarePaginator 分页结果
      */
     public function paginate(array $filters = [], int $page = 1, int $pageSize = 10)
     {
@@ -84,7 +96,10 @@ class ChannelNotifyLogService extends BaseService
     }
 
     /**
-     * 按 ID 查询详情。
+     * 按 ID 查询渠道通知日志详情。
+     *
+     * @param int $id 渠道通知日志ID
+     * @return ChannelNotifyLog|null 日志模型
      */
     public function findById(int $id): ?ChannelNotifyLog
     {
@@ -97,6 +112,9 @@ class ChannelNotifyLogService extends BaseService
 
     /**
      * 格式化单条记录。
+     *
+     * @param object $row 查询结果对象
+     * @return object 格式化后的对象
      */
     private function decorateRow(object $row): object
     {
@@ -113,6 +131,8 @@ class ChannelNotifyLogService extends BaseService
 
     /**
      * 构建基础查询。
+     *
+     * @return \Illuminate\Database\Eloquent\Builder 查询构造器
      */
     private function baseQuery()
     {
@@ -152,3 +172,6 @@ class ChannelNotifyLogService extends BaseService
     }
 
 }
+
+
+

app/service/ops/log/PayCallbackLogService.php

@@ -9,11 +9,18 @@ use app\repository\ops\log\PayCallbackLogRepository;
 
 /**
  * 支付回调日志查询服务。
+ *
+ * 负责查询支付回调记录、补充展示字段和还原回调处理状态。
+ *
+ * @property PayCallbackLogRepository $payCallbackLogRepository 支付回调日志仓库
  */
 class PayCallbackLogService extends BaseService
 {
     /**
-     * 构造函数，注入支付回调日志仓库。
+     * 构造方法。
+     *
+     * @param PayCallbackLogRepository $payCallbackLogRepository 支付回调日志仓库
+     * @return void
      */
     public function __construct(
         protected PayCallbackLogRepository $payCallbackLogRepository
@@ -22,6 +29,11 @@ class PayCallbackLogService extends BaseService
 
     /**
      * 分页查询支付回调日志。
+     *
+     * @param array $filters 筛选条件
+     * @param int $page 页码
+     * @param int $pageSize 每页条数
+     * @return \Illuminate\Contracts\Pagination\LengthAwarePaginator 分页结果
      */
     public function paginate(array $filters = [], int $page = 1, int $pageSize = 10)
     {
@@ -79,7 +91,10 @@ class PayCallbackLogService extends BaseService
     }
 
     /**
-     * 按 ID 查询详情。
+     * 按 ID 查询支付回调日志详情。
+     *
+     * @param int $id 支付回调日志ID
+     * @return PayCallbackLog|null 日志模型
      */
     public function findById(int $id): ?PayCallbackLog
     {
@@ -92,6 +107,9 @@ class PayCallbackLogService extends BaseService
 
     /**
      * 格式化单条记录。
+     *
+     * @param object $row 查询结果对象
+     * @return object 格式化后的对象
      */
     private function decorateRow(object $row): object
     {
@@ -107,6 +125,8 @@ class PayCallbackLogService extends BaseService
 
     /**
      * 构建基础查询。
+     *
+     * @return \Illuminate\Database\Eloquent\Builder 查询构造器
      */
     private function baseQuery()
     {
@@ -139,3 +159,6 @@ class PayCallbackLogService extends BaseService
     }
 
 }
+
+
+

app/service/ops/stat/ChannelDailyStatService.php

@@ -8,11 +8,18 @@ use app\repository\ops\stat\ChannelDailyStatRepository;
 
 /**
  * 通道日统计查询服务。
+ *
+ * 负责渠道日统计列表、详情和展示字段补充。
+ *
+ * @property ChannelDailyStatRepository $channelDailyStatRepository 渠道日统计仓库
  */
 class ChannelDailyStatService extends BaseService
 {
     /**
-     * 构造函数，注入通道日统计仓库。
+     * 构造方法。
+     *
+     * @param ChannelDailyStatRepository $channelDailyStatRepository 渠道日统计仓库
+     * @return void
      */
     public function __construct(
         protected ChannelDailyStatRepository $channelDailyStatRepository
@@ -21,6 +28,11 @@ class ChannelDailyStatService extends BaseService
 
     /**
      * 分页查询通道日统计。
+     *
+     * @param array $filters 筛选条件
+     * @param int $page 页码
+     * @param int $pageSize 每页条数
+     * @return \Illuminate\Contracts\Pagination\LengthAwarePaginator 分页结果
      */
     public function paginate(array $filters = [], int $page = 1, int $pageSize = 10)
     {
@@ -67,7 +79,10 @@ class ChannelDailyStatService extends BaseService
     }
 
     /**
-     * 按 ID 查询详情。
+     * 按 ID 查询渠道日统计详情。
+     *
+     * @param int $id 渠道日统计ID
+     * @return ChannelDailyStat|null 统计模型
      */
     public function findById(int $id): ?ChannelDailyStat
     {
@@ -80,6 +95,9 @@ class ChannelDailyStatService extends BaseService
 
     /**
      * 格式化单条统计记录。
+     *
+     * @param object $row 查询结果对象
+     * @return object 格式化后的对象
      */
     private function decorateRow(object $row): object
     {
@@ -96,6 +114,8 @@ class ChannelDailyStatService extends BaseService
 
     /**
      * 构建基础查询。
+     *
+     * @return \Illuminate\Database\Eloquent\Builder 查询构造器
      */
     private function baseQuery()
     {
@@ -130,3 +150,7 @@ class ChannelDailyStatService extends BaseService
     }
 
 }
+
+
+
+