• Frontend: 유상진, 이경환, 김예람
• Backend: 김태남, 박다혜, 박지훈

• 프로젝트 선택배경
  

: 학기 초 활발하게 이루어지는 과팅이 시간이 지나면서 관심이 줄어들면서,
학생간의 교류가 적어지게 되는 문제점을 해결하기 위함.
또한, 축제기간 동안 함께 즐길 수 있는 친구를 만들어 축제 활성화를 도움

• 프로젝트 목표
  

: 1:1 동성 간 매칭, 2:2 이성 간 매칭을 통해
교내에서 새로운 친구를 사귈 수 있도록 돕는 서비스를
구현하여 교내 학생들간의 교류를 활발하기 위함

CI/CD

1. Git Push를 하고 master브랜치(배포용 브랜치)에 올리면, Jenkins서버로 바로 Hook을 날립니다.
2. Jenkins에서 Test를 진행 한 후에 Docker 이미지로 제작을 합니다.
3. SpringBoot서버로 바로 컨테이너를 올려 배포를 시작합니다.

• 그라파나, 프로메테우스로 관리

주소 : https://www.figma.com/design/coLvBC7Iqj5uJgUjZAOUcY/%ED%95%9C%EB%AA%A8?node-id=1104-512&p=f&t=gmvhpHESq7JjDcyM-0

주소 : https://hanmo-front.vercel.app/landing

주소 : https://hanmo.store/api/swagger-ui/index.html#/

주소 : https://docs.google.com/spreadsheets/d/1JE8XKR276VxA5LdkBcax9DjOBxP-GwB1Ri0WR1a8sHE/edit?gid=0#gid=0

주소 : https://docs.google.com/spreadsheets/d/1MJ3ztSCG_p-YSx11Sm2T_OwdkF1ltrcpEdc58xBeTxA/edit?gid=0#gid=0

주소 : https://docs.google.com/spreadsheets/d/1nUkOPkZf07Eq-8b2qdf4PBkq0_SquE22VhyaS2gurRQ/edit?usp=sharing

• 회원가입 & SMS 인증
• 로그인 (tempToken 헤더 인증)
• 예외 처리 & 유효성 검사
• 1:1·2:2 랜덤 매칭
• 개발자에게 한마디등의 게시판
• Docker Compose 기반 인프라 구축

• 성별·MBTI·나이 등 선호 조건 매칭
• WebSocket/Redis Pub‑Sub 기반 실시간 채팅
• 관리자 페이지 (신고·삭제 관리)
• 각 번개모임 게시판, (커피 지금 이공관에서 마실 사람~ 게시물 등의 페이지)
• React 프론트와 CORS·쿠키 연동 최적화

💡 추가 아이디어: 맛집 지도 · 대화 가이드

• 지속적인 성능 개선
• 나쁜 코드 제거를 위한 리팩토링

• Google Java Style Guide 준수
• IntelliJ STS CheckStyle 플러그인 적용
• 가이드 링크: https://google.github.io/styleguide/javaguide.html

• Redis 등 캐싱 서버 적극 활용으로 서버 부하 감소
• N+1 쿼리 지양, DB 통신 최소화
• 적절한 인덱스 & 쿼리 튜닝
• 외부 API 호출은 비동기 처리

• 라이브러리: REACT
  
• 프레임워크: NEXT.JS
  
• 언어: TypeScript
  
• 스타일링: Styled-components (CSS-in-JS 방식)
  
• 상태 관리: Recoil
  
• API 통신: Axios

• 프레임워크: Spring Boot
• 언어: Java 21
• 데이터베이스: MySQL, Redis (NoSQL)
• 메시지 큐: Kafka (여유 시 도입)
• Infra & CI/CD: Docker, Jenkins, AWS RDS, S3

1. 첫 화면

   • 앱 실행 시 “한모 : 한세에서 모여봐요!” 타이틀과 한모 캐릭터가 표시된다.
   • 하단에 [매칭 확인] / [회원가입] 버튼이 있고,
     • 회원가입 → 온보딩 절차 시작
     • 매칭 확인 → 로그인 후 매칭 현황으로 이동

2. 전화번호 인증(본인 인증)

   • 휴대폰 번호 입력 → 서버가 6자리 SMS 인증번호 발송
   • 인증번호가 일치하면 임시토큰을 Redis에 키값으로 매핑해 저장
   • 이 토큰은 회원가입 완료 시 영구 세션 토큰으로 교체

3. 기본 정보 입력

   • 입력 항목: MBTI, 성별, 학과(학부), 학번(입학 연도), 나이, 인스타그램 ID
   • 서버가 값 검증·중복 체크 후 임시토큰 세션에 임시 보관 → 다음 단계 이동

4. 랜덤 별명 생성

   • 규칙: 학과명 + 랜덤 형용사 + 랜덤 동물 (예: “컴퓨터공학과 수줍은 하마”)
   • “다시 뽑기” 1회만 허용
   • 별명 확정 시 프로필에 저장되고, 임시토큰이 “회원가입 완료” 토큰으로 교체

5. 메인 페이지

   • 상단: 내 별명·매칭 상태
   • 중앙 탭: [매칭하기] [게시판] [채팅]
   • 채팅 탭은 매칭된 그룹이 있을 때만 활성화

6. 매칭하기 – 대기열 등록

   • [매칭 시작] 클릭 시 설정
     1. 모드 선택: 1 : 1 동성 / 2 : 2 이성
     2. 희망 학번 범위
     3. 선호 MBTI
   • 같은 학과는 무조건 제외
   • 매칭 완료 후 24 시간 쿨다운(재매칭 불가)

7. 매칭 알고리즘 – 그룹 완성

   • Redis 큐에 성별·학과·학번·MBTI 조건이 맞는 사용자를 순차 배치
   • 1 : 1 → 동성, 2 : 2 → 남 2 + 여 2 구성
   • 4명 충원 시 match_group 생성, 전원 status = MATCHED

8. 매칭 완료 화면

   • 프런트가 주기적 폴링으로 매칭 결과 확인
   • 화면: 4명 별명 + 인스타 ID 표시,
     • 안내: “매칭이 완료되었습니다. 30 분 내에 인스타 DM방을 만들어 인사해 주세요.”
   • [채팅 시작] 버튼 활성화 → 그룹 전용 채팅방 진입

9. 채팅 기능

   • 매칭 확정 시 chat_room:{groupId} 생성, TTL 24 시간
   • 텍스트·이모지·이미지 실시간 WebSocket 전송
   • TTL 만료 후 채팅 기록·방 자동 삭제

10. 게시판

    • 카테고리: “개발자에게 한 마디”, “과팅 후기” 등
    • 글 작성 최대 500자, Cursor 기반 무한 스크롤
    • 글·댓글 신고 3회 이상 → 자동 숨김