feat: Initialize nursing handoff education platform with Gradio, PostgreSQL setup, and initial database scripts. Added .gitignore, Docker configuration, and project metadata.

.gitignore

@@ -0,0 +1,27 @@
+# Environment variables
+.env
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+.venv/
+venv/
+ENV/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Database
+*.db
+*.sqlite3
+
+# OS
+.DS_Store
+Thumbs.db
+

app.py

@@ -0,0 +1,878 @@
+"""
+간호 인수인계 교육 플랫폼 - Gradio 멀티페이지 애플리케이션 (채팅 기반)
+"""
+
+import gradio as gr
+from config.database import SessionLocal, init_db
+from services.db_service import DatabaseService, load_scenarios_to_db
+from services.gemini_service import GeminiEvaluator
+
+# 데이터베이스 초기화
+try:
+    init_db()
+    print("✅ 데이터베이스 초기화 완료")
+
+    # 시나리오 데이터 로드
+    db = SessionLocal()
+    load_scenarios_to_db(db, "data/scenarios.json")
+    db.close()
+    print("✅ 시나리오 데이터 로드 완료")
+except Exception as e:
+    print(f"⚠️  데이터베이스 초기화 중 오류: {e}")
+    print("ℹ️  Docker Compose로 PostgreSQL을 먼저 실행해주세요: docker-compose up -d")
+
+# Gemini 평가기 초기화
+evaluator = GeminiEvaluator()
+
+
+# ===== EMR HTML 생성 함수들 (기존 로직 재사용) =====
+
+def create_emr_html(patient, scenario):
+    """실제 병원 EMR과 유사한 HTML 생성"""
+    vitals = scenario.vitals or {}
+    labs = scenario.labs or {}
+    orders = scenario.orders or []
+    nursing_notes = scenario.nursing_notes or []
+
+    # EMR 헤더
+    emr_html = f"""
+    <div style="font-family: 'Malgun Gothic', sans-serif; background: #f5f5f5; padding: 15px; border-radius: 8px;">
+        <!-- 환자 기본 정보 헤더 -->
+        <div style="background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); color: white; padding: 15px; border-radius: 8px; margin-bottom: 15px; box-shadow: 0 2px 8px rgba(0,0,0,0.1);">
+            <div style="display: grid; grid-template-columns: 1fr 1fr 1fr; gap: 20px;">
+                <div>
+                    <div style="font-size: 11px; opacity: 0.9;">환자명 / 등록번호</div>
+                    <div style="font-size: 16px; font-weight: bold; margin-top: 5px;">{patient.name} / {patient.id}</div>
+                </div>
+                <div>
+                    <div style="font-size: 11px; opacity: 0.9;">나이/성별 / 병실</div>
+                    <div style="font-size: 16px; font-weight: bold; margin-top: 5px;">{patient.age}세 / {patient.gender} / {patient.room_number}</div>
+                </div>
+                <div>
+                    <div style="font-size: 11px; opacity: 0.9;">입원일 / 재원일수</div>
+                    <div style="font-size: 16px; font-weight: bold; margin-top: 5px;">{patient.admission_date} / D+{scenario.hospital_day}</div>
+                </div>
+            </div>
+            <div style="margin-top: 12px; padding-top: 12px; border-top: 1px solid rgba(255,255,255,0.3);">
+                <div style="font-size: 11px; opacity: 0.9;">진단명</div>
+                <div style="font-size: 14px; font-weight: bold; margin-top: 5px;">{patient.diagnosis}</div>
+            </div>
+        </div>
+        
+        <!-- 알레르기 / 경고 -->
+        <div style="background: {'#fff3cd' if patient.allergies != '없음' else '#d4edda'}; border-left: 4px solid {'#ffc107' if patient.allergies != '없음' else '#28a745'}; padding: 12px; margin-bottom: 15px; border-radius: 4px;">
+            <strong>⚠️ 알레르기:</strong> {patient.allergies} &nbsp;&nbsp;|&nbsp;&nbsp; 
+            <strong>📋 과거력:</strong> {patient.comorbidities} &nbsp;&nbsp;|&nbsp;&nbsp;
+            <strong>👨‍⚕️ 담당의:</strong> {patient.attending_physician}
+        </div>
+        
+        <!-- 활력징후 패널 -->
+        <div style="background: white; padding: 15px; border-radius: 8px; margin-bottom: 15px; box-shadow: 0 1px 4px rgba(0,0,0,0.1);">
+            <div style="font-size: 14px; font-weight: bold; color: #333; margin-bottom: 12px; padding-bottom: 8px; border-bottom: 2px solid #667eea;">
+                📊 활력징후 <span style="font-size: 12px; color: #666; font-weight: normal;">({vitals.get('time', 'N/A')})</span>
+            </div>
+            <div style="display: grid; grid-template-columns: repeat(3, 1fr); gap: 12px;">
+                {create_vital_card('혈압', 'BP', vitals.get('BP', 'N/A'), '100-140/60-90', vitals.get('BP', ''))}
+                {create_vital_card('맥박', 'HR', vitals.get('HR', 'N/A'), '60-100', vitals.get('HR', ''))}
+                {create_vital_card('호흡', 'RR', vitals.get('RR', 'N/A'), '12-20', vitals.get('RR', ''))}
+                {create_vital_card('체온', 'BT', vitals.get('BT', 'N/A'), '36.0-37.5', vitals.get('BT', ''))}
+                {create_vital_card('산소포화도', 'SpO2', vitals.get('SpO2', 'N/A'), '≥95%', vitals.get('SpO2', ''))}
+                {create_vital_card('통증', 'Pain', vitals.get('Pain', 'N/A'), '0-3', vitals.get('Pain', ''))}
+            </div>
+        </div>
+        
+        <!-- 검사 결과 패널 -->
+        <div style="background: white; padding: 15px; border-radius: 8px; margin-bottom: 15px; box-shadow: 0 1px 4px rgba(0,0,0,0.1);">
+            <div style="font-size: 14px; font-weight: bold; color: #333; margin-bottom: 12px; padding-bottom: 8px; border-bottom: 2px solid #667eea;">
+                🧪 검사 결과 <span style="font-size: 12px; color: #666; font-weight: normal;">({labs.get('time', 'N/A')})</span>
+            </div>
+            {create_lab_results_table(labs)}
+        </div>
+        
+        <!-- 의사 처방 패널 -->
+        <div style="background: white; padding: 15px; border-radius: 8px; margin-bottom: 15px; box-shadow: 0 1px 4px rgba(0,0,0,0.1);">
+            <div style="font-size: 14px; font-weight: bold; color: #333; margin-bottom: 12px; padding-bottom: 8px; border-bottom: 2px solid #667eea;">
+                💊 의사 처방
+            </div>
+            <div style="font-size: 13px; line-height: 1.8;">
+                {create_orders_list(orders)}
+            </div>
+        </div>
+        
+        <!-- 간호 기록 패널 -->
+        <div style="background: white; padding: 15px; border-radius: 8px; margin-bottom: 15px; box-shadow: 0 1px 4px rgba(0,0,0,0.1);">
+            <div style="font-size: 14px; font-weight: bold; color: #333; margin-bottom: 12px; padding-bottom: 8px; border-bottom: 2px solid #667eea;">
+                📝 간호 기록
+            </div>
+            <div style="font-size: 13px;">
+                {create_nursing_notes_timeline(nursing_notes)}
+            </div>
+        </div>
+        
+        {create_surgery_info_panel(scenario) if scenario.surgery_info else ''}
+        {create_discharge_education_panel(scenario) if scenario.discharge_education else ''}
+    </div>
+    """
+    return emr_html
+
+
+def create_vital_card(label, code, value, normal_range, raw_value):
+    """활력징후 카드 생성"""
+    is_abnormal = check_vital_abnormal(code, raw_value)
+    bg_color = "#ffe6e6" if is_abnormal else "#e8f5e9"
+    border_color = "#f44336" if is_abnormal else "#4caf50"
+    icon = "⚠️" if is_abnormal else "✓"
+
+    return f"""
+    <div style="background: {bg_color}; border-left: 4px solid {border_color}; padding: 12px; border-radius: 4px; text-align: center;">
+        <div style="font-size: 11px; color: #666; margin-bottom: 4px;">{label}</div>
+        <div style="font-size: 18px; font-weight: bold; color: #333; margin: 6px 0;">{icon} {value}</div>
+        <div style="font-size: 10px; color: #888;">정상: {normal_range}</div>
+    </div>
+    """
+
+
+def check_vital_abnormal(code, value_str):
+    """활력징후 이상 여부 체크"""
+    if not value_str or value_str == "N/A":
+        return False
+
+    import re
+    numbers = re.findall(r"\d+\.?\d*", value_str)
+    if not numbers:
+        return False
+
+    try:
+        if code == "BP":
+            bp_values = re.findall(r"(\d+)/(\d+)", value_str)
+            if bp_values:
+                systolic = int(bp_values[0][0])
+                diastolic = int(bp_values[0][1])
+                return systolic < 90 or systolic > 140 or diastolic < 60 or diastolic > 90
+        elif code == "HR":
+            hr = int(numbers[0])
+            return hr < 60 or hr > 100
+        elif code == "RR":
+            rr = int(numbers[0])
+            return rr < 12 or rr > 20
+        elif code == "BT":
+            bt = float(numbers[0])
+            return bt < 36.0 or bt > 37.5
+        elif code == "SpO2":
+            spo2 = int(numbers[0])
+            return spo2 < 95
+        elif code == "Pain":
+            pain = int(numbers[0])
+            return pain > 3
+    except (ValueError, IndexError):
+        pass
+
+    return False
+
+
+def create_lab_results_table(labs):
+    """검사 결과 테이블 생성"""
+    if not labs:
+        return "<div style='color: #999; text-align: center; padding: 20px;'>검사 결과 없음</div>"
+
+    html = '<table style="width: 100%; border-collapse: collapse; font-size: 12px;">'
+    html += '<thead><tr style="background: #f8f9fa; font-weight: bold;">'
+    html += '<th style="padding: 10px; text-align: left; border-bottom: 2px solid #dee2e6;">검사항목</th>'
+    html += '<th style="padding: 10px; text-align: center; border-bottom: 2px solid #dee2e6;">결과</th>'
+    html += '<th style="padding: 10px; text-align: center; border-bottom: 2px solid #dee2e6;">참고범위</th>'
+    html += '<th style="padding: 10px; text-align: center; border-bottom: 2px solid #dee2e6;">상태</th>'
+    html += "</tr></thead><tbody>"
+
+    # CBC 결과
+    if "CBC" in labs:
+        cbc = labs["CBC"]
+        html += create_lab_row("WBC", cbc.get("WBC", "N/A"), "4.0-10.0 ×10³/µL", check_lab_abnormal("WBC", cbc.get("WBC", "")))
+        html += create_lab_row("Hemoglobin", cbc.get("Hb", "N/A"), "13.0-17.0 g/dL (M)", check_lab_abnormal("Hb", cbc.get("Hb", "")))
+        html += create_lab_row("Platelet", cbc.get("Plt", "N/A"), "150-400 ×10³/µL", False)
+        html += create_lab_row("Neutrophil", cbc.get("Neutrophil", "N/A"), "40-70%", False)
+
+    # CRP
+    if "CRP" in labs:
+        html += create_lab_row("CRP", labs["CRP"], "<0.5 mg/dL", check_lab_abnormal("CRP", labs["CRP"]))
+
+    # 전해질
+    if "BMP" in labs:
+        bmp = labs["BMP"]
+        html += create_lab_row("Sodium", f"{bmp.get('Na', 'N/A')} mmol/L", "136-145 mmol/L", False)
+        html += create_lab_row("Potassium", f"{bmp.get('K', 'N/A')} mmol/L", "3.5-5.0 mmol/L", False)
+        html += create_lab_row("Creatinine", f"{bmp.get('Cr', 'N/A')} mg/dL", "0.7-1.3 mg/dL", False)
+
+    html += "</tbody></table>"
+    return html
+
+
+def create_lab_row(name, value, ref_range, is_abnormal):
+    """검사 결과 행 생성"""
+    status_icon = "🔴" if is_abnormal else "🟢"
+    status_text = "비정상" if is_abnormal else "정상"
+    row_bg = "#fff3f3" if is_abnormal else "white"
+
+    return f"""
+    <tr style="background: {row_bg}; border-bottom: 1px solid #f0f0f0;">
+        <td style="padding: 10px;">{name}</td>
+        <td style="padding: 10px; text-align: center; font-weight: bold;">{value}</td>
+        <td style="padding: 10px; text-align: center; color: #666; font-size: 11px;">{ref_range}</td>
+        <td style="padding: 10px; text-align: center;">{status_icon} {status_text}</td>
+    </tr>
+    """
+
+
+def check_lab_abnormal(lab_name, value_str):
+    """검사 결과 이상 여부 체크"""
+    if "↑" in value_str or "↓" in value_str or "상승" in value_str or "감소" in value_str:
+        return True
+    return False
+
+
+def create_orders_list(orders):
+    """의사 처방 목록 생성"""
+    if not orders:
+        return "<div style='color: #999;'>처방 없음</div>"
+
+    html = '<div style="line-height: 1.9;">'
+    for i, order in enumerate(orders, 1):
+        if any(keyword in order for keyword in ["IV", "injection", "정주", "주사"]):
+            icon = "💉"
+        elif any(keyword in order for keyword in ["PO", "oral", "경구"]):
+            icon = "💊"
+        elif "NPO" in order or "금식" in order:
+            icon = "🚫"
+        elif any(keyword in order for keyword in ["수술", "surgery", "operation"]):
+            icon = "🔪"
+        else:
+            icon = "📋"
+
+        html += f'<div style="padding: 6px 0; border-bottom: 1px dotted #e0e0e0;">{icon} <strong>{i}.</strong> {order}</div>'
+    html += "</div>"
+    return html
+
+
+def create_nursing_notes_timeline(notes):
+    """간호 기록 타임라인 생성"""
+    if not notes:
+        return "<div style='color: #999;'>기록 없음</div>"
+
+    html = '<div style="position: relative; padding-left: 20px;">'
+    for note in notes:
+        time = note.get("time", "N/A")
+        content = note.get("note", "")
+        html += f"""
+        <div style="position: relative; margin-bottom: 15px; padding: 12px; background: #f8f9fa; border-left: 3px solid #667eea; border-radius: 4px;">
+            <div style="font-size: 11px; color: #667eea; font-weight: bold; margin-bottom: 5px;">🕐 {time}</div>
+            <div style="font-size: 13px; color: #333; line-height: 1.6;">{content}</div>
+        </div>
+        """
+    html += "</div>"
+    return html
+
+
+def create_surgery_info_panel(scenario):
+    """수술 정보 패널 생성"""
+    if not scenario.surgery_info:
+        return ""
+
+    surgery = scenario.surgery_info
+    return f"""
+    <div style="background: #fff8e1; padding: 15px; border-radius: 8px; margin-bottom: 15px; box-shadow: 0 1px 4px rgba(0,0,0,0.1); border-left: 4px solid #ffa726;">
+        <div style="font-size: 14px; font-weight: bold; color: #333; margin-bottom: 12px;">
+            🏥 수술 정보
+        </div>
+        <div style="display: grid; grid-template-columns: 1fr 1fr; gap: 10px; font-size: 13px;">
+            <div><strong>술식:</strong> {surgery.get('procedure', 'N/A')}</div>
+            <div><strong>수술시간:</strong> {surgery.get('time', 'N/A')}</div>
+            <div><strong>출혈량:</strong> {surgery.get('EBL', 'N/A')}</div>
+            <div><strong>수액량:</strong> {surgery.get('fluids', 'N/A')}</div>
+            <div style="grid-column: 1 / -1;"><strong>소견:</strong> {surgery.get('findings', 'N/A')}</div>
+            <div style="grid-column: 1 / -1;"><strong>합병증:</strong> {surgery.get('complications', '없음')}</div>
+        </div>
+    </div>
+    """
+
+
+def create_discharge_education_panel(scenario):
+    """퇴원 교육 패널 생성"""
+    if not scenario.discharge_education:
+        return ""
+
+    html = """
+    <div style="background: #e8f5e9; padding: 15px; border-radius: 8px; margin-bottom: 15px; box-shadow: 0 1px 4px rgba(0,0,0,0.1); border-left: 4px solid #4caf50;">
+        <div style="font-size: 14px; font-weight: bold; color: #333; margin-bottom: 12px;">
+            📚 퇴원 교육
+        </div>
+        <div style="font-size: 13px; line-height: 1.8;">
+    """
+
+    for edu in scenario.discharge_education:
+        html += f'<div style="padding: 6px 0; border-bottom: 1px dotted #c8e6c9;">✓ {edu}</div>'
+
+    html += "</div></div>"
+    return html
+
+
+# ===== 핵심 로직 함수들 =====
+
+def load_scenario_data(scenario_id: str):
+    """시나리오 선택 시 EMR 데이터 로드"""
+    if not scenario_id:
+        return None, None, ""
+
+    db = SessionLocal()
+    db_service = DatabaseService(db)
+
+    scenario = db_service.get_scenario(scenario_id)
+    patient = db_service.get_patient(scenario.patient_id) if scenario else None
+
+    db.close()
+
+    if not scenario or not patient:
+        return None, None, "시나리오를 찾을 수 없습니다."
+
+    emr_display = create_emr_html(patient, scenario)
+    return scenario, patient, emr_display
+
+
+def handle_chat_message(message, chat_history, session_id, student_id, scenario_id):
+    """채팅 메시지 처리"""
+    if not message or not message.strip():
+        return chat_history, ""
+    
+    # 시나리오가 선택되지 않은 경우
+    if not scenario_id or scenario_id == "":
+        warning_msg = """
+⚠️ **시나리오를 먼저 선택해주세요!**
+
+1. **EMR 정보 조회** 탭으로 이동하세요
+2. 시나리오 드롭다운에서 시나리오를 선택하세요
+3. EMR 정보를 확인한 후 다시 이 페이지로 돌아와 채팅을 시작하세요
+
+현재 선택된 시나리오: 없음
+"""
+        return chat_history + [[message, warning_msg]], ""
+
+    # 데이터베이스 연결
+    db = SessionLocal()
+    db_service = DatabaseService(db)
+
+    # 시나리오 및 환자 정보 조회
+    scenario = db_service.get_scenario(scenario_id)
+    patient = db_service.get_patient(scenario.patient_id) if scenario else None
+
+    if not scenario or not patient:
+        db.close()
+        error_msg = """
+❌ **시나리오 정보를 찾을 수 없습니다.**
+
+EMR 정보 조회 탭에서 시나리오를 다시 선택해주세요.
+"""
+        return chat_history + [[message, error_msg]], ""
+
+    # 사용자 메시지 저장
+    db_service.save_chat_message(session_id, student_id, scenario_id, "user", message)
+
+    # 시나리오 및 환자 데이터 준비
+    scenario_data = {
+        "title": scenario.title,
+        "handoff_situation": scenario.handoff_situation,
+        "hospital_day": scenario.hospital_day,
+        "vitals": scenario.vitals,
+        "labs": scenario.labs,
+        "orders": scenario.orders,
+        "nursing_notes": scenario.nursing_notes,
+    }
+
+    patient_data = {
+        "name": patient.name,
+        "age": patient.age,
+        "gender": patient.gender,
+        "diagnosis": patient.diagnosis,
+        "admission_date": str(patient.admission_date),
+        "allergies": patient.allergies,
+    }
+
+    # 이전 채팅 기록 포맷팅 (Gemini용)
+    history_for_gemini = []
+    for user_msg, bot_msg in chat_history:
+        if user_msg:
+            history_for_gemini.append(("user", user_msg))
+        if bot_msg:
+            history_for_gemini.append(("assistant", bot_msg))
+
+    # Gemini AI 피드백 생성
+    ai_response = evaluator.chat_feedback(message, history_for_gemini, scenario_data, patient_data)
+
+    # AI 응답 저장
+    db_service.save_chat_message(session_id, student_id, scenario_id, "assistant", ai_response)
+
+    db.close()
+
+    # 채팅 히스토리 업데이트
+    updated_history = chat_history + [[message, ai_response]]
+
+    return updated_history, ""
+
+
+def submit_final_handoff(chat_history, session_id, student_id, scenario_id):
+    """최종 제출 및 평가"""
+    if not chat_history:
+        return chat_history + [[None, "먼저 SBAR 인수인계 내용을 작성해주세요."]], ""
+
+    # 채팅 기록에서 SBAR 추출 (학생의 마지막 메시지들 분석)
+    # 간단히 하기 위해 학생에게 명시적으로 SBAR 형식으로 작성하도록 요청
+    final_message = """
+최종 제출을 요청하셨습니다. 
+
+지금까지 작성하신 내용을 바탕으로 최종 평가를 진행하겠습니다.
+SBAR 형식으로 정리된 내용을 다시 한 번 작성해주세요:
+
+**S - Situation (상황):**
+[여기에 작성]
+
+**B - Background (배경):**
+[여기에 작성]
+
+**A - Assessment (평가):**
+[여기에 작성]
+
+**R - Recommendation (권고사항):**
+[여기에 작성]
+
+위 형식으로 작성 후 다시 "최종 제출" 버튼을 눌러주세요.
+"""
+
+    # 실제 구현에서는 채팅 기록을 파싱하여 SBAR 추출
+    # 여기서는 간단히 안내 메시지만 반환
+    return chat_history + [[None, final_message]], ""
+
+
+def extract_sbar_from_message(message):
+    """메시지에서 SBAR 추출"""
+    import re
+    
+    sbar = {
+        "situation": "",
+        "background": "",
+        "assessment": "",
+        "recommendation": ""
+    }
+    
+    # S, B, A, R 섹션 추출
+    s_match = re.search(r'\*\*S.*?Situation.*?\*\*:?\s*(.*?)(?=\*\*B|\*\*Background|$)', message, re.DOTALL | re.IGNORECASE)
+    b_match = re.search(r'\*\*B.*?Background.*?\*\*:?\s*(.*?)(?=\*\*A|\*\*Assessment|$)', message, re.DOTALL | re.IGNORECASE)
+    a_match = re.search(r'\*\*A.*?Assessment.*?\*\*:?\s*(.*?)(?=\*\*R|\*\*Recommendation|$)', message, re.DOTALL | re.IGNORECASE)
+    r_match = re.search(r'\*\*R.*?Recommendation.*?\*\*:?\s*(.*?)$', message, re.DOTALL | re.IGNORECASE)
+    
+    if s_match:
+        sbar["situation"] = s_match.group(1).strip()
+    if b_match:
+        sbar["background"] = b_match.group(1).strip()
+    if a_match:
+        sbar["assessment"] = a_match.group(1).strip()
+    if r_match:
+        sbar["recommendation"] = r_match.group(1).strip()
+    
+    return sbar
+
+
+def process_final_submission(message, chat_history, session_id, student_id, scenario_id):
+    """SBAR 형식 메시지를 받아 최종 평가 수행"""
+    # SBAR 추출
+    sbar_data = extract_sbar_from_message(message)
+    
+    # 모든 섹션이 작성되었는지 확인
+    if not all([sbar_data["situation"], sbar_data["background"], 
+                sbar_data["assessment"], sbar_data["recommendation"]]):
+        return chat_history + [[message, "SBAR 형식이 완전하지 않습니다. S, B, A, R 모든 섹션을 작성해주세요."]], ""
+    
+    # 데이터베이스 연결
+    db = SessionLocal()
+    db_service = DatabaseService(db)
+    
+    # 시나리오 및 환자 정보 조회
+    scenario = db_service.get_scenario(scenario_id)
+    patient = db_service.get_patient(scenario.patient_id) if scenario else None
+    
+    if not scenario or not patient:
+        db.close()
+        return chat_history + [[message, "시나리오 정보를 찾을 수 없습니다."]], ""
+    
+    # 시나리오 및 환자 데이터 준비
+    scenario_data = {
+        "title": scenario.title,
+        "handoff_situation": scenario.handoff_situation,
+        "hospital_day": scenario.hospital_day,
+        "vitals": scenario.vitals,
+        "labs": scenario.labs,
+        "orders": scenario.orders,
+        "nursing_notes": scenario.nursing_notes,
+    }
+    
+    patient_data = {
+        "name": patient.name,
+        "age": patient.age,
+        "gender": patient.gender,
+        "diagnosis": patient.diagnosis,
+        "admission_date": str(patient.admission_date),
+        "allergies": patient.allergies,
+    }
+    
+    # Gemini AI 평가
+    evaluation = evaluator.evaluate_handoff(sbar_data, scenario_data, patient_data)
+    
+    # 데이터베이스에 저장
+    try:
+        record = db_service.create_handoff_record(
+            student_id=student_id,
+            scenario_id=scenario_id,
+            sbar_data=sbar_data,
+            evaluation=evaluation,
+            session_id=session_id
+        )
+        print(f"✅ 인수인계 기록 저장 완료 (ID: {record.id})")
+    except Exception as e:
+        print(f"⚠️  데이터베이스 저장 오류: {e}")
+    
+    db.close()
+    
+    # 평가 결과 포맷팅
+    total_score = evaluation.get("total_score", 0)
+    category_scores = evaluation.get("category_scores", {})
+    strengths = evaluation.get("strengths", [])
+    improvements = evaluation.get("improvements", [])
+    detailed_feedback = evaluation.get("detailed_feedback", "")
+    
+    result_message = f"""
+🎉 **최종 평가 완료!**
+
+**총점: {total_score:.1f} / 100**
+
+**카테고리별 점수:**
+- 완전성 (Completeness): {category_scores.get('completeness', 0)} / 25
+- 정확성 (Accuracy): {category_scores.get('accuracy', 0)} / 25
+- 명료성 (Clarity): {category_scores.get('clarity', 0)} / 25
+- 우선순위 (Priority): {category_scores.get('priority', 0)} / 25
+
+**💪 잘한 점:**
+{chr(10).join([f"- {s}" for s in strengths])}
+
+**📈 개선할 점:**
+{chr(10).join([f"- {i}" for i in improvements])}
+
+**📝 종합 피드백:**
+{detailed_feedback}
+
+---
+수고하셨습니다! 다른 시나리오로 연습을 계속하시려면 EMR 페이지로 돌아가 새로운 시나리오를 선택하세요.
+"""
+    
+    return chat_history + [[message, result_message]], ""
+
+
+def get_student_history(student_id: str):
+    """학생 인수인계 이력 조회 (관리자용)"""
+    if not student_id:
+        return "학생 ID를 입력해주세요."
+
+    db = SessionLocal()
+    db_service = DatabaseService(db)
+
+    stats = db_service.get_student_statistics(student_id)
+    records = db_service.get_records_by_student(student_id)
+
+    db.close()
+
+    if stats["total_submissions"] == 0:
+        return f"학생 ID '{student_id}'의 제출 기록이 없습니다."
+
+    history = f"""
+# 학생 인수인계 이력
+
+**학생 ID**: {student_id}
+
+## 통계
+- **총 제출 횟수**: {stats['total_submissions']}회
+- **평균 점수**: {stats['average_score']:.1f}점
+- **최고 점수**: {stats['highest_score']:.1f}점
+- **최저 점수**: {stats['lowest_score']:.1f}점
+
+## 최근 제출 기록
+"""
+
+    for i, record in enumerate(records[:10], 1):
+        submitted_time = record.submitted_at.strftime("%Y-%m-%d %H:%M") if record.submitted_at else "N/A"
+        history += f"""
+### {i}. {record.scenario_id}
+- **제출 시간**: {submitted_time}
+- **점수**: {record.total_score:.1f}점
+- **강점**: {', '.join(record.strengths[:2]) if record.strengths else 'N/A'}
+---
+"""
+
+    return history
+
+
+# ===== Gradio UI 구성 =====
+
+with gr.Blocks(title="간호 인수인계 교육 플랫폼", theme=gr.themes.Soft()) as app:
+    
+    # 전역 상태 변수
+    session_id_state = gr.State(value="")
+    student_id_state = gr.State(value="")
+    scenario_id_state = gr.State(value="S001_D0_ER_WARD")  # 기본값 설정
+    user_role_state = gr.State(value="student")
+    
+    gr.Markdown("""
+    # 🏥 간호 인수인계 교육 플랫폼 (채팅 기반)
+    
+    SBAR 형식으로 환자 인수인계를 연습하고 AI와 대화하며 피드백을 받아보세요.
+    """)
+    
+    # 초기 설정 섹션
+    with gr.Row():
+        with gr.Column():
+            student_id_input = gr.Textbox(
+                label="👤 학생 ID", 
+                placeholder="예: student001 (관리자는 'admin' 입력)",
+                value="student001"
+            )
+            start_btn = gr.Button("시작하기", variant="primary")
+    
+    # 탭 구성
+    with gr.Tabs() as tabs:
+        # 페이지 1: EMR 정보 조회
+        with gr.Tab("📊 EMR 정보 조회", id=0) as tab_emr:
+            gr.Markdown("## 환자 전자의무기록 (EMR)")
+            
+            # 사용 방법과 시나리오 선택을 한 행에 2열로 배치
+            with gr.Row():
+                with gr.Column(scale=2):
+                    gr.Markdown("""
+                    **📌 사용 방법:**
+                    1. 시나리오를 선택하세요
+                    2. EMR 정보를 충분히 확인하세요
+                    3. 준비가 되면 "답안 작성하러 가기" 버튼을 클릭하세요
+                    """)
+                with gr.Column(scale=3):
+                    scenario_dropdown = gr.Dropdown(
+                        choices=[
+                            ("Day 0 - 응급실→병동 인계 (수술 전)", "S001_D0_ER_WARD"),
+                            ("Day 0 - 병동→수술실 인계", "S001_D0_WARD_OR"),
+                            ("Day 0 - 회복실→병동 전동 (수술 후)", "S001_D0_RECOVERY"),
+                            ("Day 1 - 아침 인계 (POD1)", "S001_D1_MORNING"),
+                            ("Day 2 - 퇴원 전 인계 (POD2)", "S001_D2_DISCHARGE"),
+                        ],
+                        label="📋 시나리오 선택",
+                        value="S001_D0_ER_WARD",
+                        info="시나리오를 선택하면 EMR 정보가 표시됩니다"
+                    )
+            
+            emr_display = gr.HTML(
+                value="<div style='text-align: center; padding: 40px; color: #999;'>⬆️ 위에서 시나리오를 선택하세요.</div>"
+            )
+            
+            go_to_chat_btn = gr.Button("💬 답안 작성하러 가기", variant="primary", size="lg")
+            gr.Markdown("""
+            > 💡 **Tip**: EMR 페이지에서 언제든지 "답안 작성" 탭으로 이동할 수 있습니다.
+            """)
+        
+        # 페이지 2: 채팅 기반 답안 작성
+        with gr.Tab("💬 답안 작성 (채팅)", id=1) as tab_chat:
+            gr.Markdown("## SBAR 인수인계 작성 및 피드백")
+            gr.Markdown("""
+            **📌 시작하기:**
+            1. 기본 시나리오는 **"Day 0 - 응급실→병동 인계"**입니다 (상단에서 확인 가능)
+            2. EMR 정보를 확인하려면 **"EMR 정보 조회"** 탭을 클릭하세요
+            3. 준비가 되면 아래 메시지 입력창에 SBAR 내용을 작성하세요
+            """)
+            
+            with gr.Row():
+                current_scenario_display = gr.Markdown("**현재 시나리오**: 로딩 중...")
+                back_to_emr_btn = gr.Button("📊 EMR 다시 보기", size="sm", variant="secondary")
+            
+            chatbot = gr.Chatbot(
+                label="AI 교수와 대화",
+                height=500,
+                show_label=True
+            )
+            
+            with gr.Row():
+                msg_input = gr.Textbox(
+                    label="메시지 입력",
+                    placeholder="SBAR 형식으로 인수인계 내용을 작성하거나, 질문을 입력하세요...",
+                    lines=3,
+                    scale=4
+                )
+            
+            with gr.Row():
+                send_btn = gr.Button("전송", variant="primary")
+                submit_final_btn = gr.Button("최종 제출하기", variant="stop")
+                clear_btn = gr.Button("대화 초기화")
+            
+            gr.Markdown("""
+            **사용 방법:**
+            1. SBAR 형식으로 인수인계 내용을 작성하세요
+            2. AI 교수가 피드백을 제공합니다
+            3. 피드백을 바탕으로 수정하고 다시 작성할 수 있습니다
+            4. 준비가 되면 **최종 제출하기**를 눌러 평가를 받으세요
+            
+            **최종 제출 시 형식:**
+            ```
+            **S - Situation (상황):**
+            [내용]
+            
+            **B - Background (배경):**
+            [내용]
+            
+            **A - Assessment (평가):**
+            [내용]
+            
+            **R - Recommendation (권고사항):**
+            [내용]
+            ```
+            """)
+        
+        # 페이지 3: 관리자 이력 조회
+        with gr.Tab("📚 학생 이력 조회 (관리자)", id=2, visible=False) as tab_admin:
+            gr.Markdown("## 학생 인수인계 이력 조회")
+            
+            with gr.Row():
+                history_student_id = gr.Textbox(label="학생 ID", placeholder="student001")
+                history_btn = gr.Button("이력 조회")
+            
+            history_display = gr.Markdown(value="")
+    
+    # ===== 이벤트 핸들러 =====
+    
+    def initialize_session(student_id):
+        """세션 초기화"""
+        is_admin = (student_id == "admin")
+        role = "admin" if is_admin else "student"
+        
+        # 관리자인 경우 관리자 탭 표시
+        tab_visibility = gr.update(visible=is_admin)
+        
+        return student_id, role, tab_visibility, gr.update(value=f"환영합니다, {student_id}님!")
+    
+    start_btn.click(
+        fn=initialize_session,
+        inputs=[student_id_input],
+        outputs=[student_id_state, user_role_state, tab_admin, gr.Markdown()]
+    )
+    
+    def select_scenario_and_create_session(scenario_id, student_id):
+        """시나리오 선택 및 세션 생성"""
+        scenario, patient, emr_html = load_scenario_data(scenario_id)
+        
+        if scenario:
+            # 새 채팅 세션 생성
+            db = SessionLocal()
+            db_service = DatabaseService(db)
+            new_session_id = db_service.create_chat_session(student_id, scenario_id)
+            db.close()
+            
+            scenario_info = f"**현재 시나리오**: {scenario.title}"
+            
+            return emr_html, new_session_id, scenario_id, scenario_info
+        
+        return emr_html, "", scenario_id, "**현재 시나리오**: 선택되지 않음"
+    
+    scenario_dropdown.change(
+        fn=select_scenario_and_create_session,
+        inputs=[scenario_dropdown, student_id_state],
+        outputs=[emr_display, session_id_state, scenario_id_state, current_scenario_display]
+    )
+    
+    # 채팅 메시지 전송 (개선된 버전)
+    send_btn.click(
+        fn=handle_chat_message,
+        inputs=[msg_input, chatbot, session_id_state, student_id_state, scenario_id_state],
+        outputs=[chatbot, msg_input],
+        show_progress="minimal"
+    )
+    
+    msg_input.submit(
+        fn=handle_chat_message,
+        inputs=[msg_input, chatbot, session_id_state, student_id_state, scenario_id_state],
+        outputs=[chatbot, msg_input],
+        show_progress="minimal"
+    )
+    
+    # 최종 제출
+    submit_final_btn.click(
+        fn=process_final_submission,
+        inputs=[msg_input, chatbot, session_id_state, student_id_state, scenario_id_state],
+        outputs=[chatbot, msg_input]
+    )
+    
+    # 대화 초기화
+    def clear_chat(student_id, scenario_id):
+        """대화 초기화 및 새 세션 생성"""
+        db = SessionLocal()
+        db_service = DatabaseService(db)
+        new_session_id = db_service.create_chat_session(student_id, scenario_id)
+        db.close()
+        
+        return [], new_session_id
+    
+    clear_btn.click(
+        fn=clear_chat,
+        inputs=[student_id_state, scenario_id_state],
+        outputs=[chatbot, session_id_state]
+    )
+    
+    # 이력 조회
+    history_btn.click(
+        fn=get_student_history,
+        inputs=[history_student_id],
+        outputs=[history_display]
+    )
+    
+    # 버튼 핸들러 추가
+    def navigate_to_chat(session_id, scenario_id):
+        """채팅 페이지로 이동"""
+        return gr.update(selected=1)  # 채팅 탭으로 전환
+    
+    def navigate_to_emr():
+        """EMR 페이지로 이동"""
+        return gr.update(selected=0)  # EMR 탭으로 전환
+    
+    # 답안 작성하기 버튼 클릭 시 채팅 페이지로 이동
+    go_to_chat_btn.click(
+        fn=navigate_to_chat,
+        inputs=[session_id_state, scenario_id_state],
+        outputs=[tabs]
+    )
+    
+    # EMR 다시 보기 버튼 클릭 시 EMR 페이지로 이동
+    back_to_emr_btn.click(
+        fn=navigate_to_emr,
+        outputs=[tabs]
+    )
+    
+    # 초기 로드 함수
+    def initialize_app():
+        """앱 초기 로드 시 실행"""
+        default_scenario = "S001_D0_ER_WARD"
+        scenario, patient, emr_html = load_scenario_data(default_scenario)
+        
+        if scenario:
+            # 기본 시나리오 정보 표시
+            scenario_info = f"**현재 시나리오**: {scenario.title}"
+            return emr_html, default_scenario, scenario_info
+        else:
+            return emr_html, default_scenario, "**현재 시나리오**: 선택되지 않음"
+    
+    # 초기 로드
+    app.load(
+        fn=initialize_app,
+        outputs=[emr_display, scenario_id_state, current_scenario_display]
+    )
+
+
+if __name__ == "__main__":
+    app.launch(server_name="0.0.0.0", server_port=7860, share=False)
+

