Begriffe

Jede Überschrift erklärt ein Wort aus dem Panel. Der ?-Knopf im Panel führt zu einer dieser Überschriften.

ETA-Fenster

Der Kunde sieht eine Minutenspanne, keine einzelne Minute. Je sicherer das GPS und langsamer der Verkehr, desto enger das Fenster. Eine Zahl auf der Tracking-Seite würde eine Genauigkeit vortäuschen, die es nicht gibt, und den Kunden beunruhigen, wenn sich die Minute verschiebt.

Ein API-Angebot (POST /api/v1/quotes) gibt dasselbe als minMinutes und maxMinutes zurück, mit guaranteed: false. Ein Partner, der eine Zahl zeigt, verändert den Sinn des ETA-Fensters, nicht nur sein Aussehen.

flowchart TD
  q["API-Zitat, bevor es eine Bestellung gibt"] --> sum["Vorbereitung + Laden + Fahrt + Puffer"]
  sum --> win["Minutenfenster, guaranteed false"]
  live["Bestellung unterwegs"] --> need{"GPS-Position und Punkt B"}
  need -->|"eines fehlt"| none["Kein ETA, Seite lebt"]
  need -->|"beide da"| route{"Google-Route"}
  route -->|"Schlüssel und Antwort"| road["Fahrzeit"]
  route -->|"fehlt oder Fehler"| hav["Gerade Linie"]
  road --> shown["Kunde sieht ein Fenster, nicht eine Minute"]
  hav --> shown

ETA live auf /o/… erscheint nur, wenn die Bestellung unterwegs ist und wir die Fahrerposition und Punkt B kennen. Fehlt etwas, funktioniert die Seite weiter, nur ohne Fenster.

Ohne Flotte gibt es gar kein Fenster: Die Tracking-Seite zeigt dann nur den Status. Siehe Tracking-Link.

Planlimits

Jeder Plan hat ein Limit für Fahrzeuge, Fahrer und Teammitglieder. Ist das Limit erreicht, kannst du keinen neuen Eintrag hinzufügen, bis du den Plan wechselst oder einen Platz freigibst. Das ist kein Formularfehler, sondern eine Berechtigung der Firma.

Die Meldung im Panel sagt, welches Limit du erreicht hast. Der ?-Knopf beim Plan führt hierher, nicht zur Preisliste.

Tracking-Link

Die Adresse /o/… (kurze Bestell-ID) funktioniert, solange die Bestellung im System ist. Die Adresse liegt auf dem Firmen-Host: id.delieta.pl/o/…, oder — auf Pro — auf eigenem Host nach CNAME. Nach der Lieferung öffnet sich die Seite als abgeschlossen, nicht als Fehler 404. Wer den Link kennt, sieht diese Lieferung, aber die Seite zeigt weder Namen noch Telefon oder Adresse des Kunden.

Der Link hat zwei Varianten. Mit Flotte zeigt er Karte, Fahrer und ETA-Fenster. Ohne Flotte — oder bei Selbstabholung, wo niemand fährt — zeigt er nur den Status: die Bestellschritte und den Firmennamen. Fahrerposition und Zieladresse erreichen die Seite gar nicht, es gibt also nichts offenzulegen. Siehe Tracking-Seite.

Die Adresse einer anderen Firma mit deinem Code zeigt nichts. Der alte Link auf delieta.pl/o/… funktioniert weiter.

Das ist nicht der Fahrer-Token. Du kopierst den Link von der Bestellkarte. Wie im Panel: Wie man einen Tracking-Link sendet. Der Partner bekommt dieselbe URL als trackingUrl in der 201. DNS: Tracking-Domain.

Fahrer-GPS

Das Fahrertelefon sendet seine Position mit einem drv_…-Schlüssel. Bis zum ersten Signal zeigt die Flotte „Wartet auf GPS“. Das erste Signal ist ein wichtiger Moment, kein technisches Detail.

Der Schlüssel bleibt auf dem Telefon. Das Ersetzen des Schlüssels macht die alte Adresse ungültig. Sende drv_… nicht an den Kunden — der Kunde bekommt den Tracking-Link.

Tracking-Token

Das Tracking-Token ist derselbe drv_…-Schlüssel auf dem Fahrertelefon. Diesen Namen verwenden wir im Code und auf dem Bildschirm zum Verbinden des Telefons. Es ist keine Bestell-ID, öffnet nicht /o/…, ist kein Panel-Passwort.

Das sind zwei verschiedene Token: drv_… bezeichnet den Fahrer, /o/{shortId} eine Lieferung. Eine Verwechslung würde den Standort des Fahrers Personen zeigen, die nur eine Lieferung sehen sollten.

