fix: DockerSecretsResolver - don't normalize absolute paths like /var/www/html/...

deployment/infrastructure/postgresql/README.md

@@ -0,0 +1,114 @@
+# PostgreSQL Stack
+
+Shared PostgreSQL-Datenbank für Application-Stacks (Staging und Production).
+
+## Features
+
+- PostgreSQL 16 für Application-Datenbank
+- Automatische Backups (täglich um 2 Uhr)
+- Backup-Retention (7 Tage)
+- Health Checks
+- Optimierte Performance-Konfiguration
+
+## Voraussetzungen
+
+- Infrastructure Network muss existieren
+- App-Internal Network wird von diesem Stack erstellt
+
+## Setup
+
+### 1. Infrastructure Network erstellen
+
+```bash
+docker network create infrastructure
+```
+
+### 2. Secrets erstellen
+
+```bash
+# PostgreSQL Passwort
+openssl rand -base64 32 > secrets/postgres_password.txt
+chmod 600 secrets/postgres_password.txt
+```
+
+### 3. Stack deployen
+
+```bash
+docker compose up -d
+```
+
+### 4. Datenbanken erstellen
+
+```bash
+# Staging-Datenbank erstellen
+docker compose exec postgres psql -U postgres -c "CREATE DATABASE michaelschiemer_staging;"
+
+# Production-Datenbank existiert bereits (michaelschiemer)
+```
+
+## Networks
+
+**infrastructure:**
+- Externes Network (muss vorher erstellt werden)
+- Für interne Infrastruktur-Kommunikation
+
+**app-internal:**
+- Wird von diesem Stack erstellt
+- Wird von Application-Stacks genutzt
+- Für Application ↔ PostgreSQL Kommunikation
+
+## Volumes
+
+- `postgres-data` - PostgreSQL-Daten (persistent)
+- `postgres-backups` - Automatische Backups
+
+## Datenbanken
+
+- `michaelschiemer` - Production-Datenbank
+- `michaelschiemer_staging` - Staging-Datenbank (muss manuell erstellt werden)
+
+## Backups
+
+Backups werden automatisch täglich um 2 Uhr erstellt und in `/backups` gespeichert.
+
+**Manuelles Backup:**
+```bash
+docker compose exec postgres-backup sh -c "PGPASSWORD=\$(cat /run/secrets/postgres_password) pg_dump -h postgres -U postgres -d michaelschiemer -F c -f /backups/manual_backup_$(date +%Y%m%d_%H%M%S).dump"
+```
+
+**Backup wiederherstellen:**
+```bash
+docker compose exec -T postgres psql -U postgres -d michaelschiemer < backup_file.sql
+```
+
+## Troubleshooting
+
+### PostgreSQL startet nicht
+
+```bash
+# Logs prüfen
+docker compose logs -f postgres
+
+# Volume-Berechtigungen prüfen
+docker compose exec postgres ls -la /var/lib/postgresql/data
+```
+
+### Verbindungsprobleme von Application
+
+1. Prüfe, ob Application im `app-internal` Network ist
+2. Prüfe PostgreSQL-Logs
+3. Prüfe Network-Verbindung:
+   ```bash
+   docker network inspect app-internal
+   ```
+
+### Backup-Probleme
+
+```bash
+# Backup-Logs prüfen
+docker compose logs -f postgres-backup
+
+# Backup-Verzeichnis prüfen
+docker compose exec postgres-backup ls -la /backups
+```
+