Center-Datenexport (ZIP)

Wenn ein Center den Vertrag beendet und seine Cockpit-Daten mitnehmen möchte, können berechtigte Nutzer einen schreibgeschützten ZIP-Export erzeugen. Im Cockpit werden dabei keine Daten gelöscht oder geändert.

Wo im Dashboard

Content → Shopping Center → Center bearbeiten → Reiter „Verwaltung“ → Center-Daten exportieren (ZIP).

Beim Export öffnet sich ein Fortschritts-Dialog (Prozentanzeige und aktueller Schritt, z. B. Datenbank, Umami, Bot-Statistiken, Bilder). Das Fenster während des Exports nicht schließen – der ZIP-Download startet automatisch, wenn alles fertig ist.

In der Doku finden: Themenfinder (Center & Organisation) oder Suche oben (Strg+K / ⌘+K) nach „Datenexport“.

Berechtigung

Export ist möglich für:

• Super-Admin
• Center-Administrator / Marketing Manager (Organisation), wenn das Center zur eigenen Organisation gehört
• Nutzer mit der Center-Zuweisung „Daten exportieren“ (canExportData unter Einstellungen → Benutzer → Center-Zuweisung)

Inhalt des ZIP-Archivs

Ordner/Datei	Inhalt
README.txt	Kurzanleitung
manifest.json	Zeitstempel, Zähler, Status der Medien-Downloads
data/*.json	Stammdaten, Shops, Filialen, Ketten, News, Events, Angebote, Jobs, Services, Büros, Seiteninhalte, Centerplan-Metadaten, Kategorien, …
data/umami-analytics.json	Website-Analytics (Umami): aggregierte Kennzahlen und Verläufe für 30, 90 und 365 Tage – nur wenn Analytics für das Center aktiv ist und Umami erreichbar ist (siehe unten)
data/bot-analytics.json	AI-Assistent / Bot: Nutzung nach Kanal (Website, Kiosk, Companion), Top-Suchen, Intents, Erwähnungen, Journey-Funnel – Zeiträume 30/90/365 Tage
data/chatbotInteractions.json	Rohdaten aller Bot-Interaktionen (anonymisiert: keine Chat-Antworttexte)
data/centerUsageEvents.json	Rohdaten Nutzungs-Events (Kiosk/Companion/Website, z. B. Journey-Schritte)
csv/*.csv	Excel-taugliche Auszüge (Shops, News, Angebote, …)
csv/bot/	Bot- & KI-Auswertung für Excel (siehe unten)
media/	Nur Bilder: SVG, JPG/JPEG, PNG (keine 3D-Modelle, Videos, PDFs)

Nicht enthalten (Datenschutz / Sicherheit): Passwörter (z. B. Analytics-Seitenpasswort), Benutzerkonten anderer Center.

Medien: Im Ordner media/ werden ausschließlich SVG, JPG/JPEG und PNG heruntergeladen. 3D-Modelle (GLB, GLTF, …), Videos, PDFs und andere Formate sind ausgeschlossen; deren URLs bleiben in den JSON-Dateien unter data/ und werden in manifest.json unter excludedMediaUrls gelistet.

Größenlimits (Bilder): Einzeldatei max. 25 MB, Gesamtarchiv Medien max. ca. 400 MB.

Umami-Statistiken im Export

Wenn das Center Website-Analytics (Umami) nutzt (analyticsEnabled, Umami-Website-ID unter Center → Analytics), versucht der Export beim Erzeugen der ZIP-Datei dieselben aggregierten Kennzahlen wie im Dashboard abzurufen (Pageviews, Besucher, Visits, Verläufe je Tag/Monat).

Situation	Ergebnis in umami-analytics.json
Analytics aus oder anderer Provider	included: false mit kurzer Begründung
Umami aktiv, Server hat UMAMI_PASSWORD	included: true, Zeiträume unter periods
Umami aktiv, API nicht konfiguriert	included: false, Hinweis auf Umami-Dashboard

Der ZIP-Download schlägt nicht fehl, wenn Umami nicht erreichbar ist – es fehlen dann nur die Statistikdaten. Status steht auch in manifest.json unter umamiAnalytics.

Bot- und AI-Assistent-Statistiken

Für Auswertung durch den Kunden (Excel): Ordner csv/bot/ — deutsch beschriftete CSV-Dateien mit UTF-8-BOM. Kurzanleitung: csv/bot/00-LESEHILFE.txt.

Datei in csv/bot/	Inhalt
01-uebersicht-zeitraeume.csv	Nutzung Website / Kiosk / Companion für 30, 90 und 365 Tage
02-top-suchen.csv	Häufigste Suchanfragen je Zeitraum
03-top-intents.csv	Erkannte Nutzerabsichten (deutsche Bezeichnung)
04–09	Erwähnungen Shops, Gastronomie, Services, Angebote, Events, Kategorien
10-companion-journey.csv	Companion-Journey-Schritte
11-interaktionen-detail.csv	Einzelne Interaktionen (Datum, Kanal, Suche, Intent, Namen statt nur IDs)
12-nutzungs-events.csv	Nutzungs-Events (Kiosk/Companion/Website) lesbar aufbereitet

Technische Rohdaten (Archiv): weiterhin unter data/:

Datei	Inhalt
bot-analytics.json	Aggregierte Kennzahlen wie im Dashboard (30/90/365 Tage)
chatbotInteractions.json	Rohdaten aller Bot-Interaktionen
centerUsageEvents.json	Rohdaten Nutzungs-Events

Es werden keine personenbezogenen Roh-Chats exportiert – nur das, was das System ohnehin für Analytics speichert (queryNormalized, Erwähnungs-IDs, Intents).

Technik (für Entwickler)

• UI: asynchron mit Status-Dialog – POST …/export/start, GET …/export/status?jobId=, GET …/export/download?jobId=
• Direkt-Download (ohne Fortschritt): GET /api/centers/[centerId]/export
• Implementierung: apps/dashboard/src/lib/center-export/
• Nur SELECT-Abfragen, keine Migration, kein Löschen

Ablauf bei Kündigung (empfohlen)

1. Export ausführen und ZIP archivieren
2. Vertraglich dokumentieren, dass der Export erhalten wurde
3. Center ggf. deaktivieren oder löschen – separater Schritt unter „Gefährliche Aktionen“

Siehe auch: Benutzer & Organisation (Recht „Daten exportieren“).