add local test

HF_SECRETS_설정.md

@@ -1,65 +0,0 @@
-# 🔐 Hugging Face Secrets 설정 가이드
-
-## 📋 설정할 5개 Secrets
-
-Hugging Face Space → Settings → Repository secrets → New secret
-
-### 1️⃣ DB_USER
-```
-Value: ADMIN
-```
-
-### 2️⃣ DB_PASSWORD
-```
-Value: Oracle_DB_비밀번호
-```
-(Oracle Cloud Console에서 확인 또는 재설정)
-
-### 3️⃣ DB_TNS_ALIAS
-```
-Value: musclecare_high
-```
-(wallet/tnsnames.ora에서 확인한 이름)
-
-### 4️⃣ WALLET_ZIP_B64 ⭐ 가장 중요!
-```
-Value: (wallet_base64.txt 파일 전체 내용)
-```
-
-**생성 방법:**
-```bash
-# Wallet zip 파일을 Base64로 인코딩
-base64 -i ~/Downloads/Wallet_musclecare.zip -o wallet_base64.txt
-
-# wallet_base64.txt 파일 열어서 전체 복사
-cat wallet_base64.txt | pbcopy  # Mac
-```
-
-### 5️⃣ WALLET_PASSWORD
-```
-Value: Wallet_다운로드시_설정한_비밀번호
-```
-
----
-
-## ✅ 설정 완료 후
-
-```bash
-git push
-```
-
-자동으로 배포됩니다!
-
----
-
-## 🧪 배포 확인
-
-```bash
-curl https://[username]-musclecare-api.hf.space/health
-```
-
-**성공 응답:**
-```json
-{"ok": true, "db": 1}
-```
-

README.md

@@ -1,93 +1,11 @@
-# 🏋️ MuscleCare FastAPI
-
-Oracle Autonomous Database 연동 FastAPI 서버 (Wallet 기반 mTLS)
-
-## 🚀 주요 기능
-
-- 🔐 **Wallet 기반 mTLS 연결** - 최고 보안 수준
-- 📤 **사용자 상태 업로드/다운로드** - baseline + user_emb
-- 📊 **피로도 로그 저장** - Oracle DB에 안전하게 저장
-
 ---
-
-## 📡 API 엔드포인트
-
-| 엔드포인트 | 메소드 | 설명 |
-|-----------|--------|------|
-| `/health` | GET | DB 연결 상태 확인 |
-| `/upload_state` | POST | 사용자 상태 업로드 |
-| `/upload_logs` | POST | 피로도 로그 업로드 |
-
+title: MuscleCare API
+emoji: 🏋️
+colorFrom: blue
+colorTo: purple
+sdk: docker
+sdk_version: "3.10"
+app_file: start.py
+pinned: false
+license: apache-2.0
 ---
-
-## 🌐 Hugging Face Space 배포
-
-### 1. Wallet Base64 인코딩
-
-```bash
-base64 -i ~/Downloads/Wallet_musclecare.zip -o wallet_base64.txt
-```
-
-### 2. Hugging Face Secrets 설정 (5개)
-
-**Settings → Repository secrets**
-
-| Secret | Value |
-|--------|-------|
-| `DB_USER` | `ADMIN` |
-| `DB_PASSWORD` | Oracle DB 비밀번호 |
-| `DB_TNS_ALIAS` | `musclecare_high` |
-| `WALLET_ZIP_B64` | wallet_base64.txt 전체 내용 |
-| `WALLET_PASSWORD` | Wallet 비밀번호 |
-
-### 3. Git Push
-
-```bash
-git push
-```
-
-**자동 배포!** `start.py`가 Wallet을 자동으로 디코딩하고 서버를 시작합니다.
-
----
-
-## 🧪 테스트
-
-### 배포 후:
-
-```bash
-# 헬스 체크
-curl https://[username]-musclecare-api.hf.space/health
-
-# API 문서
-https://[username]-musclecare-api.hf.space/docs
-```
-
-### 로컬 테스트:
-
-```bash
-# .env 파일 생성
-cp env_example.txt .env
-nano .env  # 실제 값 입력
-
-# 서버 실행
-python app.py
-```
-
----
-
-## 📖 상세 가이드
-
-- **HF_SECRETS_설정.md** - Secrets 설정 방법
-- **DATA_ARCHITECTURE.md** - 전체 아키텍처
-
----
-
-## 🔐 보안
-
-- ✅ `.gitignore` - .env, wallet/ 제외
-- ✅ Wallet Base64로 안전하게 배포
-- ✅ Secrets로 환경 변수 관리
-
----
-
-Made with ❤️ for MuscleCare

