Add backend-specific app.py (FastAPI + Gradio status)

app.py

@@ -0,0 +1,115 @@
+"""KPAA Backend Space — OpenAI-compatible API on ZeroGPU (Gradio SDK).
+
+This Space is the inference backend. It exposes:
+- POST /v1/chat/completions  (OpenAI-compatible, streaming)
+- GET  /v1/models
+- GET  /healthz / /info
+- GET  /gradio                (minimal status page; Gradio SDK detection)
+
+UI (Open WebUI) is hosted at a separate Space which points its
+OPENAI_API_BASE_URL to this Space's /v1.
+
+Hardware: ZeroGPU (zero-a10g).
+Required secret: LAW_OC.
+"""
+from __future__ import annotations
+
+import os
+import sys
+from pathlib import Path
+
+# HF Spaces 에서는 `pip install -e .` 가 동작하지 않는다 → src/ 를 sys.path 에 prepend.
+sys.path.insert(0, str(Path(__file__).resolve().parent / "src"))
+
+
+# ─── monkey-patch: gradio_client `/api_info` schema bug ────────────────────
+# Gradio 5.x 의 gradio_client.utils 는 JSON Schema 의 `additionalProperties: True`
+# (bool, 합법적 형식) 를 dict 로만 가정해서 TypeError 를 낸다. 이 백엔드는
+# Gradio UI 자체를 사용자에게 노출하지 않지만 Gradio 가 mount 되어 있어
+# /api_info 가 호출될 가능성이 있으므로 안전 패치.
+import gradio_client.utils as _gc_utils  # noqa: E402
+
+_orig_get_type = _gc_utils.get_type
+_orig_jstpt = _gc_utils._json_schema_to_python_type
+
+
+def _safe_get_type(schema):
+    if not isinstance(schema, dict):
+        return ""
+    return _orig_get_type(schema)
+
+
+def _safe_jstpt(schema, defs):
+    if not isinstance(schema, dict):
+        return "Any"
+    return _orig_jstpt(schema, defs)
+
+
+_gc_utils.get_type = _safe_get_type
+_gc_utils._json_schema_to_python_type = _safe_jstpt
+# ──────────────────────────────────────────────────────────────────────────
+
+
+# ─── HF Spaces ZeroGPU startup canary ─────────────────────────────────────
+# ZeroGPU 는 startup 시점에 module-level `@spaces.GPU` 함수가 적어도 하나 검출되어야
+# GPU 스케줄을 잡는다. 실제 GPU 작업은 ZeroGPUBackend.stream_chat 안에서 동적으로
+# 데코레이트되지만 startup 스캔에서 안 보이므로 sentinel 추가.
+try:
+    import spaces  # type: ignore[import-not-found]
+
+    @spaces.GPU(duration=1)
+    def _zerogpu_startup_canary() -> None:
+        return None
+except ImportError:
+    pass
+# ──────────────────────────────────────────────────────────────────────────
+
+
+import gradio as gr  # noqa: E402
+
+from kpaa.server import create_app  # noqa: E402
+
+
+# Build the FastAPI app from KPAA's existing OpenAI-compatible server.
+fastapi_app = create_app()
+
+
+# Build a minimal Gradio status page so HF Spaces 에 "Gradio app" 으로 인식되고,
+# 사용자가 backend URL 에 접속해도 친절한 안내 페이지가 나오도록 함.
+with gr.Blocks(title="KPAA Backend", theme=gr.themes.Soft()) as demo:
+    gr.Markdown(
+        """
+        # 🧠 KPAA Backend — 개인정보보호법 RAG 추론 서버
+
+        한국 개인정보보호법 RAG 백엔드. **OpenAI 호환 API**.
+        UI 는 별도 Space (`scvcoder/korean-privacy-ai-assistant`) 의 Open WebUI 가 제공합니다.
+
+        ## API Endpoints
+
+        - **POST** `/v1/chat/completions` — OpenAI 호환 chat (스트리밍 지원)
+        - **GET** `/v1/models` — 모델 목록 (`kpaa-privacy-ko`)
+        - **GET** `/healthz` — health check
+        - **GET** `/info` — 상세 정보 / Swagger UI 링크
+
+        ## 외부 연동
+        Open WebUI 등에 OpenAI provider 로 등록:
+        - **URL** `https://scvcoder-kpaa-backend.hf.space/v1`
+        - **Key** any (인증 없음)
+        - **Model** `kpaa-privacy-ko`
+        """
+    )
+
+# Mount the Gradio Blocks at /gradio. The FastAPI routes (/v1/..., /healthz, ...)
+# remain at the root.
+final_app = gr.mount_gradio_app(fastapi_app, demo, path="/gradio")
+
+
+def main() -> None:
+    import uvicorn
+
+    port = int(os.environ.get("PORT", "7860"))
+    uvicorn.run(final_app, host="0.0.0.0", port=port)
+
+
+if __name__ == "__main__":
+    main()