| # 🚀 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](https://render.com) 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](https://vercel.com) 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. | |