chore(deploy): Dockerfile + Dockge compose + deploy guide

compose.yaml

@@ -0,0 +1,42 @@
+# Production stack for Dockge — builds the image on the host from this repo.
+# Dockge prefers compose.yaml, so this file is used instead of the dev
+# docker-compose.yml (which only runs Mailpit for local development).
+services:
+  flashcard:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    image: flashcard:local
+    container_name: flashcard
+    restart: unless-stopped
+    ports:
+      - "3000:3000"
+    volumes:
+      - flashcard-data:/data
+    environment:
+      NODE_ENV: production
+      PORT: "3000"
+      DB_PATH: /data/flashcard.db
+
+      # URL where users reach the app. Used in verification / reset / invite emails.
+      # CHANGE THIS to your real address, e.g. http://192.168.1.50:3000
+      # or https://flashcards.hausmans.cloud once behind a reverse proxy.
+      APP_URL: "http://CHANGE-ME:3000"
+
+      # Cookie security. Keep "false" when serving over plain HTTP — otherwise the
+      # browser drops the session cookie and login silently fails. Set to "true"
+      # only once the app is served over HTTPS (reverse proxy with TLS).
+      COOKIE_SECURE: "false"
+
+      # SMTP (Amazon SES). Leave SMTP_HOST empty to fall back to a stub mailer that
+      # prints verification/reset links to the container logs — handy for the very
+      # first sysadmin signup before SES is wired up.
+      SMTP_HOST: ""
+      SMTP_PORT: "587"
+      SMTP_SECURE: "false"
+      SMTP_USER: ""
+      SMTP_PASS: ""
+      SMTP_FROM: "Flashcard <noreply@hausmans.cloud>"
+
+volumes:
+  flashcard-data: