fix: correct SMTP_HOST default for Docker Compose

SMTP_HOST=localhost in .env was overriding the docker-compose.yml
default of "maildev" (the Docker service name). Inside a container,
localhost refers to the container itself — not the MailDev container.

Comment out SMTP_HOST and add a clear note explaining when to use
localhost (local dev without Docker) vs leaving it unset (Docker).

Author: ngoyal16

.env.example

@@ -22,10 +22,12 @@ AEGIS_PORT=8080
 # AEGIS_BIND=127.0.0.1
 
 # ── Agent & Domain ───────────────────────────────────────────────
-# Base domain for subdomain-based org resolution (optional)
-# e.g., "aegis.io" means orgs are accessed via acme.aegis.io
-# Leave empty to use X-Org-Slug header instead (dev mode)
-# AEGIS_BASE_DOMAIN=
+# Base domain for subdomain-based org resolution.
+# In production: aegis.io → orgs accessed via acme.aegis.io
+# In development: lvh.me → orgs accessed via acme.lvh.me:8080
+#   (*.lvh.me resolves to 127.0.0.1 — no /etc/hosts changes needed)
+# Leave empty to use X-Org-Slug header instead (header-only mode).
+AEGIS_BASE_DOMAIN=lvh.me
 
 # ── CORS ─────────────────────────────────────────────────────────
 # Allowed CORS origins (comma-separated)
@@ -34,9 +36,19 @@ AEGIS_ALLOWED_ORIGINS=http://localhost:5173,http://localhost:8080
 # ── SMTP (Email) ─────────────────────────────────────────────────
 # In development, MailDev runs via Docker Compose (web UI: http://localhost:1080)
 # In production, configure a real SMTP provider (SendGrid, SES, Mailgun, etc.)
-SMTP_HOST=localhost
+#
+# NOTE: When running with Docker Compose, leave SMTP_HOST commented out.
+# The compose file defaults to 'maildev' (the Docker service name).
+# Only set SMTP_HOST=localhost when running the Go server directly (without Docker).
+# SMTP_HOST=localhost
 SMTP_PORT=1025
 SMTP_USERNAME=
 SMTP_PASSWORD=
 SMTP_FROM=noreply@aegis.local
 SMTP_TLS=false
+
+# ── Logging ──────────────────────────────────────────────────────
+# Log level: debug, info, warn, error (default: info)
+LOG_LEVEL=info
+# Log format: text (human-readable) or json (structured for log aggregation)
+LOG_FORMAT=text