# 🧠 KT Vault (Project: Trial Sandbox) *μ΅œμ’… μ—…λ°μ΄νŠΈ: 2026-05-01* ## πŸ“Œ 1. Project Overview - **λͺ©μ :** KTVault 정식 μ›Ή λŒ€μ‹œλ³΄λ“œ ꡬ좕 μ „, 3κ°€μ§€ 핡심 μ‹ κΈ°μˆ (ν™”λ €ν•œ μ›Ή ν”„λ‘ νŠΈμ—”λ“œ, λΉ„μ „/μŠ€ν¬λž˜ν•‘, μŒμ„± AI)을 μ™„λ²½νžˆ λ§ˆμŠ€ν„°ν•˜κΈ° μœ„ν•΄ μƒμ„±λœ μ΅œμ „μ„  μ‹€ν—˜μš©(방음벽) λͺ¨λž˜λ†€μ΄ν„°μž…λ‹ˆλ‹€. - **성곡 λ‚΄μ—­:** 유리 질감 UI, ꡬ글 λ‰΄μŠ€ 무료 μŠ€ν¬λž˜ν•‘, GPT-4o-mini λΉ„μ „ 차트 뢄석, TTS/STT μŒμ„± λŒ€ν™” κΈ°λŠ₯ 톡합 성곡. ## πŸ—οΈ 2. Architecture & Dependency Graph - **λ°±μ—”λ“œ (`backend.py`):** 파이썬 FastAPIλ₯Ό μ‚¬μš©ν•˜μ—¬ 포트 8000μ—μ„œ ꡬ동. `openai` 라이브러리둜 λ²”μš© 응닡 및 이미지 뢄석 μ§€λŠ₯ λ‹΄λ‹Ή. - **ν”„λ‘ νŠΈμ—”λ“œ (`index.html`):** 단일 HTML둜 ꡬ성. 순수 CSS(Glassmorphism)λ₯Ό μ‚¬μš©ν•˜λ©°, μžλ°”μŠ€ν¬λ¦½νŠΈμ˜ Web Speech APIλ₯Ό 톡해 μž…(TTS)κ³Ό κ·€(STT) 역할을 μˆ˜ν–‰ν•¨. - **μ‹€ν–‰ 단좕킀:** λ°”νƒ•ν™”λ©΄μ˜ `νŠΈλΌμ΄μ–Ό 둜컬.bat`을 톡해 8000 포트 정리 ν›„ λ™μ‹œ 싀행됨. ## πŸ”— 3. Database & API Pointers - **인증 방식:** `Klaw` ν΄λ”μ˜ `.env` νŒŒμΌμ„ λ³΅μ‚¬ν•΄μ™€μ„œ μ‹œμŠ€ν…œ 곡유 OpenAI API Keyλ₯Ό ν™œμš©ν•¨. DBλŠ” μ‚¬μš©ν•˜μ§€ μ•ŠμŒ. - **상세 νŒ¨μΉ˜λ…ΈνŠΈ λ³΄κ΄€μ†Œ:** `docs/patch_note_v1.0.0.md` ## πŸ› οΈ 4. Key Facts & Snippets Archive ### [κ²½ν—˜ μžμ‚°] μ„œλ²„ 톡신 μ‹€νŒ¨ (μ’€λΉ„ ν”„λ‘œμ„ΈμŠ€) λŒ€μ²˜λ²• - **상황:** μ½”λ“œλ₯Ό λŒ€λŒ€μ μœΌλ‘œ μ—…λ°μ΄νŠΈν•œ ν›„ μ›Ήμ—μ„œ 마이크λ₯Ό λˆŒλ €μœΌλ‚˜ 계속 "μ„œλ²„ 톡신 μ‹€νŒ¨"κ°€ λœ¨λŠ” 문제 λ°œμƒ. - **μ˜€μ›μΈ:** ν”„λ‘ νŠΈμ—”λ“œ(UI)만 μƒˆλ‘œκ³ μΉ¨ν•˜κ³ , μ •μž‘ 심μž₯인 λ°±μ—”λ“œ(파이썬) 창은 껐닀 μΌœμ§€ μ•Šμ•˜μŒ. (ν˜Ήμ€ λ°±κ·ΈλΌμš΄λ“œμ— 포트 번호 8000λ²ˆμ„ λ¬Όκ³  μžˆλŠ” μ’€λΉ„κ°€ μžˆμ—ˆμŒ) - **κ΅ν›ˆ:** μ›Ήμ‚¬μ΄νŠΈ(껍데기) λ²„νŠΌμ„ λˆ„λ₯Ό λ•Œ 응닡이 μ—†μœΌλ©΄ 파이썬(μ„œλ²„)이 μ‚΄μ•„μžˆλŠ”μ§€ 무쑰건 λ¨Όμ € 확인할 것! - **μŠ€λ‹ˆνŽ« ν•΄κ²°μ±…:** μ•žμœΌλ‘œ λͺ¨λ“  배치파일(.bat) μ‹€ν–‰ μ‹œ 무쑰건 κ°•μ œλ‘œ 8000 포트 쒀비듀을 죽이고 μ‹œμž‘ν•˜λ„λ‘ μŠ€ν¬λ¦½νŠΈν™” μ™„λ£Œ. ```bat FOR /F "tokens=5" %%T IN ('netstat -a -n -o ^| findstr :8000') DO ( taskkill /F /PID %%T 2>nul ) ``` ## πŸš€ 5. Future Roadmap & R&D Blueprints ### [Blueprint] AI μžλ™ν™” λ¦¬μ…‰μ…”λ‹ˆμŠ€νŠΈ (Receptionist) μ‹œμŠ€ν…œ - **κ°œμš”:** μ‚¬λžŒμ„ λŒ€μ‹ ν•΄ μ „ν™”λ₯Ό λ°›κ³ , 고객 상담을 μ§„ν–‰ν•˜λ©°, μžλ™μœΌλ‘œ μŠ€μΌ€μ€„μ„ κΈ°λ‘ν•˜λŠ” μ™„μ „ 무인 μ ‘μˆ˜μ› ν”„λ‘œκ·Έλž¨. - **3λŒ€ 핡심 기술 연동 κ³„νš:** 1. **Voice I/O (귀와 μž…):** Trial μƒŒλ“œλ°•μŠ€μ˜ `μ‹€μ‹œκ°„ 톡합 톡화` (Web Speech API / Realtime Voice) κΈ°λŠ₯을 ν™œμš©ν•˜μ—¬ μžμ—°μŠ€λŸ¬μš΄ 원어민 μŒμ„±μœΌλ‘œ 톡화 (STT/TTS λ”œλ ˆμ΄ μ œλ‘œν™”). 2. **Knowledge RAG (λ‡Œμ™€ 지식):** 식당/병원 λ“± μ—…μž₯의 맀뉴얼(μš”κΈˆ, μ‹œκ°„, μœ„μΉ˜)을 ν”„λ‘¬ν”„νŠΈμ™€ μ°Έμ‘° DB둜 λ½μΈν•˜μ—¬ μ •ν™•ν•œ μ •λ³΄λ§Œ μΉœμ ˆν•˜κ²Œ μ•ˆλ‚΄. 3. **Function Calling (손과 μ œμ–΄ - μΆ”κ°€ ν•„μš” 둜직):** λŒ€ν™” 쀑 고객이 μ›ν•˜λŠ” 'μ˜ˆμ•½ λ‚ μ§œμ™€ μ‹œκ°„'을 LLM이 슀슀둜 μΆ”μΆœν•˜μ—¬, 파이썬 λ°±μ—”λ“œμ˜ `save_schedule(date, time)` ν•¨μˆ˜λ₯Ό λͺ°λž˜ 호좜(Trigger). ꡬ글 μΊ˜λ¦°λ”λ‚˜ μ™ΈλΆ€ JSON DB에 μ‹€μ œ μŠ€μΌ€μ€„μ„ ν™•μ • μ§“λŠ” 핡심 λ™μž‘. - **R&D μƒνƒœ:** Trial μƒŒλ“œλ°•μŠ€μ—μ„œ ν™•λ³΄ν•œ μŒμ„± 및 LLM λΆ„κΈ° κΈ°μˆ μ„ 톡해 ν”„λ ˆμž„μ›Œν¬ 기초 검증은 이미 μ™„λ£Œλœ μƒνƒœ. 파이썬 Function Calling κΈ°λŠ₯만 μ£Όμž…ν•˜λ©΄ μ¦‰μ‹œ μƒμš© μˆ˜μ€€ 도달 κ°€λŠ₯. ### [Blueprint] μ„œλ²„λ¦¬μŠ€(Cloud Run) 기반 0원 μ•„ν‚€ν…μ²˜ λ§ˆμ΄κ·Έλ ˆμ΄μ…˜ - **κ°œμš”:** ν˜„μž¬ 였리건 λ¦¬μ „μ˜ VM(e2-micro) 기반으둜 배포된 Trial μƒŒλ“œλ°•μŠ€λ₯Ό, ꡬ글 ν΄λΌμš°λ“œ 런(Cloud Run) μ„œλ²„λ¦¬μŠ€ ν™˜κ²½μœΌλ‘œ μ΄μ „ν•˜μ—¬ 'μ™„λ²½ν•œ 0원 과금'을 λ‹¬μ„±ν•˜λŠ” ν”„λ‘œμ νŠΈ. - **μΆ”μ§„ λ°°κ²½:** VM ν™˜κ²½μ€ μ½”μ–΄/램 μš”κΈˆμ€ 무료 λ°©μ–΄κ°€ κ°€λŠ₯ν•˜λ‚˜, 곡인 IP ν†΅ν–‰λ£Œ(μ›” μ•½ 3,900원)κ°€ 무쑰건 λ°œμƒν•˜λŠ” ꡬ쑰적 ν•œκ³„(24λ…„ ꡬ글 μ •μ±… λ³€κ²½)κ°€ 확인됨에 따라 이λ₯Ό νšŒν”Όν•˜κΈ° μœ„ν•¨. - **κΈ°λŒ€ 효과 (Scale-to-Zero):** 1. μ ‘μ†μžκ°€ 없을 λ•ŒλŠ” μ„œλ²„ μžμ²΄κ°€ ν—ˆκ³΅μœΌλ‘œ μ†Œλ©Έν•˜μ—¬ IP μš”κΈˆ 포함 **100% 과금 0원** 달성. 2. ν•„μš”ν•  λ•Œλ§Œ Docker μ»¨ν…Œμ΄λ„ˆκ°€ 1초 λ§Œμ— κΉ¨μ–΄λ‚˜ 응닡. - **기술적 과제:** κΈ°μ‘΄ `backend.py`λ₯Ό Dockerfile둜 νŒ¨ν‚€μ§•. ν…”λ ˆκ·Έλž¨ 봇 연동 μ‹œ 지속 κ°μ‹œ(Polling) 방식 λŒ€μ‹ , λ©”μ‹œμ§€ μˆ˜μ‹  μ‹œμ—λ§Œ μ„œλ²„λ₯Ό κΉ¨μš°λŠ” μ›Ήν›…(Webhook) λ°©μ‹μœΌλ‘œ μ „ν™˜ ν•„μˆ˜.