2
0

GroupShareController.php 2.1 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465
  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\IndexGroupShareRequest;
  6. use App\Http\Resources\V3\GroupShareResource;
  7. use App\Models\GroupInfo;
  8. use App\Models\Share;
  9. use App\Services\V3\GroupShareService;
  10. use Illuminate\Http\Request;
  11. /**
  12. * 团队文档:共享给团队的资源。
  13. *
  14. * 取代 `GET /v2/share?view=group`(`ShareController@index`)与团队页上经
  15. * `DELETE /v2/share/{id}` 把资源移出团队。资源本身的协作者管理仍走 v2 share。
  16. * v2 那份在 dashboard-v4 下线前原样保留,不要改动。
  17. */
  18. class GroupShareController extends Controller
  19. {
  20. use ResolvesCurrentUser;
  21. public function __construct(private readonly GroupShareService $shares) {}
  22. /**
  23. * 列出团队文档
  24. *
  25. * 只有团队成员看得到。每条带资源类型、标题与拥有者,以及团队对它的权限(reader / editor)。
  26. *
  27. * @urlParam group string required 团队 uid
  28. *
  29. * @queryParam page integer 页码。Default: 1
  30. * @queryParam per_page integer 每页数量,最大 200。Default: 20
  31. *
  32. * @responseStatus 403 不是这个团队的成员
  33. */
  34. public function index(IndexGroupShareRequest $request, GroupInfo $group)
  35. {
  36. return GroupShareResource::collection($this->shares->list(
  37. $group,
  38. $this->currentUser($request)['user_uid'],
  39. $request->integer('per_page', 20),
  40. ));
  41. }
  42. /**
  43. * 把资源移出团队
  44. *
  45. * 团队的 owner / manager,或资源的拥有者才能调用。只删这条共享,资源本身不动。
  46. *
  47. * @urlParam group string required 团队 uid
  48. * @urlParam share string required 共享记录 id
  49. *
  50. * @responseStatus 204 已移出,无响应体
  51. * @responseStatus 403 不能移出这项资源
  52. */
  53. public function destroy(Request $request, GroupInfo $group, Share $share)
  54. {
  55. $this->shares->remove($group, $share, $this->currentUser($request)['user_uid']);
  56. return response()->noContent();
  57. }
  58. }