GroupMemberController.php 3.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114
  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\IndexGroupMemberRequest;
  6. use App\Http\Requests\V3\StoreGroupMemberRequest;
  7. use App\Http\Requests\V3\UpdateGroupMemberRequest;
  8. use App\Http\Resources\V3\GroupMemberResource;
  9. use App\Models\GroupInfo;
  10. use App\Models\GroupMember;
  11. use App\Services\V3\GroupMemberService;
  12. use Illuminate\Http\Request;
  13. /**
  14. * 团队成员:列表、加人、改角色、移人 / 退出。
  15. *
  16. * 取代 `GET /v2/group-member?view=group`、`POST /v2/group-member`、
  17. * `DELETE /v2/group-member/{id}`(`GroupMemberController`);v2 的 PUT 是空实现,
  18. * 改角色是 v3 新增。v2 那份在 dashboard-v4 下线前原样保留,不要改动。
  19. *
  20. * 不支持 AI 模型代写(2026-11-13 定):成员管理就是权限本身,只给人类账号。
  21. */
  22. class GroupMemberController extends Controller
  23. {
  24. use ResolvesCurrentUser;
  25. public function __construct(private readonly GroupMemberService $members) {}
  26. /**
  27. * 列出团队成员
  28. *
  29. * 只有团队成员看得到。owner、manager 在前,其余按加入时间排序。
  30. *
  31. * @urlParam group string required 团队 uid
  32. *
  33. * @queryParam page integer 页码。Default: 1
  34. * @queryParam per_page integer 每页数量,最大 200。Default: 100
  35. *
  36. * @responseStatus 403 不是这个团队的成员
  37. */
  38. public function index(IndexGroupMemberRequest $request, GroupInfo $group)
  39. {
  40. return GroupMemberResource::collection($this->members->listForGroup(
  41. $group,
  42. $this->currentUser($request)['user_uid'],
  43. $request->integer('per_page', 100),
  44. ));
  45. }
  46. /**
  47. * 加一名成员
  48. *
  49. * 团队的 owner / manager 才能调用。角色默认 reader(只读)。
  50. *
  51. * @urlParam group string required 团队 uid
  52. *
  53. * @bodyParam user_id string required 要加入的用户 uuid
  54. * @bodyParam role string 角色,默认 reader。Enum: manager,editor,reader
  55. *
  56. * @responseStatus 201 加入成功
  57. * @responseStatus 403 不能管理这个团队的成员
  58. */
  59. public function store(StoreGroupMemberRequest $request, GroupInfo $group)
  60. {
  61. return GroupMemberResource::make($this->members->add(
  62. $group,
  63. $this->currentUser($request)['user_uid'],
  64. $request->validated(),
  65. ));
  66. }
  67. /**
  68. * 改成员角色
  69. *
  70. * 团队的 owner / manager 才能调用;owner 那一行不能改。
  71. *
  72. * @urlParam group string required 团队 uid
  73. * @urlParam member string required 成员记录 id
  74. *
  75. * @bodyParam role string 角色。Enum: manager,editor,reader
  76. *
  77. * @responseStatus 403 不能管理这个团队的成员,或目标是团队拥有者
  78. */
  79. public function update(UpdateGroupMemberRequest $request, GroupInfo $group, GroupMember $member)
  80. {
  81. return GroupMemberResource::make($this->members->update(
  82. $group,
  83. $member,
  84. $this->currentUser($request)['user_uid'],
  85. $request->validated(),
  86. ));
  87. }
  88. /**
  89. * 移除成员 / 退出团队
  90. *
  91. * 移除别人要 owner / manager;移除自己就是退出团队。owner 不能被移除、也不能退出。
  92. * 硬删,成功返回 204 空体。
  93. *
  94. * @urlParam group string required 团队 uid
  95. * @urlParam member string required 成员记录 id
  96. *
  97. * @responseStatus 204 已移除,无响应体
  98. * @responseStatus 403 不能移除这名成员
  99. */
  100. public function destroy(Request $request, GroupInfo $group, GroupMember $member)
  101. {
  102. $this->members->remove($group, $member, $this->currentUser($request)['user_uid']);
  103. return response()->noContent();
  104. }
  105. }