TipitakaChannelController.php 1.6 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344
  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\IndexTipitakaChannelRequest;
  6. use App\Http\Resources\V3\TipitakaChannelResource;
  7. use App\Services\V3\TipitakaChannelService;
  8. /**
  9. * 有译文的公开 channel 目录(mobile 发现页「译本合集」)。
  10. *
  11. * 取代 `GET /v2/progress?view=channel`(`ProgressChapterController@index`)。v2 那份在 dashboard-v4
  12. * 下线前原样保留,不要改动。
  13. */
  14. class TipitakaChannelController extends Controller
  15. {
  16. use ResolvesCurrentUser;
  17. public function __construct(private readonly TipitakaChannelService $channels) {}
  18. /**
  19. * 列出有译文的公开 channel
  20. *
  21. * 只列公开的、有完成度过门槛的章节的 channel,按章节数降序,每条带 `chapter_count`。
  22. *
  23. * @unauthenticated
  24. *
  25. * @queryParam type string channel 类型。Enum: translation,nissaya,original,wbw,commentary,similar
  26. * @queryParam lang string 译文语族(progress_chapters.lang,zh 涵盖简繁)。Example: zh
  27. * @queryParam min_progress number 章节完成度门槛 0–1。Default: 0.8
  28. * @queryParam page integer 页码。Default: 1
  29. * @queryParam per_page integer 每页数量,最大 200。Default: 20
  30. */
  31. public function __invoke(IndexTipitakaChannelRequest $request)
  32. {
  33. return TipitakaChannelResource::collection($this->channels->withChapters(
  34. $request->safe()->only(['type', 'lang', 'min_progress']),
  35. $this->currentUserUid($request),
  36. $request->integer('per_page', 20),
  37. ));
  38. }
  39. }