reloop-v2/README.md

ReLoop v2

잊기 전에 다시 만나는 학습법. 에빙하우스 망각곡선 + SM-2 알고리즘으로 개인화된 복습 간격을 자동 계산하는 학습 플랫폼.

운영 서버: https://reloop.nabomhalang.co.kr

핵심 기능

기능	설명
적응형 복습 스케줄링	4가지 학습자 페르소나 + 3단계 자기평가로 최적의 복습 시점을 자동 계산
복습 캘린더 + Quick Add	월간 달력에서 날짜별 복습 현황 확인, "+" 버튼으로 바로 학습 기록 등록
3종 문제집	B2B 프리미엄 ebook, PDF 자동 변환 문제집, 샘플 문제집 12권
PDF 문제 분리	모의고사 PDF + 해설지 업로드 → 30초 만에 디지털 문제집 생성
모의고사 모드	사용자 설정 타이머 + OMR 답안 선택 + 자동 채점 + 집중 모드
3단계 자기평가	어려움/보통/쉬움 → SM-2 기반 간격 배정
필기모드	Canvas 오버레이, 펜 3색, 문제별 localStorage 저장
B2B QR 등록	종이 문제집 QR 코드 → 앱 ebook 자동 등록
학교/학원 관리	학급 생성, 일괄/개인 과제, 복습 과제, 풀이 상세 확인, 선생님 해설 공유
2022 교육과정 프리셋	중1~고3 과목 생성 시 단원 자동 배치
마스터리 경로	단원별 예상 정답률 + 마스터까지 남은 일수 예측
Freemium 구독	Free(과목 3개, 복습 10개) / Pro(월 2,900원) / School(학생당 월 2,900원)

알고리즘

ReLoop은 두 가지 복습 경로를 제공합니다. 상세 설명은 ALGORITHM.md 참조.

1. SM-2 하이브리드 (메인)

사용자가 "어려웠어/괜찮았어/쉬웠어"를 선택하면 SM-2 알고리즘이 적용됩니다.

• 어려웠어 → 1일 후 재복습, EF -0.3
• 괜찮았어 → 기본 간격 × 페르소나 배율
• 쉬웠어 → 간격 확대, EF +0.15
• 간격에 페르소나 배율 + 학습 강도 배율이 곱해짐 (최대 60일 cap)
• 망각곡선 안전장치: SM-2 간격 후 예상 P < 30%이면 자동 축소

2. 에빙하우스 망각곡선 (Legacy)

S(t) = S₀ × exp(-λ × t)          기억 감쇄
P    = sigmoid(k × (S(t) - D))   정답 확률

페르소나	λ (망각속도)	간격 배율
상위권 (senior)	0.1	×1.3
중위권 (mid)	0.2	×1.0
하위권 (junior)	0.4	×0.8
벼락치기형 (crammer)	0.6	×0.6

수익 모델

	Free	Pro	School
가격	0원	월 2,900원 / 연 24,900원	학생당 월 2,900원
복습 큐	일일 10개	무제한	무제한
과목	3개	무제한	무제한
PDF 업로드	월 1회	무제한	무제한
기출 문제집	샘플만	전체	전체
마스터리 경로	미리보기	전체	전체
학교/학원 관리	-	-	전체

기술 스택

영역	기술
Backend	NestJS 10, Prisma 5, MariaDB
Frontend	Next.js 14 (App Router), React 18, styled-components 6
인증	JWT (passport-jwt)
차트	Recharts
아이콘	Phosphor React
폰트	Pretendard + Inter + JetBrains Mono
PDF 파싱	poppler-utils (pdftotext, pdftoppm, pdfinfo)
배포	PM2, nginx reverse proxy

프로젝트 구조

