PPartnerDesk

121 — Cross-Tenant-Hub

Aktualisiert am 1. Juni 2026

121 — Cross-Tenant-Hub

Ein Partner, der für mehrere Tenants gleichzeitig aktiv ist, kann einen Hub-Account anlegen. Der Hub bündelt alle Partner-Identitäten unter einer einzigen Email + einem zentralen Dashboard.

Wann sinnvoll?

  • Sie sind Affiliate für 3 Online-Coaches gleichzeitig.
  • Sie haben 2 verschiedene Email-Adressen bei 2 verschiedenen Tenants.
  • Sie wollen alle Provisionen auf einen Blick sehen.

Konzept

[Hub-Account]
    │
    ├─ Email A (verifiziert) ─→ Partner @ Tenant 1
    ├─ Email B (verifiziert) ─→ Partner @ Tenant 2
    └─ Email C (verifiziert) ─→ Partner @ Tenant 3

Ein Hub kann beliebig viele Email-Adressen verwalten. Jede Email kann mit einem Partner-Account in einem Tenant verknüpft sein (1:1 von der Email-Seite, beliebig viele Tenants).

Login

https://partnerdesk.io/hub

Eigener Login-Endpoint, eigener JWT-Token-Speicher (hub_token), eigene SPA. Du kannst parallel im normalen Partner-Portal eines Tenants eingeloggt sein, ohne dass sich die Sessions in die Quere kommen.

Anlage

Self-Service

  1. partnerdesk.io/hub/register → Email + Passwort.
  2. Verifikations-Mail wird gesendet.
  3. Klick → Hub-Account ist aktiv.

Claim-Wizard

Nach Anlage muss der Hub einen oder mehrere bestehende Partner-Accounts „claimen":

  1. „Programm hinzufügen" → Email-Adresse des Partner-Accounts eingeben.
  2. Tenant-Slug + Partner-ID angeben.
  3. PartnerDesk sendet einen Verification-Code an die Partner-Email.
  4. User gibt den Code im Claim-Wizard ein.
  5. → Verbindung erstellt.

So bleibt der originale Partner-Account intakt, aber wird vom Hub aus erreichbar.

Backfill

Bei Anlage eines Hub-Accounts scannt PartnerDesk alle Tenants nach bereits existierenden Partner-Records mit verified Account-Emails. Diese werden automatisch als „Empfehlung" angezeigt — Hub-User kann sie mit einem Klick claimen.

Hub-Dashboard

Cross-Tenant-Ansicht mit:

  • Kumulierte KPIs: Gesamt-Provisionen, Gesamt-Sales über alle Tenants.
  • Tenant-Breakdown: pro Tenant eigene Sub-Statistik.
  • Programs-Liste: alle verbundenen Tenants mit Quick-Links.
  • Transactions: gemeinsame Liste mit Tenant-Spalte.
  • Payouts: gemeinsame Liste.

Program-Switcher

Im Hub-Header ein „Programm wechseln"-Dropdown (nur sichtbar bei > 1 Programm). Klick wechselt zum jeweiligen Partner-Portal des Tenants.

Multi-Tenant-Switcher (V2)

Ein moderneres Konzept aus V2 (siehe …/165-v2-mega-commit.md):

platform_accounts als zentrale Account-Entity. Mehrere Email-Adressen, mehrere Partner-Verknüpfungen — verbessert das ältere Hub-Modell.

In der Praxis ergänzen sich beide:

  • Hub-Account für simple Cross-Tenant-Übersicht.
  • Platform-Account für tiefere Integration mit Marketplace.

PWA

Auch der Hub ist PWA-installierbar mit eigenem Scope (/hub). Sie können also zwei separate Apps auf dem Homescreen haben:

  • „Mein PartnerDesk" → PWA des konkreten Tenants.
  • „PartnerDesk Hub" → Hub für alle Tenants.

Verwandte Kapitel

Technische Tiefen-Doku: ../110-cross-tenant-hub.md, ../165-v2-mega-commit.md, ../166-v2-followups.md