docker-compose.yml

@@ -0,0 +1,23 @@
+version: '3.8'
+
+services:
+  postgres:
+    image: postgres:15-alpine
+    container_name: nursing_handoff_db
+    environment:
+      POSTGRES_DB: nursing_handoff
+      POSTGRES_USER: postgres
+      POSTGRES_PASSWORD: postgres123
+    ports:
+      - "5433:5432"
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U postgres"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+volumes:
+  postgres_data:
+

init_db.py

@@ -0,0 +1,23 @@
+"""
+데이터베이스 초기화 및 시나리오 데이터 로드 스크립트
+"""
+
+from config.database import SessionLocal, init_db
+from services.db_service import load_scenarios_to_db
+
+if __name__ == "__main__":
+    print("🚀 데이터베이스 초기화 시작...")
+
+    # 테이블 생성
+    init_db()
+
+    # 시나리오 데이터 로드
+    print("\n📥 시나리오 데이터 로드 중...")
+    db = SessionLocal()
+    try:
+        load_scenarios_to_db(db, "data/scenarios.json")
+        print("\n✅ 모든 초기화 작업이 완료되었습니다!")
+    except Exception as e:
+        print(f"\n❌ 오류 발생: {e}")
+    finally:
+        db.close()

pyproject.toml

@@ -0,0 +1,12 @@
+[project]
+name = "nursingtakeoveredu"
+version = "0.1.0"
+description = "Add your description here"
+requires-python = ">=3.12"
+dependencies = [
+    "google-generativeai>=0.8.5",
+    "gradio>=5.49.1",
+    "psycopg2-binary>=2.9.11",
+    "python-dotenv>=1.1.1",
+    "sqlalchemy>=2.0.44",
+]

start.sh

@@ -0,0 +1,24 @@
+#!/bin/bash
+
+echo "🏥 간호 인수인계 교육 플랫폼 시작..."
+echo ""
+
+# 1. PostgreSQL 시작
+echo "📦 PostgreSQL 컨테이너 시작 중..."
+docker-compose up -d
+
+# 2. PostgreSQL 준비 대기
+echo "⏳ PostgreSQL 준비 대기 중..."
+sleep 5
+
+# 3. 데이터베이스 초기화
+echo "🗄️  데이터베이스 초기화 중..."
+uv run init_db.py 
+
+# 4. Gradio 앱 실행
+echo ""
+echo "🚀 Gradio 애플리케이션 시작..."
+echo "브라우저에서 http://localhost:7860 으로 접속하세요."
+echo ""
+uv run app.py
+