🏡 'UniMate' – 대학생 룸메이트 매칭 플랫폼

대학생들을 위한 안전하고 간편한 룸메이트 매칭 서비스

---

📜 프로젝트 개요

Spring Boot 기반의 UniMate는
대학교 재학생을 대상으로 룸메이트를 매칭해주는 플랫폼으로,
학생 인증을 통한 사용자 관리, 프로필 기반 매칭, 실시간 채팅, 리뷰 기능 등을 제공합니다.

• 🧭 생활 패턴 기반 룸메이트 추천
• 💬 실시간 채팅 기능 제공
• 📝 리뷰 및 신고 기능을 통한 신뢰도 관리
• 🧑‍🤝‍🧑 안전한 학생 인증 기반 매칭 환경 조성

---

💁‍♂️ 팀원 소개 / 역할

이위림	김채현	김홍래	백승범	안병선
팀장	팀원	팀원	팀원	팀원
매칭 선호도 등록 매칭 상태 취소 유사도 계산 로직 좋아요 보내기/취소 관리자 신고 조회/처리	WebSocket을 적용한 실시간 채팅방/알림 구현	자동/사용자 선택 필터 응답 처리/상태 결정 최종 확정/거절 리뷰 기능 구현	JWT 기반 인증 시스템 전역 예외 처리 사용자 정보 관리	유저 프로필 신고 접수 기능 구현 Redis적용과 부하테스트 GitHub Actions를 이용한 배포 시도

---

📝 유저 스토리

👤 고객(사용자)

• U-1 [이메일 인증]

  실제 학교 메일 인증으로 신뢰 확보

• U-2 [생활패턴 등록]

  수면, 청결, 흡연 등 개인별 생활 습관을 파악

• U-3 [추천 프로필 리스트]

  나와 매칭률이 높은 여러 명의 후보를 확인

• U-4 ['좋아요' 보내기]

  상호 '좋아요'시 채팅방 자동 생성

• U-5 [룸메이트 확정/취소]

  채팅을 통해 상대방과 상세 조율하고 룸메이트 여부 결정

• U-6 [신고 및 제재]

  문제되는 사용자를 관리자에게 신고 및 차단

👨‍💻 관리자(Admin)

• A-1 [신고 관리]

  사용자가 신고한 유저에 대한 제재 및 탈퇴 여부 결정

---

⭐ 주요 기능

👤 사용자 기능

유저는 학교 이메일 인증을 통해 플랫폼을 이용할 수 있습니다.

• Spring Security + JWT
• 추천 룸메이트 목록 조회
• 룸메이트 좋아요·취소
• 매칭 생성·조회·취소
• 채팅방 생성·조회·메시지 전송
• 알림 조회·읽음 처리
• 프로필 생성·조회·수정·삭제

👨‍💻 관리자 기능

관리자는 인증을 거쳐 관리자 페이지에 접근할 수 있습니다.

• Spring Security + JWT
• 신고 조회·처리

---

🔧기술 스택

---

🔗 ERD (Entity Relationship Diagram)

---

🎞️ 시연 영상

---

📃 코딩 컨벤션

⚙️ 네이밍 & 작성 규칙

1. 이슈
   • 제목 규칙 : [타입] 작업내용
   • 예시 : [feat] 로그인 기능 추가
   • 본문은 템플릿에 맞춰서 작성
2. PR
   • 제목 규칙 : [타입] 작업내용
   • 예시 : [feat] 로그인 기능 추가
   • 본문은 템플릿에 맞춰서 작성
3. 브랜치
   • 생성 기준 : develop 브랜치에서 생성
   • 명명 규칙 : 타입/#이슈번호
   • 예시: feat/#1
   • main과 develop 브랜치는 브랜치 보호 규칙이 적용되어, 반드시 PR을 통해 최소 2명의 팀원 리뷰 승인 후에만 머지할 수 있다.
4. Commit Message 규칙
   • 명명 규칙 : feat(auth): JWT 기반 인증 구현