refactor: Migrate from monolithic to modular architecture

1. **Docker-Compose für Entwicklung optimieren**
2. **Umgebungsvariablen für lokale Entwicklung**
3. **Service-Abhängigkeiten**
4. **Docker-Compose für Produktion**
5. **Dokumentation**

README-ENV.md

@@ -0,0 +1,91 @@
+# Umgebungsvariablen Setup - Zusammenfassung
+
+## Was wurde implementiert
+
+Dieses Projekt wurde erfolgreich mit einer umfassenden Umgebungsvariablen-Konfiguration für die lokale Entwicklung ausgestattet.
+
+### 1. Erstellte Dateien
+
+- **`.env`** - Zentrale Konfigurationsdatei mit allen erforderlichen Umgebungsvariablen
+- **`docs/development/environment-variables-de.md`** - Umfassende Dokumentation aller Umgebungsvariablen
+- **`validate-env.sh`** - Validierungsskript für die Umgebungskonfiguration
+
+### 2. Aktualisierte Dateien
+
+- **`docker-compose.yml`** - Alle Services verwenden jetzt Umgebungsvariablen mit Fallback-Werten
+
+### 3. Konfigurierte Services
+
+Die folgenden Services sind vollständig konfiguriert:
+
+- **PostgreSQL** - Datenbank mit konfigurierbaren Zugangsdaten
+- **Redis** - Event Store und Cache mit separaten Konfigurationen
+- **Keycloak** - Authentifizierung mit konfigurierbaren Admin-Zugangsdaten
+- **Kafka/Zookeeper** - Messaging-System mit konfigurierbaren Parametern
+- **Grafana** - Monitoring mit konfigurierbaren Admin-Zugangsdaten
+- **Prometheus** - Metriken-Sammlung
+- **Zipkin** - Distributed Tracing
+
+### 4. Umgebungsvariablen-Kategorien
+
+- **Anwendungskonfiguration** (API_HOST, API_PORT, etc.)
+- **Datenbank-Konfiguration** (DB_HOST, DB_PORT, DB_USER, etc.)
+- **Redis-Konfiguration** (Event Store und Cache)
+- **Sicherheitskonfiguration** (JWT_SECRET, API_KEY, etc.)
+- **Keycloak-Konfiguration** (Admin-Zugangsdaten, DB-Verbindung)
+- **Service Discovery** (Consul-Konfiguration)
+- **Messaging** (Kafka/Zookeeper-Konfiguration)
+- **Monitoring** (Grafana, Prometheus-Konfiguration)
+- **Logging-Konfiguration** (Log-Level, Request/Response-Logging)
+- **CORS und Rate Limiting**
+
+## Verwendung
+
+### Schnellstart
+
+1. **Services starten:**
+   ```bash
+   docker-compose up -d
+   ```
+
+2. **Konfiguration validieren:**
+   ```bash
+   ./validate-env.sh
+   ```
+
+3. **Services überprüfen:**
+   ```bash
+   docker-compose ps
+   ```
+
+### Anpassungen
+
+- Bearbeiten Sie die `.env`-Datei für lokale Anpassungen
+- Verwenden Sie verschiedene Ports für mehrere Entwickler
+- Ändern Sie Passwörter für Produktionsumgebungen
+
+### Dokumentation
+
+Vollständige Dokumentation finden Sie in:
+- `docs/development/environment-variables-de.md`
+
+## Sicherheitshinweise
+
+⚠️ **Wichtig:**
+- Niemals Produktionsgeheimnisse in die Versionskontrolle einbinden
+- JWT_SECRET in der Produktion ändern
+- Starke Passwörter für Produktionsumgebungen verwenden
+- API-Schlüssel regelmäßig rotieren
+
+## Fehlerbehebung
+
+Bei Problemen:
+1. Führen Sie `./validate-env.sh` aus
+2. Überprüfen Sie die Logs mit `docker-compose logs -f`
+3. Validieren Sie die Konfiguration mit `docker-compose config`
+
+## Nächste Schritte
+
+- Testen Sie die Anwendung mit den neuen Umgebungsvariablen
+- Passen Sie die Werte nach Bedarf für Ihre Entwicklungsumgebung an
+- Erstellen Sie umgebungsspezifische .env-Dateien für verschiedene Stages