app.py

@@ -2,8 +2,13 @@ import os
 import json
 from typing import List, Optional
 from fastapi import FastAPI, HTTPException
-from pydantic import BaseModel, Field, conlist
+from pydantic import BaseModel, Field, ConfigDict
+from typing import List
 import oracledb
+from dotenv import load_dotenv
+
+# 로컬 개발: .env 파일 로드 (있으면)
+load_dotenv()
 
 # ----- 환경 변수 -----
 DB_USER = os.environ["DB_USER"]
@@ -33,6 +38,8 @@ app = FastAPI(title="MuscleCare Hybrid Server (mTLS)")
 
 # ----- 모델 -----
 class StatePayload(BaseModel):
+    model_config = ConfigDict(protected_namespaces=())
+    
     user_id: str
     rms_base: Optional[float] = None
     freq_base: Optional[float] = None
@@ -50,7 +57,7 @@ class LogItem(BaseModel):
     window_count: Optional[int] = None
 
 class LogsPayload(BaseModel):
-    items: conlist(LogItem, min_items=1)
+    items: List[LogItem] = Field(..., min_length=1)
 
 # ----- 유틸 -----
 def clob_json(obj) -> str:

env_example.txt

@@ -1,10 +0,0 @@
-# 로컬 개발용 환경 변수 예시
-# 이 파일을 .env로 복사하고 실제 값으로 변경하세요
-# cp env_example.txt .env
-
-DB_USER=ADMIN
-DB_PASSWORD=your_db_password_here
-DB_TNS_ALIAS=musclecare_high
-WALLET_DIR=/Users/gimhyeon-u/workspace/MuscleCare-FastAPI/wallet
-WALLET_PASSWORD=your_wallet_password_here
-

requirements.txt

@@ -3,3 +3,4 @@ uvicorn
 python-multipart
 oracledb>=2.3
 pydantic
+python-dotenv

start.py

@@ -1,23 +1,69 @@
 import os, base64, zipfile, io, sys, tempfile, subprocess
+from pathlib import Path
+from dotenv import load_dotenv
+
+# .env 파일 로드 (로컬 개발용)
+load_dotenv()
 
 def prepare_wallet_dir():
+    """
+    Wallet 준비:
+    - 배포 환경: WALLET_ZIP_B64에서 디코딩
+    - 로컬 환경: WALLET_DIR 경로 사용
+    """
+    # 로컬 개발: WALLET_DIR이 이미 설정되어 있는 경우
+    if "WALLET_DIR" in os.environ:
+        wallet_dir = os.environ["WALLET_DIR"]
+        if Path(wallet_dir).exists():
+            print(f"📁 로컬 Wallet 사용: {wallet_dir}")
+            return wallet_dir
+    
+    # 배포 환경: WALLET_ZIP_B64에서 디코딩
+    if "WALLET_ZIP_B64" not in os.environ:
+        raise RuntimeError(
+            "❌ WALLET_ZIP_B64 또는 WALLET_DIR 환경 변수가 필요합니다.\n"
+            "   로컬: .env 파일에 WALLET_DIR 설정\n"
+            "   배포: Hugging Face Secrets에 WALLET_ZIP_B64 설정"
+        )
+    
+    print("🔐 Wallet Base64 디코딩 시작...")
     b64 = os.environ["WALLET_ZIP_B64"]
     wallet_password = os.environ["WALLET_PASSWORD"]
+    
     # wallet을 메모리->임시디렉토리로 복원
     wallet_dir = tempfile.mkdtemp(prefix="wallet_")
