fix(analytics): make Supabase optional and update websockets for MCP server

backend/api/routes/analytics.py

@@ -1,14 +1,35 @@
 from fastapi import APIRouter, Header, HTTPException, Query
 from typing import Optional
 from datetime import datetime, timedelta
+import logging
+import os
 
 from ..storage.analytics_store import AnalyticsStore
 from ..utils.access_control import require_api_permission
 
 router = APIRouter()
-
-# Initialize analytics store
-analytics_store = AnalyticsStore()
+logger = logging.getLogger(__name__)
+
+# Initialize analytics store, but don't crash the app if Supabase is not available.
+# In environments like Hugging Face Spaces where Supabase isn't configured,
+# we disable analytics gracefully instead of raising at import time.
+try:
+    # Only attempt to initialize Supabase analytics when credentials are present
+    if os.getenv("SUPABASE_URL") and os.getenv("SUPABASE_SERVICE_KEY"):
+        analytics_store: Optional[AnalyticsStore] = AnalyticsStore()
+    else:
+        analytics_store = None
+        logger.warning(
+            "AnalyticsStore: Supabase credentials not configured. "
+            "Analytics endpoints will return 503."
+        )
+except RuntimeError as exc:
+    analytics_store = None
+    logger.warning(
+        "AnalyticsStore initialization failed (%s). "
+        "Analytics endpoints will return 503.",
+        exc,
+    )
 
 
 @router.get("/overview")
@@ -22,6 +43,12 @@ async def analytics_overview(
     Includes total queries, tool usage, red-flag count, and active users.
     """
 
+    if analytics_store is None:
+        raise HTTPException(
+            status_code=503,
+            detail="Analytics is disabled because Supabase is not configured on this deployment.",
+        )
+
     if not x_tenant_id:
         raise HTTPException(status_code=400, detail="Missing tenant ID")
     require_api_permission(x_user_role, "view_analytics")
@@ -56,6 +83,12 @@ async def analytics_tool_usage(
     Includes counts, latency, tokens, and success/error rates.
     """
 
+    if analytics_store is None:
+        raise HTTPException(
+            status_code=503,
+            detail="Analytics is disabled because Supabase is not configured on this deployment.",
+        )
+
     if not x_tenant_id:
         raise HTTPException(status_code=400, detail="Missing tenant ID")
     require_api_permission(x_user_role, "view_analytics")
@@ -82,6 +115,12 @@ async def analytics_redflags(
     Includes rule details, severity, confidence, and timestamps.
     """
 
+    if analytics_store is None:
+        raise HTTPException(
+            status_code=503,
+            detail="Analytics is disabled because Supabase is not configured on this deployment.",
+        )
+
     if not x_tenant_id:
         raise HTTPException(status_code=400, detail="Missing tenant ID")
     require_api_permission(x_user_role, "view_analytics")
@@ -112,6 +151,12 @@ async def analytics_activity(
     Includes total queries, active users, last query timestamp, and individual activity records for heatmap visualization.
     """
 
+    if analytics_store is None:
+        raise HTTPException(
+            status_code=503,
+            detail="Analytics is disabled because Supabase is not configured on this deployment.",
+        )
+
     if not x_tenant_id:
         raise HTTPException(status_code=400, detail="Missing tenant ID")
     require_api_permission(x_user_role, "view_analytics")
@@ -141,6 +186,12 @@ async def analytics_rag_quality(
     Includes average hits, scores, and latency.
     """
 
+    if analytics_store is None:
+        raise HTTPException(
+            status_code=503,
+            detail="Analytics is disabled because Supabase is not configured on this deployment.",
+        )
+
     if not x_tenant_id:
         raise HTTPException(status_code=400, detail="Missing tenant ID")
     require_api_permission(x_user_role, "view_analytics")

requirements.txt

@@ -12,7 +12,7 @@ duckduckgo-search
 PyPDF2
 python-docx
 python-multipart
-websockets>=11.0
+websockets>=13.0
 gradio==4.20.0
 requests>=2.31.0
 plotly>=5.0.0