9oormthon-univ / 2024_beotkkotthon_team_23_be

🌌23팀: 🌙 자니..? 백엔드 레포지토리

2024_BEOTKKOTTHON_TEAM_23_BE

🌌23팀 : 🌙 자니..? 백엔드 레포지토리

Commit Convention

• feat : 새로운 기능 추가
• fix : 버그 수정
• docs : 문서 수정
• style : 코드 포맷팅, 세미콜론 누락, 코드 변경이 없는 경우
• refactor: 코드 리펙토링
• test: 테스트 코드, 리펙토링 테스트 코드 추가
• chore : 빌드 업무 수정, 패키지 매니저 수정

💡 PR Convetion

아이콘	코드	설명
🎨	:art	코드의 구조/형태 개선
⚡️	:zap	성능 개선
🔥	:fire	코드/파일 삭제
🐛	:bug	버그 수정
🚑	:ambulance	긴급 수정
✨	:sparkles	새 기능
💄	:lipstick	UI/스타일 파일 추가/수정
⏪	:rewind	변경 내용 되돌리기
🔀	:twisted_rightwards_arrows	브랜치 합병
💡	:bulb	주석 추가/수정
🗃	:card_file_box	데이버베이스 관련 수정

2024_beotkkotthon_team_23_be's Issues

[ Feature ] - 미션 연속 실패(2회) 시 밤샘 팀 추방 로직 구현

🛠️ 개발 예정 기능

사용자가 밤샘 팀 참여하여 미션 2회 연속 실패 시, 밤샘 팀에서 추방

💭 해당 기능 역할

잠에 들거나 하는 이슈로 밤샘에 참여하지 않고있는 사용자를 필터링 하기 위한, 미션 연속 실패시 팀에서 추방하는 기능을 도입해, 사용자가 실질적으로 밤샘에 참여한 시간을 기록하고, 밤샘 팀에 남아있는 사용자를 실시간으로 밤샘에 참여중인 사용자로 제한한다.

📝 check-lists

• user_team에 미션 실패 count 추가.
• count가 쌓이는 로직 구현('연속' 실패하지 않으면 초기화)
• count가 2회 쌓이면 추방

[ Feature ] - active인 팀원에게 돌발적인 시각에 동일 미션 발행

🛠️ 개발 예정 기능

웹소켓 통신을 통해, 돌발적인 시각에 현재 존재하는 모든 팀 id에 대해 생존 신고 미션을 발행한다.
type: missionType을 통해 미션과 채팅을 구분한다.

💭 해당 기능 역할

클라이언트에서는 type이 "missionType" 인 데이터가 전송되면, 해당 유저가 is_active == true인지 검증한 후, true라면 content에 포함되어있는 미션을 띄워준다.

📝 check-lists

• 서버의 미션 발행 로직 구현
• 테스트

[ Feature ] - 밤샘 관련 API (밤샘 참여/그만하기)

🛠️ 개발 예정 기능

밤샘 참여하기/ 중단하기를 통해 User의 밤샘 상태를 변경하는 API

💭 해당 기능 역할

팀에 속한 유저가 "밤샘 시작하기" 버튼을 누르면 밤샘 상태가 활성화된다. "밤샘 그만하기" 버튼을 누루면 밤샘이 중단된다. 이때 같은 API를 호출하여 상태를 변경한다.

📝 check-lists

• 팀 가입 밤샘 미시작/ 팀 미가입/ 밤샘 진행 중 상태 구분
• 밤샘 시작/ 그만하기 API
• 밤샘 시작시 isActive가 true, 밤샘 중단시 isActive가 false로 변경
• lastActiveAt 관련 로직

[ Feature ] - 밤샘 달력 조회 api 및 특정 날짜의 밤샘 기록 상세보기 api 구현

🛠️ 개발 예정 기능

밤샘 달력에 표시할 각 날짜별 밤샘 데이터와, 현재까지의 밤샘 누적 시간, 밤샘 횟수 반환하는 api

💭 해당 기능 역할

클라이언트로부터 연, 월을 받아와서, 해당 연,월에 해당하는 데이터들을 반환한다.

📝 check-lists

• 해당 날짜의 밤샘 데이터가 이틀에 걸쳐있다면, 전날에 넣을지 다음 날에 넣을지 결정
• 날짜별 밤샘 데이터 + 밤샘 누적 시간 + 밤샘 횟수 반환 api 구현
• 테스트

[ Feature ] - UserTeam관련 조회 API (밤샘 중인 팀원수 & 밤샘메이트 조회)

🛠️ 개발 예정 기능

밤샘 중인 팀원 수 조회 API
밤샘 메이트 조회 API

💭 해당 기능 역할

