From 5560638e54c1d5c2dc33355fe82d625553288e15 Mon Sep 17 00:00:00 2001
From: Yun Chan <yunchan@twentyoz.kr>
Date: Sat, 27 Jun 2026 16:05:57 +0900
Subject: [PATCH] =?UTF-8?q?P1=20=EC=95=84=EB=B0=94=ED=83=80=20PSB=20?=
 =?UTF-8?q?=EC=B5=9C=EC=8B=A0=EB=B3=B8=20=EA=B8=B0=EB=B3=B8=20=EC=A0=81?=
 =?UTF-8?q?=EC=9A=A9?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 apps/web/src/pages/AvatarPreview.tsx          | 8 ++++----
 apps/web/src/pages/Session.tsx                | 2 +-
 docs/dev_dashboard.html                       | 4 ++--
 docs/ops/handoff-avatar-seoyeon-2026-06-27.md | 8 +++++---
 4 files changed, 12 insertions(+), 10 deletions(-)

diff --git a/apps/web/src/pages/AvatarPreview.tsx b/apps/web/src/pages/AvatarPreview.tsx
index b55a85e..dc6b6ec 100644
--- a/apps/web/src/pages/AvatarPreview.tsx
+++ b/apps/web/src/pages/AvatarPreview.tsx
@@ -16,7 +16,7 @@ const SEOYEON: AvatarPersona = {
   outfitColor: "#7C8A92",
   eyeColor: "#7A5A3C",
   accentColor: "#6B5E7D",
-  rasterArtSet: "seoyeon",
+  rasterArtSet: "seoyeon-live2d-psb",
   realism: 0.4,
   expressionBias: "sad",
 };
@@ -42,8 +42,8 @@ export default function AvatarPreview() {
   const previewPersona: AvatarPersona = {
     ...SEOYEON,
     rasterArtSet:
-      rig === "psb"
-        ? "seoyeon-live2d-psb"
+      rig === "safe"
+        ? "seoyeon"
         : rig === "v3"
           ? "seoyeon-live2d-v3"
           : SEOYEON.rasterArtSet,
@@ -53,7 +53,7 @@ export default function AvatarPreview() {
     <div
       className="ap"
       data-avatar-preview="true"
-      data-avatar-rig={rig === "psb" ? "psb" : rig === "v3" ? "v3" : "safe"}
+      data-avatar-rig={rig === "safe" ? "safe" : rig === "v3" ? "v3" : "psb"}
     >
       <header className="ap__head">
         <h1>서연 아바타 미리보기 (raster / Live2D식)</h1>
diff --git a/apps/web/src/pages/Session.tsx b/apps/web/src/pages/Session.tsx
index 8b87f9c..325ab4b 100644
--- a/apps/web/src/pages/Session.tsx
+++ b/apps/web/src/pages/Session.tsx
@@ -110,7 +110,7 @@ const PERSONA_AVATAR_LOOKS = {
     outfitColor: "#7C8A92",
     eyeColor: "#7A5A3C",
     accentColor: "#6B5E7D",
-    rasterArtSet: "seoyeon",
+    rasterArtSet: "seoyeon-live2d-psb",
     expressionBias: "sad",
   },
   P4: {
diff --git a/docs/dev_dashboard.html b/docs/dev_dashboard.html
index 461bd1d..0e9eb23 100644
--- a/docs/dev_dashboard.html
+++ b/docs/dev_dashboard.html
@@ -589,7 +589,7 @@
               <div class="task-list">
                 <div class="task-row"><div><span class="task-status s-risk">BLOCK</span></div><div><b>공개 Google OAuth 실제 <code>/turn</code> proof 확보</b><p>로그인 가능한 계정으로 storageState를 저장한 뒤 public-auth-turn E2E를 실행한다.</p></div><div><b>산출물</b><p><code>apps/web/node_modules/.tmp/public-auth.json</code>, public <code>/turn</code> 성공 로그</p></div><div><b>검증</b><p><code>E2E_PUBLIC_AUTH=1</code> + <code>chromium-public-auth</code> 1회 통과</p></div></div>
                 <div class="task-row"><div><span class="task-status s-done">DONE</span></div><div><b>engine config 운영값 재확인</b><p><code>GET /admin/engine-config</code>로 운영값을 직접 확인했다. <code>engine_mode=claude_cli</code>, <code>engine_url=http://127.0.0.1:9099</code>, <code>model=gateway-default</code>, <code>durable=true</code>, <code>source=database</code>로 의도값과 일치한다.</p></div><div><b>산출물</b><p>config API 응답(durable, db source)</p></div><div><b>검증</b><p><code>claude_cli / http://127.0.0.1:9099 / gateway-default</code> 의도값 대조 완료</p></div></div>
-                <div class="task-row"><div><span class="task-status s-done">DONE</span></div><div><b>과거 Live2D demo 자산 제거</b><p>Mao/Haru 샘플, Pixi/Cubism 런타임, 공개 <code>/live2d/*</code> 캐시 잔여 접근을 차단했다.</p></div><div><b>산출물</b><p><code>apps/web/functions/live2d/[[path]].js</code>, SVG-only avatar</p></div><div><b>검증</b><p>운영 <code>/live2d/mao/*</code>, Cubism core <code>404</code></p></div></div>
+                <div class="task-row"><div><span class="task-status s-done">DONE</span></div><div><b>과거 Live2D demo 자산 제거</b><p>Mao/Haru 샘플, Pixi/Cubism 런타임, 공개 <code>/live2d/*</code> 캐시 잔여 접근을 차단했다.</p></div><div><b>산출물</b><p><code>apps/web/functions/live2d/[[path]].js</code>, P1 PSB raster avatar + SVG fallback</p></div><div><b>검증</b><p>운영 <code>/live2d/mao/*</code>, Cubism core <code>404</code></p></div></div>
                 <div class="task-row"><div><span class="task-status s-done">DONE</span></div><div><b>프로세스 난립 정리</b><p>임시 Vite preview와 dev API를 내리고 운영 확인용 프로세스만 유지한다.</p></div><div><b>산출물</b><p>9099 engine, 8001 prod API, cloudflared tunnel 1개</p></div><div><b>검증</b><p><code>Get-NetTCPConnection</code>에서 8000/517x/5537 비어 있음</p></div></div>
                 <div class="task-row"><div><span class="task-status s-plan">GATE</span></div><div><b>한신대 공문/데이터 거버넌스 게이트 정리</b><p>SSO 클레임, 추가 축어록 수급, 미성년 원본 활용동의, 개인정보 처리방침을 P1 진입 전 외부 의존성으로 명확히 둔다. 로컬 문서 골격은 준비됐지만 한신대/데이터 steward의 written evidence는 아직 필요하다.</p></div><div><b>산출물</b><p><code>docs/ops/hanshin-data-governance-gate.md</code>, 공문 질의 항목, 동의 범위 체크리스트, SSO claim mapping 표</p></div><div><b>검증</b><p>문서 artifact 작성 완료; IRB 게이트가 아니라 데이터/SSO 게이트로 외부 증거 필요 상태 유지</p></div></div>
               </div>
@@ -613,7 +613,7 @@
                 <div class="task-row"><div><span class="task-status s-done">DONE</span></div><div><b>음성 실패 턴 미저장</b><p>음성 회기도 엔진 응답 생성 성공 후에만 learner/client turn을 저장한다. 실패한 transcript는 pending 상태에서 제거한다.</p></div><div><b>산출물</b><p>voice failure persistence guard</p></div><div><b>검증</b><p>voice + voice-success + session-layout 15 passed</p></div></div>
                 <div class="task-row"><div><span class="task-status s-done">DONE</span></div><div><b>비영구 상태 문구 정리</b><p>admin health와 voice degraded reason은 내부 fallback/seed 표현 대신 비영구 런타임 상태를 사용자용 문구로 표시한다.</p></div><div><b>산출물</b><p>operator-facing copy cleanup</p></div><div><b>검증</b><p>settings/admin focused E2E 통과</p></div></div>
                 <div class="task-row"><div><span class="task-status s-done">DONE</span></div><div><b>직접 URL persona 차단</b><p><code>/learn/session/:code</code>로 직접 들어와도 DB 원본 persona가 아니면 회기 시작을 막는다.</p></div><div><b>산출물</b><p>route guard, degraded/seed fallback regression</p></div><div><b>검증</b><p>unavailable persona code E2E 통과</p></div></div>
-                <div class="task-row"><div><span class="task-status s-done">DONE</span></div><div><b>demo Live2D 자산 제거</b><p>Mao/Haru 샘플과 Pixi/Cubism 런타임을 공개 배포물에서 제거했다. 세션 화면은 SVG persona avatar만 렌더링한다.</p></div><div><b>산출물</b><p>SVG-only avatar, legacy <code>/live2d/*</code> 404 function</p></div><div><b>검증</b><p>Mao/Haru/Cubism core routes 404, no Live2D/Pixi chunks</p></div></div>
+                <div class="task-row"><div><span class="task-status s-done">DONE</span></div><div><b>demo Live2D 자산 제거</b><p>Mao/Haru 샘플과 Pixi/Cubism 런타임을 공개 배포물에서 제거했다. 세션 화면은 P1 PSB raster avatar와 SVG fallback을 렌더링한다.</p></div><div><b>산출물</b><p>P1 PSB raster avatar, SVG fallback, legacy <code>/live2d/*</code> 404 function</p></div><div><b>검증</b><p>Mao/Haru/Cubism core routes 404, no Live2D/Pixi chunks</p></div></div>
               </div>
             </div>
             <div class="tab-panel" id="panel-p1" role="tabpanel" aria-labelledby="tab-p1" hidden>
diff --git a/docs/ops/handoff-avatar-seoyeon-2026-06-27.md b/docs/ops/handoff-avatar-seoyeon-2026-06-27.md
index 725273d..9dd043c 100644
--- a/docs/ops/handoff-avatar-seoyeon-2026-06-27.md
+++ b/docs/ops/handoff-avatar-seoyeon-2026-06-27.md
@@ -3,6 +3,8 @@
 > 다른 세션에서 이어서 작업하기 위한 인계. imagegen(gpt-image-2)+BiRefNet+파츠 분리 리깅 파이프라인 전체를 여기서 참조.
 > 상세 원칙은 `CLAUDE.md` §4.
 
+> 2026-06-27 추가: PSB 레이어 기반 최신본은 `master` 기본 P1 아바타로 연결됐다. 실제 세션과 `/dev/avatar-preview` 기본값은 `rasterArtSet="seoyeon-live2d-psb"`이고, 기존 `seoyeon` 세트는 `/dev/avatar-preview?rig=safe` fallback으로만 확인한다.
+
 ---
 
 ## 0. 한 줄 요약
@@ -30,10 +32,10 @@
   - 28표정→클러스터 매핑(`VARIANT_FOR_EXPRESSION`) 내장.
 - **연결 배선**:
   - `persona.ts`: `AvatarPersona.rasterArtSet?: string` 추가됨.
-  - `Session.tsx`: `PERSONA_AVATAR_LOOKS.P1 = { rasterArtSet: "seoyeon", expressionBias: "sad", ... }` + avatar 객체에 `rasterArtSet` 전달.
+  - `Session.tsx`: `PERSONA_AVATAR_LOOKS.P1 = { rasterArtSet: "seoyeon-live2d-psb", expressionBias: "sad", ... }` + avatar 객체에 `rasterArtSet` 전달.
   - `ClientAvatar.tsx`: `useRaster` 분기(rasterArtSet 있으면 `RasterBust`, 없으면 기존 SVG). `data-render-mode` 속성 추가.
   - `App.tsx`: `/dev/avatar-preview` 라우트(인증 없음).
-- **dev 미리보기**: `apps/web/src/pages/AvatarPreview.tsx`(서연 220px, speaking/sad·idle/sad·listening/warm·thinking/anxious).
+- **dev 미리보기**: `apps/web/src/pages/AvatarPreview.tsx`(기본 PSB 최신본, `?rig=safe` 기존 safe 세트, `?rig=v3` atlas 세트).
 - **스크린샷 도구**: `apps/web/scripts/avatar-shot.mjs` (`BASE_URL=http://localhost:<port> node ...`).
 - **현재 에셋(Image #1=긴 머리 버전)**: `apps/web/public/avatar/seoyeon/{neutral,sad,tired,anxious,warm,startled,eyes-closed,speaking}.png` + `parts/`. → Image #2 재생성 시 덮어쓰기.
 
@@ -49,7 +51,7 @@
 ## 4. 환경 메모
 - **dev 서버**: 5173 단일 인스턴스로 띄움(백그라운드). 끊기면 `cd apps/web && npm run dev -- --port 5173 --strictPort`. (5173/5174 중복 인스턴스가 "깨진 화면" 원인이었음 — 항상 5173 단일로.)
 - codex CLI 0.142.2, auth_mode=chatgpt(구독). object-separation venv: `~/.venvs/object-separation` (CPU-only BiRefNet).
-- 서연=P1은 API 시드(`apps/api/app/services/persona.py`). 웹엔 P1이 `PERSONA_AVATAR_LOOKS`에 있고 rasterArtSet="seoyeon".
+- 서연=P1은 API 시드(`apps/api/app/services/persona.py`). 웹엔 P1이 `PERSONA_AVATAR_LOOKS`에 있고 rasterArtSet="seoyeon-live2d-psb".
 
 ## 5. 미해결/결정 필요
 - Image #2 캐릭터의 **의상 색/추가 디테일** (비전 도구 불안정 → 사용자 확인 필요).