← 모든 프로젝트

4명 팀 프로젝트 · 백엔드 · 2026.08 – 2026.10 (10주)

Super-Sub

생활체육 경기 영상으로 실력을 검증하고, 팀에 필요한 용병을 찾아 주는 플랫폼

  • Python
  • FastAPI
  • PostgreSQL
  • Next.js
  • Flutter
  • pgvector
  • ViTPose
  • EXAONE
  • vLLM
  • k3s
  • AWS
  • Cloudflare

데모 — 예시 데이터로 화면만 둘러보는 판입니다. 실제 데이터와 영상 분석이 도는 판은 개인 PC 에 있습니다.

팀 서비스 — 팀이 AWS 에서 운영하는 서비스입니다.

개인 사본 구성 — 팀 서비스 전체를 개인 PC 에서 돌리는 인프라 코드입니다. 보여 주기용으로 추린 저장소라 팀 코드는 들어 있지 않습니다.

대회 참가작 — 원티드 AI Championship 2026 에 팀으로 참가해 올린 페이지입니다.

Super-Sub 첫 화면

어떤 서비스인가

생활체육 팀(풋살 · 축구 등)은 사람이 모자랄 때 용병을 구하지만, 처음 보는 사람의 실력은 알 길이 없습니다. Super-Sub 는 그 사람이 올린 경기 영상을 근거로 삼습니다.

경기 영상 관절(자세) 추출 항목별 점수 실력 리포트 — 등급 · 판정 문장
선수 카드 포메이션 빈 자리 — AI 추천 · 지인 찾기 경기 신청 · 수락 알림

분석 결과 화면

영상을 올리고 분석할 선수를 고르면 관절을 따라가며 자세를 재고, 기준 선수와 나란히 놓아 차이를 보여 줍니다. 팀 시연 영상의 장면이고, 화면 속 영상은 시연용입니다.

공을 차는 선수의 다리에 관절 선이 그려지고, 오른쪽에 분석 진행 단계가 보이는 화면
관절 추적 — 고른 선수의 관절을 따라가며 자세를 잰다. 오른쪽은 분석이 진행되는 단계
기준 선수 영상과 올린 영상이 나란히 놓이고, 오른쪽에 등급과 근거 문장, 항목별 점수 도형이 보이는 화면
기준 선수와 비교 — 분홍이 기준 선수, 초록이 올린 영상. 오른쪽에 등급 · 근거 문장 · 항목별 점수
백스윙, 접촉, 접촉 후 세 순간의 자세를 분홍과 초록 뼈대로 겹쳐 그린 화면
임팩트 순간 맞추기 — 백스윙 · 접촉 · 접촉 후의 자세를 겹쳐 차이를 본다
등급과 점수, 근거 문장, 여섯 항목의 점수 도형이 있는 분석 리포트
분석 리포트 — 등급, 근거 문장, 여섯 항목의 점수. 내 프로필에서 다시 볼 수 있다

서비스 구성

4명이 영역을 나눠 맡았습니다. 수치는 그 영역 전체의 것이고, 팀 문서의 2026-09-23 기준입니다.

박민호PM · QA

요구사항 · 일정 관리QA 총괄main 통합
이미지가 올라옴 2분 안에 서버가 스스로 갱신 파드가 뜰 때 마이그레이션
백엔드 배포를 k3s 로 전환GitHub Actions — 이미지 빌드

백성검웹 · 앱

분석 리포트 화면선수 카드 · 공개 링크포메이션 판AI 추천팀 매칭 화면
Next.js 16 · React 19서버 쪽 중계(BFF) · httpOnly 쿠키Flutter · Riverpod — 계약 시험 · 실서버 연결(스토어 배포 전)

나백엔드 · 파이프라인 · 배포

7컨텍스트(헥사고날)
100API 엔드포인트
48DB 마이그레이션
사용자카드분석매칭평가과금알림
영상 업로드 — S3 분석 작업 큐 결과 적재 리포트 API
EC2 서버 · S3 권한 · DB 백업시험 CI — 백엔드(실제 DB) · 앱

정상호AI 분석

사람 검출(RT-DETR) 자세 추정(ViTPose) 동작 특징 규칙(루브릭) 채점
0.00같은 영상 다섯 번 — 총점 표준편차(영상 4편)
약 1분 6초한 편 분석, S3 입출력까지(T4 · vLLM)
등급은 코드가 결정론적으로EXAONE 4.0 1.2B 는 근거 문장만GPU 워커가 큐에서 가져간다

