AI 이력서 평가 및 적성 검사 시스템

MatchingFit 은 수강생의 이력서를 AI가 분석하여 역량 기반 정량 평가 및 인사담당자의 성향에 맞는 인재 추천 시스템 입니다.

👥 팀원 소개

배민서	권태윤	김명수	윤지수
BE	BE	BE	FE
팀장	팀원	팀원	팀원
GitHub	GitHub	GitHub	GitHub

---

📸 UI 스크린샷

• 메인 페이지 화면(대시보드)

  

로그인 & 회원가입 화면

이력서 분석

업무 성향 테스트

HR 담당자 성향테스트

분석결과 화면

결과 보고서 다운로드

---

🛠️ 주요 기능

• 사용자: 이력서 업로드 및 분석 기능, 이력서 분석 결과 및 PDF 다운 이력서 매칭 될 경우 메일 알림
• 인사담당자: HR 성향테스트 및 유저 이력서 매칭 기능

---

⚙️ 인프라 환경

• 사용자: 이력서 업로드 및 분석 기능, 이력서 분석 결과 및 PDF 다운 이력서 매칭 될 경우 메일 알림
• 인사담당자: HR 성향테스트 및 유저 이력서 매칭 기능

---

🏗️ 기술 스택

분야	기술
Backend	Spring Boot, JPA, OPENAI, ELASTICSEARCH, KIBANA, PYTHON
Frontend	Next.js, TypeScript
Database	PostgreSQL, S3
DevOps	Docker, NGINX, REDIS
CI/CD	GitHub Actions

---

Language

Frontend

Backend

Infra

Cooperation

---

🚀 Getting Started

Backend (Spring Boot)

# 1. 프로젝트 클론
git clone https://github.com/MatchingFit/MatchingFit_BACKEND.git
cd MatchingFit_BACKEND

# 2. 환경변수 설정
cp src/main/resources/application.yml.example src/main/resources/application.yml
# (application.yml을 자신의 DB/환경에 맞게 수정하세요)

# 3. 서버 실행
./gradlew bootRun

Frontend (Next.js)

cd MatchingFit_FRONTREND

# 의존성 설치
npm install

# 개발 서버 실행
npm run dev

---

📂 Project Structure

backend
└── src
    └── main
        └── java
            └── com
                └── example
                    └── matcing_fit
                        ├── domain/          # 핵심 도메인 로직
                        │   ├── manager/     # 인사담당자 관련
                        │   ├── resume/      # 이력서 관련  
                        │   ├── score/       # 점수 관련
                        │   └── user/        # 사용자 관련
                        ├── global/          # 전역 설정 (Ai, Elasticsearch, 보안 등)
                        └── Application.java # 메인 클래스

---

🧱 Git 컨벤션

📍 브랜치 전략

• main: 운영 배포용 브랜치
• dev: 다음 출시 버전을 개발하는 브랜치 (오류 없는 코드만 push)
• 기능 브랜치 규칙:

main
develop
chore/브랜치명{issue-number}
hotfix/브랜치명{issue-number}
feat/브랜치명{issue-number}
refactor/브랜치명{issue-number}

예시:
31-feat-마이페이지-api-추가

---

📌 Git-Flow 전략

브랜치	설명
main	제품 출시용 안정화 브랜치
develop	통합 개발 브랜치 (기능 병합 후 테스트)
feat/*	기능 개발 브랜치 (develop에서 분기)

---

📍 커밋 메시지 컨벤션

<타입> <변경 요약> <이슈번호(optional)>

예시:
feat : user생성 #10

---

✅ 커밋 타입 목록

타입	설명
Feat	새로운 기능 추가
Fix	버그 수정
Refactor	코드 리팩토링
Chore	패키지 매니저 수정, 그 외 기타 수정 ex) .gitignore
!HOTFIX	급하게 치명적인 버그를 고쳐야 하는 경우

---

멋쟁이사자처럼 인턴쉽 프로그램 프로젝트입니다.