Tenant anlegen¶

Es gibt zwei Wege um einen neuen Tenant anzulegen. Der bevorzugte Weg ist die Operator-App — sie ist vollständig automatisiert und erfordert keinen manuellen Ansible-Schritt.

Weg 1 — Operator-App (empfohlen)¶

Öffnen Sie Operator → Tenants und klicken Sie auf Neuen Tenant anlegen.

Feld	Pflicht	Hinweis
Firmenname	Ja	Anzeigename, z.B. „Muster GmbH"
Slug	Ja	Wird automatisch aus dem Namen generiert. Bestimmt die Adresse: `<slug>.sanoli-erp.de`.
Admin-E-Mail	Ja	Der neue Admin erhält automatisch einen Set-Password-Link per Mail.

Nach dem Klick auf Anlegen & provisionieren läuft alles automatisch über die Task-Warteschlange:

PostgreSQL-Datenbank anlegen
Migrationen ausführen
Admin-User + TenantMembership erstellen
Core-Module aktivieren
Set-Password-Mail verschicken
Subdomain + SSL-Zertifikat einrichten (~1 Minute)

Im Sheet sehen Sie einen Live-Status bis der Task done ist.

Subdomain-Timing

Die Subdomain wird vom systemd-Timer innerhalb der nächsten Minute eingerichtet. Die Seite ist dann unter https://<slug>.sanoli-erp.de erreichbar.

Weg 2 — Django-Admin-Assistent (alternativ)¶

Öffnen Sie den Verwaltungsbereich unter api.sanoli-erp.de/admin/ und klicken Sie in der Tenant-Liste auf den Button ✦ Tenant-Assistent.

/// caption Der Tenant-Assistent-Button in der Tenant-Liste ///

Schritt 1 — Basis-Informationen¶

/// caption Schritt 1: Name und Kennung eingeben ///

Feld	Pflicht	Hinweis
Name	Ja	Anzeigename, z.B. "Praxis Müller GmbH"
Kennung	Ja	Wird automatisch aus dem Namen generiert. Nur Kleinbuchstaben, Zahlen, Bindestriche. Bestimmt die Adresse: `<kennung>.sanoli-erp.de`.
Zugangspasswort	Nein	Leer = sicheres Passwort wird automatisch generiert.

Kennung bearbeiten

Die Kennung wird automatisch aus dem Namen abgeleitet (Umlaute werden umgewandelt). Sie können sie vor dem Fortfahren manuell anpassen — danach ist sie unveränderlich.

Schritt 2 — SaaS-Plan¶

Wählen Sie einen Plan für den Tenant. Der Plan legt Limits fest:

Kein Plan = unbegrenzte Nutzung
Starter / Business / Enterprise = vordefinierte Limits

Pläne werden unter Operator → Pläne verwaltet.

Schritt 3 — Admin-Account¶

Feld	Pflicht	Hinweis
Admin-E-Mail	Ja	Login-E-Mail des ersten Tenant-Administrators
Admin-Passwort	Nein	Leer = sicheres Passwort wird generiert und im Ergebnis angezeigt

Passwort sichern

Wenn das Passwort automatisch generiert wird, erscheint es einmalig im Ergebnis-Fenster. Notieren Sie es sofort und leiten Sie es sicher an den Tenant-Administrator weiter.

Schritt 4 — Bestätigung¶

Prüfen Sie alle Angaben in der Zusammenfassung. Klicken Sie auf ✅ Tenant anlegen um die Einrichtung zu starten.

Ergebnis¶

Nach erfolgreicher Einrichtung zeigt der Assistent:

Eine Bestätigung dass Datenbank, Zugänge und Module eingerichtet wurden
Einen Einrichtungsbefehl für den letzten Schritt (Subdomain-Aktivierung)

Letzter Schritt — Subdomain aktivieren

Führen Sie den angezeigten Befehl in Ihrem Terminal aus. Danach ist der Tenant unter https://<kennung>.sanoli-erp.de erreichbar und erhält ein gültiges SSL-Zertifikat.

Ablauf im Überblick¶

sequenceDiagram
    actor Operator
    participant Assistent as Tenant-Assistent
    participant System as Plattform

    Operator->>Assistent: 4 Schritte ausfüllen + bestätigen
    Assistent->>System: Datenbank einrichten
    Assistent->>System: Zugänge und Module aktivieren
    Assistent->>Operator: Ergebnis + Einrichtungsbefehl
    Operator->>System: Einrichtungsbefehl ausführen
    System->>System: Subdomain + Zertifikat aktivieren
    Note over Operator: Tenant ist erreichbar ✅