[Child #73] 마법 노트 Codex hook·화면 추가

[SilverSupplier]

Parent: #73

목적

docs/GAME_DESIGN.md §13.1 기준으로 마법 노트를 NPC 발언과 발견을 자동 기록하는 codex로 만든다. M1에서는 vertical slice와 엔딩 리포트에 필요한 최소 hook을 먼저 만들고, M2 이후에 full codex 화면을 완성한다.

범위 분리

M1 필수 범위

• 노트 데이터 모델 최소 구현
• NPC 발언/발견/층 요약 기록 hook
• 화면 우상단 책 아이콘 + 새 기록 시 0.4초 펄스
• note_unlock SFX 연결
• 엔딩 리포트 대표 관찰문 3줄 자동 발췌

M2 이후 full Codex 화면

• Tab 키 또는 책 아이콘 클릭으로 열림 -> soft pause
• 3개 탭:
  • 대사 — NPC가 한 말 모두, 층별·시간순으로 묶임
  • 층별 노트 — 각 층의 진행 마무리 문장
  • 발견 — 시도한 base 5종과 overlay 6종을 그리드로. 첫 성공한 항목은 또렷, 미발견은 실루엣
• Tab 또는 Esc로 닫음
• 상태 영속화

API

NPC 시스템(#78)과 gameplay 시스템에서 호출할 수 있는 hook 제공:

• NoteCodex.AppendDialogue(floor: int, text: string, timestamp: float)
• NoteCodex.MarkDiscovery(category: "base" | "overlay", name: string)
• NoteCodex.AppendFloorSummary(floor: int, text: string)
• NoteCodex.PickEndingHighlights(count: int = 3)

대표 관찰문 발췌 우선순위:

1. 첫 발견 발언/기록
2. 층 완료 마무리
3. 엔딩 인사

해야 할 일

• Codex 데이터 모델 (대사·층 노트·발견 목록)
• 책 아이콘 펄스 컴포넌트
• 엔딩 리포트의 자동 발췌 로직
• full Codex 단계에서 pause 키 입력 처리 (Tab)과 3 탭 UI
• PlayMode test: 기록 누적, 책 아이콘 펄스, 엔딩 발췌, full Codex 열기/닫기

주요 파일/대상

• unity/MagicExamHall/Assets/MagicExamHall/Scripts/Runtime/NoteCodex.cs (신규)
• unity/MagicExamHall/Assets/MagicExamHall/Prefabs/CodexPanel.prefab (신규, M2 이후)
• unity/MagicExamHall/Assets/MagicExamHall/Scripts/Runtime/ExamGameController.cs

의존성

• [Child #73] 핵심 사운드 1차 셋업 #74 사운드 (note_unlock)
• [Child #73] Exam Mentor 컨텍스트 소환 모델·대사 풀 #78 NPC가 codex API 호출
• [Child #73] M1 Vertical slice — 1·5층 축약 + 핵심 사운드 + 엔딩 리포트 #85 vertical slice는 M1 필수 범위에 의존

완료 조건

M1 완료 기준:

• 책 아이콘이 항상 표시되고 새 기록 시 펄스
• NPC 발언과 발견이 데이터 모델에 누적됨
• 엔딩 리포트가 codex에서 자동으로 3줄 발췌
• PlayMode test 2개 이상 통과

전체 완료 기준:

• Tab으로 3 탭이 있는 codex 열림
• NPC 발언이 대사 탭에 누적됨
• 발견 그리드가 첫 성공 시 또렷해짐
• PlayMode test 3개 이상 통과