AdminReadingStatsController.php 1.4 KB

123456789101112131415161718192021222324252627282930313233343536
  1. <?php
  2. namespace App\Http\Controllers\V3;
  3. use App\Http\Controllers\Controller;
  4. use App\Http\Requests\V3\ShowAdminStatsRequest;
  5. use App\Http\Resources\V3\AdminReadingStatsResource;
  6. use App\Services\V3\ReadingStatsService;
  7. use App\Services\V3\StatsRange;
  8. /**
  9. * 管理后台阅读统计(单例资源,仅 root / administrator)。新资源,没有 v2 前身。
  10. */
  11. class AdminReadingStatsController extends Controller
  12. {
  13. public function __construct(private readonly ReadingStatsService $stats) {}
  14. /**
  15. * 阅读统计
  16. *
  17. * 一次返回整页:指标(含上一同长区间作对比)、日活 / 月活、每日序列、热门章节、
  18. * 三藏与根本·义注·复注分布、读经时长分布、读经积分。结果缓存 10 分钟。
  19. * 口径:活跃读者来自阅读记录(recents,只有登录用户);读经时长只有 App;
  20. * 章节浏览(views)含游客与搜索引擎爬虫。
  21. *
  22. * @queryParam from string 起始日(UTC,Y-m-d)。Default: 今天往前 29 天
  23. * @queryParam to string 结束日(UTC,Y-m-d,含当天)。Default: 今天
  24. * @queryParam client string 客户端。Enum: all,web,mobile。Default: all
  25. */
  26. public function __invoke(ShowAdminStatsRequest $request)
  27. {
  28. [$from, $to] = StatsRange::resolve($request->validated());
  29. return AdminReadingStatsResource::make($this->stats->stats($from, $to, $request->validated('client', 'all')));
  30. }
  31. }