flowchart LR
  drv["drv_-Schlüssel auf dem Fahrertelefon"] --> gps["Position und Auftrag des Fahrers"]
  page["/o/-Seite plus Kurzcode"] --> glance["eine Lieferung ohne Name und Telefon"]
  drv -.->|"öffnet nicht"| glance
  page -.->|"steuert nicht"| gps

Alarm-Dringlichkeit

Die Farbe sagt, wie dringend ein Alarm ist. Sie bedeutet nicht, ob der Alarm gelesen oder gelöst wurde.

• Dringend (rot): passiert jetzt.
• Risiko (bernstein): bald zu spät — Ankunft verfehlt das ETA-Fenster.
• Betrieblich (grau): in dieser Schicht zu erledigen — ein Fahrer im Leerlauf, ein schwacher Akku, eine Warteschlange ohne Zuweisung.

Bestätigen, schlummern und lösen sind drei getrennte Aktionen. Ein gelesener grauer Alarm bleibt betrieblich, bis jemand ihn schließt.

Mandant

Ein Mandant ist eine Firma: Pizzeria, Blumenladen, Service. Personenkonto und Firma sind nicht dasselbe.

Daten sind zwischen Firmen getrennt, nicht zwischen Rollen. Ein Mitglied von Firma A sieht die Daten von Firma B nicht. Innerhalb der Firma hat jeder Eingeladene vollen Betriebszugriff; Rolle ist ein Label.

Die Partner-API nimmt keinen Firmennamen im Body. Der Schlüssel dlt_live_… bezeichnet selbst die Firma.

flowchart LR
  session["Panel: angemeldete Sitzung"] --> doorA["Firmentür"]
  key["Partner: Bearer dlt_live"] --> doorB["Firmentür"]
  doorA --> co["Firma A"]
  doorB --> co
  co -.-> miss["Firma B existiert für diesen Aufruf nicht"]
  pub["Veröffentlichbarer Schlüssel"] -->|"nur catalog:read"| menu["GET /menu"]
  role["Mitgliederrolle"] -.->|"Label, kein Tor"| co

Modul

Ein Modul ist ein Satz von Bildschirmen und Funktionen, den eine Firma hat oder nicht hat: Shop, Flotte, Reservierungen, Catering, Übersetzungen, Online-Zahlungen. Shop und Flotte sind die Pfade, der Rest sind Add-ons, die den Shop brauchen.

Ein Modul ist nur an, wenn drei Bedingungen zugleich gelten: Das Abo deckt es ab, der Schalter des Inhabers unter Einstellungen → Module ist an, und die Module, die es braucht, laufen auch. Ein ausgeschaltetes Modul verschwindet aus dem Menü, seine Daten bleiben. Vollständige Beschreibung: Module und Abo.

flowchart LR
  plan["Abo deckt das Modul ab"] --> on{"Alle drei zugleich"}
  sw["Schalter des Inhabers an"] --> on
  need["Benoetigte Module laufen"] --> on
  on -->|"ja"| shown["Modul im Menue und auf dem Dashboard"]
  on -->|"nein"| hidden["Weg aus dem Menue, Daten bleiben"]

Berechtigung

Eine Berechtigung ist alles, was der Plan der Firma erlaubt: Limits (Fahrzeuge, Fahrer, Mitglieder) und Funktionen (Live-Tracking, Analytik, White-Label-Bereitschaft sowie die Shop-Funktionen: Bestellungen, Reservierungen und Catering). Ohne Berechtigung siehst du keinen deaktivierten Knopf, denn die Funktion ist einfach nicht da. Eine Berechtigung ist nur die erste der drei Bedingungen eines Moduls.

Live-Tracking ist in Starter, Growth und Pro. Analytik ist in den höheren Plänen. Eine eigene Domain funktioniert im Plan Pro: Du richtest sie unter Einstellungen → Für Entwickler in der Domain-Karte ein, Schritt für Schritt in der Tracking-Domain. Die anderen Karten in den Integrationen beschreiben Schlüssel und Lokaladresse.

Der ?-Knopf neben den Planlimits führt zu den Limits; „Berechtigung“ ist das weitere Wort, das auch Funktionen umfasst, nicht nur Limits. Aktuelle Limits und Preise: Einstellungen → Abo.

Tour

Eine Tour (engl. run) ist der aktuelle Kurs des Fahrers: die Stopps, die er jetzt bedient, in Reihenfolge. Auf der Fahrerkarte steht sie als „Aktuelle Tour“. Eine leere Tour heißt: Der Fahrer hat Schicht, aber ihm ist nichts zugewiesen — ein anderer Zustand als fehlendes GPS.

Eine Tour ist keine Bestellung. Der öffentliche Tracking-Link gehört immer zu einer Bestellung, nicht zur ganzen Tour.