dockerised backend, created dockerfile for dev and prod envirnments.

Author: chetanr25

.dockerignore

@@ -19,20 +19,22 @@ SMTP_PASSWORD=your_app_specific_password
 SMTP_FROM_EMAIL=your_email@gmail.com
 SMTP_FROM_NAME=KCET College Predictor
 
-# Google OAuth (for Google-specific validation, optional since Supabase handles OAuth)
+# Google OAuth
 GOOGLE_CLIENT_ID=
 GOOGLE_CLIENT_SECRET=
 GEMINI_API_KEY=your-gemini-api-key
 
-# Supabase Configuration
-# Get these from: https://supabase.com/dashboard/project/YOUR_PROJECT/settings/api
-SUPABASE_URL=https://your-project-id.supabase.co
-SUPABASE_KEY=your-anon-public-key
-SUPABASE_SERVICE_KEY=your-service-role-key
+# PostgreSQL Configuration
+POSTGRES_URL=postgresql+asyncpg://postgres:postgres@localhost:5432/collegefinder
 
 # JWT Configuration
 JWT_SECRET_KEY=generate-a-random-secret-key-at-least-32-chars
 JWT_ALGORITHM=HS256
 JWT_EXPIRATION_HOURS=24
 
-DEBUG=true
+DEBUG=true
+
+# AWS / ECR Deployment
+AWS_REGION=ap-south-1
+ECR_REPO=<account-id>.dkr.ecr.<region>.amazonaws.com/<repo-name>
+IMAGE_TAG=latest

backend/.env.example .env.examplebackend/.env.example renamed to .env.example

@@ -0,0 +1,44 @@
+-include .env
+export
+
+COMPOSE = docker compose -f infra/docker-compose.yml
+
+.PHONY: backend frontend up down db migrate logs clean deploy-ecr
+
+# Start backend + postgres (docker)
+up:
+	$(COMPOSE) up --build
+
+# Start only backend + postgres
+backend:
+	$(COMPOSE) up --build postgres backend
+
+# Start frontend locally with npm
+frontend:
+	cd app/frontend && npm run dev
+
+# Start postgres only
+db:
+	$(COMPOSE) up -d postgres
+
+# Run alembic migrations (requires postgres running)
+migrate:
+	cd app/backend && alembic upgrade head
+
+# View logs
+logs:
+	$(COMPOSE) logs -f
+
+# Stop all services
+down:
+	$(COMPOSE) down
+
+# Stop all services and remove volumes (fresh start)
+clean:
+	$(COMPOSE) down -v
+
+# Deploy backend image to AWS ECR (requires .env with AWS_REGION, ECR_REPO, IMAGE_TAG)
+deploy-ecr:
+	aws ecr get-login-password --region $(AWS_REGION) | docker login --username AWS --password-stdin $(ECR_REPO)
+	docker build -f app/backend/Dockerfile -t $(ECR_REPO):$(IMAGE_TAG) app/backend
+	docker push $(ECR_REPO):$(IMAGE_TAG)

API_DOCUMENTATION.md

@@ -2,7 +2,6 @@ FROM python:3.11-slim
 
 WORKDIR /app
 
-# Install system dependencies if any
 RUN apt-get update && apt-get install -y \
     build-essential \
     && rm -rf /var/lib/apt/lists/*
@@ -12,8 +11,6 @@ RUN pip install --no-cache-dir -r requirements.txt
 
 COPY . .
 
-# Expose the port FastAPI runs on
 EXPOSE 8005
 
-# Command to run the application locally with hot reload
 CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8005", "--reload"]