단잠 / 각기 다른 사람들이 모여 단잠에 들다 ✨

정든 고향을 떠나 처음으로 혼자만의 생활을 시작하는 대학생들의 78.8%가처음을 시작할 공간으로 기숙사를 선택합니다. 하지만 기숙사에 거주했던 대학생들은 많은 불편을 겪습니다.

고려대학교 학생 정책 발굴단 참가팀에서 진행한 기숙사생 390명의 기숙사 만족도에 대한 설문에서, 기숙사 생활 평균 만족도는 절반을 겨우 넘긴 2.87점이며 기숙사생 중 93%가 거주하면서 불편을 느꼈다고 언급 하였습니다.

대학생으로 이루어진 저희는 기숙사 생활 중 느꼈던 아쉬움을 토대로 기숙사 생활의 불편함을 이야기하는 학생들을 깊이 이해하여 이들의 만족스러운 주거 생활을 위한 커뮤니티 서비스를 제작하고자 합니다.

⚠️ 갈수록 커지는 주거비용과 전세사기 증가는 청년들에게 큰 부담으로 다가오고 있어요!

최근 3년간(2021~2023년) 서울 월세시장 추이를 분석한 결과 서울의 소규모 월셋집의 월세는 2년간 15.8% 증가했습니다. 이는 관리비, 수도요금, 에너지 비용 등을 제외한 금액으로 실제 거주시에는 이를 포함한 식비 등의 생활비용과 함께 지출 부담이 더욱 컸을 것으로 예상할 수 있습니다.

뿐만 아니라 최근 청년 세대를 겨냥한 전세보증 사기범죄가 전국적으로 속출하고 있습니다. 따라서 전세사기 피해자의 절반 가까이(47.7%)가 20~30대로 나타났으며 이는 극단적인 선택에까지 이르고 있었습니다.

⚠️ 다양한 이유로 청년들의 기숙사 선호도가 올라가고 있어요

정든 고향을 떠나 처음으로 혼자만의 생활을 시작하는 대학생들의 78.8%가 처음을 시작할 공간으로 기숙사를 선택합니다. 1인 가구로서의 주거비 및 생활비에 대한 부담, 외로움 등에 대한 고민으로 공동 주거 형태를 선호하기 때문입니다. 이와 같은 이유로 공동 주거 형태를 선택한 이들은 거주자 간 교류, 새로운 만남의 기회 등을 기대하고 있습니다.

⚠️ 그러나 기대한 것과는 달리 기숙사 생활은 매우 불편하기만 해요..

우리나라의 높은 기숙사 수용률과 외부거주 시 발생하는 높은 거주 비용이 많은 영향을 주어 대부분이 이미 기숙사에 거주를 하며 기대하는 바가 명확히 있지만 현실의 기숙사생들은 많은 불편을 겪고 있었습니다.

고려대학교 학생정책발굴단 참가팀에서 진행한 기숙사생 390명의 기숙사 만족도에 대한 설문에서, 기숙사 생활 평균 만족도는 절반을 겨우 넘긴 2.87점이며 기숙사생 중 93%가 거주하면서 불편을 느꼈다고 언급하였습니다.

⚠️ 기숙사 룸메이트부터 시설은 물론, 교류할 수 있는 환경도 부족해요!

자체 조사 결과 기숙 생활 경험자 88.4%가 룸메이트 간 발생하는 갈등을 겪어본 것으로 드러났으며 갈등 예방을 위해 기숙사에 입사하기 전 성향에 맞는 룸메이트를 꼭 찾아보고 싶다는 생각을 가지고 있었습니다. 뿐만 아니라 기숙사에 거주하는 학생들 중 88.5%가 메이트 간 갈등 외의 불편함, 즉 소음이나 편의시설 등에 대한 부정적인 의견도 찾아볼 수 있었으며, 공동 거주 형태에 새로운 만남과 교류 등을 기대하나, 일정 조율, 지속성, 신뢰성 등 꾸준한 모임 참여를 위한 시스템이 마련되어 있지 않아 겪는 불편함 또한 발견하였습니다.

✨ 팀 새옹지마가 "단잠"을 통해 해결할게요 ! ✨

BackEnd	BackEnd	BackEnd	BackEnd
팀장 ☃️나강민	팀원 🐻‍❄️김대연	팀원 🐰유다인	팀원 🐶김석범	팀원 🐶박규원	팀원 🐶허성택

