pfandsystem-demo/dokumentationen/DEPLOYMENT_ANLEITUNG.md

# 🚀 Deployment-Anleitung: Live-Version erstellen

## 📋 Übersicht

**Dev-Version:** `/root` (pfandsystem.backdigital.de)
**Live-Version:** `/var/www/pfandsystem-live` (neue-domain.de)

---

## 🔧 Schritt-für-Schritt Anleitung

### 1. **Neues Verzeichnis erstellen**

```bash
# Live-Version Verzeichnis
sudo mkdir -p /var/www/pfandsystem-live
cd /var/www/pfandsystem-live

# Git Repository klonen
git clone ssh://git@49.13.154.75:2244/christian/pfandsystem.git .

# Auf main branch wechseln
git checkout main
```

---

### 2. **Umgebungsvariablen anpassen**

#### Frontend `.env`:
```bash
cat > .env << 'EOF'
VITE_API_URL=https://DEINE-NEUE-DOMAIN.de/api
EOF
```

#### Backend `.env`:
```bash
cat > backend/.env << 'EOF'
# Database
DB_HOST=localhost
DB_PORT=3307
DB_USER=pfandsystem_live
DB_PASSWORD=NEUES_SICHERES_PASSWORT
DB_NAME=pfandsystem_live

# JWT
JWT_SECRET=NEUER_JWT_SECRET_KEY_HIER

# Server
PORT=3002
NODE_ENV=production

# Resend API
RESEND_API_KEY=re_6BE6Hv6U_H7ggkAT4ApbiSZ5SCo2Cf1qA

# File Upload
UPLOAD_DIR=/var/www/pfandsystem-live/backend/uploads
MAX_FILE_SIZE=10485760
EOF
```

---

### 3. **Docker-Compose anpassen**

```bash
cat > docker-compose.yml << 'EOF'
version: '3.8'

services:
  # MySQL Datenbank (Live)
  mysql:
    image: mysql:8.0
    container_name: pfandsystem-live-mysql
    restart: unless-stopped
    environment:
      MYSQL_ROOT_PASSWORD: NEUES_ROOT_PASSWORT
      MYSQL_DATABASE: pfandsystem_live
      MYSQL_USER: pfandsystem_live
      MYSQL_PASSWORD: NEUES_SICHERES_PASSWORT
    volumes:
      - mysql_data:/var/lib/mysql
    ports:
      - "3307:3306"
    networks:
      - pfandsystem-live-network
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
      interval: 10s
      timeout: 5s
      retries: 5

  # phpMyAdmin (Live)
  phpmyadmin:
    image: phpmyadmin:latest
    container_name: pfandsystem-live-phpmyadmin
    restart: unless-stopped
    environment:
      PMA_HOST: mysql
      PMA_PORT: 3306
    ports:
      - "8082:80"
    networks:
      - pfandsystem-live-network
    depends_on:
      - mysql

  # Frontend (Live)
  frontend:
    image: nginx:1.25-alpine
    container_name: pfandsystem-live-frontend
    restart: unless-stopped
    volumes:
      - ./dist:/usr/share/nginx/html:ro
    networks:
      - pfandsystem-live-network
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.pfandsystem-live.rule=Host(`DEINE-NEUE-DOMAIN.de`)"
      - "traefik.http.routers.pfandsystem-live.entrypoints=web,websecure"
      - "traefik.http.routers.pfandsystem-live.tls=true"
      - "traefik.http.routers.pfandsystem-live.tls.certresolver=letsencrypt"
      - "traefik.http.services.pfandsystem-live.loadbalancer.server.port=80"

volumes:
  mysql_data:
    driver: local

networks:
  pfandsystem-live-network:
    driver: bridge
EOF
```

---

### 4. **Traefik Dynamic Config für Backend**

```bash
mkdir -p /var/www/pfandsystem-live/traefik-config

cat > /var/www/pfandsystem-live/traefik-config/backend.yml << 'EOF'
http:
  routers:
    # Backend API Router (Live)
    pfandsystem-live-api:
      rule: "Host(`DEINE-NEUE-DOMAIN.de`) && PathPrefix(`/api`)"
      service: pfandsystem-live-api
      entryPoints:
        - web
        - websecure
      tls:
        certResolver: letsencrypt
      priority: 100

    # Backend Uploads Router (Live)
    pfandsystem-live-uploads:
      rule: "Host(`DEINE-NEUE-DOMAIN.de`) && PathPrefix(`/uploads`)"
      service: pfandsystem-live-api
      entryPoints:
        - web
        - websecure
      tls:
        certResolver: letsencrypt
      priority: 100

  services:
    # Backend Service (Live)
    pfandsystem-live-api:
      loadBalancer:
        servers:
          - url: "http://172.17.0.1:3002"
EOF
```

---

### 5. **Traefik-Config in bestehenden Traefik einbinden**

```bash
# Kopiere Config in Traefik dynamic Ordner
sudo cp /var/www/pfandsystem-live/traefik-config/backend.yml /root/traefik/dynamic/pfandsystem-live.yml

# Traefik neu laden (erkennt automatisch neue Configs)
docker restart pfandsystem-traefik
```

---

### 6. **Datenbank initialisieren**

