feat: P1 풀빌드 — React 프론트 7화면 + 백엔드 상담루프·평가·음성·RAG

web (Vite+React19+TS, Cloudflare Pages 배포):
- 디자인토큰(세이지틸/테라코타 SSOT), 앱셸, 공통 UI 프리미티브
- 7화면: 로그인/학습자홈/상담세션/회기리뷰/교수자/관리자/설정
- ClientAvatar: SVG 반구상 흉상 4상태 + RMS 립싱크 + 6파라미터 정서
- 회기리뷰는 외부 레퍼런스 디자인을 Vignette 토큰으로 리스킨

api (FastAPI):
- 게이트웨이 /v1/generate·/v1/stream 어댑터(상주풀/EngineSession 보존)
- services: 페르소나 L0~L6 빌더 / 결정론 상태머신 / 가드레일 /
  턴 오케스트레이터 / 회기간 메모리 / 평가AI / 음성 / RAG
- store: DB off 폴백(in-memory), sessions 실구현

검증:
- web: node22 tsc+vite build 통과(node23 segfault 회피), Pages 배포 200
- api: app.main import 통과
- 핫픽스: Topbar initials undefined-safe (undefined.trim 크래시)
- E2E: 서연(P1) 상담 1턴 — 좋은/나쁜 상담에 차등 반응 실증

apps/web/src/components/shell/AppShell.tsx

@@ -0,0 +1,36 @@
+import type { ReactNode } from "react";
+import { Topbar } from "./Topbar";
+import { Sidebar } from "./Sidebar";
+import { useAuth } from "../../lib/auth";
+
+export interface AppShellProps {
+  children: ReactNode;
+  /** 역할 컨텍스트 라벨 오버라이드 (없으면 user.role 라벨) */
+  contextLabel?: string;
+  /** 좌측 네비 숨김 (세션 화면처럼 집중 모드) */
+  hideNav?: boolean;
+  /** 메인 패딩·최대폭 제거 (풀-블리드 레이아웃) */
+  bleed?: boolean;
+}
+
+/**
+ * AppShell — 3역할 공통 셸. 톱바 + (역할 네비) + 메인.
+ * body[data-role] 은 AuthProvider 가 관리(여기선 셸 골격만).
+ * 미인증 시에도 안전하게 렌더(네비 없이) — 가드는 라우터(RequireAuth)가 담당.
+ */
+export function AppShell({ children, contextLabel, hideNav, bleed }: AppShellProps) {
+  const { user } = useAuth();
+  const showNav = !hideNav && !!user;
+
+  return (
+    <div className="vg-shell">
+      <Topbar contextLabel={contextLabel} />
+      <div className={"vg-shell__body" + (showNav ? "" : " vg-shell__body--bare")}>
+        {showNav ? <Sidebar role={user.role} /> : null}
+        <main className={"vg-main" + (bleed ? " vg-main--bleed" : "")}>
+          <div className="vg-main__inner">{children}</div>
+        </main>
+      </div>
+    </div>
+  );
+}