# Wiki Deployment Checklist

## ✅ Vor dem Deployment

- [ ] Alle Änderungen committed
- [ ] API-Route `app/api/wiki/route.ts` vorhanden
- [ ] API-Route `app/api/wiki/[...path]/route.ts` vorhanden
- [ ] Wiki-Seite `app/wiki/page.tsx` vorhanden
- [ ] Docker-Compose mit beiden Services konfiguriert

## 🔧 Deployment-Schritte

### 1. Services neu starten
```bash
docker-compose down
docker-compose up -d --build
```

### 2. Services prüfen
```bash
docker-compose ps
```
**Erwartet:** Beide Services (web, wiki) sollten "Up" zeigen

### 3. Wiki-Service-Logs prüfen
```bash
docker-compose logs wiki --tail=50
```
**Erwartet:** "Build complete. Starting server on port 8080..."

### 4. API-Route testen
```bash
curl https://doing-it.de/api/wiki/
```
**Erwartet:** HTML-Inhalt des Wikis, nicht 404

### 5. Wiki-Seite testen
Browser: `https://doing-it.de/wiki`
**Erwartet:** Wiki wird im iframe angezeigt

## 🐛 Troubleshooting

### Problem: 404 auf /wiki

**Schritt 1:** Prüfe ob Wiki-Service läuft
```bash
docker-compose ps wiki
docker-compose logs wiki
```

**Schritt 2:** Prüfe ob API-Route erreichbar ist
```bash
curl https://doing-it.de/api/wiki/
```

**Schritt 3:** Prüfe interne Kommunikation
```bash
docker-compose exec web curl http://wiki:8080/
```

**Schritt 4:** Prüfe Environment-Variable
```bash
docker-compose exec web printenv WIKI_SERVICE_URL
```
Sollte sein: `http://wiki:8080`

**Schritt 5:** Prüfe Next.js Logs
```bash
docker-compose logs web | grep -i wiki
```

### Problem: Wiki lädt nicht im iframe

**Lösung 1:** Prüfe Browser-Konsole (F12) auf Fehler

**Lösung 2:** Prüfe ob API-Route HTML zurückgibt
```bash
curl -I https://doing-it.de/api/wiki/
```

**Lösung 3:** Prüfe CORS-Header (sollte bereits gesetzt sein)

## 📝 Wichtige Konfiguration

### docker-compose.yml sollte enthalten:

```yaml
web:
  environment:
    - WIKI_SERVICE_URL=http://wiki:8080
  depends_on:
    - wiki

wiki:
  expose:
    - "8080"
```

### Environment-Variable

Die `WIKI_SERVICE_URL` muss auf `http://wiki:8080` gesetzt sein (Docker-Service-Name, nicht localhost!).

## ✅ Nach erfolgreichem Deployment

- [ ] Wiki ist unter https://doing-it.de/wiki erreichbar
- [ ] Navigation-Link funktioniert
- [ ] Wiki-Inhalte werden angezeigt
- [ ] Keine 404-Fehler
- [ ] Keine Fehler in Browser-Konsole