Dansori_EQ/docs/SCENARIO.md

SCENARIO — 제품 요구사항 (권위 있는 원본)

1. 목적

자연어로 헤드폰/IEM의 음색을 조정하는 Windows 앱. 사용자가 "보컬 가까이, 저음 단단히" 같은 문장을 입력하면, AI가 파라메트릭 EQ를 만들어 Equalizer APO에 즉시 반영한다. Luxsin X8의 AI EQ 경험을 소프트웨어로 재현하되, 어떤 DAC/앰프와도 무관하게 동작한다.

2. 범위

In scope

• 헤드폰/IEM 프로파일 로컬 DB (AutoEQ 기반) + 앱 내 업데이트
• 프로파일 선택 → 베이스 파라메트릭 EQ 로드
• 자연어 프롬프트 → Claude API → EQ delta(구조화 JSON) → 적용
• EQ 그래프 시각화(현재 EQ + 타깃)
• APO config 렌더링/쓰기 + 라이브 적용
• 되돌리기/히스토리/베이스 리셋, 활성/바이패스 토글

Out of scope

• DAC/앰프 EQ 프로파일(평탄하므로 대상 아님; 색채는 EQ로 표현 불가)
• 측정 마이크 기반 실측 보정(현 단계 미채택; 향후 확장 여지만 남김)
• 모바일/웹/멀티플랫폼 (Windows 네이티브 전용)

3. 핵심 제약 (사용자 확정)

1. 미적으로 아름다운 모던 GUI — WPF 모던 UI 감성. 단순/텍스트 UI 금지. 웹앱 금지.
2. EQ 그래프 시각화 포함 — 보기 좋은 그래픽.
3. 저권한 — 사용자 개입 최소. (최초 1회 설정만 승격, 이후 무승격 — ARCHITECTURE 참조)
4. 프로파일 목록 IEM/헤드폰 분리 표시.
5. 라이선스 분리 관리 — 배포 불가 데이터는 별도 폴더, 배포 시 제외 옵션. 그러나 UI에는 구분 없이 병합 표시.
6. AutoEQ 베이스 + 귀로 AI 미세조정 (측정 없음).
7. Anthropic API 키는 사용자 제공(설정에서 입력/저장).

4. 사용자 워크플로 (해피 패스)

1. 앱 실행 → (최초 1회) APO 연동 설정 마법사 = 1회 UAC 승격.
2. 사이드바에서 이어폰/헤드폰 검색·선택(IEM/헤드폰 그룹 구분).
3. 해당 AutoEQ 베이스 EQ가 그래프와 필터 목록에 로드됨(자동 적용).
4. 하단 프롬프트에 "보컬 더 가깝게, 저음 단단하게" 입력 → 전송.
5. AI가 EQ를 갱신하고 무엇을·왜 바꿨는지 설명을 표시 → APO에 즉시 적용.
6. 귀로 듣고 "치찰음 조금 줄여" 등 반복 → 만족 시 종료(설정 유지).
7. 필요 시 "베이스로 리셋" 또는 "되돌리기".

4.5 핵심 사용자 여정 (End-to-End) — 정식

1. 프로파일 업데이트 — DB 관리 팝업에서 AutoEQ 최신 프로파일을 받는다.
2. 프로파일 선택 — 내 이어폰/헤드폰(IEM·헤드폰 분리 목록)을 골라 베이스 EQ를 로드한다.
3. AI로 APO PEQ 조절 — 자연어("보컬 가까이, 저음 단단히")로 AI가 EQ를 생성/수정하고 Equalizer APO에 즉시 적용한다. (그래프에서 손으로도 미세조정)
4. 나만의 EQ 완성 — 귀로 듣고 반복 조정해 개인화된 EQ를 확정한다.
5. EQ 공유 — 완성한 EQ를 .tweq로 내보낸다(대상 기기 + AI 대화 히스토리 포함).
6. 다른 사용자가 받아 듣기/수정 — 우리 프로그램으로 .tweq를 가져오면 정보 미리보기(대상 기기·히스토리·노트) 후 적용한다. 가져올 때 대상 기기 프로파일을 로컬 DB와 자동 매칭하고, 없으면 DB 업데이트로 내려받도록 안내한다. 받은 EQ는 그래프 편집 + AI 프롬프트로 재수정하고 다시 공유할 수 있다(완전한 왕복 루프).

원칙:

• 공유 EQ는 기기 종속적이다(같은 기기에서 가장 정확). 그래서 .tweq에 대상 기기명을 담아 미리보기에서 보여준다.
• .tweq엔 측정 데이터가 아니라 기기 이름/메타만 담겨 라이선스 문제 없이 배포된다.
• DAC/앰프는 EQ 대상이 아니다(평탄). 유효 변수는 트랜스듀서 + 귀 + 취향.

5. 계절/사용 컨텍스트 (참고)

• 여름 IEM 위주 / 겨울 헤드폰 위주, 서로 오감. → 프로파일 전환이 잦음(사이드바 UX 중요).
• IEM은 착용/팁에 따라 응답이 변하므로 귀 튜닝 루프가 특히 유효.

6. 성공 기준

• 알려진 헤드폰/IEM 선택 시 즉시 합리적 베이스 EQ 적용.
• 자연어 1~2회로 원하는 방향(보컬/저음/치찰음 등) 도달.
• APO 반영이 ~1초 내 체감.
• 최초 설정 후에는 UAC 프롬프트가 다시 뜨지 않음.
• UI가 "예쁘다"는 인상(다크 Fluent, 그래프 포함).