Enterprise Gmail Workbench · Akademie
Startseite

INTERAKTIVE BEDIENUNGSAKADEMIE

Vom ersten Start bis zur sicheren Automatisierung

Eine praxisorientierte, vollständig offlinefähige Einführung. Jeder Arbeitsablauf endet bewusst vor einer irreversiblen Aktion und führt über Dry-Run, Schutzprüfung und Freigabe.

Kapitel 1 von 10

KAPITEL 1

Erster Start

1
Projekt bauen
mvn clean verify
2
Credentials ablegen

credentials/credentials.json wird lokal gespeichert und nicht in Git eingecheckt.

3
Webmodul starten
mvn -pl gmail-web -am spring-boot:run
4
Workbench öffnen
http://127.0.0.1:8080

KAPITEL 3

Dashboard lesen

1
Health Score

Bewertet Bestand, Regeln, Jobs und Sicherheit gemeinsam.

2
Speicherpotenzial

Ist nur eine Schätzung. Erst der Dry-Run zeigt die tatsächlich betroffenen Nachrichten.

3
Empfehlungen

Öffnen immer einen sicheren Vorbereitungsschritt und führen nie direkt zum endgültigen Löschen.

KAPITEL 4

Der sichere Standardablauf

Empfehlung
  ↓
Query Builder
  ↓
Dry-Run
  ↓
Schutzentscheidungen prüfen
  ↓
Freigabe
  ↓
In Papierkorb verschieben
  ↓
Auditbericht
Wichtig: Permanentes Löschen ist standardmäßig deaktiviert. Für den normalen Betrieb wird ausschließlich der Gmail-Papierkorb empfohlen.

KAPITEL 5

Regel sicher erstellen

1
Bedingungen eng formulieren

Beginnen Sie mit einem spezifischen Absender, Label oder Altersfenster.

2
Schutz aktiv lassen

Markierte, wichtige und ungelesene Nachrichten bleiben geschützt.

3
Limit setzen

Begrenzen Sie den ersten Lauf auf eine kleine Anzahl.

4
Als Entwurf speichern

Erst nach erfolgreichem Dry-Run aktivieren.

KAPITEL 6

Jobs überwachen

StatusBedeutung
WAITINGwartet auf Ausführung
RUNNINGwird verarbeitet
FINISHEDerfolgreich abgeschlossen
FAILEDFehler prüfen, nicht blind neu starten

Bei Fehlern zuerst Meldung, Laufzeit, Retry-Anzahl und OAuth-Zustand prüfen.

KAPITEL 7

Fehlerhilfe

OAuth erforderlich

Prüfen Sie credentials/credentials.json, öffnen Sie „Konten“ und führen Sie die Google-Anmeldung aus.

Dashboard zeigt Demo-Daten

Das Frontend verwendet offline Demo-Read-Models, wenn das Spring-Boot-Backend nicht läuft oder der REST-Endpunkt nicht erreichbar ist.

Gmail API meldet Rate Limit

Job nicht sofort mehrfach starten. Retry abwarten, Trefferlimit reduzieren und Batch-Größe prüfen.

Regel findet zu viele Nachrichten

Query verengen, Schutzoptionen kontrollieren und zuerst mit kleinem Limit als Dry-Run testen.

KAPITEL 8

Plugin Center & Provider

Plugins erweitern Funktionen kontrolliert. Provider zeigen ihre Fähigkeiten explizit; ein IMAP-Adapter darf daher nicht stillschweigend Gmail-Labels vortäuschen.

Plugins zuerst prüfen, dann bewusst aktivieren. Fremdcode startet niemals automatisch.

KAPITEL 9

Workflow Studio & Safe AI

Der Assistant erzeugt nur eine Query und Sicherheitshinweise. Workflow Studio erzwingt Search, Dry-Run und Approval vor einer Papierkorbaktion.

Search → Dry-Run → Approval → Trash → Report

KAPITEL 10

Governance, Backup & Observability

RBAC entscheidet über Berechtigungen. Backups enthalten Regeln, Layouts und Konfiguration, aber niemals OAuth-Tokens oder Client Secrets. Observability bündelt Health, Metriken, Logs und Traces.

⌂ Cockpit