밤샘 활성화가 되어 있는 팀원들의 숫자를 조회하는 API와 같은 팀의 유저들을 모두 조회하는 API를 구현한다.

📝 check-lists

• 밤샘 중인 팀원 수 조회 API
• 밤샘 메이트 조회 API

[ Fix ] - User 조회 API 반환값 수정

🛠️ 개발 예정 기능

User 조회 API 반환값 수정

📝 check-lists

• IsInTeam : 팀에 속해있는지 여부
• teamId : 팀에 속해있다면 teamId를, 속해있지 않으면 null 반환
• isReported : 10번 이상 신고됐는지 여부

[ Feature ] - 밤샘 메이트 팀 별 채팅 서비스

🛠️ 개발 예정 기능

STOMP의 메세지 브로커를 이용한 밤샘 메이트 팀 채팅 서비스를 구현한다.

💭 해당 기능 역할

밤샘에 참여하는 팀원들 사이에 실시간 통신을 가능하게 한다.

📝 check-lists

• 채팅 구현
• 테스트

[ Feature ] - 팔로워 조회 API

🛠️ 개발 예정 기능

팔로워 조회 API

💭 해당 기능 역할

유저가 팔로우하는 다른 유저들의 닉네임, 칭호를 반환하는 API 구현

📝 check-lists

• 팔로워 조회 API 구현

[ Fix ] - 클라이언트 사이드 소셜로그인 인증 반영하여 OAuth 로직 수정

🛠️ 개발 예정 기능

보일러플레이트가 가지고있던 웹 기반의 소셜로그인 인증 방식에서, 클라이언트 사이드에서 인증을 진행하는 방식으로 백엔드 코드를 수정한다.

💭 해당 기능 역할

클라이언트에서 전달해주는 시리얼라이저와 프로바이더 정보를 바탕으로 유저를 생성, 조회하고 / 액세스 토큰과 리프레시 토큰을 반환한다.

📝 check-lists

• 불필요 파일 삭제
• User Domain 수정
• AuthController에 소셜로그인 엔드포인트 추가
• AuthService에 소셜로그인 관련 로직 추가

[ Feature ] - 미션 결과 저장, 미션 타임라인 조회 api 구현

🛠️ 개발 예정 기능

웹소켓을 통해 발행된 미션에 대한 결과를 저장하는 로직과,
각 팀에 속한 팀원들의 미션 타임라인을 조회하는 api를 구현한다.

📝 check-lists

• 사진 미션 성공 or 실패 시, 결과 저장하는 api 구현
• 질문 미션 성공 or 실패 시, 결과 저장하는 api 구현
• 팀원들의 미션 타임라인을 조회하는 api 구현

[ Fix ] - 게시글 작성 버그 해결 / 게시글 작성 시 사진 추가(최대 3개) 기능 구현

🛠️ 개발 예정 기능

현재 발생하고있는 글 작성 시 서버 에러를 해결한다.
게시글 작성 시, 사용자가 사진 파일 최대 3개를 업로드 할 수 있도록 기능을 수정한다.

📝 check-lists

• 게시글 작성 서버 에러 수정
• 게시글 작성시 사진파일 업로드 기능 구현
• PostImage 도메인 추가(Post:PostImage = 1:N)
• GET PostDetail 시, 연관된 사진 함께 조회
• Patch PostDetail 시, 사진 파일 삭제 or 추가 기능 구현

[ Feature / Fix] - 좋아요 API 구현 / 커뮤니티 스크린 각종 버그 수정

🛠️ 개발 예정 기능

좋아요 토글 기능, 좋아요 누른 게시글 보기 기능을 구현한다.
커뮤니티와 관련된 기능들 중 각종 버그를 수정한다.

📝 check-lists

• 좋아요 토글 API
• 좋아요한 게시글 보기 API
• 커뮤니티 버그 수정

[ Feature ] - 팀 목록 조회 api (필터링, 무한스크롤), 팀 상세

🛠️ 개발 예정 기능

필터에 따라 (제목,카테고리,비밀방 여부, 풀방 여부) 팀 목록을 조회하는 api를 페이지네이션 하여 구현한다.
hasNext 값을 함께 반환하여, 다음 값이 있는지 전달한다.

💭 해당 기능 역할

📝 check-lists

• 팀 조회 api 구현
• 팀 관련 Dto 및 코드 리펙토링

[ Feature ] - Follow API (팔로우 & 언팔로우)

🛠️ 개발 예정 기능

팔로우 API 구현

💭 해당 기능 역할

호출 시 다른 유저를 팔로우하지 않은 상태라면 팔로우를 하고, 이미 팔로우가 되어있다면 언팔로우가 된다.

📝 check-lists

• Toggle 방식으로 메소드 구현
• 팔로우 API