reloop-v2/
├── backend/
│   └── src/
│       ├── auth/              # JWT 인증
│       ├── dashboard/         # 대시보드 요약
│       ├── forget/            # 망각곡선 + SM-2 엔진
│       ├── me/                # 프로필 + 티어 전환
│       ├── problem-sets/      # 문제집 + PDF 파싱
│       │   └── parsing/       # pdftotext 기반 파서 + OCR fallback
│       ├── reviews/           # 복습 큐 (자동 이월 + Free 10개 제한)
│       ├── stats/             # 통계 + 마스터리 경로 (Pro 전용)
│       ├── study-logs/        # 학습 기록 + PDF 문제 분리
│       ├── subjects/          # 과목 + 교육과정 프리셋 + Free 3개 제한
│       ├── tags/              # 태그 (CRUD + 이름 변경)
│       ├── organizations/     # 학교/학원
│       ├── classes/           # 학급
│       └── assignments/       # 과제 (일괄/개인/복습 + 풀이상세 + 선생님 노트)
├── frontend/
│   └── src/
│       ├── app/
│       │   ├── dashboard/     # 대시보드 (캘린더, 숙련도)
│       │   ├── review/        # 복습 세션 (키보드 단축키)
│       │   ├── exams/         # 문제집 카탈로그 (프리미엄/내 문제집/샘플)
│       │   ├── study/
│       │   │   ├── exam/      # 모의고사 화면 (타이머 + 집중모드)
│       │   │   ├── import-pdf/# PDF 문제 분리
│       │   │   └── history/   # 학습 기록
│       │   ├── subjects/      # 과목/태그 관리 + 색상 피커
│       │   ├── pricing/       # 요금제 (Free/Pro/School)
│       │   ├── profile/       # 프로필 + 학습설정 + 티어 전환
│       │   └── school/        # 학교 관리
│       ├── components/
│       │   ├── ui/            # 공통 UI 컴포넌트
│       │   ├── layout/        # AppShell, SideNav, BottomNav
│       │   ├── review/        # ReviewCalendar + Quick Add
│       │   └── charts/        # 망각곡선, 숙련도 차트
│       └── lib/               # API 클라이언트, 상수, 인증
└── prisma/
    └── schema.prisma          # DB 스키마 (15 모델)

규모

항목	수치
프로덕션 코드	45,641줄
API 엔드포인트	71개
DB 모델	15개
프론트엔드 페이지	26개
샘플 문제집	12권

빠른 시작

필수 조건

• Node.js 20+, pnpm 9+
• MariaDB/MySQL 8+
• poppler-utils (apt install poppler-utils)

설치

git clone ssh://git@your-gitea:2222/hanarang/reloop-v2.git
cd reloop-v2

# 백엔드
cd backend
pnpm install
cp .env.example .env          # DATABASE_URL, JWT_SECRET 편집
pnpm prisma migrate dev
pnpm prisma:seed
pnpm dev                      # :3001

# 프론트엔드
cd ../frontend
pnpm install
cp .env.example .env.local    # NEXT_PUBLIC_API_URL 편집
pnpm dev                      # :3000

환경 변수

Backend (backend/.env)

변수	필수	설명
DATABASE_URL	O	mysql://user:pass@host:3306/reloop_v2
JWT_SECRET	O	32자+ 랜덤 문자열
JWT_EXPIRES_IN	-	기본 7d
CORS_ORIGINS	-	허용 도메인 (쉼표 구분)
PORT	-	기본 3001

Frontend (frontend/.env.local)

변수	설명
NEXT_PUBLIC_API_URL	기본 http://localhost:3001/api

배포

cd /path/to/reloop-v2

# 풀 배포 (백엔드 + 프론트엔드)
cd backend && npx prisma generate && npx prisma migrate deploy && rm -f *.tsbuildinfo && pnpm build && pm2 restart reloop-api
cd ../frontend && pnpm build && cp -r .next/static .next/standalone/.next/ && cp -r public .next/standalone/ && pm2 restart reloop-web

주요 API 엔드포인트

Method	Endpoint	설명
POST	/api/auth/register	회원가입
POST	/api/auth/login	로그인
GET	/api/auth/me	내 정보
PATCH	/api/me/profile	프로필 수정 (페르소나 변경 시 스케줄 재계산)
PATCH	/api/me/subscription-tier	구독 티어 전환 (Free/Pro/School)
GET	/api/dashboard/summary	대시보드 요약
GET	/api/reviews/queue	복습 큐 (Free 10개 제한, 밀린 복습 자동 이월)
POST	/api/reviews/:id/submit	복습 결과 제출
GET	/api/reviews/calendar	월간 복습 캘린더
GET	/api/reviews/day	일별 복습 상세
POST	/api/study-logs	학습 기록 생성
POST	/api/study-logs/from-problem-set	모의고사 일괄 제출
POST	/api/study-logs/parse-pdf	PDF 문제 분리
GET	/api/problem-sets	문제집 목록
GET	/api/subjects	과목 목록 (Free 3개 제한)
GET	/api/stats/mastery-path	마스터리 경로 (Pro 전용)
POST	/api/assignments	과제 생성 (일괄/개인/복습)
GET	/api/assignments/:id/submissions/:userId/details	학생 풀이 상세

라이선스

UNLICENSED (비공개)