Initial Dansori character workspace

Noeul_Profile/08_Roadmap/App_Integration.md

@@ -0,0 +1,36 @@
+# 앱 통합 (App Integration)
+
+노을 반응 시스템을 **DansoriEQ(및 향후 Dansori 앱)** 에 탑재하는 방식.
+
+## 런타임 호스트 두 선택지 (O1 — 결정 예정)
+| 옵션 | 방식 | 장점 | 단점 |
+|---|---|---|---|
+| **A. WPF-C# 이식** | 리그·시퀀서를 C#로 포팅, WPF 캔버스에 렌더 | 네이티브·경량·기존 `AlphaTools` 재활용 | 런타임을 두 벌(웹/C#) 유지 |
+| **B. WebView2 임베드** | 웹 런타임(뷰어 진화형)을 WPF WebView2에 임베드 | 런타임 1벌(데이터·코드 공유) | WebView2 의존·상호작용 브리지 필요 |
+> 프로토타입은 웹으로 계속. Phase 3에서 A/B 결정. 어느 쪽이든 **데이터(`rig.json`·클립·`reactions.json`·이미지)는 그대로 재사용**.
+
+## 트리거 API (앱 ↔ 마스코트)
+```
+Mascot.SetIdle("dance_idle")          // 배경 기본 루프 지정
+Mascot.React("success")               // 상황키 → reactions.json → 클립 재생 → 끝나면 return(idle)
+Mascot.React("error")
+Mascot.Say("환영합니다", "smile")      // 임시 대사(mouth+face)만, 포즈 유지
+Mascot.Stop() / Mascot.SetVisible(b)
+```
+- 앱 이벤트(버튼 실패/성공, 화면 진입 등)에서 상황키만 던진다. 표현 방법은 마스코트가 데이터로 결정.
+
+## 리소스 번들
+- **필요한 PNG만** 앱 리소스로 복사(전부 아님): 리그 16파츠 + 사용하는 표정 세트 + 사용하는 baked 포즈 + hairmask.
+- 데이터 파일(`rig.json`·클립·`reactions.json`)은 소스로 번들.
+
+## 좌표·정렬 규약
+- 스테이지 캔버스 기준(현재 리그 520×900). 앱 배치 시 전체 스케일/위치만 트랜스폼.
+- 파츠 앵커 정렬은 기존 `Character_Builder/AlphaTools.cs`(알파 기반 목/어깨 검출)와 동일 알고리즘 재활용.
+- 색 변형은 런타임 hairmask hue-shift(이미지 추가 없음).
+
+## 배경 마스코트 연동(DansoriEQ 예시)
+- 메인화면 배경 노을를 **통짜 → 리그**로 교체(부유+말하기 동기화는 기존 `MainWindow.SetBgMascotTalking` 훅 활용).
+- 참고: `../../HANDOFF.md`, DansoriEQ `docs/HANDOFF.md §8`.
+
+## 포터블 원칙
+- 절대경로 금지. `Noeul_Profile`은 통째 이동 가능하게 상대경로만 사용.