"프로젝트 경험을, 증명 가능한 포트폴리오로."
Passfolio — Pass(합격) + Portfolio(포트폴리오), 이름 그대로 '합격하는 포트폴리오' 를 지향합니다.
개발자 취업 준비생의 GitHub 프로젝트를 분석하고, 이를 근거로 기존 포트폴리오를 개선하거나 새 포트폴리오의 방향을 설계해주는 서비스입니다.
본 레포지토리는 해당 서비스의 Backend(API Server · Orchestration Hub) 를 담당합니다.
- AI발 기술 변화와 경력직 선호 속에 '쉬었음' 청년은 6년간 약 32% 증가(36.0만 → 47.7만 명)했고, Z세대 92% 가 "취업 문턱이 높아졌다"고 답했습니다.
- 채용 평가의 무게중심은 스펙에서 '증명된 실력' — 포트폴리오·실증으로 이동하고 있습니다.
- 그런데 정작 구직 개발자의 57.5% 가 "내용·성과의 논리적 정리"를, 52.5% 가 "기여도 명시"를 가장 어려워합니다. 어려움의 본질은 디자인이 아니라 내용 구조화입니다.
- 기존 서비스는 문장 '교정'(첨삭)이나 git 메타데이터 기반 '템플릿'에 머물러, 개발자 포트폴리오의 '내용'에 특화된 서비스는 공백이었습니다.
- 프로젝트 분석 : GitHub 저장소를 clone하여 코드 기여도·기술 스택·핵심 성과를 추출한 분석 리포트 생성
- 포트폴리오 개선·설계 : 분석 결과를 근거로 기존 포트폴리오 개선 및 신규 포트폴리오 방향 설계
- 성장 로드맵 : 채용 시장 기준의 역할별 스킬 커버리지 진단과 학습 경로 제시
- 자기소개서 확장 : 포트폴리오와 자기소개서의 상호 변환·개선
- 동일 포트폴리오 기준, 단순 문장 교정은 평가 점수 +1.15에 그쳤지만 코드 분석을 결합한 개선은 60.2 → 77.8(+17.5) 을 달성 — '근거 있는 내용 개선'의 효과를 정량적으로 확인했습니다.
- 기여도·핵심 기능·성과가 코드에서 자동 도출되므로, 지원자는 객관적 근거로 실력을 증명할 수 있습니다.
🧐 평가 기준?
Passfolio는 포트폴리오·자소서를 개선(생성) 전후로 각각 채점하여 점수 변화(delta)를 함께 제공합니다.
- LLM Model:
gemini-3.1-flash-lite(temperature=0) - 구조화 출력: 항목별
score / reason(근거) / fix(개선 제안)반환 - 전후 비교: 원문과 개선안을 병렬 평가한 뒤 최종 점수·항목별 delta를 산출
| 점수 | 등급 |
|---|---|
| 85 이상 | 우수 ★★★ |
| 70 ~ 84 | 양호 ★★ |
| 55 ~ 69 | 보통 ★ |
| 55 미만 | 미흡 |
📁 포트폴리오 평가 기준 (5개 항목)
| 항목 | 가중치 | 평가 내용 |
|---|---|---|
| A. 과정/판단력 | 35% | 배경→문제인식→판단→실행 흐름의 명확성, 기술/도구 선택 이유("왜 이 기술인가", 대안 대비 근거) |
| B. 역할/기여도 | 25% | 본인 역할의 구체성, 1인칭 기여 표현("내가/주도/직접 설계"), 트러블슈팅 서술(문제→원인→해결) |
| C. 성과/인사이트 | 20% | 정량적 성과 우선, 경험→성장→직무 기여 연결 |
| D. 작성품질 | 10% | 아래 세부 채점표로 합산 |
| E. 직무연관성 | 10% | 목표 직무 관련 기술·경험·역량 증명 여부 |
| 세부 항목 | 배점 | 기준 |
|---|---|---|
| D1. 분량 | 0~40 | 400자 이상 40점 / 200~399자 20점 / 200자 미만 0점 |
| D2. 수치 성과 밀도 | 0~40 | 정량 성과(%, ms, 배수, 건수) 3개 이상 40점 / 2개 25점 / 1개 10점 / 0개 0점 ※ 날짜·기간·전화번호는 제외 |
| D3. 감점 | -20~0 | 추상 표현("열심히" 등) 1개당 -3점(최대 -10) / 동일 의미 중복 1건당 -4점(최대 -8) / 근거 없는 bullet 단순 나열 4개 이상 -5점 |
D = max(0, D1 + D2 + D3), 최대 80점 — LLM 반환값을 신뢰하지 않고 코드에서 재계산
최종 점수 = A×0.35 + B×0.25 + C×0.20 + D×0.10 + E×0.10
📝 자소서 평가 기준 (4개 항목)
| 항목 | 가중치 | 평가 내용 |
|---|---|---|
| A. 지원동기 | 20% | 두괄식 구성, 기업 이해도 반영, 입사 설득력 |
| B. 직무역량 | 40% | STAR 구조(상황-과제-행동-결과) 충족, 수치/정성 성과, 경험→성장→기여 연결 |
| C. 인재상 | 25% | 핵심 가치관 부합, 소통/협업 경험, 갈등 해결 사례 |
| D. 작성품질 | 15% | 아래 세부 채점표로 합산 |
평가 시 문항 제목과 글자 수 제한을 함께 전달하여 문항 맥락에 맞게 채점합니다.
- 성장과정·자기소개 문항 → A에서 '기업 이해도' 대신 서술 구조·진정성 중점 평가
- 직무역량 문항 → B에 더 높은 기대치 적용
- 섹션 제목에서 글자 수 제한 자동 파싱 (예: "최대 1,000자", "500자 이내", "제한없음")
| 세부 항목 | 배점 | 기준 |
|---|---|---|
| D1. 분량 | 0~40 | 글자 수 제한이 있으면 충족률 기준: 90% 이상 40점 / 70~89% 25점 / 50~69% 15점 / 50% 미만 0점 제한이 없으면: 800자 이상 40점 / 600~799자 20점 / 600자 미만 0점 |
| D2. 성과 밀도 | 0~40 | 정량 성과 3개 이상 30점 / 2개 20점 / 1개 10점 + 구체적 정성 성과("무엇이→어떻게→어떤 변화" 충족 시만 인정) 2개 이상 10점 / 1개 5점 ※ 정량이 없어도 정성으로 최대 10점 획득 가능 |
| D3. 감점 | -20~0 | 추상 표현 1개당 -3점(최대 -10) / 동일 의미 중복 1건당 -2점(최대 -8) / 내용 없는 bullet 4개 이상 -5점 |
D = max(0, D1 + D2 + D3), 최대 80점
최종 점수 = A×0.20 + B×0.40 + C×0.25 + D×0.15
개선 전후 텍스트를 각각 채점한 뒤 아래 정보를 반환합니다.
eval_before/eval_after: 개선 전/후 가중 총점eval_delta: 점수 변화량 (after − before)eval_detail: 항목별 전후 점수·변화량·근거·개선 제안
- 연령대 : 20대 초반 ~ 30대 초반의 IT 취업 준비생·주니어 개발자
- 특징 : GitHub에 프로젝트 경험은 있으나 이를 포트폴리오 '내용'으로 구조화하는 데 어려움을 겪음
- 니즈 : 기여도·성과의 객관적 증명, 채용 시장 기준의 방향 제시, 문서 작성 부담 경감
서비스의 구체적인 내용은 아래에서 확인하실 수 있습니다.
- 서비스 : @Passfolio Site
- 발표 자료 (Web PPT) : @Passfolio PPT
💡 구글에 Passfolio라고 검색해도 최상단에 나와요 😆
| 김태현 | 송성호 |
|---|---|
 @Youcu |
 @sungho1949 |
