ReLoop v2
잊기 전에 다시 만나는 학습법. 페르소나 기반 망각 곡선으로 개인화된 복습 간격을 자동으로 계산하는 적응형 학습 플랫폼.
수능, 자격증, 어학, 취미 학습 — 어떤 공부든 ReLoop이 기억을 관리합니다.
핵심 기능
| 기능 | 설명 |
|---|---|
| 적응형 복습 스케줄링 | 페르소나 + 문제 난이도에 따라 "정답률이 기준 아래로 떨어지는 시점"을 자동 계산해 복습 큐에 넣습니다 |
| KICE 기출 문제집 | 2025/2026 수능 수학 4단원(공통/확률과 통계/미적분/기하) 92문항을 PDF에서 자동 크롭한 이미지로 제공 |
| 모의고사 모드 | 실제 시험처럼 타이머 + OMR 답안 선택 + 자동 채점 + 학습 기록 일괄 생성 |
| Solved.ac PS 연동 | Solved.ac 계정에서 최신 백준 풀이 이력을 동기화해 복습 큐에 추가 |
| 통계 대시보드 | 학습 히트맵, 단원별·PS 정답률, 숙련도 성장 곡선을 시각화 |
| PWA 지원 | 모바일 홈 화면에 앱으로 설치 가능 |
기술 스택
| 영역 | 기술 |
|---|---|
| Backend | NestJS 10 + Prisma 5 + MariaDB |
| Frontend | Next.js 14 (App Router) + React 18 + styled-components 6 |
| 인증 | JWT (passport-jwt) |
| 보안 | helmet, @nestjs/throttler (60req/min), CORS whitelist |
| 아이콘 | Phosphor React |
| 폰트 | Pretendard + Inter + JetBrains Mono |
| 배포 | PM2 on Debian VM, nginx reverse proxy |
| PDF 처리 | poppler-utils (pdftotext, pdftoppm, pdfinfo) |
| OCR | Codex CLI Vision (codex exec -i) |
프로젝트 구조
reloop-v2/
├── backend/ # NestJS API 서버
│ ├── src/
│ │ ├── auth/ # JWT 인증 (login, register, me)
│ │ ├── dashboard/ # 대시보드 요약 API
│ │ ├── forget/ # 페르소나 망각 곡선 엔진
│ │ ├── me/ # 프로필, 아바타 업로드
│ │ ├── problem-sets/ # 문제집 CRUD + 파싱 모듈
│ │ │ └── parsing/ # PDF 파싱 엔진 (범용, 전략 패턴)
│ │ │ ├── strategies/ # kice.ts, math.ts
│ │ │ └── ocr-fallback/ # Codex Vision OCR
│ │ ├── reviews/ # 복습 큐 관리
│ │ ├── stats/ # 통계 API
│ │ ├── study-logs/ # 학습 기록 + 모의고사 일괄 제출
│ │ ├── subjects/ # 과목 관리
│ │ └── tags/ # 태그 관리
│ ├── prisma/
│ │ ├── schema.prisma # DB 스키마
│ │ ├── seed.ts # 데모 데이터 시드
│ │ └── migrations/ # 마이그레이션 히스토리
│ ├── scripts/
│ │ ├── kice-import.ts # KICE PDF 임포트 CLI
│ │ └── ocr-fix.ts # OCR 보정 CLI
│ └── uploads/ # 문제 이미지, 아바타 (git 제외)
├── frontend/ # Next.js 프론트엔드
│ ├── src/
│ │ ├── app/ # App Router 페이지들
│ │ │ ├── dashboard/ # 대시보드 (채움/빈 상태)
│ │ │ ├── exams/ # 문제집 카탈로그
│ │ │ ├── study/
│ │ │ │ ├── exam/[id]/ # 모의고사 시험 화면
│ │ │ │ └── history/ # 학습 기록 히스토리
│ │ │ ├── review/ # 복습 세션
│ │ │ ├── solve/[id]/ # 개별 문제 풀기
│ │ │ ├── study-logs/[id]/ # 학습 기록 상세
│ │ │ ├── stats/ # 통계
│ │ │ ├── subjects/ # 과목 및 태그 관리
│ │ │ ├── profile/ # 프로필 + 설정 통합
│ │ │ ├── pricing/ # 플랜 (공개/로그인 분기)
│ │ │ ├── onboarding/ # 신규 사용자 온보딩
│ │ │ ├── login/ + register/ # 인증
│ │ │ ├── privacy/ terms/ contact/ # 법적 페이지
│ │ │ └── page.tsx # 랜딩 페이지
│ │ ├── components/
│ │ │ ├── ui/ # Button, Card, Icon, Toast, Select, DatePicker, ...
│ │ │ ├── layout/ # AppShell, SideNav, BottomNav
│ │ │ ├── auth/ # AuthCard (로그인/회원가입 통합)
│ │ │ ├── dashboard/ # EmptyDashboard
│ │ │ └── legal/ # LegalLayout
│ │ ├── lib/ # api.ts, auth.ts, constants.ts, exam-date.ts
│ │ └── styles/ # theme.ts (디자인 토큰, 애니메이션)
│ └── public/ # 정적 파일, PWA manifest, 아이콘
├── data/kice/ # KICE 원본 PDF (git 제외, 저작권)
│ ├── 2025/{국어,수학,영어,...}/
│ └── 2026/{국어,수학,영어,...}/
├── docs/ # 상세 매뉴얼
│ ├── algorithm.md # 망각 곡선 알고리즘 상세
│ ├── architecture.md # 시스템 아키텍처
│ ├── user-guide.md # 사용자 가이드
│ ├── admin-guide.md # 운영/배포 가이드
│ └── pdf-pipeline.md # PDF 파싱 파이프라인
└── Plans.md # 개발 계획 + 진행 상황
알고리즘 요약
상세 내용: docs/algorithm.md
ReLoop은 FSRS 대신 자체 페르소나 기반 망각 곡선을 사용합니다.
핵심 수식
실력 감쇄: S(t) = S₀ × exp(-λ × t)
정답 확률: P = sigmoid(k × (S(t) - D))
- S₀ (0~1): 마지막 학습 시점의 실력. 맞으면 올라가고 틀리면 떨어짐
- λ (lambda): 페르소나별 망각 속도. senior(0.1)은 느리게, crammer(0.6)은 빠르게 잊음
- D: 문제 난이도 (0~1)
- k: sigmoid 기울기 (기본 4.0)
복습 시점 결정
"정답 확률 P가 사용자의 기준(P_threshold) 아래로 떨어지는 시점"을 다음 복습일로 잡습니다.
| 복습 민감도 | P_threshold | 의미 |
|---|---|---|
| 엄격 (strict) | 0.7 | 70% 이하로 떨어지면 복습 |
| 균형 (moderate) | 0.5 | 50% 이하 |
| 여유 (relaxed) | 0.35 | 35% 이하 |
페르소나
| 페르소나 | λ (망각속도) | 복습 주기 경향 |
|---|---|---|
| Senior | 0.1 | 7~14일 (느린 망각) |
| Mid | 0.2 | 2~5일 |
| Junior | 0.4 | 1~2일 (빠른 망각) |
| Crammer | 0.6 | 매일~격일 |
S₀ 업데이트 규칙
| 결과 | 새 S₀ |
|---|---|
| 정답 | S₀ × 0.5 + 0.6 |
| 부분 | S₀ × 0.7 + 0.3 |
| 오답 | S₀ × 0.5 |
빠른 시작
필수 조건
- Node.js 20+
- pnpm 9+
- MariaDB/MySQL 8+
- poppler-utils (
pdftotext,pdftoppm,pdfinfo)
설치 및 실행
# 1. 클론
git clone ssh://git@your-gitea:2222/hanarang/reloop-v2.git
cd reloop-v2
# 2. 백엔드
cd backend
pnpm install
cp .env.example .env # DATABASE_URL, JWT_SECRET 편집
pnpm prisma migrate dev
pnpm prisma:seed # 데모 계정 생성
pnpm dev # http://localhost:3001
# 3. 프론트엔드 (새 터미널)
cd frontend
pnpm install
cp .env.example .env.local # NEXT_PUBLIC_API_URL 편집
pnpm dev # http://localhost:3000
# 4. (선택) KICE 기출 임포트
# data/kice/ 에 PDF 배치 후:
cd backend
pnpm cli:kice-import --year=2026
데모 계정
| 이메일 | 비밀번호 |
|---|---|
| demo@reloop.local | demo1234 |
환경 변수
Backend (backend/.env)
| 변수 | 필수 | 기본값 | 설명 |
|---|---|---|---|
DATABASE_URL |
O | — | mysql://user:pass@host:3306/reloop_v2 |
JWT_SECRET |
O | — | 32자 이상 랜덤 문자열 |
JWT_EXPIRES_IN |
— | 7d |
토큰 만료 기간 |
CORS_ORIGINS |
— | http://localhost:3000 |
쉼표 구분 허용 도메인 |
PORT |
— | 3001 |
API 서버 포트 |
Frontend (frontend/.env.local)
| 변수 | 필수 | 기본값 |
|---|---|---|
NEXT_PUBLIC_API_URL |
— | http://localhost:3001/api |
배포
상세 내용: docs/admin-guide.md
# 서버에서
cd /path/to/reloop-v2
# 백엔드
cd backend && pnpm install && pnpm prisma:deploy && pnpm build
pm2 restart reloop-api
# 프론트엔드
cd frontend && pnpm install && pnpm build
cp -r .next/static .next/standalone/.next/
cp -r public .next/standalone/
pm2 restart reloop-web
API 요약
상세 내용: docs/architecture.md
| Method | Endpoint | 설명 |
|---|---|---|
| POST | /api/auth/register |
회원가입 |
| POST | /api/auth/login |
로그인 (JWT 발급) |
| GET | /api/auth/me |
내 정보 |
| PATCH | /api/me/profile |
프로필 수정 |
| POST | /api/me/avatar |
아바타 업로드 |
| GET | /api/dashboard/summary |
대시보드 요약 |
| GET | /api/problem-sets |
문제집 목록 |
| GET | /api/problem-sets/:id |
문제집 상세 (문항 + 지문) |
| GET | /api/study-logs |
학습 기록 목록 |
| POST | /api/study-logs |
학습 기록 생성 |
| GET | /api/study-logs/:id |
학습 기록 상세 |
| PATCH | /api/study-logs/:id |
학습 기록 수정 |
| POST | /api/study-logs/from-problem-set |
모의고사 일괄 제출 |
| GET | /api/reviews/queue |
오늘의 복습 큐 |
| POST | /api/reviews/:id/submit |
복습 결과 제출 |
| GET | /api/subjects |
과목 목록 |
| GET | /api/stats/subjects |
과목별 통계 |
| GET | /api/stats/mastery-path |
숙련도 성장 곡선 |
라이선스
UNLICENSED (비공개)