2
0

GroupController.php 3.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121
  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\IndexGroupRequest;
  6. use App\Http\Requests\V3\StoreGroupRequest;
  7. use App\Http\Requests\V3\UpdateGroupRequest;
  8. use App\Http\Resources\V3\GroupResource;
  9. use App\Models\GroupInfo;
  10. use App\Services\V3\GroupService;
  11. use Illuminate\Http\Request;
  12. /**
  13. * 团队本身:搜公开团队、详情、建、改、删。
  14. *
  15. * 取代 `GET /v2/group?view=all`、`GET|POST|PUT|DELETE /v2/group(/{id})`(`GroupController`)。
  16. * 「我的团队」列表见 {@see MeGroupController}。v2 那份在 dashboard-v4 下线前原样保留,不要改动。
  17. *
  18. * 不支持 AI 模型代写(2026-11-13 定)。
  19. */
  20. class GroupController extends Controller
  21. {
  22. use ResolvesCurrentUser;
  23. public function __construct(private readonly GroupService $groups) {}
  24. /**
  25. * 搜公开团队
  26. *
  27. * 共享资源时挑团队用。只列公开团队(status 30),按名字排序。
  28. *
  29. * @queryParam search string 按团队名模糊匹配
  30. * @queryParam page integer 页码。Default: 1
  31. * @queryParam per_page integer 每页数量,最大 200。Default: 20
  32. */
  33. public function index(IndexGroupRequest $request)
  34. {
  35. return GroupResource::collection($this->groups->searchPublic(
  36. $request->validated('search'),
  37. $request->integer('per_page', 20),
  38. ));
  39. }
  40. /**
  41. * 建团队
  42. *
  43. * 建的人成为 owner。同一个人名下不能重名。
  44. *
  45. * @bodyParam name string required 团队名,最长 64
  46. * @bodyParam description string 简介,最长 1024
  47. * @bodyParam status integer 10 私有、30 公开。Default: 30
  48. *
  49. * @responseStatus 201 建好了
  50. */
  51. public function store(StoreGroupRequest $request)
  52. {
  53. return GroupResource::make($this->groups->create(
  54. $this->currentUser($request)['user_uid'],
  55. $request->validated(),
  56. ));
  57. }
  58. /**
  59. * 团队详情
  60. *
  61. * 公开团队谁都能看(可不登录),私有团队只有成员能看。带查看者在团队里的角色。
  62. *
  63. * @unauthenticated
  64. *
  65. * @urlParam group string required 团队 uid
  66. *
  67. * @responseStatus 403 私有团队,且不是成员
  68. */
  69. public function show(Request $request, GroupInfo $group)
  70. {
  71. return GroupResource::make($this->groups->show($group, $this->currentUserUid($request)));
  72. }
  73. /**
  74. * 改团队信息
  75. *
  76. * 团队的 owner / manager 才能调用,只改传了的字段。
  77. *
  78. * @urlParam group string required 团队 uid
  79. *
  80. * @bodyParam name string 团队名,最长 64
  81. * @bodyParam description string 简介,最长 1024
  82. * @bodyParam status integer 10 私有、30 公开
  83. *
  84. * @responseStatus 403 不能修改这个团队
  85. */
  86. public function update(UpdateGroupRequest $request, GroupInfo $group)
  87. {
  88. return GroupResource::make($this->groups->update(
  89. $group,
  90. $this->currentUser($request)['user_uid'],
  91. $request->validated(),
  92. ));
  93. }
  94. /**
  95. * 删团队
  96. *
  97. * 只有 owner 能删。团队名下还有资源(channel、文章等)时拒绝,`resources` 里给出各类的条数;
  98. * 否则连同成员与共享给团队的记录一起硬删,返回 204 空体。
  99. *
  100. * @urlParam group string required 团队 uid
  101. *
  102. * @responseStatus 204 已删除,无响应体
  103. * @responseStatus 403 只有 owner 能删
  104. * @responseStatus 409 团队名下还有资源
  105. */
  106. public function destroy(Request $request, GroupInfo $group)
  107. {
  108. $this->groups->delete($group, $this->currentUser($request)['user_uid']);
  109. return response()->noContent();
  110. }
  111. }