config: enhance .env.example and refine Caddyfile formatting

- Added new comments and examples in `.env.example` for clarity and proper configuration.
- Improved readability and structure of `Caddyfile` with better indentation, comments, and routing logic.

Signed-off-by: Stefan Mogeritsch <stefan.mo.co@gmail.com>

config/docker/caddy/web-app/Caddyfile

@@ -1,40 +1,43 @@
 {
-# Global options
+# TLS wird durch Pangolin/Traefik auf dem VPS terminiert – hier kein HTTPS nötig
   auto_https off
+
   servers {
             metrics
           }
 }
 
 :4000 {
-# Root directory
+# Root-Verzeichnis für statische Assets
   root * /usr/share/caddy
 
-# Logging
+# Logging (strukturiert, JSON)
   log {
         output stdout
         format json
       }
 
-# Compression
+# Komprimierung
   encode gzip zstd
 
-# Configuration Template
+# Caddy-Template-Engine für config.json (liefert API_BASE_URL & KEYCLOAK_URL an den Browser)
   templates {
               mime application/json
             }
 
-# API Proxy (has priority)
+# API-Proxy (höchste Priorität – vor dem SPA-Fallback)
   handle /api/* {
                   reverse_proxy api-gateway:8081
                 }
 
-# Health Check
+# Health-Check-Endpunkt (für Pangolin Health-Check konfigurieren: GET /health)
   handle /health {
                    respond "healthy" 200
                  }
 
-# Serve static files if they exist, otherwise serve index.html (SPA)
-  file_server
-  try_files {path} /index.html
+# SPA-Fallback: existierende Dateien direkt ausliefern, sonst index.html
+  handle {
+           try_files {path} /index.html
+           file_server
+         }
 }

config/docker/caddy/web-app/config.json

@@ -1,10 +1,4 @@
 {
-  "apiBaseUrl": "{{env "
-  API_BASE_URL
-  " | default "
-  "}}",
-  "keycloakUrl": "{{env "
-  KEYCLOAK_URL
-  " | default "
-  "}}"
+  "apiBaseUrl": "{{env `API_BASE_URL`}}",
+  "keycloakUrl": "{{env `KEYCLOAK_URL`}}"
 }