배포: 프론트 교체를 헬스 게이트 뒤로

.github/workflows/deploy-app.yml

@@ -130,18 +130,6 @@ jobs:
           cd "$DEPLOY_DIR"
           docker compose up -d --build ai realtime backend
 
-      - name: Build and deploy frontend
-        env:
-          VITE_API_BASE_URL: https://stack-up.shop
-          VITE_REALTIME_BASE_URL: https://stack-up.shop
-          VITE_SSE_BASE_URL: https://stack-up.shop
-        run: |
-          cd "$GITHUB_WORKSPACE/frontend"
-          npm ci
-          npm run build
-          mkdir -p /var/www/stackup/frontend/dist
-          rsync -a --delete "$GITHUB_WORKSPACE/frontend/dist/" /var/www/stackup/frontend/dist/
-
       - name: Wait for healthy
         run: |
           cd "$DEPLOY_DIR"
@@ -166,6 +154,23 @@ jobs:
           docker compose ps
           exit $rc
 
+      # 프론트 교체는 백엔드·AI 가 healthy 를 증명한 뒤에만 한다.
+      # 이전에는 헬스 게이트 앞에 있어서, 새 백엔드가 부팅에 실패해도 새 API 를 전제로
+      # 빌드된 프론트가 이미 라이브로 나가 있었다 — 실패한 배포가 "죽은 백엔드 + 새 프론트"
+      # 라는 어긋난 조합을 남긴다. 이 순서면 실패 시 프론트는 마지막 정상 버전에 머문다.
+      # (빌드 자체는 위 CI 의 Frontend 잡이 이미 검증했으므로 여기 빌드가 새로 실패할 여지는 작다.)
+      - name: Build and deploy frontend
+        env:
+          VITE_API_BASE_URL: https://stack-up.shop
+          VITE_REALTIME_BASE_URL: https://stack-up.shop
+          VITE_SSE_BASE_URL: https://stack-up.shop
+        run: |
+          cd "$GITHUB_WORKSPACE/frontend"
+          npm ci
+          npm run build
+          mkdir -p /var/www/stackup/frontend/dist
+          rsync -a --delete "$GITHUB_WORKSPACE/frontend/dist/" /var/www/stackup/frontend/dist/
+
       - name: Prune dangling images (best-effort)
         if: always()
         run: docker image prune -f >/dev/null 2>&1 || true

CLAUDE.md

@@ -144,7 +144,7 @@ cd frontend && npm install && npm run dev
 - Phase 1 (MVP) 진행 중. US-01 ~ US-20 우선.
 - 디자인 시스템 토큰 파일 미생성 — 디자인 적용 첫 PR에서 `frontend/src/app/styles/tokens.css` 생성.
 - Spring Security, RabbitMQ starter, Flyway는 백엔드 기능 작성 PR과 함께 도입.
-- `infra/rabbitmq/definitions.json`은 현재 exchange 3개 (`stackup.core-to-ai`, `stackup.ai-to-core`, `stackup.realtime`), 큐 7개 정의. 피드백 큐는 US-24 작업 시 추가.
+- `infra/rabbitmq/definitions.json`은 현재 exchange 4개 (`stackup.core-to-ai`, `stackup.ai-to-core`, `stackup.realtime` topic + `stackup.dlx` direct), 큐 15개 + DLQ 15개 정의 (분석 4종·질문·꼬리질문·피드백·음성·TTS + 콜백 5종 + realtime notify).
 - **Redis 미사용** — 휘발성 데이터(OAuth state, 멱등 키, 질문 풀 캐시)는 PostgreSQL의 short-lived 레코드 또는 Core 서버 인메모리로 처리.
 - 실시간 푸시는 **SSE + WebSocket 병행**. SSE는 작업 상태(RT2), WebSocket은 라이브 면접 메시지(RT1) 및 음성 스트림(RT3). 미디어 시그널링은 추후 WebRTC 도입 시점에 검토.
 - `RealTime Server (Go)`는 `realtime/` 디렉토리에 부트스트랩 완료. 현재 SSE만 활성, WS 엔드포인트는 US-Session-03 / US-Voice-01에서 도입.