CokZIP

해커톤에서 만든 학습 도우미

2026년 8월 GEEKS 해커톤에서 시작했습니다. 관심 분야와 학습 목표, 현재 수준을 입력하면 커리큘럼을 만들고 문제 풀이와 오답 복습으로 이어지는 서비스를 기획했습니다.

사용 흐름

1. Google 계정으로 로그인하고 관심 분야·목표·수준을 입력합니다.
2. Gemini가 3~8개의 학습 스텝으로 커리큘럼을 만듭니다.
3. 각 스텝에서 영상과 요약을 보고 4지선다 진단 문제를 풉니다.
4. 채점 결과와 해설을 저장하고, 틀린 문제를 개념별로 묶어 복습합니다.
5. 시험 모드에서는 오답률과 마지막 풀이 시점을 기준으로 복습 순서를 정합니다.

맡은 역할

아이디어와 기능 구성을 정하는 기획을 주도했습니다. 온보딩부터 학습·복습·시험 대비까지의 흐름을 정리하고, Spring Boot 백엔드의 API·데이터 처리와 클라이언트 연결을 지원했습니다.

WORK NOTES

트러블슈팅

02 CASES

1. 01

   처음 로그인한 뒤 잘못된 화면으로 이동했습니다.

   이전 이동

   첫 로그인 → 학습 화면으로 바로 이동

   현재 이동

   신규 → 목표 입력 / 기존 → 학습 화면

   해결 과정과 코드 보기

   원인

   로그인 성공만 보고 이동하면 처음 온 사용자도 학습 화면으로 가서 목표 입력을 건너뛰었습니다.

   해결 방법

   서버 응답에 신규 여부인 isNewUser를 넣었습니다. 클라이언트는 값이 true면 /onboarding, 아니면 /로 보냅니다.

   결과

   신규 사용자는 목표 입력 화면으로, 기존 사용자는 학습 화면으로 이동합니다.

   실제 코드와 출처

   isNewUser가 참이면 목표를 입력하는 화면으로, 아니면 기존 학습 화면으로 보냅니다.

   if (result.isNewUser) {
     router.push("/onboarding");
   } else {
     router.push("/");
   }
   

   서버 응답 · 화면 분기 코드

2. 02

   진행률이 실제보다 크게 표시됐습니다.

   이전 표시

   50 × 100 = 5000%

   현재 표시

   50% 그대로 표시

   해결 과정과 코드 보기

   원인

   서버가 이미 0~100%로 보낸 진행률에 화면에서 다시 100을 곱해 숫자가 커졌습니다.

   해결 방법

   서버의 퍼센트 계산을 확인한 뒤 화면의 추가 곱셈을 제거했습니다. 클라이언트는 받은 진행률을 반올림해 그대로 표시합니다.

   결과

   6개 중 3개를 마치면 50%로 표시합니다. 전체 스텝이 없으면 서버가 0을 반환합니다.

   실제 코드와 출처

   progressRate는 이미 퍼센트이므로 화면에서는 한 번만 반올림합니다.

   progressRate: Math.round(data?.progressRate ?? 0),
   

   서버 계산 · 화면 표시

기술 구성

완성한 범위

로그인부터 온보딩, 학습, 오답 복습, 시험 모드까지 구현한 해커톤 프로토타입입니다. 서버에는 인증과 각 학습 단계의 API를 구성했고, 서비스·보안·AI 연동을 확인하는 테스트 코드도 포함했습니다.