# 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, 그래프 포함).