+    print(f"📁 임시 디렉토리: {wallet_dir}")
+    
     zip_bytes = base64.b64decode(b64)
     with zipfile.ZipFile(io.BytesIO(zip_bytes)) as z:
         z.extractall(wallet_dir)
+    
     # 안전을 위해 권한 축소
     for root, _, files in os.walk(wallet_dir):
         for f in files:
             os.chmod(os.path.join(root, f), 0o600)
+    
+    print("✅ Wallet 압축 해제 완료")
+    
     # 지갑 비밀번호는 oracledb에서 사용
     os.environ["WALLET_DIR"] = wallet_dir
     os.environ["WALLET_PASSWORD"] = wallet_password
+    
     return wallet_dir
 
 if __name__ == "__main__":
-    prepare_wallet_dir()
+    print("=" * 60)
+    print("🚀 MuscleCare FastAPI 서버 시작")
+    print("=" * 60)
+    
+    # Wallet 준비
+    try:
+        prepare_wallet_dir()
+    except Exception as e:
+        print(f"❌ Wallet 준비 실패: {e}")
+        sys.exit(1)
+    
     # Uvicorn 기동
+    print("\n🌐 FastAPI 서버 실행...")
+    print("=" * 60)
     subprocess.run([sys.executable, "-m", "uvicorn", "app:app", "--host", "0.0.0.0", "--port", "7860"])

test_api.sh

@@ -0,0 +1,76 @@
+#!/bin/bash
+
+# MuscleCare API 테스트 스크립트
+
+# 서버 URL 설정
+# 로컬: http://localhost:7860
+# 배포: https://[username]-musclecare-api.hf.space
+BASE_URL="${1:-http://localhost:7860}"
+
+echo "======================================"
+echo "🧪 MuscleCare API 테스트"
+echo "======================================"
+echo "서버: $BASE_URL"
+echo ""
+
+# 1. Health 체크
+echo "1️⃣ Health 체크"
+echo "--------------------------------------"
+curl -X GET "$BASE_URL/health" \
+  -H "accept: application/json" | jq .
+echo ""
+echo ""
+
+# 2. 사용자 상태 업로드
+echo "2️⃣ 사용자 상태 업로드"
+echo "--------------------------------------"
+curl -X POST "$BASE_URL/upload_state" \
+  -H "Content-Type: application/json" \
+  -H "accept: application/json" \
+  -d '{
+    "user_id": "test_user_001",
+    "rms_base": 0.11,
+    "freq_base": 50.1,
+    "user_emb": [0.135, 0.012, 49.3, 0.8, 0.84, 0.02, 0.11, 0.0021, 0.35, 0.71, 0.92, 0.88],
+    "model_version": "v1.0.0"
+  }' | jq .
+echo ""
+echo ""
+
+# 3. 피로도 로그 업로드
+echo "3️⃣ 피로도 로그 업로드"
+echo "--------------------------------------"
+curl -X POST "$BASE_URL/upload_logs" \
+  -H "Content-Type: application/json" \
+  -H "accept: application/json" \
+  -d '{
+    "items": [
+      {
+        "user_id": "test_user_001",
+        "session_id": "session_001",
+        "measure_date": "2025-10-22",
+        "rms": 0.12,
+        "freq": 49.8,
+        "fatigue": 0.83,
+        "mode": "Hybrid",
+        "window_count": 100
+      },
+      {
+        "user_id": "test_user_001",
+        "session_id": "session_002",
+        "measure_date": "2025-10-22",
+        "rms": 0.15,
+        "freq": 48.5,
+        "fatigue": 0.91,
+        "mode": "E2E",
+        "window_count": 120
+      }
+    ]
+  }' | jq .
+echo ""
+echo ""
+
+echo "======================================"
+echo "✅ 테스트 완료"
+echo "======================================"
+

검수_결과.md

