build: align dev environment with klz-2026 standards

.env.example

@@ -0,0 +1,79 @@
+# ============================================================================
+# Mintel.me - Environment Configuration
+# ============================================================================
+# Copy this file to .env for local development
+# For production, use .env.production as a template
+# ============================================================================
+
+# ────────────────────────────────────────────────────────────────────────────
+# Application Configuration
+# ────────────────────────────────────────────────────────────────────────────
+PROJECT_NAME=mintel-me
+NODE_ENV=development
+NEXT_PUBLIC_BASE_URL=http://mintel.me.localhost
+# TARGET is used to differentiate between environments (testing, staging, production)
+TARGET=development
+NEXT_PUBLIC_TARGET=development
+
+# ────────────────────────────────────────────────────────────────────────────
+# Docker Orchestration (Traefik)
+# ────────────────────────────────────────────────────────────────────────────
+TRAEFIK_HOST=mintel.me.localhost
+TRAEFIK_RULE=Host(`mintel.me.localhost`)
+# Use AUTH_MIDDLEWARE to enable/disable Gatekeeper locally
+# Default is empty (disabled) for local development
+# Production: mintel-me-auth
+AUTH_MIDDLEWARE=
+
+# ────────────────────────────────────────────────────────────────────────────
+# Directus CMS Configuration
+# ────────────────────────────────────────────────────────────────────────────
+DIRECTUS_URL=https://cms.mintel.me
+DIRECTUS_HOST=cms.mintel.me.localhost
+DIRECTUS_KEY=some-random-key
+DIRECTUS_SECRET=some-random-secret
+DIRECTUS_DB_NAME=directus
+DIRECTUS_DB_USER=directus
+DIRECTUS_DB_PASSWORD=directus
+
+# ────────────────────────────────────────────────────────────────────────────
+# Analytics (Umami)
+# ────────────────────────────────────────────────────────────────────────────
+UMAMI_WEBSITE_ID=
+UMAMI_API_ENDPOINT=https://analytics.infra.mintel.me
+
+# ────────────────────────────────────────────────────────────────────────────
+# Error Tracking (Sentry)
+# ────────────────────────────────────────────────────────────────────────────
+SENTRY_DSN=
+
+# ────────────────────────────────────────────────────────────────────────────
+# Gatekeeper (Standard Auth)
+# ────────────────────────────────────────────────────────────────────────────
+GATEKEEPER_PASSWORD=mintel
+GATEKEEPER_ORIGIN=https://mintel.me/gatekeeper
+COOKIE_DOMAIN=.mintel.me
+AUTH_COOKIE_NAME=mintel_gatekeeper_session
+
+# ────────────────────────────────────────────────────────────────────────────
+# Deployment Configuration (CI/CD only)
+# ────────────────────────────────────────────────────────────────────────────
+IMAGE_TAG=latest
+ENV_FILE=.env
+LOG_LEVEL=info
+
+# ============================================================================
+# IMPORTANT NOTES
+# ============================================================================
+#
+# Networking:
+# ──────────
+# • The project uses a project-prefixed internal network: ${PROJECT_NAME}-internal
+# • All inter-service communication should use Docker aliases
+#
+# Authentication:
+# ───────────────
+# • Gatekeeper is managed via Traefik ForwardAuth
+# • Set AUTH_MIDDLEWARE=${PROJECT_NAME}-auth in .env.production to enable it
+#
+# ============================================================================