🔊 스펙랭킹 (SpecRanking)

취업 준비생을 위한 스펙 분석 & 랭킹 비교 서비스
스펙, 점수로 보이고 싶다면?
이젠 감이 아닌, 데이터로 나를 확인해보세요.

---

📌 프로젝트 개요

**스펙랭킹(SpecRanking)**은 취업 준비생(이하 취준생)들의 스펙 데이터를 기반으로 AI 분석 및 유사 집단과의 비교 랭킹을 제공하는 웹 서비스입니다.
최근 채용 시장은 직무별 요구 역량이 복잡해지고, 구직자 개인이 자신의 위치를 정확히 파악하기 어려워졌습니다.
이에 따라 스펙랭킹은 아래와 같은 문제의식을 바탕으로 개발되었습니다:

• “내 스펙은 괜찮은 걸까?”
• “나와 비슷한 사람들은 어떻게 준비했을까?”
• “무엇을 더 보완해야 할까?”

사용자는 스펙 정보(예: 학력, 자격증, 어학 점수, 인턴 경험 등)를 입력하면, AI가 점수를 산정하고 비슷한 사용자들과의 상대 랭킹을 시각화해 보여줍니다.
이를 통해 자신을 객관적으로 바라보고, 앞으로 어떤 준비가 필요한지 방향을 잡을 수 있습니다.

단순한 점수 매기기를 넘어, 취업 전략 수립의 나침반이 되는 것이 우리의 최종 목표입니다.

---

📋 설명

개발자들이 자신의 스펙(경력, 학력, 자격증 등)을 등록하고 비교할 수 있는 플랫폼의 백엔드 시스템입니다. 사용자 인증, 스펙 관리, 실시간 채팅, 소셜 기능, AI 기반 분석 등 다양한 기능을 제공합니다.

ERD

ERDCloud

관련 블로그 글

1. 기술 스택 선정 과정 - 확장성과 안정성 사이의 균형점 찾기

2. ERD 설계 과정에서 마주한 기술적 트레이드오프들

3. 채팅방 삭제 기능 설계 - 미래를 대비한 ERD 설계

4. JPA 양방향 매핑과 CASCADE.ALL 도입 결정 과정

5. 분산 환경에서 1:1 채팅 서버 구축하기 - 이벤트 기반 아키텍처 도입기

6. WebSocket + Kafka를 활용한 실시간 채팅 시스템 구현기

7. 테크 스펙 작성 - 문서로 하는 코딩

✨ 기능 요약

🔐 사용자 인증 시스템

• OAuth2 소셜 로그인: 카카오 로그인 지원
• JWT 토큰 인증: Access Token + Refresh Token 방식
• 보안 필터: Spring Security 기반 인증/인가
• 자동 토큰 갱신: 만료된 토큰 자동 갱신 스케줄러

👤 User Domain

• 사용자 정보 관리
• 프로필 이미지 업로드
• 닉네임 중복 검사

📊 스펙 관리 시스템

• 종합 스펙 등록: 학력, 경력, 자격증, 어학점수 등록
• 스펙 조회: 다양한 필터, 스펙 상세 정보 관리, 사용자 스펙 검색
• AI 분석: AI서버로 응답을 활용해 스펙 데이터 기반 인사이트 제공

💬 실시간 채팅 시스템

• WebSocket 통신: 실시간 메시지 송수신
• 채팅방 관리: 1:1 채팅방 자동 생성 및 관리
• Kafka 연동: 메시지 이벤트 스트리밍
• Ping-Pong: 연결 상태 확인 스케줄러
• 알림: 실시간 알림 시스템

🤝 소셜 기능

• 북마크: 관심 있는 사용자 북마크
• 댓글 시스템: 스펙에 대한 댓글 및 대댓글
• 알림: 실시간 알림 시스템

📄 이력서 관리

• 파일 업로드: PDF 이력서 업로드 및 관리
• S3 저장: AWS S3 기반 파일 저장소

🏗️ 아키텍처

도메인 중심 설계

src/main/java/kakaotech/bootcamp/respec/specranking/
├── 🎯 domain/                     # 도메인 계층
│   ├── auth/                     # 인증 도메인
│   ├── user/                     # 사용자 도메인
│   ├── spec/                     # 스펙 도메인
│   ├── chat/                     # 채팅 도메인
│   ├── social/                   # 소셜 도메인
│   └── notification/             # 알림 도메인
├── 🌐 global/                     # 글로벌 설정
│   ├── common/                   # 공통 설정
│   ├── infrastructure/           # 인프라 계층
│   └── devsetup/                 # 개발 환경 설정
└── SpecRankingApplication.java   # 메인 애플리케이션

인프라 구조

Frontend (React) 
       ↓
Load Balancer
       ↓
Backend Server (Spring Boot)
       ├─ MySQL (데이터 저장)
       ├─ Redis (캐시 및 세션)
       ├─ AWS S3 (파일 저장)
       ├─ Kafka (메시지 스트리밍)
       └─ AI Server (스펙 분석)

배포 환경

• 개발: dev 브랜치 → dev 환경
• 스테이징: stage 브랜치 → stage 환경
• 운영: main 브랜치 → prod 환경

🔧 개발 도구

개발 환경 초기화

프로젝트에는 개발용 데이터 초기화 클래스들이 포함되어 있습니다:

• InitializeUser: 테스트 사용자 생성
• InitializeSpec: 샘플 스펙 데이터 생성
• InitializeChat: 테스트 채팅 데이터 생성

프로필별 설정

• local: 로컬 개발 환경
• dev: 개발 서버 환경
• stage: 스테이징 환경
• prod: 운영 환경

프로필별 설정으로 손쉽게 로컬 개발 환경에서도 S3 및 AI 서버와의 의존성을 해결할 수 있습니다. Mock 서버 빈을 주입 받아 외부 의존성 없이 개발을 진행할 수 있습니다.

📚 관련 레포

• ChatConsumer 서비스: 19-Respec-BE-Chatconsumer - 채팅 메시지 처리 마이크로서비스