pointcab_webexport/USER_GUIDE.md

# Benutzerhandbuch - PointCab Webexport Server

Dieses Handbuch erklärt die Verwendung des PointCab Webexport Servers.

## 🏠 Admin-Dashboard

### Zugang

Öffnen Sie das Admin-Dashboard unter:
```
https://ihre-domain.de/admin/dashboard
```

Oder lokal:
```
http://localhost:3000/admin/dashboard
```

### Übersicht

Das Dashboard zeigt:
- Liste aller Projekte
- Projekt-Status (aktiv/abgelaufen)
- Aktionen (Bearbeiten, Löschen, Link kopieren)

## 📤 Projekt hochladen (ZIP/RAR)

### Schritt 1: Neues Projekt

1. Klicken Sie auf **"Neues Projekt"**
2. Wählen Sie **"ZIP/RAR hochladen"**

### Schritt 2: Datei auswählen

1. Klicken Sie auf **"Datei auswählen"**
2. Wählen Sie Ihre ZIP- oder RAR-Datei
3. Unterstützte Formate: `.zip`, `.rar`
4. Maximale Größe: 500 MB (konfigurierbar)

### Schritt 3: Projekt-Details

| Feld | Beschreibung | Pflicht |
|------|--------------|---------|
| Projektname | Eindeutiger Name | Ja |
| Passwort | Optionaler Schutz | Nein |
| Ablaufdatum | Automatisches Löschen | Nein |

### Schritt 4: Hochladen

1. Klicken Sie auf **"Hochladen"**
2. Warten Sie bis der Upload abgeschlossen ist
3. Bei mehreren HTML-Dateien: Wählen Sie die Haupt-HTML

### Ergebnis

Nach erfolgreichem Upload erhalten Sie:
- **Share-Link:** `https://ihre-domain.de/abc123/view`
- **Share-ID:** `abc123`

## 📁 Manuelles Projekt erstellen

### Wann verwenden?

- Wenn Sie Dateien später hinzufügen möchten
- Für schrittweises Befüllen
- Für RAR-Archive (erst Projekt, dann RAR entpacken)

### Schritte

1. Klicken Sie auf **"Neues Projekt"**
2. Wählen Sie **"Manuell erstellen"**
3. Geben Sie den Projektnamen ein
4. Optional: Passwort und Ablaufdatum
5. Klicken Sie auf **"Erstellen"**

Das Projekt wird mit einer Platzhalter-HTML erstellt.

## 📦 RAR entpacken

### Voraussetzung

- Ein manuell erstelltes Projekt
- RAR-Datei mit dem Webexport

### Schritte

1. Öffnen Sie das Projekt im Dashboard
2. Klicken Sie auf **"RAR entpacken"**
3. Wählen Sie die RAR-Datei
4. Klicken Sie auf **"Entpacken"**
5. Der Server entpackt die Datei automatisch

### Was passiert?

1. Die Platzhalter-HTML wird gelöscht
2. Die RAR wird entpackt
3. HTML-Dateien werden erkannt
4. Bei mehreren HTMLs: Auswahl-Seite erscheint

## 🔗 Projekt teilen

### Share-Link kopieren

1. Im Dashboard: Klicken Sie auf das **Link-Symbol** 📋
2. Der Link wird in die Zwischenablage kopiert
3. Teilen Sie den Link

### Link-Format

```
https://ihre-domain.de/{shareId}/view
```

Beispiel:
```
https://pointcab-webexport.zell-cloud.de/xmqqkfs0/view
```

## 🔐 Passwort-Schutz

### Passwort setzen

**Beim Erstellen:**
1. Geben Sie ein Passwort im Feld "Passwort" ein
2. Das Projekt ist sofort geschützt

**Nachträglich:**
1. Öffnen Sie das Projekt im Dashboard
2. Klicken Sie auf **"Bearbeiten"**
3. Geben Sie ein neues Passwort ein
4. Speichern Sie

