Add backend README with frontmatter (zero-a10g)

README.md

@@ -1,13 +1,56 @@
 ---
-title: Kpaa Backend
-emoji: ⚡
-colorFrom: yellow
-colorTo: pink
+title: KPAA Backend - 개인정보보호법 RAG 추론 API
+emoji: 🧠
+colorFrom: green
+colorTo: blue
 sdk: gradio
-sdk_version: 6.14.0
-python_version: '3.13'
+sdk_version: "5.20.0"
 app_file: app.py
 pinned: false
+short_description: KPAA RAG 추론 백엔드 (OpenAI 호환 API)
+hardware: zero-a10g
+license: mit
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# KPAA Backend
+
+한국 개인정보보호법 RAG 백엔드. **OpenAI 호환 API**를 노출합니다.
+
+이 Space는 **추론 백엔드 전용**입니다. UI는 별도 Space([scvcoder/korean-privacy-ai-assistant](https://huggingface.co/spaces/scvcoder/korean-privacy-ai-assistant))에서 Open WebUI로 제공됩니다.
+
+## 아키텍처
+
+```
+사용자 브라우저
+    ↓ (UI 접속)
+[Open WebUI Space]
+    ↓ (OpenAI API 호출)
+[이 Space — KPAA Backend]
+    ↓ (RAG 검색 + Gemma 4 추론)
+법제처 OPEN API + 상담사례 SQLite + ZeroGPU
+```
+
+## Endpoints
+
+| Method | Path | 설명 |
+|---|---|---|
+| POST | `/v1/chat/completions` | OpenAI 호환 chat (`stream=true` 지원) |
+| GET | `/v1/models` | 사용 가능 모델 (`kpaa-privacy-ko`) |
+| GET | `/healthz` | liveness check |
+| GET | `/info` | 상세 정보 + Swagger UI |
+| GET | `/gradio` | Gradio 상태 페이지 |
+
+## Open WebUI 연결 (UI Space에서 자동 설정)
+
+```bash
+OPENAI_API_BASE_URL=https://scvcoder-kpaa-backend.hf.space/v1
+OPENAI_API_KEY=any-value
+DEFAULT_MODELS=kpaa-privacy-ko
+```
+
+## Secrets / Hardware
+- **Secret** `LAW_OC` — 법제처 OPEN API ID (필수)
+- **Hardware** ZeroGPU (zero-a10g) — Pro 무료
+
+## 라이선스
+MIT (코드) · 답변 데이터는 PIPC/privacy.go.kr 출처표시