feat: implement direct e-commerce search service with Playwright/Browserless and add supporting admin page and debug routes.

app/routers/debug.py

@@ -0,0 +1,91 @@
+import os
+import logging
+from datetime import datetime
+from typing import List
+
+from fastapi import APIRouter, Depends, HTTPException
+from fastapi.responses import FileResponse
+from pydantic import BaseModel
+
+from app.services import auth_service
+
+router = APIRouter(
+    prefix="/debug",
+    tags=["debug"],
+    dependencies=[Depends(auth_service.get_current_active_admin)],
+)
+
+logger = logging.getLogger(__name__)
+
+DEBUG_DIR = "debug_dumps"
+
+class DebugFile(BaseModel):
+    filename: str
+    size: int
+    created_at: float
+    created_at_formatted: str
+
+@router.get("/dumps", response_model=List[DebugFile])
+def list_debug_dumps():
+    """List all debug dump files"""
+    if not os.path.exists(DEBUG_DIR):
+        return []
+    
+    files = []
+    try:
+        for filename in os.listdir(DEBUG_DIR):
+            filepath = os.path.join(DEBUG_DIR, filename)
+            if os.path.isfile(filepath):
+                stat = os.stat(filepath)
+                files.append(DebugFile(
+                    filename=filename,
+                    size=stat.st_size,
+                    created_at=stat.st_ctime,
+                    created_at_formatted=datetime.fromtimestamp(stat.st_ctime).strftime("%Y-%m-%d %H:%M:%S")
+                ))
+        
+        # Sort by creation time (newest first)
+        files.sort(key=lambda x: x.created_at, reverse=True)
+        return files
+    except Exception as e:
+        logger.error(f"Error listing debug dumps: {e}")
+        raise HTTPException(status_code=500, detail=str(e))
+
+@router.get("/dumps/{filename}")
+def download_debug_dump(filename: str):
+    """Download a specific debug dump file"""
+    if not os.path.exists(DEBUG_DIR):
+        raise HTTPException(status_code=404, detail="Debug directory not found")
+    
+    filepath = os.path.join(DEBUG_DIR, filename)
+    
+    # Security check: prevent directory traversal
+    if not os.path.abspath(filepath).startswith(os.path.abspath(DEBUG_DIR)):
+        raise HTTPException(status_code=403, detail="Access denied")
+        
+    if not os.path.isfile(filepath):
+        raise HTTPException(status_code=404, detail="File not found")
+        
+    return FileResponse(filepath, filename=filename)
+
+@router.delete("/dumps/{filename}")
+def delete_debug_dump(filename: str):
+    """Delete a specific debug dump file"""
+    if not os.path.exists(DEBUG_DIR):
+        raise HTTPException(status_code=404, detail="Debug directory not found")
+    
+    filepath = os.path.join(DEBUG_DIR, filename)
+    
+    # Security check: prevent directory traversal
+    if not os.path.abspath(filepath).startswith(os.path.abspath(DEBUG_DIR)):
+        raise HTTPException(status_code=403, detail="Access denied")
+        
+    if not os.path.isfile(filepath):
+        raise HTTPException(status_code=404, detail="File not found")
+    
+    try:
+        os.remove(filepath)
+        return {"message": "File deleted"}
+    except Exception as e:
+        logger.error(f"Error deleting debug dump {filename}: {e}")
+        raise HTTPException(status_code=500, detail=str(e))