refactor: clean up root directory by removing cache, old data, and moving scripts

.github/workflows/ci.yml

@@ -9,14 +9,14 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - name: 소스코드 체크아웃
+      - name: checkout
         uses: actions/checkout@v4
 
       - name: Python 3.10 환경 구성
         uses: actions/setup-python@v5
         with:
           python-version: "3.10"
-          cache: "pip" # 의존성 설치 속도 가속
+          cache: "pip"
 
       - name: 의존성 및 개발 도구 설치
         run: |

bugfix_report_20260519.md

@@ -1,73 +0,0 @@
-# 🕸️ Hugging Face Spaces 런타임 에러 최종 해결 기술 보고서
-> **최종 수정 일자:** 2026년 5월 19일  
-> **대상 플랫폼:** Hugging Face Spaces (FinGraph Chatbot UI)  
-> **원격 서버 최종 가동 상태:** 🟢 200 OK (정상 구동 및 서비스 제공 중)  
-
-안녕하세요, 개발자님.  
-Hugging Face Spaces 환경에서 발생하였던 **ValueError 및 TypeError(unhashable type: 'dict')** 이슈를 전격 조치하고, 원격 서버의 **Gradio 6.14.0 무오류 기동(HTTP 200 OK)** 상태까지 실시간 검증을 완료하였습니다!
-
-본 보고서는 최종 해결 내역과 근본 장애 요인의 분석 및 자동화 검증 이력을 상세히 제공합니다.
-
----
-
-## 1. 🚨 치명적 장애 요인 분석 (Root Cause Analysis)
-
-### 1.1 `TypeError: unhashable type: 'dict'` (Jinja2 / Starlette 캐시 해시 충돌)
-* **원인:** Hugging Face Spaces의 구버전 `Gradio 4.44.0` 환경에서 Starlette의 `TemplateResponse`를 로드할 때 발생한 치명적인 프레임워크 수준의 버그입니다. 
-* Gradio 4.x 내부에서 테마 설정(`"soft"`) 파라미터가 파싱되면서 템플릿 직렬화 캐싱 환경(`Jinja2 cache_key`)에 `dict` 객체가 키로 섞여 들어갔습니다. `dict`는 변경 가능(Mutable)하여 해시가 불가능하므로, `jinja2/utils.py` 캐시 맵핑 호출 시 `TypeError`가 던져지며 웹 라우터 자체가 붕괴(500)되었습니다.
-* **해결책:** 테마 렌더링 무결성이 확보되고 Jinja2 호환 에러가 영구 보완된 **`Gradio 6.14.0` (로컬 가상환경에서 검증이 끝난 최신 버전)**으로 프로덕션 버전을 통일하여 에러를 원천 소멸시켰습니다.
-
-### 1.2 `ValueError: When localhost is not accessible...` (루프백 바인딩 오류)
-* **원인:** 가상 머신/컨테이너 내부에서 포트 바인딩 매개변수 없이 `demo.launch()`가 실행되면 루프백 `127.0.0.1`에 종속되어 컨테이너 외부로 트래픽 전달이 불가해집니다.
-* **해결책:** `app.py` 구동 매개변수를 `"server_name": "0.0.0.0"`, `"server_port": 7860`으로 상시 바인딩하여 해결 완료했습니다.
-
----
-
-## 2. 🛠️ 종합 조치 내역 (Applied Changes)
-
-### 2.1 패키지 버전 정합성 100% 일치 조치
-로컬 가상환경의 안정적인 검증 사양을 프로덕션(Hugging Face) 환경과 완벽히 동기화하였습니다.
-
-* **`README.md` 프론트매터 수정:**
-  ```yaml
-  sdk: gradio
-  sdk_version: 6.14.0  # (기존: 4.44.0) 로컬 규격과 동기화
-  ```
-
-* **`requirements.txt` 의존성 상향 조정:**
-  ```text
-  # Gradio UI
-  gradio>=6.0.0          # (기존: >=4.0.0)
-  huggingface_hub>=0.20.0 # (기존: <1.0.0 구버전 제약 제거로 호환성 보장)
-  ```
-
-* **`app.py` 실행 파라미터 정비:**
-  ```python
-  launch_kwargs = {
-      "server_name": "0.0.0.0",
-      "server_port": 7860,
-  }
-  ```
-
----
-
-## 3. 🧪 100% 자동 검증 및 실시간 가동 상태 결과
-
-### 3.1 5대 방어 및 로컬 현장 테스트 완전 통과
-* **Import-Time DB 연결 방지:** `0.0초` 만에 안전하게 로컬 점검을 마쳐 CI/CD 수집 크래시 원천 차단.
-* **린트 및 타입 검사 무결성:** `ruff` 및 `mypy` 검증 무경고 완전 통과.
-* **RAG 3대 골드 시나리오 검증 (`smoke_test_rag.py`):** **3/3개 시나리오 완전 PASS!**
-
-### 3.2 🚀 원격 배포 동기화 및 200 OK 실시간 검증 완료
-- 커밋(`fix: upgrade Gradio to 6.14.0...`) 완료 후 `origin main` 푸시가 완벽하게 성공했습니다.
-- 원격 Spaces 컨테이너가 Gradio 6.14.0 부팅 및 네트워크 프록시 동기화(Warm-up) 과정을 무사히 마쳤습니다.
-- **실시간 HTTP 응답 코드 조회 검증:**
-  ```bash
-  $ curl -s -o /dev/null -w "%{http_code}" https://dev-yuje-fingraph.hf.space/
-  ➡️ 최종 응답: 200 (OK) 🎉
-  ```
-  현재 허깅페이스 원격 서비스가 무오류 가동 모드로 성공적으로 전환되었음을 직접 검증해 내었습니다.
-
----
-> **Developer Note:**  
-> 프로덕션 서버의 무결한 구동 상태까지 실시간 체크하여 `200 OK` 가동 상태를 확실히 확보하였습니다. 오타가 없는 정식 배포 주소인 **[https://huggingface.co/spaces/dev-yuje/FinGraph](https://huggingface.co/spaces/dev-yuje/FinGraph)**에서 완전하게 치유된 RAG 챗봇 서비스를 지금 바로 만나보실 수 있습니다. 앞으로도 개발자님의 든든하고 주도적인 파트너로서 최고의 완성도를 유지하겠습니다!