Design	Design
팀원 🐰홍영주🎨	팀원 🐰박소현🎨

프로젝트 아키텍처

Key Features (주요 기능)

• MSA:

  • Spring Cloud를 통한 MSA 아키텍처를 구성하였습니다.
  • API Gateway Service를 통해 인증/인가, 로드밸런싱을 진행합니다
  • Eureka Discovery Server를 통해 인스턴스 서버들을 관리합니다
  • OpenFeign을 통해 도메인간 통신을 진행합니다.

• 회원:

  • 로그인이 진행되고, 필터 단에서 유저의 권한을 확인하여 토큰을 발급합니다.
  • 발급된 토큰을 기반으로 권한별 API를 처리합니다.
  • Security Config에서 권한을 처리합니다.
  • 마이페이지 기능 개발이 완료되었습니다.

• 메이트:

  • 산책메이트, 식사메이트, 룸메이트 서비스 개발을 진행합니다
  • 메이트프로필 조회와, MBTI 필터링을 진행합니다

• 채팅:

  • 채팅방 생성,조회,삭제 작업을 처리합니다
  • Kafka ,STOMP, ws 를 통한 채팅 서비스를 개발합니다
  • 개인/단체 채팅방 생성이 가능합니다.

• 알람:

  • 회원가입 승인/거부 알림이 가능합니다
  • 채팅방 알림설정이 가능합니다
  • 알림 조회가 가능합니다

• 스케줄:

  • 개인일정을 캘린더로 관리할 수 있습니다
  • 고정일정을 시간표로 관리할 수 있습니다

• 신고/차단:

  • 특정 유저 신고가 가능합니다
  • 차단한 유저로 부터 메세지, 알람을 받지 않도록 설정 가능합니다

ERD

erdcloud :

Technology Stack (기술 스택)

FrontEnd

React
TypeScript

BackEnd

SpringBoot		3.4.3
Java		17
Spring Data JPA		5.0.0
QueryDSL		1.11.12
Spring Security		3.4.2

Infra

MariaDB
phpmyadmin
Nginx Proxy Manager
Jenkins
Kafka
MINIO
Docker

Development Workflow (개발 워크플로우)

브랜치 전략 (Branch Strategy)

우리의 브랜치 전략은 아래와 같은 Git Flow를 기반으로 하며, 다음과 같은 브랜치를 사용합니다.

• Main Branch

  • 배포 가능한 상태의 코드를 유지합니다.
  • 모든 배포는 이 브랜치에서 이루어집니다.

• develop Branch

  • 통합 기능 관리 브랜치 입니다
  • feat에서 개발한 기능을 develop 브랜치에서 통합하여 관리합니다.

• feat Branch

  • 기능 개발 브랜치 입니다.
  • 기능 단위로 브랜치를 나누어 기능을 개발하였습니다.

• refactor Branch

  • 코드 리팩토링 브랜치 입니다.
  • 코드 리팩토링이 필요한 경우 refactor 브랜치에서 작업했습니다.

• release Branch

  • 배포 전 버전을 관리하는 브랜치 입니다.
  • 최종 배포하기 전 테스트를 진행하고, 이상이 없다면 Main브랜치로 배포를 진행합니다.

• hotfix Branch

  • 핫픽스를 관리하는 브랜치 입니다.
  • 배포된 환경에서 수정사항이 발생했을 경우, hotfix 브랜치에서 관리하였습니다.

Convention

네이밍 컨벤션

함수명은 카멜 케이스를 기본으로 하고 컬럼명은 스네이크케이스를 기본으로 한다.

// 카멜 케이스
camelCase
// 스네이크 케이스
snake_case

커밋 컨벤션

참고 : https://hqc24.tistory.com/9

[feat]: 회원탈퇴 기능 수정

[목적]: 기존 hard-delete 방식 대신, soft-delete 방식을 적용하여 기능 수정을 하기 위해서.  

[목표]: soft-delete 방식으로 회원탈퇴를 구현하여, 유저가 물리적으로 삭제되는 것이 아닌,
	   상태값으로 탈퇴여부를 관리하여, 유저 계정 복구에 대비.  

[달성도]: 

  - soft-delete 구현 완료.  

  - 멤버 테이블에 탈퇴여부 상태값 추가 완료.  

[기타]: DB 과부화를 방지하기 위해서, 탈퇴 회원은 30일 이후 자동 삭제되도록 처리할 필요가 있음.