KFZ-Bozo Handbuch

Apps & Zugänge › PWA / Installierbare App

PWA / Installierbare App

FunktionLive✓ Geprüft am Sat Sep 05 2026 02:00:00 GMT+0200 (Mitteleuropäische Sommerzeit)

Das System lässt sich wie eine App auf Tablet oder Handy installieren („zum Startbildschirm hinzufügen"). Beim Öffnen entscheidet eine Weiche am Gerät, ob das Büro-Panel oder das Mechaniker-Tablet erscheint. Das Symbol kennt zusätzlich Kurzbefehle für die täglichen Wege.

BüroWerkstatt

So arbeitest du damit

  1. Öffne das System im Browser des Tablets oder Handys.
  2. Bestätige den Hinweis „App installieren", oder wähle im Browser-Menü „Zum Startbildschirm hinzufügen".
  3. Starte die App künftig über das Symbol auf dem Startbildschirm statt über den Browser.
  4. Halte das Symbol gedrückt, um direkt zu Mechaniker, Annahme, Kalender, Aufträgen oder Bühnenmodus zu springen.
  5. Scanne auf einem Werkstatt-Tablet einmalig den QR-Ausweis, damit die App künftig gleich in der Werkstatt-Ansicht öffnet.

Danach: Mechaniker-Tablet

Beim Start öffnet die App nicht sofort ein festes Ziel, sondern eine kurze Weiche. Sie sieht nach, ob dieses Gerät an einen Mechaniker gebunden ist: Dann geht es in die Werkstatt-Ansicht (Mechaniker-Tablet), sonst ins Büro-Panel (Büro-CRM (Admin)). Diese Entscheidung muss am Gerät selbst fallen, weil die Bindung nur dort liegt; damit sie nicht sichtbar aufblitzt, läuft sie schon beim Aufbau der Seite und hat einen zweiten Weg als Netz. Die Identität der installierten App bleibt dabei bewusst gleich, auch wenn sich das Ziel ändert — sonst würden bereits installierte Symbole auf den Tablets zu Waisen. Im Hintergrund meldet sich zusätzlich ein kleiner Dienst im Browser an. Er speichert nichts zwischen, sondern ist die Voraussetzung dafür, dass der Browser die Installation überhaupt anbietet und dass Push-Nachrichten ankommen (Web-Push-Benachrichtigungen, Benachrichtigungen: Push, Aktivitäts-Log & Live-Ansicht). Erkennt er einen alten, nicht mehr antwortenden Vorgänger, räumt er ihn weg und lädt die Seite einmal neu.

  • Der Browser bietet die Installation nicht an → die Seite wurde ohne gesicherte Verbindung geöffnet oder der Hintergrunddienst konnte sich nicht anmelden; Seite neu laden.
  • Die App öffnet auf einem Werkstatt-Tablet das Büro-Panel → die Gerätebindung fehlt oder wurde gelöscht; über den Kurzbefehl „Mechaniker" öffnen und den Ausweis neu scannen.
  • Die App lädt beim Start einmal von selbst neu → ein alter Hintergrunddienst wurde ersetzt; das passiert je Gerät einmal.
  • Die Weiche bleibt hängen und zeigt nur „KFZ Bozo wird geöffnet…" → das Skript wurde blockiert; nach kurzer Zeit greift der zweite Weg und schickt ins Büro-Panel.
Gehört zuGehört zuGehört zuBrauchtPWA / Inst…Büro-CRM (Admi…Mechaniker-Tab…KundenportalWeb-Push-Benac…
  • Für das Kundenportal ist keine Installation vorgesehen; die Verknüpfung im Frontmatter meint die gemeinsame technische Grundlage, nicht ein Kunden-App-Symbol (zu prüfen, ob die Verknüpfung so bleiben soll).
  • app/manifest.ts
  • app/start/page.tsx
  • components/StartRouter.tsx
  • components/admin/ServiceWorkerRegister.tsx
start_url/start
id/admin (App-Identität bleibt fix, nur Ziel wandert)

Beleg: app/manifest.ts vorhanden mit vollständiger Icon/Shortcut-Konfiguration; app/start/page.tsx implementiert die Geräte-Weiche

Apps & ZugängeSeite bearbeiten: wiki/seiten/apps-zugaenge/feat-pwa-manifest.md