Overview

Pullit - AI 기반 학습 플랫폼 (2025.08 ~ 2025.11)

PDF 학습 자료를 올리면 AI가 문제를 만들어 주고, 틀린 문제는 오답노트로 다시 풀 수 있는 학습 플랫폼입니다. 카카오테크캠퍼스 3기에서 프론트엔드 4명이 함께 만들었고, 22개 팀 중 1위로 최우수 프로젝트상을 받았습니다.

저는 프로젝트 초기 세팅과 CI, 전체 레이아웃과 라우팅, SSE 실시간 알림을 구축하고 문제 풀이, 오답노트, 대시보드 페이지와 반응형 디자인을 맡았습니다.

Tech Stack

Frontend

- React 19, TypeScript, Vite, React Router, TanStack Query, Axios, Emotion, Chakra UI

Code Quality

- ESLint(Airbnb), Prettier, Husky

Infra / DevOps

- GitHub Actions, Vercel

Features

문제집 생성

- PDF를 올리면 AI가 객관식, 참/거짓, 단답형 문제를 생성

- 생성되는 동안 다른 페이지를 쓸 수 있고, 완료되면 실시간 알림

문제 풀이

- 문제 유형별 풀이 화면, 자동 채점, 정답과 해설

나의 문제집

- 폴더로 문제집 분류, 이름 변경, 삭제, 다시 풀기

오답노트

- 틀린 문제만 다시 풀기, 맞히면 오답 수가 줄고 모두 맞히면 자동 삭제

대시보드

- 학습 통계와 최근 1년의 학습 기록(잔디)

Implementation

개발 환경과 협업 규칙

4명이 같은 코드베이스에서 작업하는 만큼, 코드 스타일과 품질을 사람이 아닌 도구가 지키도록 초기 환경을 만들었습니다.

- Vite + React + TypeScript로 프로젝트를 세팅하고 디자인 토큰을 정의했습니다.

- ESLint(Airbnb)와 Prettier를 Husky로 커밋 전에 자동 실행하고, Windows와 macOS 사이의 개행 문자를 LF로 통일했습니다.

- PR마다 GitHub Actions에서 Prettier, ESLint, 타입 검사를 실행해 검사를 통과한 코드만 병합되도록 했습니다.

- 스타일링 방식을 Tailwind CSS·shadcn에서 Emotion·Chakra UI로 전환했습니다.

레이아웃과 라우팅

초기에는 state 값으로 화면을 바꾸는 구조여서 URL만으로는 어떤 페이지인지 알 수 없었습니다.

- React Router의 중첩 라우팅(Outlet)으로 바꿔, 헤더와 사이드바는 그대로 두고 페이지 영역만 바뀌도록 했습니다.

- 사이드바의 현재 메뉴 강조도 state 대신 URL을 기준으로 바꿔, 새로고침하거나 주소로 바로 들어와도 올바르게 표시되도록 했습니다.

SSE 실시간 알림

문제 생성에는 시간이 걸리기 때문에, 기다리는 동안 다른 페이지를 쓰다가 완료되면 바로 알 수 있도록 SSE를 적용했습니다.

- SSE 연결 로직을 커스텀 훅으로 분리하고, 전역 레이아웃에서 연결을 유지합니다.

- 생성이 끝나면 토스트 알림을 띄우고, 토스트를 누르면 해당 문제집의 풀이 페이지로 바로 이동합니다.

- 알림이 쌓이지 않도록 토스트는 한 번에 하나만 보이게 했습니다.

문제 풀이

객관식, 참/거짓, 단답형 세 가지 유형을 하나의 풀이 흐름 안에서 처리하도록 설계했습니다.

- 문제 유형에 따라 풀이 컴포넌트를 바꿔 렌더링해, 새 유형이 생겨도 컴포넌트만 추가하면 되도록 했습니다.

- 문제를 오가도 고른 답이 유지되고, 이미 푼 문제는 문제 네비게이터에 표시됩니다.

- 모든 문제를 풀면 채점 결과를 보여주고, 정답·해설 화면에서는 1번 문제부터 다시 확인할 수 있습니다.

- 풀이 상태를 커스텀 훅으로 분리했고, 존재하지 않는 문제집 ID로 들어오면 에러 페이지를 보여줍니다.

오답노트와 대시보드

복습과 학습 동기 부여를 담당하는 두 페이지를 구현했습니다.

- 오답노트 목록과 검색을 구현하고, 필터링 로직을 커스텀 훅으로 분리했습니다.

- 오답을 다시 풀어 맞히면 오답 수가 줄어들도록 API를 연결했습니다.

- 대시보드에는 학습 통계 카드와 최근 1년의 학습 기록을 보여주는 잔디(heatmap)를 만들고, 날짜는 사용자의 로컬 시간대를 기준으로 계산했습니다.

반응형 디자인

모바일에서도 학습할 수 있도록 모든 페이지에 반응형 디자인을 적용했습니다.

- 모바일에서는 문제집과 오답노트 목록을 카드형으로 바꾸고, 사이드바를 화면 하단에 배치했습니다.

- 모바일에서도 문제집과 폴더를 수정할 수 있도록 터치 이벤트를 추가했습니다.

- 학습 잔디는 좁은 화면에서 좌우로 스크롤해 볼 수 있게 했습니다.

Troubleshooting

페이지를 이동할 때마다 SSE 연결이 끊기는 문제

- 문제: 다른 페이지로 이동하면 SSE 연결이 끊겼다가 다시 연결되어, 그 사이에 온 문제 생성 완료 알림을 놓칠 수 있었습니다.

- 원인: SSE를 페이지 컴포넌트 안에서 연결하고 있어서, 라우팅으로 컴포넌트가 언마운트될 때 연결도 함께 닫혔습니다.

- 해결: 연결을 페이지가 바뀌어도 유지되는 전역 레이아웃으로 옮기고, ref로 연결을 관리해 중복 연결을 막았습니다.

새로고침하면 404가 나는 문제

- 문제: Vercel에 배포한 뒤 하위 경로로 직접 들어가거나 새로고침하면 404 페이지가 나왔습니다.

- 원인: SPA는 index.html 하나로 모든 경로를 처리하는데, 서버는 요청한 경로에 해당하는 파일을 찾으려 했습니다.

- 해결: vercel.json에서 모든 경로를 index.html로 rewrite해 라우팅을 React Router가 처리하도록 했습니다.