Skip DB init in TESTING; add reset_db

Avoid initializing the SQLite DB during tests by checking the TESTING env var in app.lifespan and logging accordingly. Add scripts/reset_db.py to remove and re-create the DB file for fresh state during development/benchmarks. Update tests: conftest sets TESTING=true and test_api uses a shared client fixture instead of creating TestClient per test. Update results.json sample data (IDs and durations) as part of test/sample data refresh.

Author: ArshVermaGit

DEPLOYMENT.md

@@ -0,0 +1,63 @@
+# CodeLens. Deployment Guide (Production)
+
+Follow this guide to deploy **CodeLens. v1.0.0** to the professional cloud. This configuration uses **Vercel** for the frontend, **Render** for the backend, and **Supabase/Neon** for the PostgreSQL database.
+
+---
+
+## 1. 🗄️ Setup the Database (PostgreSQL)
+
+Since SQLite is disk-based and will be deleted at every restart on Render/Vercel, you **must** use a managed PostgreSQL service.
+
+1.  **Go to [Supabase](https://supabase.com)** or [Neon](https://neon.tech).
+2.  **Create a new Project** called "CodeLens".
+3.  **Copy your Connection String** (it should look like `postgres://user:pass@host:5432/dbname`).
+4.  **Important**: Keep this URL safe—it is your `DATABASE_URL`.
+
+---
+
+## 2. 🚀 Setup the Backend (Render)
+
+Render will host your FastAPI API and your Dockerized environment.
+
+1.  **Go to [Render Dashboard](https://dashboard.render.com)**.
+2.  **New -> Web Service** and connect your GitHub repository.
+3.  **Configure**:
+    -   **Runtime**: `Docker`.
+    -   **Environment Variables**:
+        -   `DATABASE_URL`: (Paste your Supabase/Neon URL here).
+        -   `API_KEY_ENABLED`: `true` (highly recommended for production).
+        -   `API_KEY`: A strong secret password.
+        -   `APP_ENV`: `production`.
+4.  **Deploy**: Render will automatically build the `Dockerfile` in the root and start the service.
+5.  **Identify**: Copy your Render URL (e.g., `https://codelens-api.onrender.com`).
+
+---
+
+## 3. 🎨 Setup the Frontend (Vercel)
+
+Vercel will host your React/Vite dashboard.
+
+1.  **Go to [Vercel](https://vercel.com)**.
+2.  **Import** your `dashboard` folder (or the whole repository and set the root directory to `dashboard`).
+3.  **Update `vercel.json`**:
+    -   Open [`dashboard/vercel.json`](file:///Users/arshverma/GitHub/open-ev-code-handler/dashboard/vercel.json).
+    -   Replace `https://YOUR_BACKEND_URL.render.com` with your **real** Render URL.
+4.  **Deploy**: Vercel will build the React application and provide a global dashboard link.
+
+---
+
+## 4. 🤖 Running Remote Evaluations
+
+Once deployed, you can run the benchmark script from your local machine (or any CI) against your **production** instance:
+
+```bash
+python scripts/evaluate.py --url https://your-render-url.com --api-key YOUR_SECRET_KEY
+```
+
+---
+
+> [!CAUTION]
+> **Database Migrations**: When you first deploy to a new PostgreSQL instance, the tables will be empty. The first request to the API will automatically trigger `create_db_and_tables()` via the lifespan hook—no manual SQL is required.
+
+> [!TIP]
+> **Vercel Rewrites**: The `vercel.json` rewrite rule is what allows the frontend to talk to the backend without CORS issues. Ensure the URL is exactly correct.

app.py

@@ -42,9 +42,13 @@
 @asynccontextmanager
 async def lifespan(app: FastAPI):
     # Startup
-    create_db_and_tables()
+    if not os.getenv("TESTING"):
+        create_db_and_tables()
+        logger.info(f"CodeLens API started — DB at {settings.db_path}")
+    else:
+        logger.info("CodeLens API running in TESTING mode — DB initialization skipped")
+
     cleanup_task = asyncio.create_task(cleanup_expired_episodes())
-    logger.info(f"CodeLens API started — DB at {settings.db_path}")
 
     yield
 

codelens_env/config.py

@@ -1,4 +1,5 @@
 from functools import lru_cache
+from typing import Optional
 from pydantic_settings import BaseSettings, SettingsConfigDict
 
 class Settings(BaseSettings):
@@ -19,6 +20,7 @@ class Settings(BaseSettings):
     rate_limit_per_minute: int = 60        # requests per minute per IP
 
     # Persistence
+    database_url: Optional[str] = None
     db_path: str = "./data/codelens.db"
     db_echo: bool = False    # Set True to log all SQL queries
 

codelens_env/database.py

@@ -7,6 +7,20 @@
 
 def get_engine():
     settings = get_settings()
+    
+    if settings.database_url:
+        # Support Render/Heroku 'postgres://' URLs by converting to 'postgresql://'
+        url = settings.database_url
+        if url.startswith("postgres://"):
+            url = url.replace("postgres://", "postgresql://", 1)
+        
+        return create_engine(
+            url,
+            echo=settings.db_echo,
+            pool_pre_ping=True,  # Ensure connections are alive
+        )
+    
+    # Fallback to local SQLite
     Path(settings.db_path).parent.mkdir(parents=True, exist_ok=True)
     return create_engine(
         f"sqlite:///{settings.db_path}",

dashboard/vercel.json

@@ -0,0 +1,15 @@
+{
+  "rewrites": [
+    {
+      "source": "/api/(.*)",
+      "destination": "https://YOUR_BACKEND_URL.render.com/$1"
+    },
+    {
+      "source": "/ws/(.*)",
+      "destination": "wss://YOUR_BACKEND_URL.render.com/ws/$1"
+    }
+  ],
+  "framework": "vite",
+  "buildCommand": "npm run build",
+  "outputDirectory": "dist"
+}