PPartnerDesk

120 — PWA Partner-Portal

Aktualisiert am 1. Juni 2026

120 — PWA Partner-Portal

Das Partner-Portal ist eine Progressive Web App (PWA) — kann wie eine native App auf dem Smartphone-Homescreen installiert werden, funktioniert offline (begrenzt) und unterstützt Push-Notifications.

Was ist eine PWA?

Eine Webseite, die sich anfühlt wie eine App:

  • Eigenes Icon auf dem Homescreen.
  • Vollbild-Modus (keine Browser-Adressleiste).
  • Schneller Start.
  • Offline-Fähigkeit (cached Inhalte).
  • Push-Benachrichtigungen (Android + Desktop, eingeschränkt iOS).

Installation

Android

  1. Partner-Portal in Chrome/Samsung Internet/Firefox öffnen.
  2. Nach Sekunden erscheint Banner: „App installieren".
  3. Klick → App wird zum Homescreen hinzugefügt.

Alternative: Drei-Punkte-Menü → „App installieren" oder „Zum Startbildschirm".

iOS / iPad

iOS unterstützt PWA-Install nur über Safari (nicht Chrome/Firefox):

  1. Partner-Portal in Safari öffnen.
  2. „Teilen"-Button unten in der Toolbar.
  3. „Zum Home-Bildschirm".
  4. Bestätigen.

PartnerDesk zeigt iOS-Nutzern automatisch eine Step-by-Step-Anleitung mit Screenshots.

Desktop (Chrome, Edge, Brave)

In der Adressleiste erscheint rechts ein Install-Icon → Klick → App-Fenster.

Was bietet die PWA?

Offline

Wenn der Partner offline ist:

  • Build-Assets (JS/CSS) sind gecached → App startet.
  • Letzter Daten-Stand wird angezeigt (z. B. die zuletzt geladene Dashboard-Sicht).
  • Klick auf Aktionen, die Server-Round-Trip brauchen → Hinweis „Sie sind offline".

Push-Notifications

Partner können Push-Notifications aktivieren:

  1. Partner-Portal → Profil → „Push-Benachrichtigungen aktivieren".
  2. Browser/OS fragt nach Erlaubnis.
  3. Bei Zustimmung: PartnerDesk speichert Subscription.
  4. Bei System-Events (Sale, Payout) wird parallel zur Email auch eine Push-Nachricht geschickt.

Voraussetzungen:

  • Browser/OS unterstützt Web-Push (Android Chrome ja, iOS 16.4+ ja, Desktop Chrome/Edge/Firefox/Safari ja).
  • Plattform-Owner hat VAPID-Keypair konfiguriert.

Shortcuts

PWA-Manifest definiert App-Icon-Quick-Actions:

  • Dashboard (direkt zur KPI-Übersicht).
  • Auszahlungen (direkt zur Payout-Liste).
  • Werbemittel (direkt zu Banner/Coupons).

Long-Press auf das App-Icon (Android) → Shortcut-Menü.

Service Worker

Im Hintergrund läuft ein Service Worker:

  • Cache-First für Build-Assets (JS, CSS, Fonts).
  • Network-First mit Cache-Fallback für API-Calls + HTML.
  • Offline-Shell: generische „Sie sind offline"-Page bei komplett fehlender Verbindung.

Snooze

Wenn der Partner den Install-Prompt einmal weggeklickt hat, erscheint er 7 Tage nicht erneut — nicht aufdringlich.

Was passiert nach Update?

Bei einem PartnerDesk-Update:

  • Browser lädt im Hintergrund die neuen Assets.
  • Beim nächsten Page-Refresh wird die neue Version aktiv.

Kein manuelles „App-Update aus dem Store" nötig — PWAs sind immer aktuell.

Performance

PWAs sind nach dem ersten Laden sehr schnell — alle statischen Assets aus Cache. Erstaufruf ist normaler Webseiten-Aufruf, danach App-Geschwindigkeit.

Verwandte Kapitel

Technische Tiefen-Doku: ../093-pwa-partner-portal.md, ../165-v2-mega-commit.md (Push), ../166-v2-followups.md (iOS-Install)