add receipts support

.env.example

@@ -4,9 +4,10 @@
 #
 # Quick start (local dev):
 #   cp .env.example .env.local
-#   docker compose -f docker-compose.dev.yml up -d
+#   docker compose -f docker-compose.dev.yml up -d   # Postgres + MinIO
 #   bun run db:push    # or: bun run db:migrate
 #   bun run dev
+#   MinIO console: http://localhost:9001 (minioadmin / minioadmin)
 #
 # Quick start (Docker app + Postgres):
 #   cp .env.example .env
@@ -63,8 +64,10 @@ NODE_ENV=development
 # Set true when connecting to local Postgres without SSL (default for compose).
 DB_DISABLE_SSL=true
 
-# Dev-only: host port for `docker compose -f docker-compose.dev.yml` Postgres.
+# Dev-only: host ports for `docker compose -f docker-compose.dev.yml`.
 POSTGRES_PORT=5432
+MINIO_API_PORT=9000
+MINIO_CONSOLE_PORT=9001
 
 # Optional: if Next dev picks another port, you do not need to change URLs for
 # sign-in — the auth client uses window.location.origin in the browser.
@@ -124,6 +127,24 @@ NEXT_PUBLIC_UMAMI_SCRIPT_URL=https://analytics.umami.is/script.js
 # Bearer token for POST /api/cron/generate-recurring (recurring invoice cron).
 # CRON_SECRET=
 
+# =============================================================================
+# Receipt storage — S3-compatible (optional)
+# =============================================================================
+# When unset, receipt files are stored locally in .data/receipts/ (dev-friendly).
+# Works with AWS S3, MinIO, Cloudflare R2, etc.
+#
+# Local dev with docker-compose.dev.yml MinIO (host `bun dev`):
+S3_ENDPOINT=http://localhost:9000
+S3_BUCKET=beenvoice-receipts
+S3_ACCESS_KEY=minioadmin
+S3_SECRET_KEY=minioadmin
+S3_REGION=us-east-1
+#
+# docker-compose.yml sets S3_ENDPOINT=http://minio:9000 inside the app container
+# automatically. MINIO_ROOT_* below must match S3_ACCESS_KEY / S3_SECRET_KEY.
+MINIO_ROOT_USER=minioadmin
+MINIO_ROOT_PASSWORD=minioadmin
+
 # =============================================================================
 # SSO — Authentik OIDC (optional)
 # =============================================================================