### Passwort-Eingabe

Wenn ein Projekt geschützt ist:
1. Besucher sehen eine Passwort-Seite
2. Nach korrekter Eingabe wird das Projekt angezeigt
3. Das Passwort wird im Browser gespeichert (Cookie)

### Passwort entfernen

1. Bearbeiten Sie das Projekt
2. Löschen Sie das Passwort-Feld
3. Speichern Sie

## 📄 Multi-HTML-Auswahl

### Wann erscheint die Auswahl?

Wenn ein Projekt **mehrere HTML-Dateien** enthält:
- `Web_0.html`
- `pano.html`
- `index.html`

### Auswahl-Seite

1. Besucher sehen eine Liste aller HTML-Dateien
2. Klick auf einen Eintrag öffnet diese HTML
3. Die Auswahl wird gespeichert (Cookie)

### Haupt-HTML festlegen

Im Dashboard:
1. Bearbeiten Sie das Projekt
2. Wählen Sie die Haupt-HTML aus der Liste
3. Speichern Sie

## ⏰ Ablaufdatum

### Ablaufdatum setzen

1. Beim Erstellen oder Bearbeiten
2. Wählen Sie ein Datum im Kalender
3. Nach diesem Datum ist das Projekt nicht mehr zugänglich

### Was passiert bei Ablauf?

- Besucher sehen eine "Projekt abgelaufen"-Meldung
- Das Projekt bleibt im Dashboard sichtbar
- Sie können das Ablaufdatum verlängern oder entfernen

## 🗑️ Projekt löschen

### Im Dashboard

1. Finden Sie das Projekt
2. Klicken Sie auf **"Löschen"** 🗑️
3. Bestätigen Sie die Löschung

### Was wird gelöscht?

- Datenbank-Eintrag
- Alle hochgeladenen Dateien
- Der Share-Link wird ungültig

**⚠️ Achtung:** Löschen kann nicht rückgängig gemacht werden!

## 📊 Projektstruktur

### Unterstützte Strukturen

**Standard PointCab Export:**
```
projekt.zip
├── Web_0.html (oder index.html)
├── Web_0_web/
│   ├── js/
│   ├── css/
│   ├── img/
│   └── panos/
```

**Multi-HTML Export:**
```
projekt.zip
├── Web_0.html
├── Web_1.html
├── pano.html
├── Web_0_web/
│   └── ...
├── Web_1_web/
│   └── ...
```

### Automatische Erkennung

Der Server erkennt automatisch:
- Haupt-HTML-Datei
- Web-Subfolder (z.B. `Web_0_web/`)
- Asset-Verzeichnisse

## 🔧 Tipps & Tricks

### Große Dateien

- ZIP ist schneller als RAR
- Bei sehr großen Projekten: Manuell + RAR

### Mehrere HTML-Dateien

- Benennen Sie die Haupt-HTML eindeutig
- Oder setzen Sie sie nachträglich im Dashboard

### Passwort vergessen?

- Im Dashboard können Sie das Passwort jederzeit ändern
- Es gibt keine "Passwort vergessen"-Funktion für Besucher

### Projekt umbenennen

- Im Dashboard: Bearbeiten → Namen ändern
- Der Share-Link bleibt gleich!

## 🆘 Häufige Probleme

### "404 - Datei nicht gefunden"

**Ursache:** Asset-Pfade sind falsch
**Lösung:** Prüfen Sie die ZIP-Struktur

### "Projekt abgelaufen"

**Ursache:** Ablaufdatum erreicht
**Lösung:** Im Dashboard Ablaufdatum verlängern

### "Falsches Passwort"

**Ursache:** Tippfehler oder Cache
**Lösung:** Browser-Cache löschen, erneut versuchen

### Leere Seite

**Ursache:** JavaScript-Fehler
**Lösung:** Browser-Konsole prüfen (F12)

---

**Weitere Hilfe:** Kontaktieren Sie den Administrator