NBE4-5-2-Team01

프로그래머스 백엔드 데브코스 4기 5회차 1팀 단단한 나뭇가지의 2차 팀 프로젝트입니다.

단단한 나뭇가지

조정인	강웅빈	김지수	신우석	엄현수
팀장	팀원	팀원	팀원	팀원
@jxxngin	@Woongbin06	@j1suk1m	@shinwoos	@sameom1048

📆 Project Overview

1. 프로젝트 명

📆 Music Calendar

2. 프로젝트 소개

매일 들은 노래를 기록하고, 공유하고, 확인할 수 있는 음악 캘린더 플랫폼

3. 주요 기능

• 회원 관리 👥
• 음악 검색, 기록 및 추천 🎵
• 음악 기록 분석을 통한 주간, 월간, 장르별, 가수별 통계 시각화 📊
• 이메일 알림 및 푸시 알림 🔔
• 팔로우 기능 및 친구 캘린더 조회 💘

4. 작업 및 역할 분담

이름	역할
조정인	팀 리딩 음악 검색 음악 추천
강웅빈	팔로우 유저 검색 팔로잉, 팔로워 목록 조회
김지수	캘린더 조회 캘린더 생성 음악 기록 및 기록 수정
신우석	소셜 로그인 회원 관리
엄현수	이메일 알림 및 푸시 알림 알림 읽음 처리 받은 알림 목록 조회 음악 기록 통계 시각화

🛠️ Tech

프로젝트 설정 및 실행

리포지토리 클론

git clone https://github.com/prgrms-be-devcourse/NBE4-5-2-Team01.git
cd NBE4-5-2-Team01

프론트엔드 설정 및 실행

cd frontend
npm install
npm run dev

백엔드 설정

application.yml 파일에 맞게 환경 변수 설정

푸시 알림 허용

chrome://settings/content/siteDetails?site=http://localhost:3000/에서 알림 허용

기술 스택

언어

• JAVA 23
• TypeScript

프레임워크 및 라이브러리

• Spring 3.4.2
• Spring Security
• React 19.0.0
• Next.js 15.1.7
• ShadCN/UI

IED 및 개발 도구

• IntelliJ IDEA
• Visual Studio Code

버전 관리 및 협업 도구

• Git
• GitHub
• Slack
• Notion
• Discord

Usecase Diagram

ERD

System Architecture

Flow Chart

🗃️ Flow Chart

브랜치 전략

GitHub Flow 전략 사용

• Main Branch
  • 배포 가능한 상태의 코드 유지
  • 모든 배포는 이 브랜치에서 수행
• {name} Branch
  • 각 팀원의 개발 브랜치
  • 모든 기능 개발은 이 브랜치에서 수행
• 테스트가 완료되면, main 브랜치를 타겟으로 Pull Request를 생성하여 Review를 요청
• Review가 완료되고, 피드백이 모두 반영되면 해당 feature 브랜치를 main브랜치로 Merge

API 명세서

📝 API 명세서

컨벤션

🎯 Commit Convention
📌 Code Convention