```bash
# Docker Container starten
cd /var/www/pfandsystem-live
docker compose up -d mysql phpmyadmin

# Warte bis MySQL bereit ist
sleep 30

# SQL Schema importieren
docker exec -i pfandsystem-live-mysql mysql -upfandsystem_live -pNEUES_SICHERES_PASSWORT pfandsystem_live < backend/schema.sql

# Admin-User erstellen
cd backend
npm install
node scripts/create-admin.js
```

---

### 7. **Frontend bauen**

```bash
cd /var/www/pfandsystem-live

# Dependencies installieren
npm install

# Frontend bauen
npm run build

# Manifest-Links fixen
node fix-manifest-link.cjs
```

---

### 8. **Backend starten**

```bash
cd /var/www/pfandsystem-live/backend

# Dependencies installieren
npm install

# Backend als Service starten (mit PM2)
npm install -g pm2
pm2 start server.js --name pfandsystem-live
pm2 save
pm2 startup
```

---

### 9. **Frontend-Container starten**

```bash
cd /var/www/pfandsystem-live
docker compose up -d frontend
```

---

### 10. **Logo und Branding anpassen**

#### Logo ersetzen:
```bash
# Eigenes Logo (192x192 und 512x512)
cp /pfad/zu/deinem/logo-192.png /var/www/pfandsystem-live/public/logo-192.png
cp /pfad/zu/deinem/logo-512.png /var/www/pfandsystem-live/public/logo-512.png

# Favicon
cp /pfad/zu/deinem/favicon.ico /var/www/pfandsystem-live/public/favicon.ico
```

#### Manifest anpassen:
```bash
nano /var/www/pfandsystem-live/public/manifest.json
```

Ändere:
```json
{
  "name": "Dein Firmenname - Pfandsystem",
  "short_name": "Dein Pfandsystem",
  "theme_color": "#DEINE_FARBE",
  "background_color": "#DEINE_FARBE"
}
```

#### Farben anpassen:
```bash
nano /var/www/pfandsystem-live/src/index.css
```

Ändere Primary-Color, etc.

#### Frontend neu bauen:
```bash
cd /var/www/pfandsystem-live
npm run build
node fix-manifest-link.cjs
docker restart pfandsystem-live-frontend
```

---

## 🧪 Testing

### 1. **DNS konfigurieren:**
```
DEINE-NEUE-DOMAIN.de → A-Record → Server-IP
```

### 2. **Testen:**
```bash
# SSL-Zertifikat wird automatisch von Traefik generiert
curl -I https://DEINE-NEUE-DOMAIN.de

# Login testen
curl https://DEINE-NEUE-DOMAIN.de/api/auth/login \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"email":"admin@pfandsystem.de","password":"admin123"}'
```

### 3. **Im Browser öffnen:**
```
https://DEINE-NEUE-DOMAIN.de
```

---

## 📊 Übersicht der Ports

| Service | Dev | Live |
|---------|-----|------|
| MySQL | 3306 | 3307 |
| phpMyAdmin | 8081 | 8082 |
| Backend | 3001 | 3002 |
| Frontend | via Traefik | via Traefik |

---

## 🔄 Updates deployen

```bash
cd /var/www/pfandsystem-live

# Neueste Version holen
git pull origin main

# Frontend neu bauen
npm run build
node fix-manifest-link.cjs
docker restart pfandsystem-live-frontend

# Backend neu starten
pm2 restart pfandsystem-live
```

---

## 🛡️ Sicherheit

1. **Passwörter ändern:**
   - MySQL Root-Passwort
   - MySQL User-Passwort
   - JWT Secret
   - Admin-Passwort (nach erstem Login)

2. **Firewall:**
   ```bash
   # Nur notwendige Ports öffnen
   ufw allow 80/tcp
   ufw allow 443/tcp
   ufw allow 22/tcp
   ```

3. **Backups:**
   ```bash
   # Automatisches Backup einrichten
   crontab -e
   # Täglich um 2 Uhr
   0 2 * * * /var/www/pfandsystem-live/backup.sh
   ```

---

## ✅ Checkliste

- [ ] Verzeichnis erstellt
- [ ] Git geklont
- [ ] .env Dateien angepasst
- [ ] docker-compose.yml angepasst
- [ ] Traefik-Config erstellt
- [ ] Datenbank initialisiert
- [ ] Admin-User erstellt
- [ ] Frontend gebaut
- [ ] Backend gestartet (PM2)
- [ ] Frontend-Container gestartet
- [ ] Logo/Branding angepasst
- [ ] DNS konfiguriert
- [ ] SSL-Zertifikat generiert
- [ ] Login getestet
- [ ] Alle Funktionen getestet

---

## 🎯 Zusammenfassung

**Dev-Version:**
- Verzeichnis: `/root`
- Domain: `pfandsystem.backdigital.de`
- MySQL Port: 3306
- Backend Port: 3001

**Live-Version:**
- Verzeichnis: `/var/www/pfandsystem-live`
- Domain: `DEINE-NEUE-DOMAIN.de`
- MySQL Port: 3307
- Backend Port: 3002

Beide Versionen laufen parallel auf derselben Instanz mit eigenem Traefik-Routing!