@@ -1,237 +0,0 @@
-# ✅ 전체 검수 결과
-
-## 📊 검수 완료 - 배포 준비 완료!
-
----
-
-## 🎯 핵심 파일 구조
-
-```
-MuscleCare-FastAPI/
-├── start.py           ✅ Wallet 디코딩 + 서버 부팅
-├── app.py             ✅ FastAPI 앱 (간소화됨)
-├── Dockerfile         ✅ start.py 실행
-├── requirements.txt   ✅ 의존성
-├── .gitignore         ✅ 보안 파일 제외
-├── README.md          ✅ 프로젝트 설명
-└── env_example.txt    ✅ 환경 변수 예시
-```
-
----
-
-## ✅ 코드 검수 결과
-
-### 1. start.py ✅
-```python
-✅ WALLET_ZIP_B64 환경 변수 읽기
-✅ Base64 디코딩
-✅ zipfile로 압축 해제
-✅ 임시 디렉토리 생성 (/tmp/wallet_)
-✅ 파일 권한 설정 (0o600)
-✅ WALLET_DIR, WALLET_PASSWORD 환경 변수 설정
-✅ uvicorn subprocess 실행
-```
-
-**작동 흐름:**
-```
-start.py 실행
-  ↓
-prepare_wallet_dir()
-  ↓
-환경 변수: WALLET_DIR, WALLET_PASSWORD 설정
-  ↓
-uvicorn app:app 실행
-  ↓
-app.py가 WALLET_DIR 사용
-```
-
-### 2. app.py ✅
-```python
-✅ 환경 변수 읽기:
-   - DB_USER
-   - DB_PASSWORD
-   - WALLET_DIR (start.py가 설정)
-   - WALLET_PASSWORD (start.py가 설정)
-   - DB_TNS_ALIAS
-
-✅ oracledb.create_pool():
-   - user, password
-   - dsn=TNS_ALIAS
-   - config_dir=WALLET_DIR
-   - wallet_location=WALLET_DIR
-   - wallet_password=WALLET_PASSWORD
-   
-✅ 엔드포인트:
-   - GET /health → DB 연결 테스트
-   - POST /upload_state → user_state 테이블 UPSERT
-   - POST /upload_logs → fatigue_logs 테이블 INSERT
-```
-
-### 3. Dockerfile ✅
-```dockerfile
-✅ Python 3.10-slim
-✅ requirements.txt 설치
-✅ 코드 복사
-✅ CMD ["python", "start.py"]  ← 중요!
-```
-
-### 4. requirements.txt ✅
-```
-✅ fastapi
-✅ uvicorn
-✅ python-multipart
-✅ oracledb>=2.3
-✅ pydantic
-```
-
-### 5. .gitignore ✅
-```
-✅ .env
-✅ wallet/
-✅ *.zip
-✅ wallet_base64.txt
-✅ __pycache__/
-```
-
----
-
-## 🔐 보안 검수
-
-### ✅ Git 제외 파일
-```bash
-git status | grep -E "(\.env|wallet/)"
-```
-**결과:** `.gitignore` 확인 → 제외됨 ✅
-
-### ✅ 환경 변수 사용
-- 모든 민감 정보는 환경 변수로 관리
-- 코드에 하드코딩 없음
-
-### ✅ Wallet 보호
-- Git에 포함 안 됨
-- Base64로 Secrets에 안전하게 저장
-
----
-
-## 📡 API 검수
-
-### 엔드포인트 구조
-
-#### GET /health
-```python
-✅ pool.acquire() 사용
-✅ SELECT 1 FROM DUAL
-✅ 연결 상태 반환
-```
-
-#### POST /upload_state
-```python
-✅ StatePayload 검증
-✅ user_emb 길이 체크 (12)
-✅ MERGE INTO MuscleCare.user_state
-✅ CLOB JSON 저장
-✅ 트랜잭션 commit
-```
-
-#### POST /upload_logs
-```python
-✅ LogsPayload 검증
-✅ executemany로 배치 INSERT
-✅ MuscleCare.fatigue_logs 테이블
-✅ 트랜잭션 commit
-```
-
----
-
-## 🌐 배포 플로우 검수
-
-### Hugging Face Space 실행 순서:
-
-```
-1. Docker 빌드
-   ↓
-2. start.py 실행
-   ↓
-3. prepare_wallet_dir()
-   - WALLET_ZIP_B64 환경 변수 읽기 (Secrets)
-   - Base64 디코딩
-   - /tmp/wallet_xxxxx에 압축 해제
-   - WALLET_DIR 환경 변수 설정
-   ↓
-4. uvicorn 실행
-   - app:app 로드
-   ↓
-5. app.py 초기화
-   - 환경 변수 읽기
-   - oracledb.create_pool() (WALLET_DIR 사용)
-   ↓
-6. ✅ 서버 실행 완료
-```
-
----
-
-## 🧪 테스트 체크리스트
-
-### 로컬 테스트 (선택):
-- [ ] wallet/ 디렉토리 준비
-- [ ] 환경 변수 export
-- [ ] `python app.py` 실행
-- [ ] `curl http://localhost:7860/health` 성공
-
-### 배포 후 테스트 (필수):
-- [ ] Logs에 "✅ Wallet 압축 해제 완료"
-- [ ] Logs에 "Uvicorn running"
-- [ ] `curl https://[username]-xxx.hf.space/health`
-- [ ] 응답: `{"ok": true, "db": 1}`
-- [ ] `/docs` 페이지 접근 가능
-
----
-
-## ❌ 발견된 문제점
-
-### 없음! ✅
-
-모든 파일이 올바르게 구성되었습니다.
-
----
-
-## 🎯 다음 단계
-
-### 1. Hugging Face Secrets 설정 (5개)
-
-`HF_SECRETS_설정.md` 참조
-
-### 2. Git Push
-
-```bash
-git add .
-git commit -m "Ready for deployment"
-git push
-```
-
-### 3. 배포 확인
-
-- Logs 확인
-- API 테스트
-- 문서 확인
-
----
-
-## 📝 최종 요약
-
-| 항목 | 상태 |
-|------|------|
-| **코드 구조** | ✅ 완벽 |
-| **보안** | ✅ .gitignore 설정됨 |
-| **Wallet 처리** | ✅ start.py로 자동화 |
-| **Docker 설정** | ✅ start.py 실행 |
-| **환경 변수** | ✅ Secrets로 관리 |
-| **API 구조** | ✅ 간결하고 효율적 |
-| **배포 준비** | ✅ 완료 |
-
----
-
-**검수 결과: 배포 가능! 🚀**
-
-Git push만 하면 됩니다!
-

