Add CI workflow, Docker tooling, and deployment docs

Author: lunaticsm

.github/workflows/test.yml

@@ -0,0 +1,29 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+      - master
+      - develop
+  pull_request:
+
+jobs:
+  tests:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+
+      - name: Run pytest
+        run: pytest

README.md

@@ -56,6 +56,26 @@ docker run --rm -p 8000:8000 --env-file .env -v $(pwd)/uploads:/app/uploads imag
 
 Customize `DB_URL`, `UPLOAD_DIR`, etc. via the `--env-file` or individual `-e` flags.
 
+### Docker Compose & Postgres
+
+For a Postgres-backed setup (with uploads persisted to a Docker volume), use the provided composition:
+
+```bash
+docker compose up --build
+```
+
+Key environment variables for production deployments:
+
+| Variable | Description |
+|----------|-------------|
+| `DB_URL` | Should point to your managed database, e.g. `postgresql+psycopg2://user:pass@host:5432/dbname`. |
+| `UPLOAD_DIR` | Mounted path where files are stored (use a persistent volume or S3-compatible backend). |
+| `RATE_LIMIT_PER_MINUTE` | Adjust per-client quotas according to expected traffic. |
+| `MAX_FILE_SIZE_BYTES` | Enforce a tighter upload cap if needed. |
+| `CACHE_MAX_AGE_SECONDS` | Tune cache headers for served files. |
+| `CORS_ORIGINS` | Lock down origins for production frontends. |
+| `ENABLE_CLEANER` | Keep true to remove stale files automatically. |
+
 ## API Overview
 
 | Method | Path | Description |

docker-compose.yml

@@ -0,0 +1,34 @@
+version: "3.9"
+
+services:
+  app:
+    build: .
+    image: image-uploader-app
+    container_name: image-uploader-app
+    env_file: .env
+    environment:
+      UPLOAD_DIR: /data/uploads
+      DB_URL: postgresql+psycopg2://cdn:cdn@db:5432/cdn
+    depends_on:
+      db:
+        condition: service_healthy
+    volumes:
+      - uploads-data:/data/uploads
+    ports:
+      - "8000:8000"
+
+  db:
+    image: postgres:16
+    restart: always
+    environment:
+      POSTGRES_DB: cdn
+      POSTGRES_USER: cdn
+      POSTGRES_PASSWORD: cdn
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U cdn -d cdn"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+volumes:
+  uploads-data: