Files
reloop-v2/docs/user-guide.md
reloop 78371cacf8 feat(phase10C): 온보딩 + 프론트 재구성 — 수학 수능 4단원 + PS 트랙
- lib/api.ts: GoalType('math-suneung'|'ps'|...), MathUnit, MATH_UNIT_LABEL,
  MeUser{focusUnits,bojHandle}, ps.* helper (search/bookmark/sync/getProblem)
- onboarding/page.tsx: 5개 GoalType 옵션, math-suneung 단원 멀티셀렉트,
  ps 인풋 + 즉시 동기화 토글, focusUnits/bojHandle PATCH
- profile/page.tsx: 동일 컨트롤 노출 + 검증
- ps/{page,bookmarks/page,sync/page}.tsx: 검색·필터·북마크·동기화 신규 섹션
- components/ps/PsTabs.tsx, layout/{SideNav,BottomNav}.tsx, ui/Icon.tsx:
  PS 진입점 + Phosphor code/bookmark-simple 아이콘
- exam/shared.ts: getExamDurationSeconds → 수학 100분 고정
- 비수학 하드코딩 전면 제거: dashboard/exams/study/subjects/school/assignment
- 카피 갱신: landing/pricing/layout metadata + README + docs(user/admin/pipeline)
- .eslintrc.json: Next core lint 결정성 확보

Phase 10C DoD 통과 — pnpm build + lint 0 에러, /ps /ps/bookmarks /ps/sync 라우트 생성,
grep -rE '국어|영어|한국사|생활과 윤리|사회탐구' frontend/src docs = 0
2026-04-14 19:38:16 +09:00

6.5 KiB

ReLoop 사용자 가이드

시작하기

1. 회원가입

  1. https://reloop.nabomhalang.co.kr 접속
  2. "무료로 시작하기" 또는 상단 "로그인" 클릭
  3. 회원가입 탭에서 이메일, 닉네임, 비밀번호 입력
  4. 체험만 하고 싶다면 "로그인 없이 체험하기"로 데모 계정 사용 가능

2. 온보딩

회원가입 직후 4단계 온보딩이 진행됩니다:

  1. 목표 설정 — 닉네임 확인 + 목표 시험 선택 (수학 수능/PS/자격증/어학/없음)
  2. 현재 실력 — 현재 등급과 목표 등급 설정 (1-9등급 카드 선택)
  3. 집중 단원 — 수학 4단원(공통/확통/미적/기하) 중 집중할 영역 선택
  4. 학습 리듬 — 페르소나 선택 (뒤에 자세히 설명)

핵심 기능

대시보드

로그인 후 가장 먼저 보는 화면입니다.

  • 오늘의 복습 큐: 오늘 복습해야 할 문항 수. "지금 시작" 버튼으로 바로 진입
  • 주간 정답률: 이번 주에 복습한 문항의 정답률 추이
  • 숙련도 진행: 전체 태그 중 90% 이상 숙련된 비율 (원형 게이지)
  • 곧 마스터할 영역: 숙련도 80% 이상인 태그들 (조금만 더 하면 마스터)
  • 최근 학습: 최근에 풀었거나 복습한 문항 목록 (클릭하면 상세 보기)
  • 학습 코치: 현재 페르소나에 맞는 조언 메시지

문제집 (/exams)

사이드바 "문제집" 메뉴에서 기출 문제집 카탈로그를 볼 수 있습니다.

  • 연도별, 과목별 필터로 원하는 시험지 검색
  • "시작" 버튼을 누르면 모의고사 모드로 진입
  • 현재 제공 중인 문제집: 2025/2026 수능 수학 4단원(공통/확통/미적/기하)

모의고사 모드

실제 시험처럼 문제를 풀 수 있습니다.

화면 구성:

  • 상단: 시험 제목 + 카운트다운 타이머 + 진행률
  • 중앙: 문제 이미지 (원본 시험지에서 자동 크롭) + 공통 지문 (접기/펼치기)
  • 하단: OMR 답안 버블 (①②③④⑤) + 네비게이션 버튼

기능:

  • 이전 / 건너뛰기 / 다음 / 항목이동 (4개 버튼)
  • 문제 이미지 클릭 → 확대 보기
  • 키보드 단축키: 1-5(답 선택), ←/→(문제 이동), F(표시), Enter(다음)
  • 시험 종료: 우상단 메뉴에서 "시험 종료(제출)" 선택

집중 모드:

  • 기본: 사이드바가 보이는 일반 모드 (OFF)
  • 우상단 "집중 모드" 버튼으로 전체 화면 모드 전환 가능

제출 후:

  • 자동 채점 결과: 맞은 문제 수 / 총 문항 + 정답률
  • 각 문항의 내 답 vs 정답 비교
  • 모든 문항이 학습 기록에 자동 저장 → 복습 큐에 자동 진입

복습 세션 (/review)

대시보드의 "지금 시작" 또는 사이드바 "복습" 메뉴로 진입합니다.

  • 오늘 복습해야 할 문항이 카드 형태로 순서대로 제시
  • 문제 이미지를 보고 스스로 답을 떠올린 뒤 결과를 기록:
    • 맞음: 실력(S₀)이 크게 상승, 다음 복습까지 간격 늘어남
    • 부분: 약간 상승, 간격 약간 늘어남
    • 틀림: 실력 하락, 짧은 간격으로 재복습
    • 건너뛰기: 이 카드를 나중으로 미룸
  • 결과 기록 후 2초간 "결과 기록됨" 토스트 표시 (실행 취소 가능)
  • 모든 카드 처리 시 완료 축하 화면

학습 기록 (/study/history)

모든 학습 기록을 테이블(데스크톱) 또는 카드 리스트(모바일)로 확인합니다.

  • 단원, 날짜, 결과로 필터링
  • 검색창에서 제목/단원/태그로 검색
  • 각 항목 클릭 → 상세 페이지에서:
    • 문제 이미지 + 내 답 vs 정답
    • 복습 스케줄 타임라인
    • "다시 풀기" 버튼 (개별 문제 풀기 화면으로 이동)

통계 (/stats)

학습 패턴과 성장을 시각적으로 확인합니다.

  • 학습 히트맵: 최근 18주간 날짜별 학습량 (색상 농도)
  • 단원/PS 정답률: 각 단원 및 PS 태그의 정답/오답 비율 바 차트
  • 숙련도 성장 곡선: 태그별 숙련도가 시간에 따라 어떻게 변했는지 선 그래프

단원 및 태그 (/subjects)

수학 단원과 태그를 관리합니다.

  • 단원별로 하위 태그 목록 + 각 태그의 현재 숙련도
  • 태그 이름 수정 (인라인 편집)
  • 태그 보관 (소프트 삭제 + 실행 취소)
  • 새 단원/태그 추가

프로필 (/profile)

4개 탭으로 구성:

내용
프로필 아바타 업로드, 닉네임, 이메일, 현재 플랜
학습 설정 현재/목표 등급 (카드 선택), 페르소나, 복습 민감도
알림 일일 복습 알림, 주간 리포트, 마케팅 수신 토글
계정 플랜 관리, 데이터 내보내기, 진행 초기화, 로그아웃

페르소나 선택 가이드

페르소나 추천 대상 복습 빈도
숙련자 (Senior) 이미 기초가 탄탄한 사람. 유지 목적 학습 주 1-2회
중급 (Mid) 대부분의 학습자. 추천 기본값 2-3일마다
초보 (Junior) 새로운 분야를 시작한 사람 매일~격일
단기집중 (Crammer) 시험 직전 벼락치기 매일 여러 번

나중에 프로필 설정에서 언제든 변경할 수 있습니다.

모바일 사용

  • 하단 네비게이션 바로 주요 메뉴 접근
  • 프로필 탭에서 설정 + 로그아웃
  • 모의고사: 문제 이미지 탭하면 확대
  • PWA 설치: 브라우저 메뉴에서 "홈 화면에 추가"로 앱처럼 사용 가능

자주 묻는 질문

Q: 복습 큐에 너무 많은 문제가 쌓여요. A: 프로필 → 학습 설정에서 복습 민감도를 "여유"로 변경하면 복습 간격이 길어집니다. 또는 페르소나를 "숙련자"로 바꿔보세요.

Q: 수능 외에 다른 공부에도 쓸 수 있나요? A: 네. 과목과 태그를 자유롭게 만들어 자격증, 어학, 취미 학습 등 어떤 공부든 기록하고 복습할 수 있습니다. KICE 기출 문제집은 수능 준비생을 위한 추가 기능입니다.

Q: 오답 노트처럼 쓸 수 있나요? A: 학습 기록 상세에서 메모를 남길 수 있고, 틀린 문항은 자동으로 짧은 간격의 복습 큐에 들어갑니다. "다시 풀기"로 해당 문제만 다시 도전할 수도 있습니다.

Q: 데이터를 백업할 수 있나요? A: 프로필 → 계정 탭에서 "데이터 내보내기"를 누르면 학습 기록을 JSON 파일로 다운로드할 수 있습니다.