Revamp README: Add Badges, Modern Structure, and Clearer Onboarding

.github/workflows/docker-build.yml

@@ -0,0 +1,51 @@
+name: Docker Build and Test
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+
+    - name: Set up Docker Buildx
+      uses: docker/setup-buildx-action@v3
+
+    - name: Build Backend
+      run: |
+        cd Backend
+        docker build -t inpactai-backend:test .
+        
+    - name: Build Frontend
+      run: |
+        cd Frontend
+        docker build -t inpactai-frontend:test .
+        
+    - name: Start services
+      run: |
+        docker compose up -d
+        sleep 30
+        
+    - name: Check backend health
+      run: |
+        curl -f http://localhost:8000/ || exit 1
+        
+    - name: Check frontend health
+      run: |
+        curl -f http://localhost:5173/ || exit 1
+        
+    - name: Show logs on failure
+      if: failure()
+      run: |
+        docker compose logs
+        
+    - name: Cleanup
+      if: always()
+      run: |
+        docker compose down -v

Backend/.dockerignore

@@ -0,0 +1,21 @@
+__pycache__
+*.pyc
+*.pyo
+*.pyd
+.Python
+*.so
+.env
+.venv
+env/
+venv/
+ENV/
+.git
+.gitignore
+.pytest_cache
+.coverage
+htmlcov/
+dist/
+build/
+*.egg-info/
+.DS_Store
+*.log

Backend/.env.example

@@ -0,0 +1,12 @@
+user=postgres
+password=your_postgres_password
+host=your_postgres_host
+port=5432
+dbname=postgres
+GROQ_API_KEY=your_groq_api_key
+SUPABASE_URL=your_supabase_url
+SUPABASE_KEY=your_supabase_key
+GEMINI_API_KEY=your_gemini_api_key
+YOUTUBE_API_KEY=your_youtube_api_key
+REDIS_HOST=redis
+REDIS_PORT=6379

Backend/Dockerfile

@@ -0,0 +1,18 @@
+FROM python:3.10-slim
+
+WORKDIR /app
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    gcc \
+    libpq-dev \
+    curl \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+COPY . .
+
+EXPOSE 8000
+
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000", "--reload"]

Backend/Dockerfile.prod

@@ -0,0 +1,33 @@
+FROM python:3.10-slim AS builder
+
+WORKDIR /app
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    gcc \
+    libpq-dev \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY requirements.txt .
+RUN pip install --no-cache-dir --user -r requirements.txt
+
+FROM python:3.10-slim
+
+WORKDIR /app
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    libpq5 \
+    && rm -rf /var/lib/apt/lists/* \
+    && groupadd -r appuser && useradd -r -g appuser appuser
+
+COPY --from=builder /root/.local /root/.local
+COPY . .
+
+RUN chown -R appuser:appuser /app
+
+USER appuser
+
+ENV PATH=/root/.local/bin:$PATH
+
+EXPOSE 8000
+
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000"]

Backend/app/main.py

@@ -1,5 +1,6 @@
-from fastapi import FastAPI
+from fastapi import FastAPI, Request
 from fastapi.middleware.cors import CORSMiddleware
+from starlette.middleware.base import BaseHTTPMiddleware
 from .db.db import engine
 from .db.seed import seed_db
 from .models import models, chat
@@ -9,13 +10,21 @@
 from sqlalchemy.exc import SQLAlchemyError
 import logging
 import os
+import time
 from dotenv import load_dotenv
 from contextlib import asynccontextmanager
 from app.routes import ai
 
 # Load environment variables
 load_dotenv()
 
+# Configure logging
+logging.basicConfig(
+    level=logging.INFO,
+    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s'
+)
+logger = logging.getLogger(__name__)
+
 
 # Async function to create database tables with exception handling
 async def create_tables():
@@ -38,13 +47,42 @@ async def lifespan(app: FastAPI):
     print("App is shutting down...")
 
 
+# Custom middleware for logging and timing
+class RequestMiddleware(BaseHTTPMiddleware):
+    async def dispatch(self, request: Request, call_next):
+        start_time = time.time()
+
+        logger.info(f"Incoming: {request.method} {request.url.path}")
+
+        response = await call_next(request)
+
+        process_time = time.time() - start_time
+        response.headers["X-Process-Time"] = str(process_time)
+        response.headers["X-Content-Type-Options"] = "nosniff"
+        response.headers["X-Frame-Options"] = "DENY"
+        response.headers["X-XSS-Protection"] = "1; mode=block"
+
+        logger.info(f"Completed: {request.method} {request.url.path} - {response.status_code} ({process_time:.3f}s)")
+
+        return response
+
 # Initialize FastAPI
 app = FastAPI(lifespan=lifespan)
 
+# Add custom middleware
+app.add_middleware(RequestMiddleware)
+
 # Add CORS middleware
 app.add_middleware(
     CORSMiddleware,
-    allow_origins=["http://localhost:5173"],
+    allow_origins=[
+        "http://localhost:5173",
+        "http://localhost:5174",
+        "http://localhost:5175",
+        "http://localhost:5176",
+        "http://frontend:5173",
+        "http://127.0.0.1:5173"
+    ],
     allow_credentials=True,
     allow_methods=["*"],
     allow_headers=["*"],

Backend/app/routes/post.py

@@ -18,25 +18,37 @@
 import uuid
 from datetime import datetime, timezone
 
-# Load environment variables
 load_dotenv()
-url: str = os.getenv("SUPABASE_URL")
-key: str = os.getenv("SUPABASE_KEY")
-supabase: Client = create_client(url, key)
+
+url: str = os.getenv("SUPABASE_URL", "")
+key: str = os.getenv("SUPABASE_KEY", "")
+
+if not url or not key or "your-" in url:
+    print("⚠️  Supabase credentials not configured. Some features will be limited.")
+    supabase = None
+else:
+    try:
+        supabase: Client = create_client(url, key)
+    except Exception as e:
+        print(f"❌ Supabase connection failed: {e}")
+        supabase = None
 
 # Define Router
 router = APIRouter()
 
-# Helper Functions
 def generate_uuid():
     return str(uuid.uuid4())
 
 def current_timestamp():
     return datetime.now(timezone.utc).isoformat()
 
-# ========== USER ROUTES ==========
+def check_supabase():
+    if not supabase:
+        raise HTTPException(status_code=503, detail="Database service unavailable. Please configure Supabase credentials.")
+
 @router.post("/users/")
 async def create_user(user: UserCreate):
+    check_supabase()
     user_id = generate_uuid()
     t = current_timestamp()