npm install
cp .env.example .env    # API 키를 입력하세요
npm run dev             # http://localhost:3000

MISTRAL_API_KEY=            # 필수 — 사건 생성, 심문, 평가, STT
ELEVENLABS_API_KEY=         # 필수 — 용의자 음성을 위한 TTS
ELEVENLABS_VOICE_ID=        # 선택 사항 — 특정 ElevenLabs 음성 ID
NEXT_PUBLIC_SUPABASE_URL=   # 필수 — Supabase 프로젝트 URL
NEXT_PUBLIC_SUPABASE_ANON_KEY=  # 필수 — Supabase 익명 키 (RLS 보호)
SUPABASE_SERVICE_ROLE_KEY=  # 선택 사항 — 관리자 내보내기 엔드포인트
EXPORT_SECRET=              # 선택 사항 — 관리자 내보내기 인증

npm run dev       # 개발 서버
npm run build     # 프로덕션 빌드
npm run start     # 프로덕션 서버
npm run lint      # ESLint

score = timeScore x difficultyMultiplier x efficiencyBonus x hintPenalty x accusationPenalty

timeScore       = 1000 x sqrt(max(0, 1 - elapsed / (parTime x 2)))
multiplier      = easy 1.0x, medium 1.5x, hard 2.0x, expert 2.5x
efficiencyBonus = 1.0-1.5x (기준 질문보다 적으면 보너스)
hintPenalty     = 0.85^hintsUsed
accusePenalty   = max(0, 1 - wrongAccusations x 0.1)

app/
├── page.tsx                     # 제목 화면
├── cases/                       # 사건 선택 — 장소 + 난이도
├── game/
│   ├── page.tsx                 # 메인 게임 오케스트레이터
│   ├── hooks/                   # useVoiceRecorder, useTTS, useGameTimer, useSfx, useSettings
│   ├── components/              # Dock, TopBar, CaseFile, SuspectZone, BriefingScreen, dialogs
│   ├── win/                     # 승리 화면 + InitialsEntry
│   └── lose/                    # 패배 화면
├── leaderboard/                 # 상위 20, 신규 항목 애니메이션
├── settings/                    # API 키 설정, 내보내기, 환경설정
├── help/                        # 게임 방법, 점수, 정보
├── about/                       # 제작자 정보
└── api/
    ├── generate-case/           # GET — Mistral 사건 생성
    ├── interrogate/             # POST — 플레이어 질문 → 용의자 응답
    ├── accuse/                  # POST — 고발 평가 (별도 판사)
    ├── evaluate/                # POST — 승/패 분석
    ├── hint/                    # POST — 난독화된 스트레스 트리거 힌트
    ├── tts/                     # POST — ElevenLabs TTS
    ├── transcribe/              # POST — Voxtral STT
    ├── leaderboard/             # GET/POST — Supabase 리더보드
    ├── patterns/                # GET/POST — 세션 간 학습 패턴
    └── export/                  # GET — 관리자 JSONL 내보내기

src/lib/
├── mistral/                     # Mistral 클라이언트, 심문, 평가, 사건 생성, 임베딩
├── game-session.ts              # 서버 측 세션 저장소, 승리 토큰, 내보내기
├── game-state.ts                # 타입 정의
├── scoring.ts                   # 점수 계산 + 탐정 등급
├── sanitize.ts                  # 입력 검증, 주입 탐지
├── db.ts                        # Supabase 클라이언트
└── rate-limit.ts                # IP당 속도 제한

CREATE TABLE leaderboard (
  id uuid DEFAULT gen_random_uuid() PRIMARY KEY,
  player_name text NOT NULL,
  case_number text,
  case_setting text,
  suspect_name text,
  time_remaining int,
  stress_level int,
  clues_found int,
  hints_used int,
  accusations_used int,
  detective_rating text,
  score int NOT NULL,
  created_at timestamptz DEFAULT now()
);

ALTER TABLE leaderboard ENABLE ROW LEVEL SECURITY;
CREATE POLICY "Public read" ON leaderboard FOR SELECT USING (true);
CREATE POLICY "Public insert" ON leaderboard FOR INSERT WITH CHECK (true);

CREATE TABLE game_exports (
  id uuid DEFAULT gen_random_uuid() PRIMARY KEY,
  session_id text UNIQUE NOT NULL,
  case_data jsonb NOT NULL,
  conversation jsonb NOT NULL,
  outcome text NOT NULL,
  difficulty text NOT NULL,
  setting text,
  stats jsonb NOT NULL,
  accusation_text text,
  accusation_correct boolean,
  created_at timestamptz DEFAULT now()
);

ALTER TABLE game_exports ENABLE ROW LEVEL SECURITY;
CREATE POLICY "anon_insert" ON game_exports FOR INSERT TO anon WITH CHECK (true);
CREATE POLICY "no_public_read" ON game_exports FOR SELECT TO anon USING (false);

CREATE TABLE interrogation_patterns (
  id uuid DEFAULT gen_random_uuid() PRIMARY KEY,
  session_id text UNIQUE NOT NULL,
  setting text,
  difficulty text NOT NULL,
  outcome text NOT NULL,
  questions jsonb,
  effective_questions jsonb,
  max_stress int,
  clues_found int,
  time_elapsed int,
  embedding vector(1024),
  created_at timestamptz DEFAULT now()
);

ALTER TABLE interrogation_patterns ENABLE ROW LEVEL SECURITY;
CREATE POLICY "anon_insert" ON interrogation_patterns FOR INSERT TO anon WITH CHECK (true);
CREATE POLICY "anon_read" ON interrogation_patterns FOR SELECT TO anon USING (true);