Initial commit mit MkDocs-Dokumentation

docs/deployment/production.md

@@ -0,0 +1,193 @@
+# Produktions-Deployment
+
+---
+
+## Empfohlene Architektur
+
+```
+Internet / Heimnetz
+        ↓
+   nginx (Reverse Proxy)
+        ↓
+   ┌────┴────┐
+   │         │
+Backend   Frontend
+ :3001     (statische Dateien)
+```
+
+---
+
+## systemd-Service
+
+Für ein dauerhaftes Betreiben als systemd-Service:
+
+```bash
+sudo nano /etc/systemd/system/ripster.service
+```
+
+```ini
+[Unit]
+Description=Ripster - Disc Ripping Service
+After=network.target
+
+[Service]
+Type=simple
+User=michael
+WorkingDirectory=/home/michael/ripster
+ExecStart=/bin/bash /home/michael/ripster/start.sh
+ExecStop=/bin/bash /home/michael/ripster/kill.sh
+Restart=on-failure
+RestartSec=10s
+
+# Umgebungsvariablen
+Environment=NODE_ENV=production
+Environment=PORT=3001
+Environment=LOG_LEVEL=info
+
+[Install]
+WantedBy=multi-user.target
+```
+
+```bash
+# Service aktivieren und starten
+sudo systemctl daemon-reload
+sudo systemctl enable ripster
+sudo systemctl start ripster
+
+# Status prüfen
+sudo systemctl status ripster
+
+# Logs anzeigen
+journalctl -u ripster -f
+```
+
+---
+
+## Frontend-Build
+
+Für Produktion das Frontend bauen:
+
+```bash
+cd frontend
+npm run build
+```
+
+Die statischen Dateien landen in `frontend/dist/`.
+
+---
+
+## nginx-Konfiguration
+
+```nginx
+# /etc/nginx/sites-available/ripster
+server {
+    listen 80;
+    server_name ripster.local;
+
+    # Statisches Frontend
+    root /home/michael/ripster/frontend/dist;
+    index index.html;
+
+    # SPA Fallback (React Router)
+    location / {
+        try_files $uri $uri/ /index.html;
+    }
+
+    # API-Proxy zum Backend
+    location /api/ {
+        proxy_pass http://localhost:3001;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+
+    # WebSocket-Proxy
+    location /ws {
+        proxy_pass http://localhost:3001;
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection "upgrade";
+        proxy_set_header Host $host;
+    }
+}
+```
+
+```bash
+sudo ln -s /etc/nginx/sites-available/ripster /etc/nginx/sites-enabled/
+sudo nginx -t && sudo systemctl reload nginx
+```
+
+---
+
+## Nur-Backend-Produktion (ohne nginx)
+
+Falls kein Reverse Proxy gewünscht ist, kann das Backend die Frontend-Dateien direkt ausliefern:
+
+```bash
+# Frontend bauen
+cd frontend && npm run build
+
+# Backend startet und serviert frontend/dist/
+cd backend && NODE_ENV=production npm start
+```
+
+Das Backend ist so konfiguriert, dass es im Produktionsmodus die `frontend/dist/`-Dateien als statische Assets ausliefert.
+
+---
+
+## Datenbank-Backup
+
+```bash
+# Datenbank sichern
+cp backend/data/ripster.db backend/data/ripster.db.backup.$(date +%Y%m%d)
+
+# Oder mit SQLite-eigenem Backup-Befehl
+sqlite3 backend/data/ripster.db ".backup '/mnt/backup/ripster.db'"
+```
+
+!!! tip "Automatisches Backup"
+    Cron-Job für tägliches Backup:
+    ```cron
+    0 3 * * * sqlite3 /home/michael/ripster/backend/data/ripster.db ".backup '/mnt/backup/ripster-$(date +\%Y\%m\%d).db'"
+    ```
+
+---
+
+## Log-Rotation
+
+Ripster rotiert Logs automatisch täglich. Falls zusätzlich systemd-Journal-Rotation gewünscht ist:
+
+```bash
+# /etc/logrotate.d/ripster
+/home/michael/ripster/backend/logs/*.log {
+    daily
+    rotate 14
+    compress
+    missingok
+    notifempty
+}
+```
+
+---
+
+## Sicherheitshinweise
+
+!!! warning "Heimnetz-Einsatz"
+    Ripster ist für den Einsatz im **lokalen Heimnetz** konzipiert und enthält **keine Authentifizierung**. Stelle sicher, dass der Dienst nicht öffentlich erreichbar ist.
+
+Falls öffentlicher Zugang benötigt wird:
+
+1. **Basic Auth** via nginx:
+   ```bash
+   sudo htpasswd -c /etc/nginx/.htpasswd michael
+   ```
+   ```nginx
+   location / {
+       auth_basic "Ripster";
+       auth_basic_user_file /etc/nginx/.htpasswd;
+       # ...
+   }
+   ```
+
+2. **VPN-Zugang** (empfohlen): Zugriff nur über WireGuard/OpenVPN
+
+3. **SSL/TLS**: Let's Encrypt mit certbot für HTTPS