[ Feature ] - 팀 관련 API (팀 생성, 팀 참여하기, 팀 나가기)

🛠️ 개발 예정 기능

팀 생성 API
팀 참여하기 API
팀 나가기 API

💭 해당 기능 역할

팀 이름, 카테고리, 모집 인원, 밤샘 시간, 비밀방 여부, 팀 소개 문구를 받아 팀 생성 모집글을 작성하고 유저가 모집글을 통해 모집글을 조회하고 팀 가입하기 버튼을 눌러 팀에 가입한다. 팀 나가기 버튼을 누르면 팀에서 나간다.

📝 check-lists

• 팀 생성 API
• 밤샘 팀 가입하기 API
• 팀 나가기 API
• 유저는 하나에 팀에만 가입하도록 처리
• 팀 인원 제한이 넘으면 가입할 수 없음
• 유저가 팀에 참여시 팀 인원을 변경
• 팀을 생성한 경우 방장 활성화, 자동으로 팀 인원 1 증가

[ Feature ] - 목표시간 초과 시 방 폭파 로직

🛠️ 개발 예정 기능

목표 시간 초과 시 방 폭파 API

💭 해당 기능 역할

팀이 설정한 목표 시간이 초과되면, 자동으로 멤버들이 팀에서 나가고 밤샘 관련 기록이 업데이트 되면서 칭호 획득 조건을 충족 시 칭호가 부여된다.

📝 check-lists

• 목표 시간 초과 확인 스케줄러 구현
• 목표 시간 초과 시 팀 삭제
• 목표 시간 초과 시 팀 멤버들을 자동으로 나가게 함
• 각 유저의 밤샘 기록 업데이트와 조건 충족 시 칭호 부여

[ Feature ] - 밤샘 게시판 구현

🛠️ 개발 예정 기능

자니 사용자들이 자유롭게 소통할 수 있는 밤샘 게시판을 구현한다.

📝 check-lists

• 게시글 CRUD(페이지네이션 포함)
• 게시글에 대한 댓글 CRUD

[ Feature ] - 추방하기 API

🛠️ 개발 예정 기능

추방하기 API

💭 해당 기능 역할

방장의 권한을 가진 사용자만, 유저를 팀에서 추방할 수 있다.

📝 check-lists

• 방장 권한 확인 로직
• 추방하려는 유저가 해당 팀에 속해있는지 확인
• 본인 추방 불가
• 추방하기 API

[ Feature ] - 사용자 신고 API 구현

🛠️ 개발 예정 기능

특정 사용자를 신고하는 API 구현

💭 해당 기능 역할

• 다른 유저의 신고가 10번 이상 누적되면 User의 reported 필드를 true로 바꿔줌. -> 밤샘 참여 불가능, 팀 생성 불가능
• A라는 유저에 대하여 B 유저는 A 유저를 한 번만 신고할 수 있음. 다시 신고할 수 없음
• 일반 유저가 신고가 10번 이상 누적되면? 그 유저는 방에서 자동으로 탈퇴당함
• 방장이 신고가 10번 이상 누적되면? 방장에서 물러나고 자동으로 다른 방장을 설정

📝 check-lists

• User Entity isreported 필드 추가
• 10번 이상 신고 당할 시 isreported 필드를 true로 변경
• 예외처리

[ Fix ] - 밤샘 메이트 조회 return 값 수정 & 새 방장 설정 로직

🛠️ 개발 예정 기능

밤샘 메이트 조회 return 값 수정

📝 check-lists

• 밤샘 메이트 조회 시 isLeader 값도 같이 반환되도록 수정
• 방장이 팀을 나갈 시 새로운 방장을 설정한다. (방에 가장 오래 있었던 유저를 방장으로 설정) 이때 user_team_id를 기준으로 정렬하여 선정한다.

[ Feature ] - 칭호 부여 비즈니스로직 구현

🛠️ 개발 예정 기능

사용자가 밤샘 참여 완료 시, 칭호 달성 조건을 만족했는지 확인 후 이에 따른 칭호 부여.

📝 check-lists

• 사용자가 밤샘 완료 시, 각 칭호별 달성 요건 확인 로직 구현
  잠만보 : 첫 밤샘 참여
  올빼미 : 밤샘 참여 10시간
  낮밤이 바뀐자 : 연속 밤샘 4일
  밤의 수호자: 밤샘 총시간 50시간
  밤샘마스터 : 최소 6시간 이상 밤샘을 채운 횟수가 10회
  고독한 밤샘가 : 1인 밤샘 5번 이상
  밤을 다스리는 자 : 방장으로 참여한 밤샘 총시간 50시간
  불면의 달인: 밤샘 총시간 100시간
• 요건 만족 시 칭호 부여 로직 구현