배포_체크리스트.md

@@ -1,191 +0,0 @@
-# ✅ 배포 최종 체크리스트
-
-## 📋 파일 구조 검수
-
-### ✅ 필수 파일 (Git에 포함)
-- [x] `start.py` - Wallet 디코딩 및 서버 부팅
-- [x] `app.py` - FastAPI 애플리케이션
-- [x] `Dockerfile` - start.py 실행
-- [x] `requirements.txt` - 의존성
-- [x] `.gitignore` - 보안 파일 제외
-- [x] `README.md` - 프로젝트 설명
-- [x] `env_example.txt` - 환경 변수 예시
-
-### ❌ 제외 파일 (Git에 포함 안 됨)
-- [ ] `.env` - 로컬 환경 변수
-- [ ] `wallet/` - Wallet 파일들
-- [ ] `wallet_base64.txt` - Base64 인코딩 파일
-- [ ] `*.zip` - Wallet 압축 파일
-
----
-
-## 🔐 Hugging Face Secrets (5개)
-
-### 필수 Secrets:
-
-| Secret Name | 설정됨? | Value 예시 |
-|-------------|---------|-----------|
-| `DB_USER` | [ ] | `ADMIN` |
-| `DB_PASSWORD` | [ ] | Oracle DB 비밀번호 |
-| `DB_TNS_ALIAS` | [ ] | `musclecare_high` |
-| `WALLET_ZIP_B64` | [ ] | Base64 인코딩된 Wallet |
-| `WALLET_PASSWORD` | [ ] | Wallet 비밀번호 |
-
----
-
-## 🔍 코드 검수
-
-### start.py
-```python
-✅ WALLET_ZIP_B64 환경 변수 읽기
-✅ Base64 디코딩
-✅ 임시 디렉토리에 압축 해제
-✅ WALLET_DIR, WALLET_PASSWORD 환경 변수 설정
-✅ uvicorn으로 FastAPI 실행
-```
-
-### app.py
-```python
-✅ 환경 변수로 DB 설정 읽기
-✅ Wallet 경로 사용
-✅ 연결 풀 생성 (Thin mode + mTLS)
-✅ /health 엔드포인트
-✅ /upload_state 엔드포인트 (MERGE INTO)
-✅ /upload_logs 엔드포인트 (executemany)
-```
-
-### Dockerfile
-```dockerfile
-✅ Python 3.10-slim
-✅ requirements.txt 설치
-✅ start.py로 실행
-✅ 포트 7860 노출
-```
-
-### requirements.txt
-```
-✅ fastapi
-✅ uvicorn
-✅ python-multipart
-✅ oracledb>=2.3
-✅ pydantic
-```
-
----
-
-## 🧪 배포 전 로컬 테스트
-
-### 환경 변수 설정 (로컬)
-
-```bash
-export DB_USER="ADMIN"
-export DB_PASSWORD="your_db_password"
-export DB_TNS_ALIAS="musclecare_high"
-export WALLET_DIR="/Users/gimhyeon-u/workspace/MuscleCare-FastAPI/wallet"
-export WALLET_PASSWORD="your_wallet_password"
-```
-
-### 서버 실행
-
-```bash
-python app.py
-```
-
-또는 start.py로:
-
-```bash
-# Wallet zip 파일 준비 필요
-python start.py
-```
-
----
-
-## 🚀 배포 명령어
-
-### 1. Git 상태 확인
-
-```bash
-git status
-```
-
-**확인:**
-- ❌ `.env` 없어야 함
-- ❌ `wallet/` 없어야 함
-- ❌ `wallet_base64.txt` 없어야 함
-
-### 2. Git 커밋 및 푸시
-
-```bash
-git add .
-git commit -m "Deploy to HF with Wallet mTLS"
-git push
-```
-
----
-
-## 🔄 배포 후 확인
-
-### 1. Logs 확인
-
-Hugging Face Space → **Logs** 탭
-
-**성공 메시지:**
-```
-🔐 Wallet 디코딩 시작...
-📁 임시 디렉토리 생성: /tmp/wallet_xxxxx
-✅ Wallet 압축 해제 완료
-✅ tnsnames.ora 확인
-INFO:     Uvicorn running on http://0.0.0.0:7860
-```
-
-### 2. API 테스트
-
-```bash
-curl https://[username]-musclecare-api.hf.space/health
-```
-
-**기대 응답:**
-```json
-{"ok": true, "db": 1}
-```
-
-### 3. API 문서
-
-```
-https://[username]-musclecare-api.hf.space/docs
-```
-
----
-
-## 🔧 문제 해결
-
-### "WALLET_ZIP_B64 환경 변수가 없습니다"
-
-- [ ] Secrets 이름 확인: `WALLET_ZIP_B64` (정확히)
-- [ ] Secret 값 확인: wallet_base64.txt 전체 내용
-- [ ] Space 재시작
-
-### "Wallet 압축 해제 실패"
-
-- [ ] Base64 인코딩 재시도
-- [ ] Wallet zip 파일이 손상되지 않았는지 확인
-
-### "DB 연결 실패"
-
-- [ ] Oracle DB 상태 AVAILABLE 확인
-- [ ] `DB_PASSWORD` 확인
-- [ ] `DB_TNS_ALIAS` 확인
-
----
-
-## ✅ 최종 체크
-
-- [ ] Dockerfile이 start.py 실행하도록 수정됨
-- [ ] .gitignore 생성됨
-- [ ] README.md 업데이트됨
-- [ ] env_example.txt 생성됨
-- [ ] Git에 민감 파일 제외 확인
-- [ ] 5개 Secrets 설정 준비됨
-
-**모든 준비 완료!** 🎉
-