Initial commit

Docker Backend/QUICKSTART.md

@@ -0,0 +1,169 @@
+# Quick Start - Deployment in 5 Minuten
+
+## Schnellste Methode: Per SCP auf Server kopieren
+
+### 1. Server-Voraussetzungen prüfen
+
+SSH auf deinen Server und prüfe:
+
+```bash
+# Docker installiert?
+docker --version
+
+# Docker Compose installiert?
+docker-compose --version
+
+# Falls nicht installiert:
+curl -fsSL https://get.docker.com -o get-docker.sh
+sh get-docker.sh
+```
+
+### 2. Backend auf Server kopieren
+
+Auf deinem **lokalen Windows-Rechner** (Git Bash oder WSL):
+
+```bash
+# Ins Backend-Verzeichnis
+cd "/e/Dokumente/05_Skrift/Frontend_Backend_Konfigurator/Docker Backend"
+
+# Zum Server kopieren (ersetze USER und SERVER)
+rsync -avz \
+  --exclude 'node_modules' \
+  --exclude 'output' \
+  --exclude 'cache' \
+  --exclude '.git' \
+  ./ root@dein-server.de:/opt/skrift-backend/
+```
+
+**Oder mit SCP (wenn rsync nicht verfügbar):**
+
+```bash
+# Windows PowerShell
+scp -r "E:\Dokumente\05_Skrift\Frontend_Backend_Konfigurator\Docker Backend\*" root@dein-server.de:/opt/skrift-backend/
+```
+
+### 3. Auf dem Server starten
+
+SSH auf den Server:
+
+```bash
+ssh root@dein-server.de
+
+# Ins Backend-Verzeichnis
+cd /opt/skrift-backend
+
+# .env Datei erstellen
+cat > .env << 'EOF'
+SCRIPTALIZER_LICENSE_KEY=f9918b40-d11c-11f0-b558-0800200c9a66
+SCRIPTALIZER_ERR_FREQUENCY=0
+BATCH_SIZE=30
+CACHE_LIFETIME_HOURS=2
+RATE_LIMIT_PER_MINUTE=2
+NODE_ENV=production
+EOF
+
+# Output-Verzeichnis für N8N erstellen
+mkdir -p /var/skrift-output
+chmod 755 /var/skrift-output
+
+# Container bauen und starten
+docker-compose up -d --build
+
+# Logs ansehen
+docker-compose logs -f
+```
+
+### 4. Testen
+
+```bash
+# Auf dem Server
+curl http://localhost:4000/health
+
+# Sollte antworten mit:
+# {"status":"ok","timestamp":"..."}
+```
+
+### 5. Nginx Proxy Manager einrichten
+
+1. Nginx Proxy Manager öffnen (z.B. http://dein-server.de:81)
+2. "Proxy Hosts" → "Add Proxy Host"
+3. Konfiguration:
+   - **Domain Names**: `backend.deine-domain.de`
+   - **Scheme**: `http`
+   - **Forward Hostname/IP**: `skrift-backend`
+   - **Forward Port**: `4000`
+   - **Cache Assets**: ✓
+   - **Block Common Exploits**: ✓
+
+4. Tab "SSL":
+   - **SSL Certificate**: "Request a new SSL Certificate"
+   - **Force SSL**: ✓
+   - **Email**: deine@email.de
+
+5. Speichern
+
+### 6. Finaler Test
+
+```bash
+# Von deinem lokalen Rechner
+curl https://backend.deine-domain.de/health
+```
+
+## FERTIG!
+
+Dein Backend läuft jetzt auf: `https://backend.deine-domain.de`
+
+### WordPress Integration
+
+In deinem WordPress Plugin die Backend-URL eintragen:
+
+```php
+define('SKRIFT_BACKEND_URL', 'https://backend.deine-domain.de');
+```
+
+## Wichtige Befehle
+
+```bash
+# Container Status
+docker-compose ps
+
+# Logs ansehen
+docker-compose logs -f
+
+# Container neu starten
+docker-compose restart
+
+# Container stoppen
+docker-compose down
+
+# Update nach Code-Änderungen
+docker-compose up -d --build
+```
+
+## Problemlösung
+
+### Container startet nicht
+```bash
+docker-compose logs
+# Häufig: Fonts fehlen oder .env nicht korrekt
+```
+
+### Port 4000 schon belegt
+```bash
+# In docker-compose.yml ändern:
+ports:
+  - "4001:4000"  # Anderen externen Port verwenden
+```
+
+### Keine Verbindung von außen
+```bash
+# Firewall prüfen
+sudo ufw status
+sudo ufw allow 4000/tcp
+```
+
+## Nächste Schritte
+
+- Siehe [DEPLOYMENT.md](./DEPLOYMENT.md) für Details
+- Siehe [README.md](./README.md) für API-Dokumentation
+- N8N Workflow einrichten für automatische Plotter-Übertragung