feat(deploy): prepare application for Render deployment with PostgreSQL and Docker

Author: Lidianacosta

.dockerignore

@@ -0,0 +1,12 @@
+.git
+.venv
+.pytest_cache
+.mypy_cache
+.ruff_cache
+__pycache__
+db.sqlite
+.env
+tests
+docs
+AGENTS.md
+README.md

Dockerfile

@@ -0,0 +1,34 @@
+# Use the official uv image for building
+FROM ghcr.io/astral-sh/uv:python3.12-bookworm-slim AS builder
+
+# Set the working directory
+WORKDIR /app
+
+# Enable bytecode compilation
+ENV UV_COMPILE_BYTECODE=1
+
+# Copy project files
+COPY pyproject.toml uv.lock ./
+
+# Install dependencies without the project itself
+RUN uv sync --frozen --no-install-project --no-dev
+
+# Final stage
+FROM python:3.12-slim-bookworm
+
+WORKDIR /app
+
+# Copy the environment from the builder
+COPY --from=builder /app/.venv /app/.venv
+
+# Add the virtual environment to the PATH
+ENV PATH="/app/.venv/bin:$PATH"
+
+# Copy the rest of the application
+COPY . .
+
+# Expose the port
+EXPOSE 8000
+
+# Start command: run migrations then the app
+CMD alembic upgrade head && uvicorn src.main:app --host 0.0.0.0 --port 8000

pyproject.toml

@@ -7,6 +7,7 @@ requires-python = ">=3.12"
 dependencies = [
     "aiosqlite>=0.22.1",
     "alembic>=1.18.4",
+    "asyncpg>=0.31.0",
     "fastapi[standard]>=0.135.1",
     "pwdlib[argon2]>=0.3.0",
     "pyjwt>=2.12.1",

render.yaml

@@ -0,0 +1,21 @@
+services:
+  # Web Service
+  - type: web
+    name: fastapibanksystem
+    runtime: docker
+    plan: free
+    region: oregon
+    envVars:
+      - key: DATABASE_URL
+        fromDatabase:
+          name: fastapibank-db
+          property: connectionString
+      - key: SECRET_KEY
+        generateValue: true
+      - key: ENVIRONMENT
+        value: production
+
+databases:
+  - name: fastapibank-db
+    plan: free
+    region: oregon

src/core/config.py

@@ -4,7 +4,7 @@
 including database URLs, environment contexts, and security keys.
 """
 
-from pydantic import Field
+from pydantic import Field, field_validator
 from pydantic_settings import BaseSettings, SettingsConfigDict
 
 
@@ -24,6 +24,14 @@ class Settings(BaseSettings):
 
     database_url: str = Field(default="sqlite+aiosqlite:///db.sqlite")
 
+    @field_validator("database_url", mode="before")
+    @classmethod
+    def assemble_db_url(cls, v: str) -> str:
+        """Fix postgres scheme for SQLAlchemy compatibility."""
+        if v and v.startswith("postgres://"):
+            return v.replace("postgres://", "postgresql+asyncpg://", 1)
+        return v
+
     environment: str = Field(default="production")
 
     secret_key: str = Field(