[TEST] test41

.backend copy.pid

@@ -0,0 +1 @@
+2909266

client/app.py

@@ -530,7 +530,7 @@ with demo:
 # Hugging Face Spaces 및 로컬 실행 모두 지원
 # Spaces에서는 demo.launch()가 자동 호출되지만, allowed_paths 설정을 위해 직접 호출
 server_host = os.getenv("SERVER_HOST", "0.0.0.0")
-frontend_port = int(os.getenv("FRONTEND_PORT", 7860))
+frontend_port = int(os.getenv("FRONTEND_PORT"))
 
 # Gradio 실행 (CSS 적용)
 demo.launch(

client/frontend/app_ui.py

@@ -23,6 +23,7 @@ from frontend.components.failure_modal import FailureModalComponent
 from frontend.components.success_screen import SuccessScreenComponent
 from frontend.components.giveup_screen import GiveUpScreenComponent
 from frontend.components.floating_chatbot import FloatingChatbotComponent
+from frontend.components.welcome_modal import WelcomeModal
 from frontend.styles.custom_css import get_all_css  # Gradio 6: launch()에서 사용
 
 # 게임 상태 관리 (UUID, 세션 등)
@@ -47,6 +48,7 @@ class AppUI:
         self.success_screen = SuccessScreenComponent()
         self.giveup_screen = GiveUpScreenComponent()
         self.floating_chatbot = FloatingChatbotComponent()
+        self.welcome_modal = WelcomeModal()
 
         # 상태 변수
         self.failure_history = None
@@ -134,6 +136,9 @@ class AppUI:
             # ============== 플로팅 AI 챗봇 (UUID 공유) ==============
             self.floating_chatbot.render(game_state=self.game_state)
 
+            # ============== 웰컴 모달 (첫 방문 시 YouTube 튜토리얼) ==============
+            self.welcome_modal.render()
+
             # 반환할 컴포넌트들
             components = {
                 'demo': demo,

client/frontend/components/floating_chatbot.py

@@ -505,8 +505,23 @@ class FloatingChatbotComponent:
         Args:
             game_state: 외부에서 전달받은 gr.BrowserState (UUID 포함)
         """
+        # 초기 환영 메시지 정의
+        welcome_message = """Welcome to Audio Semantle! 👋 Get ready for a unique and super fun pronunciation puzzle game where your voice is the key!
+
+Here's how it works:
+
+1. **You start completely blind!** You have absolutely NO idea what the mystery word or phrase is. That's part of the fun!
+2. **Your first move:** Just speak any word or phrase that comes to mind. Seriously, anything!
+3. **Get instant feedback:** Our AI will listen and give you scores (0-100) for your Pitch, Rhythm, Energy, Pronunciation, and an Overall similarity score to the hidden target.
+4. **Deduce and discover:** Based on these scores, and with my help offering progressive hints, you'll start narrowing down what the target phrase might be.
+5. **Unlimited attempts:** This isn't like Wordle! You have as many tries as you need to figure it out. It's all about discovery and getting closer with each attempt.
+
+Don't overthink your first try – it's meant to be a shot in the dark! Just say anything you like, and let's see where that takes us. Ready to give it a go? What's the first thing that comes to your mind?"""
+
+        self.initial_history = [{"role": "assistant", "content": welcome_message}]
+
         # 상태 관리
-        self.chat_history = gr.State([])
+        self.chat_history = gr.State(self.initial_history.copy())
         self.game_state_ref = game_state  # 외부 game_state 참조 저장
 
         # 토글 버튼 (Checkbox) - JavaScript로 visibility 제어
@@ -531,9 +546,9 @@ class FloatingChatbotComponent:
                     min_width=32
                 )
 
-            # 챗봇
+            # 챗봇 (초기 환영 메시지 포함)
             chatbot = gr.Chatbot(
-                value=[],
+                value=self.initial_history,
                 height=280,
                 elem_id="floating-chatbot",
                 show_label=False

client/frontend/components/welcome_modal.py

@@ -0,0 +1,306 @@
+"""
+웰컴 모달 컴포넌트 - YouTube 튜토리얼 영상 팝업
+첫 방문 시 자동으로 표시, "다시 보지 않기" 기능 지원
+
+localStorage 키: 'welcome_modal_dismissed' (게임 상태와 독립적)
+"""
+
+import gradio as gr
+
+
+class WelcomeModal:
+    """
+    웰컴 모달 - YouTube 튜토리얼 영상 표시
+
+    - 첫 방문 시 자동 표시
+    - "다시 보지 않기" 클릭 시 localStorage에 저장
+    - 게임 초기화와 독립적으로 설정 유지
+    """
+
+    # YouTube 영상 ID
+    YOUTUBE_VIDEO_ID = "YbCf6x0B3fU"
+
+    # localStorage 키 (게임 상태와 별도)
+    STORAGE_KEY = "welcome_modal_dismissed"
+
+    HTML_TEMPLATE = """
+    ${value && value.visible ? `
+    <div class="welcome-modal-overlay" data-welcome-overlay="true">
+        <div class="welcome-modal-container">
+            <div class="welcome-modal-content">
+                <h2 class="welcome-modal-title">Welcome to Voice Semantle!</h2>
+
+                <div class="welcome-modal-video">
+                    <iframe
+                        src="https://www.youtube.com/embed/${value.videoId || 'YbCf6x0B3fU'}?rel=0&modestbranding=1"
+                        title="Voice Semantle Tutorial"
+                        frameborder="0"
+                        allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"
+                        referrerpolicy="strict-origin-when-cross-origin"
+                        allowfullscreen>
+                    </iframe>
+                </div>
+
+                <div class="welcome-modal-actions">
+                    <button class="welcome-modal-btn welcome-modal-btn-primary" data-welcome-close="true">
+                        Start Playing
+                    </button>
+                    <button class="welcome-modal-btn welcome-modal-btn-secondary" data-welcome-dismiss="true">
+                        Don't show again
+                    </button>
+                </div>
+            </div>
+        </div>
+    </div>
+    ` : ''}
+    """
+
+    CSS_TEMPLATE = """
+    /* 웰컴 모달 - 전역 스타일에 영향 없도록 스코핑 */
+    .welcome-modal-overlay {
+        position: fixed !important;
+        top: 0 !important;
+        left: 0 !important;
+        right: 0 !important;
+        bottom: 0 !important;
+        width: 100vw !important;
+        height: 100vh !important;
+        background-color: rgba(0, 0, 0, 0.7) !important;
+        backdrop-filter: blur(4px);
+        z-index: 9999 !important;
+        display: flex !important;
+        justify-content: center !important;
+        align-items: center !important;
+        padding: 20px;
+        box-sizing: border-box;
+        font-family: inherit;
+    }
+
+    .welcome-modal-container {
+        width: 100%;
+        max-width: 1280px;
+        max-height: 90vh;
+        overflow-y: auto;
+        position: relative;
+        animation: welcomeModalFadeIn 0.3s ease-out;
+        font-family: inherit;
+    }
+
+    @keyframes welcomeModalFadeIn {
+        from {
+            opacity: 0;
+            transform: scale(0.9) translateY(-20px);
+        }
+        to {
+            opacity: 1;
+            transform: scale(1) translateY(0);
+        }
+    }
+
+    .welcome-modal-close {
+        position: absolute;
+        top: 16px;
+        right: 16px;
+        background: rgba(255, 255, 255, 0.1);
+        border: 1px solid rgba(255, 255, 255, 0.2);
+        border-radius: 50%;
+        width: 40px;
+        height: 40px;
+        cursor: pointer;
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        color: #ffffff;
+        transition: all 0.2s ease;
+        z-index: 10;
+        padding: 0;
+        font-family: inherit;
+    }
+
+    .welcome-modal-close:hover {
+        background: rgba(255, 255, 255, 0.2);
+        transform: scale(1.1);
+    }
+
+    .welcome-modal-content {
+        padding: 32px;
+        text-align: center;
+        font-family: inherit;
+    }
+
+    .welcome-modal-title {
+        font-size: 60px;
+        font-weight: 700;
+        color: #ffffff;
+        margin: 0 0 24px 0;
+        font-family: inherit;
+    }
+
+    .welcome-modal-subtitle {
+        font-size: 16px;
+        color: rgba(255, 255, 255, 0.7);
+        margin: 0 0 24px 0;
+        font-family: inherit;
+    }
+
+    .welcome-modal-video {
+        position: relative;
+        width: 100%;
+        padding-bottom: 56.25%; /* 16:9 aspect ratio */
+        border-radius: 16px;
+        overflow: hidden;
+        background: #000;
+        margin-bottom: 24px;
+    }
+
+    .welcome-modal-video iframe {
+        position: absolute;
+        top: 0;
+        left: 0;
+        width: 100%;
+        height: 100%;
+    }
+
+    .welcome-modal-actions {
+        display: flex;
+        justify-content: center;
+        gap: 12px;
+        align-items: center;
+    }
+
+    .welcome-modal-btn {
+        padding: 14px 32px;
+        border-radius: 20px;
+        font-size: 16px;
+        font-weight: 600;
+        cursor: pointer;
+        transition: all 0.2s ease;
+        border: none;
+        min-width: 200px;
+        font-family: inherit;
+    }
+
+    .welcome-modal-btn-primary {
+        background: #4db8ff !important;
+        color: #ffffff !important;
+    }
+
+    .welcome-modal-btn-primary:hover {
+        transform: translateY(-2px);
+    }
+
+    .welcome-modal-btn-secondary {
+        background: transparent;
+        color: rgba(255, 255, 255, 0.6);
+        border: 1px solid rgba(255, 255, 255, 0.2);
+    }
+
+    .welcome-modal-btn-secondary:hover {
+        background: rgba(255, 255, 255, 0.1);
+        color: rgba(255, 255, 255, 0.9);
+    }
+
+    /* Mobile responsive */
+    @media (max-width: 600px) {
+        .welcome-modal-container {
+            max-width: 100%;
+            border-radius: 16px;
+        }
+
+        .welcome-modal-content {
+            padding: 24px 16px;
+        }
+
+        .welcome-modal-title {
+            font-size: 22px;
+        }
+
+        .welcome-modal-btn {
+            width: 100%;
+            min-width: unset;
+        }
+    }
+    """
+
+    JS_ON_LOAD = """
+    const STORAGE_KEY = 'welcome_modal_dismissed';
+    const videoId = props.value?.videoId || 'YbCf6x0B3fU';
+
+    // 페이지 로드 시 localStorage 체크
+    const isDismissed = localStorage.getItem(STORAGE_KEY) === 'true';
+
+    // "다시 보지 않기"를 선택하지 않은 경우에만 모달 표시
+    if (!isDismissed) {
+        // 폰트가 완전히 로드된 후 모달 표시
+        document.fonts.ready.then(() => {
+            // 폰트 로드 후 약간의 딜레이 추가 (렌더링 안정화)
+            setTimeout(() => {
+                props.value = { visible: true, videoId: videoId };
+            }, 100);
+        });
+    }
+
+    // 클릭 이벤트 핸들러
+    element.addEventListener('click', (e) => {
+        // 배경 클릭으로 닫기
+        if (e.target.dataset.welcomeOverlay === 'true') {
+            props.value = { visible: false, videoId: props.value?.videoId };
+        }
+
+        // X 버튼 또는 "Start Playing" 버튼 클릭
+        if (e.target.closest('[data-welcome-close="true"]')) {
+            props.value = { visible: false, videoId: props.value?.videoId };
+        }
+
+        // "Don't show again" 버튼 클릭
+        if (e.target.closest('[data-welcome-dismiss="true"]')) {
+            localStorage.setItem(STORAGE_KEY, 'true');
+            props.value = { visible: false, videoId: props.value?.videoId };
+        }
+    });
+
+    // ESC 키로 닫기
+    const handleKeydown = (e) => {
+        if (e.key === 'Escape' && props.value && props.value.visible) {
+            props.value = { visible: false, videoId: props.value?.videoId };
+        }
+    };
+    document.addEventListener('keydown', handleKeydown);
+    """
+
+    def __init__(self, video_id: str = None):
+        """
+        웰컴 모달 초기화
+
+        Args:
+            video_id: YouTube 영상 ID (기본값: YbCf6x0B3fU)
+        """
+        self.video_id = video_id or self.YOUTUBE_VIDEO_ID
+        self.component = None
+
+    def render(self) -> gr.HTML:
+        """
+        웰컴 모달 컴포넌트 렌더링
+
+        Returns:
+            gr.HTML: 렌더링된 모달 컴포넌트
+        """
+        # 초기값은 visible: False로 설정 (JS에서 로드 후 표시)
+        self.component = gr.HTML(
+            value={"visible": False, "videoId": self.video_id},
+            html_template=self.HTML_TEMPLATE,
+            css_template=self.CSS_TEMPLATE,
+            js_on_load=self.JS_ON_LOAD,
+            elem_id="welcome-modal",
+        )
+        return self.component
+
+    @staticmethod
+    def show(video_id: str = "YbCf6x0B3fU") -> dict:
+        """모달 열기"""
+        return {"visible": True, "videoId": video_id}
+
+    @staticmethod
+    def hide() -> dict:
+        """모달 닫기"""
+        return {"visible": False, "videoId": ""}

client/frontend/styles/chatbot_style.py

@@ -88,8 +88,8 @@ FLOATING_CHATBOT_CSS = """
     position: fixed;
     bottom: 104px;
     right: 20px;
-    width: 420px;
-    height: 640px;
+    width: 636px;
+    height: 840px;
     max-width: calc(100vw - 20px);
     max-height: calc(100vh - 128px);
     gap: 0;
@@ -267,7 +267,7 @@ FLOATING_CHATBOT_CSS = """
 }
 
 /* 모바일 반응형 */
-@media (max-width: 480px) {
+@media (max-width: 768px) {
     #chat-container {
         width: calc(100vw - 32px);
         right: 16px;

client/frontend/styles/custom_css.py

@@ -38,6 +38,6 @@ def get_all_css():
 def get_head_scripts():
     """head에 삽입할 JavaScript 반환"""
     import os
-    backend_port = os.getenv("BACKEND_PORT", "8445")
+    backend_port = os.getenv("BACKEND_PORT")
     backend_port_script = f"<script>window.BACKEND_PORT = {backend_port};</script>"
     return backend_port_script + CELEBRATION_JS + FALLING_ELEMENTS_JS + GAMEOVER_JS

client/services/analysis_service.py

@@ -110,7 +110,8 @@ async def analyze_voice(audio_bytes: bytes, date: str, session_id: str) -> Dict:
     add_hint_to_history(session_id, advice)
 
     # 7. Save guess record to database
-    save_guess_record(
+    logger.info(f"[DB] Attempting to save guess record for session={session_id}, puzzle={puzzle['puzzle_number']}")
+    save_result = save_guess_record(
         session_id=session_id,
         puzzle_number=puzzle["puzzle_number"],
         pitch=pitch,
@@ -123,6 +124,10 @@ async def analyze_voice(audio_bytes: bytes, date: str, session_id: str) -> Dict:
         is_correct=is_correct,
         user_text=user_text,
     )
+    if save_result:
+        logger.info(f"[DB] ✅ Successfully saved guess record")
+    else:
+        logger.error(f"[DB] ❌ Failed to save guess record!")
 
     total_time = (time.time() - start_time) * 1000
     logger.info(f"⏱️  TOTAL REQUEST TIME: {total_time:.1f}ms")

client/services/database.py

@@ -125,10 +125,10 @@ def save_guess_record(
             """
             INSERT INTO guess_records
             (session_id, puzzle_number, pitch, rhythm, energy, pronunciation,
-             transcript, overall, advice, is_correct, guess_timestamp, user_text)
+             transcript, overall, advice, is_correct, guess_timestamp)
             VALUES
             (:session_id, :puzzle_number, :pitch, :rhythm, :energy, :pronunciation,
-             :transcript, :overall, :advice, :is_correct, :guess_timestamp, :user_text)
+             :transcript, :overall, :advice, :is_correct, :guess_timestamp)
         """
         )
 
@@ -147,7 +147,6 @@ def save_guess_record(
                     "advice": advice,
                     "is_correct": is_correct,
                     "guess_timestamp": guess_timestamp,
-                    "user_text": user_text,
                 },
             )
             connection.commit()
@@ -159,6 +158,9 @@ def save_guess_record(
 
     except Exception as e:
         logger.error(f"Failed to save guess record: {e}")
+        import traceback
+        traceback.print_exc()
+        print(f"[DB ERROR] save_guess_record failed: {e}")
         return False