Add Docker deployment (build- and stack-tested)

- backend/Dockerfile: gunicorn, not the dev server.
- frontend/Dockerfile: multi-stage, nginx serves the static build.
- nginx.conf proxies /api and /auth to the backend so both services
  share one origin - keeps the session cookie simple first-party,
  no SameSite=None/CORS complexity in production.
- docker-compose.yml: bind-mounts ./data/{instance,uploads} (not
  named volumes) so the sqlite db and uploaded photos are visible
  under the project dir; :Z flag for SELinux-enforcing hosts
  (Fedora/RHEL) - without it gunicorn fails with "unable to open
  database file".
- FRONTEND_PORT env var to pick the exposed port.
- .env.example: documents CORS_ORIGIN is moot in the compose setup
  (same-origin via nginx) and that SESSION_COOKIE_SECURE=true needs
  a TLS-terminating reverse proxy in front in real deployment.

Verified: both images build clean, full stack up via docker compose,
login flow starts for real against the actual NC instance through
the nginx proxy, sqlite db persists to the bind mount correctly.

backend/.dockerignore

@@ -0,0 +1,7 @@
+.venv/
+__pycache__/
+**/__pycache__/
+*.pyc
+instance/
+uploads/
+.env

backend/.env.example

@@ -30,6 +30,13 @@ LLM_MODEL=
 # --- Flask ---
 FLASK_SECRET_KEY=dev-change-me
 DATABASE_PATH=instance/wgbill.sqlite3
+# Only matters when the frontend calls this backend from a different origin
+# (e.g. local dev, vite on :5173). The docker-compose.yml setup puts nginx
+# in front of both on one origin, so the browser never makes a cross-origin
+# call and this is effectively unused there - but Flask-CORS still needs a
+# concrete value, not "*", since credentials (the session cookie) are
+# involved.
+CORS_ORIGIN=http://localhost:5173
 
 # --- Auth ---
 # Generate with: python3 -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"
@@ -39,6 +46,10 @@ DATABASE_PATH=instance/wgbill.sqlite3
 TOKEN_ENCRYPTION_KEY=
 # Idle session lifetime in days (sliding - refreshed on each use).
 SESSION_TTL_DAYS=30
-# Cookies need Secure (HTTPS-only) for any real deployment. Only set to
-# false for plain-http localhost dev.
+# Cookies need Secure (HTTPS-only) for any real deployment - browsers won't
+# send/store a Secure cookie over plain HTTP. Only set to false for
+# plain-http localhost dev. For docker-compose: put your own TLS-terminating
+# reverse proxy (Caddy, nginx-proxy-manager, etc.) in front of the exposed
+# frontend port and set this true; without that, leave it false or login
+# will silently fail to persist.
 SESSION_COOKIE_SECURE=true

backend/Dockerfile

@@ -0,0 +1,23 @@
+FROM python:3.12-slim
+
+WORKDIR /app
+
+# Pillow needs these to build/run; python:3.12-slim's manylinux wheels cover
+# most of it, but libjpeg/zlib runtime libs are still needed at import time.
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    libjpeg62-turbo \
+    zlib1g \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+COPY . .
+
+RUN mkdir -p instance uploads
+
+EXPOSE 5000
+
+# instance/ (sqlite db) and uploads/ (receipt photos) should be mounted as
+# volumes - see docker-compose.yml - so they survive a container rebuild.
+CMD ["gunicorn", "--bind", "0.0.0.0:5000", "--workers", "2", "--timeout", "60", "run:app"]

backend/requirements.txt

@@ -4,3 +4,4 @@ python-dotenv==1.0.1
 requests==2.32.3
 Pillow==10.4.0
 cryptography==43.0.1
+gunicorn==23.0.0