Skip to content

feat: 오답 복습에 간격 반복 일정 추가 - #41

Merged
hyesngy merged 3 commits into
developfrom
feat/review-schedule
Nov 12, 2026
Merged

hyesngy merged 3 commits into
developfrom
feat/review-schedule

Conversation

@hyesngy

@hyesngy hyesngy commented Nov 12, 2026

Copy link
Copy Markdown
Contributor

관련 이슈

없음 (#38, #39, #40의 후속 작업)

변경사항

  • 오답 복습에 문제별 간격 반복 일정을 추가했다. 지금까지는 오답 전체를 한 번에 내고, 한 번 맞히면 복습에서 영구히 빠졌다. 맞힌 문제도 간격을 늘려 다시 내고 오늘 풀 문제만 고르기 위해서다.
  • 규칙(ReviewScheduler): 첫 복습은 오답으로 표시한 다음 날. 맞히면 간격 × 2.5(하루 이상 지나 맞히면 최소 3일), 헷갈리면 × 1.2, 틀리면 1일로 초기화. 예정일 전에 풀면 실제로 지난 날수만 인정한다. 다음 간격이 30일을 넘으면 복습 완료. 제때 계속 맞히면 1일 → 3일 → 8일 → 20일 → 완료.
  • 풀이 기록에 "오늘 복습 (N)" 버튼을 추가했다. 기존 "오답 다시 풀기 (N)"는 차례와 무관하게 복습을 마치지 않은 오답을 모두 푸는 버튼으로 남겼다.
  • 채점을 "또 틀렸어요 / 헷갈렸어요 / 맞았어요" 세 단계로 바꾸고, 채점 후 다음 복습까지 남은 날수를 안내한다.
  • 기록 카드에 "오늘 복습 / 다음 복습 날짜 / 복습 완료"를 표시하고, 요약 칸을 "복습 완료"와 "오늘 복습"으로 바꿨다.
  • 이전 버전에서 "다시 풀어 맞힘"으로 복습에서 빠졌던 기록은 마지막 복습 3일 뒤에 다시 일정에 들어온다.
  • docs/domain.md에 용어를, docs/decisions.md에 결정(상태: 제안)을 추가했다.

변경·영향 범위

담당 주 영역: 앱 기능 (Storage / UI)

  • 앱 기능 (Capture / AI / Storage / UI)
  • StoreKit·사용량 정책
  • API·프록시
  • 앱 설정·권한·릴리스
  • 테스트·CI·개발 도구
  • 규칙·문서 (AGENTS.md, docs/)
  • 기타:

PR 분류

  • 일반 변경
  • Critical Path 변경

사전 예측

  • 예상 소요·기대 효과: 3~4시간. 계획한 "망각곡선 복습"을 실제 일정으로 구현한다.
  • 예상 병목·리스크: 기록 JSON에 필드를 추가하므로 기존 기록 호환. 이전 버전에서 복습을 마친 것으로 처리되던 기록의 취급.
  • 담당 영역 밖 확인 사항: 없음. AI 호출, 사용량 차감, 프록시는 건드리지 않는다.

실제 결과·트러블슈팅

  • 실제 소요·반영 결과: 약 4시간. 계획한 항목을 모두 반영했다.
  • 실제 병목·해결 과정: 처음에는 간격을 "문제를 푼 날"부터 세어, 며칠 전에 푼 기록을 오늘 오답으로 표시하면 바로 오늘 복습에 들어왔다. 오답으로 표시하려고 기록을 열면 정답을 다시 보게 되므로 "오답으로 표시한 날"부터 세도록 고쳤다(markedIncorrectAt). 오답 표시를 풀었다 다시 하면 예전 간격을 이어 가던 문제와, 마지막 문제의 복습일 안내가 완료 화면에 보이지 않던 문제도 함께 고쳤다.
  • 배운 점·후속 작업: 시험일을 입력받아 남은 기간에 맞춰 간격을 줄이는 기능은 넣지 않았다. 기록 100개 한도에서 복습 중인 오답이 밀려 사라질 수 있는 문제도 남아 있다. docs/decisions.md의 결정은 팀 확인 후 "채택"으로 바꾼다.

검증 결과

  • 검증 내용: xcrun swift-format lint --recursive --strict Paxo PaxoTests 통과. xcodebuild ... test 로컬 126개 통과(신규 7개: 간격 증가와 완료, 틀림·헷갈림 처리, 일찍 풀기, 자정 기준 복습 차례, 이전 버전 기록 편입, 오답 표시일 기준, 재표시 초기화). 앱에서 직접 확인: 10월 16일에 푼 기록을 오늘 오답으로 표시해도 "오늘 복습"이 늘지 않음, 채점 버튼 3개 표시, "또 틀렸어요" 후 완료 화면에 "방금 문제는 1일 뒤에 다시 나와요." 표시, 오답 표시 해제 시 요약 복귀. 간격이 3일·8일로 늘어나는 것과 "오늘 복습" 버튼으로 시작하는 흐름은 날짜가 지나야 해서 앱에서는 확인하지 못했고 테스트로만 검증했다. 기록 카드의 "다음 복습 날짜" 문구는 눈으로 확인하지 않았다.
  • API Contract 앱·프록시 양쪽 반영 여부: 해당 없음
  • 시크릿 포함 여부: 없음

- 맞히면 간격을 늘리고 틀리면 다음 날로 되돌려 문제별로 복습일 계산
- 오늘 복습할 문제만 푸는 버튼과 세 단계 채점(또 틀림·헷갈림·맞음) 추가
- 간격이 30일을 넘으면 복습 완료로 처리
- 이전 버전에서 다시 맞힌 기록도 일정에 편입
- 며칠 전에 푼 기록을 오늘 오답으로 표시하면 바로 오늘 복습에 들어오던 문제 수정
- 오답 표시를 풀었다 다시 하면 예전 간격을 이어 가지 않고 다음 날부터 시작
- 다시 풀기 마지막 문제의 다음 복습일 안내가 완료 화면에 보이도록 수정
@github-actions

Copy link
Copy Markdown

AI 사전 코드 리뷰 (파일럿)

검토 SHA: 94a17abddee4 · 방식: 전체
상태: 미해결 0 · 해결 0 · 오탐 0 · 위험 수용 0
AI 호출: 1/20

오답 복습 간격 반복(Spaced Repetition) 알고리즘 도입 및 관련 UI/테스트 변경 사항을 검토했습니다. `ReviewScheduler` 기반의 복습 일정 계산, 모델 필드 확장, UI 세션 반영 및 단위 테스트가 프로젝트 컨벤션을 준수하여 정상 구현되었습니다.

ID 심각도 확신·구분 위치 문제 상태
— — — — 수정할 가치가 높은 문제를 찾지 못했습니다. —

사람의 판정: /ai-review false-positive AX-... 이유(10자 이상), /ai-review accepted-risk AX-... 이유(10자 이상), /ai-review reopen AX-...
AI 결과는 승인이나 머지 조건을 대체하지 않습니다.

@hyesngy
hyesngy merged commit eebe766 into develop Nov 12, 2026
7 checks passed
@hyesngy
hyesngy deleted the feat/review-schedule branch November 12, 2026 02:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant