AdminReadingStatsResource.php 1.6 KB

12345678910111213141516171819202122232425262728293031323334
  1. <?php
  2. namespace App\Http\Resources\V3;
  3. use App\Services\V3\ReadingStatsService;
  4. use Illuminate\Http\Request;
  5. /**
  6. * 管理后台阅读统计(一次返回整页数据)。口径见 {@see ReadingStatsService}。
  7. *
  8. * client=web 时读经时长相关字段为 null / 空(Web 没有计时);client=mobile 时章节浏览为 null。
  9. */
  10. class AdminReadingStatsResource extends BaseResource
  11. {
  12. /**
  13. * @param Request $request
  14. * @return array{
  15. * range: array{from: string, to: string, client: string},
  16. * summary: array{active_readers: int, chapters_opened: int, reading_seconds: int|null, reading_users: int|null, page_views: int|null, dict_lookups: int},
  17. * previous: array{active_readers: int, chapters_opened: int, reading_seconds: int|null, reading_users: int|null, page_views: int|null, dict_lookups: int},
  18. * sticky: array{dau: int, mau: int},
  19. * daily: array<int, array{date: string, readers_web: int, readers_mobile: int, reading_minutes: int, page_views: int, dict_lookups: int}>,
  20. * top_chapters: array<int, array{article_id: string, book: int, paragraph: int, title: string, collection: string|null, readers: int, records: int}>,
  21. * pitaka_share: array<int, array{tag: string, records: int}>,
  22. * layer_share: array<int, array{tag: string, records: int}>,
  23. * duration_buckets: array<int, array{bucket: string, user_days: int}>,
  24. * reading_credits: array{credits: int, users: int, capped_user_days: int, clamped_ratio: float}|null
  25. * }
  26. */
  27. public function toArray($request): array
  28. {
  29. return $this->resource;
  30. }
  31. }