폴더 공유 기능 명세

[kimminkyeu]

폴더 공유 기능 명세

🌟 공유 기능

• 사용자는 폴더 1개를 외부인에게 공유할 수 있습니다.
• 설정에서 내가 공유한 폴더 목록을 확인할 수 있습니다.

◽ 개발 서버 API

• 프론트엔드 개발을 위한 백엔드 서버의 API가 스웨거로 명세되어 있습니다.
• 스웨거 경로: https://v2.minlife.me/swagger-ui/index.html#/shared-folder-api-controller

◽ 구현 요구 사항

• 현재 화면

  

  폴더를 마우스 우클릭하면 Context Menu가 뜹니다.

• 📌 폴더 1개를 우클릭해서 외부로 공유할 수 있도록 버튼과 팝업창을 만들어주세요

  

• 📌 공유된 폴더 링크로 라우팅 되게까지만 해주세요.

  공유된 폴더는 로그인 하지 않아도 볼 수 있습니다.

  공유 폴더는 uuid로 조회됩니다.

  Next app 라우팅으로 app/(unsigned)/share/{uuid} 디렉토리 추가해주세요.

• 📌 폴더 삭제 예외 처리

  • 현재 “휴지통으로 이동하기” 할 경우에 공유가 해제되어야 한다.
  • ⭐휴지통으로 이동 시, 현재 공개중인 폴더이며,
    이동시 외부에서 더이상 접근할 수 없다는 경고창이 떠야 한다.
  • ⭐로그인 하던 안하던 해당 공개 링크로 접근 시, “삭제된 폴더입니다” 하는 화면이가 뜨거나,
    접근할 수 없는 폴더 라는 문구가 떠야 한다.

• 📌 공유된 링크에 외부인이 접속했을 때

  1. 공유 → 공개 로 워딩 변경. → 공개가 더 자연스럽다고 생각하는데, 의견 주시길 바람.

  2. json 데이터 형식에 따라 정적으로 북마크 리스트 렌더링

     

• 📌 내 설정 → 공유 취소하기

  1. accessToken 값의 null 여부로 해당 폴더의 공개 여부 판단

  2. 내 설정으로 들어가면 폴더 공유 목록 확인 가능

     폴더 아이콘 우측으로 “공개 중이다” 라는 뱃지가 표시된다.

     

  3. accessToken 값의 존재하는 폴더는 공개된 폴더.

     따라서 클릭시 api를 비공개하기로 연결

     

◽ 기타

아이콘은 아래꺼 사용해주세요

• https://lucide.dev/icons/

◽ 에러 코드

• 서비스 에러 코드 명세

  공유 폴더 서비스 에러 코드 추가했습니다. (ShareFolder)