2
0

MeReadingTimeController.php 1.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142
  1. <?php
  2. namespace App\Http\Controllers\V3;
  3. use App\Http\Controllers\Concerns\ResolvesCurrentUser;
  4. use App\Http\Controllers\Controller;
  5. use App\Http\Requests\V3\StoreMeReadingTimeRequest;
  6. use App\Http\Resources\V3\ReadingTimeResource;
  7. use App\Services\V3\ReadingTimeService;
  8. /**
  9. * 当前登录用户的读经时长上报。读经时长按积分策略换成 AI 对话积分(游客不计)。
  10. *
  11. * 新资源,没有 v2 前身。
  12. */
  13. class MeReadingTimeController extends Controller
  14. {
  15. use ResolvesCurrentUser;
  16. public function __construct(private readonly ReadingTimeService $readingTime) {}
  17. /**
  18. * 上报一段读经时长
  19. *
  20. * 客户端在阅读器前台、且最近有滚动或翻页时计时,每 5 分钟或切后台时上报一次。
  21. * 服务端按墙钟时间核减(当天计入的不超过距上次上报经过的时间),单日不超过 24 小时;
  22. * 断网补报可带 `day`,最多 2 天前。返回这一天累计计入的秒数。
  23. *
  24. * @bodyParam seconds integer required 这段的读经秒数,1–900
  25. * @bodyParam day string 归属的 UTC 日(Y-m-d),缺省为今天。断网补报用
  26. */
  27. public function store(StoreMeReadingTimeRequest $request)
  28. {
  29. $data = $request->validated();
  30. return ReadingTimeResource::make($this->readingTime->report(
  31. $this->currentUser($request)['user_uid'],
  32. (int) $data['seconds'],
  33. $data['day'] ?? null,
  34. ));
  35. }
  36. }