DOCS/deployment_guide.md

🚀 Master Deployment Guide: Dodge AI

Follow these steps to take your project from local to live.

📁 Repository Structure (Monorepo)

Your project is now organized for professional deployment:

dodge-ai/
 ├── backend/            # FastAPI + SQLite
 │    ├── dodge_ai.py    # Main API
 │    ├── data.db        # Database
 │    └── requirements.txt
 └── frontend/           # React (Vite)
      ├── src/           # UI Components
      └── .env           # Environment config

---

🟢 Step 1: Backend Deployment (Render.com)

1. Create Account: Go to Render and connect your GitHub.
2. New Web Service: Select your repository.
3. Configure:
   • Name: dodge-ai-backend
   • Root Directory: backend
   • Runtime: Python 3
   • Build Command: pip install -r requirements.txt
   • Start Command: uvicorn dodge_ai:app --host 0.0.0.0 --port 10000
4. Env Variables:
   • Add OPENROUTER_API_KEY: your_key_here
5. Wait: Once deployed, you will get a URL like https://dodge-ai-backend.onrender.com.

---

🔵 Step 2: Frontend Deployment (Vercel.com)

1. Create Account: Go to Vercel and connect your GitHub.
2. Import Project: Select the same repository.
3. Configure:
   • Project Name: dodge-ai-frontend
   • Framework Preset: Vite
   • Root Directory: frontend
4. Env Variables (CRITICAL):
   • Add VITE_API_URL: https://dodge-ai-backend.onrender.com (from Step 1)
5. Deploy: Click Deploy. Your site will be live at https://dodge-ai-frontend.vercel.app.

---

🧠 Master Prompt for Future AI Help

If you need to explain this deployment to another AI or for documentation, use this:

Goal: Deploy a monorepo ERP AI System. Backend: FastAPI in /backend, port 10000, Root Dir: backend. Frontend: React (Vite) in /frontend, Root Dir: frontend. Linkage: Frontend uses VITE_API_URL to hit the Render backend. Features: Intent detection, SQL generation, Cytoscape graph, Recharts.