한계 — 채점 기준은 축구 인스텝 슈팅 하나, 임계값은 지도자 검수 전 잠정치

넷이 함께

API — EC2 의 k3s영상 — S3분석 — 필요할 때만 켜는 GPU 서버웹 — Vercel · 앞단 — Cloudflare
1,126백엔드 시험
446AI 시험
1,085웹 시험
419앱 시험
제안서 9장 · 부록 · 개발 로그를 문서 사이트로

내가 맡은 일 — 백엔드

팀에서 백엔드를 맡았습니다. 커밋 439건 중 175건이 백엔드 코드(fastapi/)이고, 나머지는 대부분 API 계약 · 요구사항 같은 설계 · 진행 문서입니다(2026-09-29 기준).

백엔드 코드 커밋 175 / 439

서버의 뼈대와 규칙

바운디드 컨텍스트 × 계층(헥사고날)API 계약 문서 + pytestPostgreSQL · SQLAlchemy · Alembic
스키마 변경은 마이그레이션으로

회원과 보안

가입 · 로그인 — bcrypt · 서명된 JWT
구글 ID 토큰 검증 계정 생성
인증 사건 로깅인증 엔드포인트 요청 제한운영에서 API 문서(/docs) 닫기

영상 분석 파이프라인

업로드 — S3 사전 서명 URL 작업 큐 워커 S3 결과 → DB 적재 리포트 API
멈춘 작업 회수프로필 보관DB · S3 연쇄 삭제저장 안 한 임시 영상 정리재업로드 감지

팀과 매칭

팀 초대 · 수락 팀↔팀 경기 신청 · 수락 알림
매칭 조건 · 상대 후보빈 자리 추천 후보서로 지인 신청

운영

/metrics 엔드포인트k3s 배포 매니페스트시연용 자동 수락 봇

맡은 영역 밖에서 한 일

맡은 영역은 백엔드였지만, 기능이 화면 끝까지 이어지도록 다른 사람의 영역도 필요한 만큼 고쳤습니다. 팀 main 에 들어간 것만 적었습니다.

웹 화면 — 백성검 님 영역

오버롤 등급 · 레이더 차트진행 표시가 실제 완료를 따라감 · 실패는 따로관리자 페이지(/admin/videos)매칭 · 경기 화면이 페이지를 옮겨도 이어짐「경기 완료」 흐름 · 시간 겹침 규칙 + 시험시연용 심사위원 계정 배정

화면 ⇄ 서버 — 어긋나던 결함(초대를 수락해도 판에 안 서던 것 · 뺀 사람이 새로고침하면 되살아나던 것)을 양쪽을 함께 고쳐 풀었다

협업 도구

push · PR CI 백엔드(실제 PostgreSQL · pgvector) · Flutter 시험
시험을 도는 CI 를 처음 걸었다문서 사이트 그림 · ERD 생성기를 저장소로

끝난 뒤에도 돌게 — 개인 사본

팀 서비스는 AWS 에서 돌았습니다. 프로젝트가 끝나도 보여 줄 수 있도록, 팀 코드는 한 줄도 고치지 않고 전체를 내 PC 로 옮긴 사본을 따로 운영합니다. 위 「데모」는 그 사본의 화면을 예시 데이터로 늘 열어 둔 것입니다.

팀(AWS)개인 사본(내 PC) EC2k3s — PostgreSQL · 백엔드 · 화면 S3MinIO — 환경 변수 하나(AWS_ENDPOINT_URL_S3) 공인 IPCloudflare 터널 GPU 서버 T4 16GBRTX 3050 8GB — 추론 서버 없이 GPU 를 차례로
백업 하나(비밀 값 · 데이터) 새로 클론한 저장소 깨끗한 환경에서 전체 복구
약 1분 30초되살리기(기계 준비물이 있는 상태)
첫 HEAD 요청만 403 → 백엔드만 클러스터 안에서 MinIO 에 직결화면 개인화는 빌드 때 패치로 — 「팀분석」 화면
팀분석 화면 — 팀장·팀원 알약과 포메이션 판
팀분석 화면 — 팀장이 포메이션 판의 빈 자리를 채운다(시연 데이터)