HitMusicU

배경¶

Anthropic 하네스 엔지니어링(Planner→Generator→Evaluator 반복 루프)을 적용하여 Learn 페이지를 근본적으로 재설계.
사용자 피드백: "카드, 묶음, 표현 모든 것이 정리되지 않은 느낌"

근본 원인 분석 (Analyst)¶

1. 카드가 평면 리스트 (그룹핑 없음)
2. 묶음(deck) 개념 부재
3. All 탭에 정리 도구 없음
4. Study 탭이 카드 1장씩만 (전체 진행 안 보임)

변경 사항¶

프론트엔드¶

• 2탭(Study/All) → 4탭(오늘 복습/곡별/난이도별/전체)
• 742줄 단일 파일 → 5개 모듈 컴포넌트로 분리
• 곡별 그룹핑: mastered/learning/new 진행 바 + 곡별 학습 세션
• CEFR 레벨 그룹핑: Beginner(A1-A2)/Intermediate(B1-B2)/Advanced(C1)
• 전체 탭: 정렬 4종(최신/곡명/레벨/복습일) + 필터(학습상태/레벨)
• 세션 완료 레이스 컨디션 수정 (useEffect 기반)
• 공통 유틸 추출 (LevelBadge, difficultyColor)

백엔드¶

• FLASHCARDS 테이블에 LEVEL 컬럼 추가 (A1~C1, nullable)
• insertFlashcard, findFlashcardsDue, findAllFlashcards에 LEVEL 반영

백오피스¶

• 표현 추출 LLM 프롬프트에 CEFR level 태깅 추가 (동기/비동기, 한국어/영어 4개 프롬프트)

커밋¶

75f6f00

하네스 루프¶

Analyst → Planner → Generator R1 → Evaluator R1 (CRITICAL 2, HIGH 3) → Generator R2 → Evaluator R2 (APPROVE)