현재 작업 전체 반영

apps/web/README.md

@@ -16,6 +16,8 @@ npm run dev        # http://localhost:5173 (개발 서버, /api → :8000 프록
 
 ```bash
 npm run build      # tsc -b + vite build → dist/
+npm run generate:api-types  # FastAPI OpenAPI → src/lib/api.gen.ts
+npm run check:api-types     # 생성 타입 stale 체크
 npm run generate:live2d-assets
 npm run preview    # 빌드 결과 미리보기
 npm run typecheck  # tsc --noEmit (타입 체크만)
@@ -64,7 +66,8 @@ src/
     tokens.css             ★ 디자인 토큰 (라이트/다크/역할 accent). dev_dashboard 계승.
     global.css             reset + body + 스크롤바 + 유틸.
   lib/
-    api.ts                 fetch wrapper(credentials:include) + SSE 헬퍼 + 세션 API + 백엔드 타입.
+    api.ts                 fetch wrapper(credentials:include) + SSE 헬퍼 + 세션 API.
+    api.gen.ts             FastAPI OpenAPI에서 생성한 백엔드 DTO 타입.
     auth.tsx               AuthContext(user/role/login/logout). body[data-role] 반영.
     format.ts              시간/타이머/숫자 포맷(tabular).
   components/