| 파트리더 · 풀스택 | 팀원 · 백엔드 |
Frontend — @Passfolio/Frontend
| 김태현 | 박준우 |
|---|---|
| @Youcu |
 @parkjunwoo0209 |
| 파트리더 · 풀스택 | 팀원 · 프론트엔드 |
Portfolio-AI — @Passfolio/Portfolio-AI
| 이상빈 | 박준우 | 송성호 |
|---|---|---|
 @dltkdqlsco |
@parkjunwoo0209 |
@sungho1949 |
| 팀 리더 | 파트리더 · 팀원 | 팀원 |
| 김태현 |
|---|
| @Youcu |
| 파트리더 · 프로젝트 분석 AI |
본 Part의 Repo는 Private으로 비공개 영역입니다.
Backend 파트가 담당하는 서비스 핵심 기능입니다. 모든 비동기 작업의 디스패치/집계 허브(Orchestration Hub) 역할을 합니다.
- 인증 · 보안 : GitHub OAuth2 + JWT 인증, GitHub 토큰은 AES(Redis) + AWS KMS 이중 봉투 암호화로 보관
- 분석 오케스트레이션 : 분석 요청을 SQS로 디스패치(precheck · analysis)하고, Lambda 웹훅으로 결과를 수신해 배치 단위로 집계
- 분석 → 포트폴리오 파이프라인 : 배치 전건 성공 시 FastAPI(Portfolio-AI)로 포트폴리오·로드맵 생성을 자동 핸드오프 (private 내부 호출)
- 실시간 알림 : SSE 기반 저장소별 분석 진행률·상태 스트리밍
- 동시성 · 안정성 : Redisson 분산 락, Bucket4j + Redis 분산 레이트 리밋(Fail-Open/Fail-Closed), Caffeine L1 캐시
- 파일 처리 : S3 멀티파트 업로드 + Presigned URL, Spring Batch 기반 미사용 파일 정리
- 알림 연동 : Solapi SMS · 메일 발송
| Category | Stack |
|---|---|
| Backend |        |
| DB · Cache |      |
| Observability |    |
| 버전 관리 |  |
| 협업 툴 |   |
| CI/CD |    |
| Infra |      |
- 서비스 Documentation : @passfolio.dev/docs
- 발표 자료 (Web PPT) : @Passfolio Deck
- BE Deployment : @Notion-BE Deployment
- Cloudflare : @Notion-Cloudflare
- OpenAPI Data Pipeline : @Notion-Open API Data Pipeline : data.go.kr
- BE Convention : @Notion-BE Convention
💡 Architecture는 PPT 참조
- Harness Engineering : @Notion-Harness Engineering
- 기획 및 제안서 : 2026.03.03 ~ 2026.03.23
- 상세 설계 : 2026.03.24 ~ 2026.04.14
- UI/UX 디자인 : 2026.04.04 ~ 2026.04.18
- 개발 착수 : 2026.04.19 ~ 2026.06.04
- 테스트 (Unit · E2E 병행) : 2026.04.19 ~ 2026.06.04
- 시연 : 2026.06.04
- 최종 발표 PT : 2026.06.07
gantt
title Passfolio 개발 일정 (2026)
dateFormat YYYY-MM-DD
axisFormat %m/%d
section 기획 · 설계
기획 및 제안서 :a1, 2026-03-03, 2026-03-23
상세 설계 :a2, 2026-03-24, 2026-04-14
UI/UX 디자인 :a3, 2026-04-04, 2026-04-18
section 개발 · 테스트
개발 :b1, 2026-04-19, 2026-06-04
테스트 (Unit · E2E 병행) :b2, 2026-04-19, 2026-06-04
section 마무리
시연 :milestone, m1, 2026-06-04, 0d
최종 발표 PT :milestone, m2, 2026-06-07, 0d
- 관리 방식 : 파트별 분업 + 주간 단위 반복(스프린트 유사)으로 진행, 파트 간 인터페이스(API·웹훅)는 사전 합의 후 병렬 개발
- 이슈 관리 : GitHub Issues로 기능·버그 단위 추적
- 문서 관리 : Notion에 기획안·회의록·기술 문서 기록, 서비스 문서는 웹 Documentation 페이지로 공개
- 소스 코드 관리 : GitHub Pull Request 기반 코드 리뷰 및 히스토리 관리, Discord로 실시간 커뮤니케이션
💬 About Passfolio Team
◦ 명지대학교(자연) 캡스톤 디자인 프로젝트를 진행한 Team 20세기's 입니다.
◦ 재학생 4인 구성으로, 4개 파트(FE · BE · Portfolio-AI · Project-Analyzer-AI)를 나누어 협업했습니다.
◦ 현재 서버 운영은 일시 중단 상태이며, 2026년 12월 정식 출시를 목표로 재정비 중입니다. 문의: hooby@passfolio.dev