2
0

ChannelController.php 4.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123
  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\IndexChannelRequest;
  6. use App\Http\Requests\V3\UpdateChannelRequest;
  7. use App\Http\Resources\V3\ChannelResource;
  8. use App\Models\Channel;
  9. use App\Services\V3\ChannelService;
  10. use Illuminate\Http\Request;
  11. /**
  12. * channel:公开目录、详情、改信息、删除。
  13. *
  14. * 取代 `GET /v2/channel?view=public|system`、`GET|PUT|PATCH|DELETE /v2/channel/{channel}`
  15. * (`ChannelController`)。某个 studio 的列表与新建见 {@see StudioChannelController},
  16. * 我能写的见 {@see EditableChannelController}。v2 那份在 dashboard-v4 下线前原样保留,不要改动。
  17. *
  18. * channels 表不支持 AI 模型代写(2026-11-16 定):模型 token 调改、删一律 403。
  19. */
  20. class ChannelController extends Controller
  21. {
  22. use ResolvesCurrentUser;
  23. public function __construct(private readonly ChannelService $channels) {}
  24. /**
  25. * 公开 channel 目录
  26. *
  27. * 只列全网公开的。`system=true` 只要系统 channel——系统 channel 是全站共用的原文、术语等,
  28. * 不论 status 都列(巴利原文 `_System_Pali_VRI_` 就是 status 10)。带 `book` + `para` 时每条多返回该章的完成度
  29. * `progress`,并可按它排序。
  30. *
  31. * @unauthenticated
  32. *
  33. * @queryParam system boolean 只列系统 channel
  34. * @queryParam search string 按名字模糊匹配
  35. * @queryParam type string channel 类型。Enum: translation,nissaya,original,wbw,commentary,similar
  36. * @queryParam lang string 语言
  37. * @queryParam book integer 章节所在的书(与 para 同时给)
  38. * @queryParam para integer 章节起始段(与 book 同时给)
  39. * @queryParam order string 排序字段。Enum: updated_at,created_at,name,progress Default: updated_at
  40. * @queryParam dir string 排序方向。Enum: asc,desc Default: desc
  41. * @queryParam page integer 页码。Default: 1
  42. * @queryParam per_page integer 每页数量,最大 200。Default: 20
  43. */
  44. public function index(IndexChannelRequest $request)
  45. {
  46. $filters = $request->safe()->except(['system', 'page', 'per_page']);
  47. $filters['system'] = $request->boolean('system');
  48. return ChannelResource::collection($this->channels->listPublic(
  49. $filters,
  50. $this->currentUserUid($request),
  51. $request->integer('per_page', 20),
  52. ));
  53. }
  54. /**
  55. * channel 详情
  56. *
  57. * 公开的谁都能看;私有的只有拥有者、团队成员、被共享的人能看。带查看者的 `abilities`。
  58. *
  59. * @unauthenticated
  60. *
  61. * @urlParam channel string required channel uid
  62. *
  63. * @responseStatus 403 私有 channel,且看不见
  64. */
  65. public function show(Request $request, Channel $channel)
  66. {
  67. return ChannelResource::make($this->channels->show($channel, $this->currentUserUid($request)));
  68. }
  69. /**
  70. * 改 channel 信息
  71. *
  72. * 只改传了的字段。拥有者;团队的 channel 由团队 owner / manager / editor 改;共享权限 ≥30 也能改。
  73. * 系统 channel 不能改。AI 模型不能改。
  74. *
  75. * @urlParam channel string required channel uid
  76. *
  77. * @bodyParam name string 名字,最长 128;同一 studio 内不能重名
  78. * @bodyParam type string 类型。Enum: translation,nissaya,original,wbw,commentary,similar
  79. * @bodyParam lang string 语言,最长 16
  80. * @bodyParam summary string 简介,最长 1024
  81. * @bodyParam status integer 10 私有、20 公开不列出(拿到链接能看,不进任何公开列表)、30 公开
  82. * @bodyParam source_type string 来源。Enum: original,reprint,ai
  83. * @bodyParam source_id string 来源 id
  84. * @bodyParam config object 配置
  85. *
  86. * @responseStatus 403 不能修改
  87. */
  88. public function update(UpdateChannelRequest $request, Channel $channel)
  89. {
  90. return ChannelResource::make($this->channels->update(
  91. $channel,
  92. $this->currentUser($request)['user_uid'],
  93. $request->validated(),
  94. ));
  95. }
  96. /**
  97. * 删除 channel
  98. *
  99. * 软删除,返回被删的 channel。个人 channel 由拥有者删,团队的只有团队 owner 能删。
  100. * channel 下已有译文、术语或逐词时拒绝(409,`content` 列出有哪几类)。系统 channel 不能删。
  101. *
  102. * @urlParam channel string required channel uid
  103. *
  104. * @responseStatus 403 不能删除
  105. * @responseStatus 409 channel 下还有内容
  106. */
  107. public function destroy(Request $request, Channel $channel)
  108. {
  109. return ChannelResource::make($this->channels->delete(
  110. $channel,
  111. $this->currentUser($request)['user_uid'],
  112. ));
  113. }
  114. }