matalee/hpce-dev

1---2title: Roadshow Server V33emoji: 🎯4colorFrom: blue5colorTo: indigo6sdk: docker7app_port: 78608pinned: false9license: apache-2.010short_description: 초개인화 Context Engine 백엔드 (마이K Intent 116개)11---12 13# roadshow-server-v3 — Hugging Face Spaces14 15AX Tech Connect 시연용 백엔드 (FastAPI + DuckDB + MLflow + sklearn).16 17## 엔드포인트18 19- `GET /health` — 상태 확인20- `GET /api/scenarios/cs-myk-v3` — 시나리오 메타21- `POST /api/sessions` — 세션 생성22- `POST /api/sessions/{id}/survey` — 설문 제출 → 116개 Intent 추론23- `GET /api/intents/latest?session_id=...` — 최신 Intent Top-N24- `GET /api/admin/tables` — 모든 user 테이블 목록25- `WS /ws` — WebSocket (BEHAVIOR → INTENT_UPDATE)26 27## 환경 변수 (Space Settings → Variables)28 29| 변수 | 기본값 | 설명 |30|---|---|---|31| `SCENARIO_ID` | `cs-myk-v3` | 시나리오 ID |32| `TOP_N_INTENT` | `5` | 화면 노출 Top-N |33| `CORS_ORIGINS` | `""` (전체 허용) | 프론트 도메인 화이트리스트 |34| `DB_PATH` | `/data/roadshow_v3.duckdb` | DuckDB 파일 (Dockerfile에서 설정) |35| `MLFLOW_URI` | `sqlite:////data/mlflow_v3.db` | MLflow Tracking |36| `MLFLOW_ARTIFACT_ROOT` | `/data/mlruns_v3` | MLflow 아티팩트 |37 38## 빌드/실행 (Spaces 자동)39 40`Dockerfile`로 정의된 컨테이너가 자동 빌드되어 포트 7860에서 실행됩니다.41첫 추론 호출 시 16개 sklearn 모델이 자동 학습 + MLflow 등록됩니다.42 43## 휘발성 데이터44 45`/data` 볼륨은 Space 재시작 시 휘발됩니다. 시연용으로는 무방.46영구 보존 필요 시 HF Persistent Storage (유료) 활성화 검토.47