fix(backend): Correct SPA static files mounting order

- Move SPAStaticFiles mount to end of main.py (after all API routes)
- Fix 404 errors for API endpoints
- Static catchall now properly preserves /api routes

backend/main.py

@@ -223,23 +223,6 @@ def get_websocket_manager() -> WebSocketManager:
     """Get WebSocket manager instance"""
     return saap_app.websocket_manager
 
-# =====================================================
-# STATIC FILES - Serve Vue.js Frontend (SPA Mode)
-# =====================================================
-
-# Import custom SPA Static Files handler
-from spa_static_files import SPAStaticFiles
-
-# Mount static files for frontend (must be AFTER all API routes)
-# SPAStaticFiles preserves API routes while serving Vue.js SPA
-import os
-frontend_dist = "/app/frontend/dist"
-if os.path.exists(frontend_dist):
-    app.mount("/", SPAStaticFiles(directory=frontend_dist, html=True), name="static")
-    logger.info(f"✅ SPA Static files mounted: {frontend_dist}")
-else:
-    logger.warning(f"⚠️ Frontend dist directory not found: {frontend_dist}")
-
 # =====================================================
 # ENHANCED ROOT ENDPOINT WITH HYBRID INFO (API)
 # =====================================================
@@ -1639,3 +1622,20 @@ async def startup_message():
 # NOTE: No if __name__ == "__main__" block needed
 # Supervisor/Uvicorn will start the app directly
 # ==========================================
+
+# =====================================================
+# STATIC FILES - Serve Vue.js Frontend (SPA Mode)
+# ⚠️ CRITICAL: Must be AFTER all API routes!
+# =====================================================
+
+# Import custom SPA Static Files handler
+from spa_static_files import SPAStaticFiles
+
+# Mount static files for frontend (must be AFTER all API routes)
+# SPAStaticFiles preserves API routes while serving Vue.js SPA
+frontend_dist = "/app/frontend/dist"
+if os.path.exists(frontend_dist):
+    app.mount("/", SPAStaticFiles(directory=frontend_dist, html=True), name="static")
+    logger.info(f"✅ SPA Static files mounted: {frontend_dist}")
+else:
+    logger.warning(f"⚠️ Frontend dist directory not found: {frontend_dist}")

backend/spa_static_files.py

@@ -17,15 +17,12 @@ class SPAStaticFiles(StaticFiles):
     async def get_response(self, path: str, scope: Scope):
         """
         Handle requests:
-        - API routes (/api/*) → 404 (let FastAPI handle)
         - Static files (exist) → serve file  
         - Everything else → index.html (SPA routing)
-        """
-        # Let API routes pass through to FastAPI
-        if path.startswith("api/") or path.startswith("docs") or path.startswith("redoc") or path.startswith("openapi.json"):
-            # Return 404 to let FastAPI handle it
-            raise RuntimeError("Not found")
         
+        NOTE: This should be mounted AFTER API routes in main.py
+        so API routes are handled first
+        """
         try:
             # Try to serve the file
             return await super().get_response(path, scope)