📖 프로젝트 소개

하루의 기분을 글로 남기면, AI가 감정을 분석해 나에게 꼭 맞는 감정 키워드를 추천해줘요. 마음에 드는 감정을 고르면, 지금의 나와 어울리는 음악까지 함께 추천해주는 감정 기반 일기 서비스, Feelody! 감정과 음악을 연결해주는 특별한 일기 습관, Feelody에서 당신의 하루를 기록해보세요. 🎧📓💙

---

🔗 배포 링크

https://www.feelody.site/

---

🗣️ 프로젝트 발표 영상 & 발표 문서

🗓️ 2025.04.03

📺 발표 영상 예시

📑 발표 문서 예시

---

🖥️ 서비스 소개

메인홈

---

👤 사용자

소개페이지	소셜로그인

로그인 상태 처리	동일 이메일 처리

회원가입	프로필

마이페이지	마이페이지 수정

로그아웃	회원탈퇴

---

📒 일기

일기작성 - 감정분석	일기작성 - 분석실패

일기작성 - 기본감정	감정 선택 - 일기 프리뷰

음악추천 성공 - 일기저장	음악추천 실패 - 일기저장

일기저장	일기삭제

일기검색	감정차트

탭이동 컨펌창	작성중단 컨펌창

---

🧰 사용 스택

FE

BE

---

👥 팀 동료

FE

@KIMDOTS	@chiyo-an	@minhui-p
김민정	안정은	박민희

BE

@shinezeee	@rodzlen	@parkh12
신혜지	김휘수	박현성

📑 프로젝트 규칙

Branch Strategy

• main / dev 브랜치 기본 생성
• main과 dev로 직접 push 제한
• PR 전 최소 2인 이상 승인 필수

Git Convention

1. 적절한 커밋 접두사 작성
2. 커밋 메시지 내용 작성

접두사	이모지	설명
Feat	✨	새로운 기능 추가
Fix	🐛	기능 수정 및 버그 수정
Chore	💡	오타 수정, 주석 추가 등 기능 변경 없이 코드 수정
Docs	📝	문서 수정 (예: README.md)
Build	🚚	빌드 관련 파일 수정 또는 삭제
Test	✅	테스트 코드 추가 및 수정 (프로덕션 코드 변경 없음)
Refactor	♻️	코드 리팩토링 (기능 변화 없이 구조 개선)
Hotfix	🚑	긴급 수정

Pull Request

Title

• 제목은 '[Feat]/#이슈번호/홈 페이지 구현'과 같이 작성합니다 [FE]
• 제목은 '✨/홈 페이지 구현'과 같이 작성합니다 [BE]

PR Type

• FEAT: 새로운 기능 구현
• FIX: 버그 수정
• DOCS: 문서 추가 및 수정
• STYLE: 포맷팅 변경
• REFACTOR: 코드 리팩토링
• CHORE: 기타 작업

Description

• 구체적인 작업 내용을 작성해주세요.
• 이미지를 별도로 첨부하면 더 좋습니다 👍

Discussion

• 추후 논의할 점에 대해 작성해주세요.

Code Convention

BE

• 패키지명 전체 소문자

FE

• ESLint, Prettier 사용하여 들여쓰기, 따옴표 통일
• 파일 및 폴더명: camelCase (ex. userProfile.tsx)
• 컴포넌트: PascalCase (ex. UserProfile.tsx)
• 변수 및 함수: camelCase (ex. fetchUserData)
• 상수:UPPER_SNAKE_CASE (ex. API_BASE_URL)
• 이벤트 핸들러:handleEventName (ex. handleClick)
• axios 기반 API 모듈화
• 전역 상태관리 : Zustand
• 서버 상태관리: React Query
• 불필요한 리렌더링 최소화

Communication Rules

• Zep, Discord 활용
• 오전 10시 20분 정기 회의 (30분)

📋 Documents

📜 API 명세서 예시

📜 요구사항 정의서 예시

📜 ERD 예시

📜 테이블 명세서 예시

📜 화면 정의서 예시)