Begriffe

Der ?-Helfer im Panel sagt „siehe Begriff“ und landet auf einer dieser Überschriften. Jede Überschrift ist ein Wort aus der UI, kein Architekturkapitel.

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äre falsche Präzision.

Ein API-Zitat (POST /api/v1/quotes) gibt dasselbe als minMinutes und maxMinutes zurück, mit guaranteed: false. Ein Partner, der eine Zahl zeigt, bricht den Begriff, nicht nur das Mock.

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

Lebendes ETA auf /o/… gibt es nur, wenn die Bestellung unterwegs ist, es eine Fahrerposition gibt und Punkt B.

Planlimits

Jeder Plan hat eine Decke für Fahrzeuge, Fahrer und Mitglieder. Nach der Decke speichert eine neue Zeile nicht, bis du den Plan wechselst oder einen Platz freigibst. Das ist kein Feldvalidierungsfehler — das ist eine Berechtigung der Firma.

Die Meldung im Panel sagt, welche Decke du getroffen hast.

Tracking-Link

Die Adresse /o/… (kurze Bestell-ID) funktioniert, solange die Bestellung im System ist. In Produktion auf dem Firmen-Host: id.delieta.pl/o/…, oder — auf Pro — auf eigenem Host nach CNAME. Nach der Lieferung öffnet sie sich als abgeschlossen, nicht als 404.

Der Host 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 Position auf einem drv_…-Schlüssel. Bis zum ersten Signal zeigt die Flotte „Wartet auf GPS“. Der erste Ping ist ein Meilenstein.

Der Schlüssel bleibt auf dem Telefon. Rotation macht die alte Adresse ungültig. Klebe drv_… nicht dem Kunden — der Kunde hat den Tracking-Link.

Tracking-Token

Das Tracking-Token ist derselbe drv_…-Schlüssel auf dem Fahrertelefon. Name im Code und auf dem Enrolment-Bildschirm. Es ist keine Bestell-ID, öffnet nicht /o/…, ist kein Panel-Passwort.

Zwei Token, zwei Welten: drv_… sagt „dieser Mensch ist hier“; /o/{shortId} sagt „diese Pizza ist hier“.

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

Farbe sagt, wie dringend. Das ist kein Lesestatus und keine Lösung.

• Dringend (rot): passiert jetzt.
• Risiko (bernstein): bald zu spät — Ankunft verfehlt das ETA-Fenster.
• Betrieblich (grau): in dieser Schicht klären.

Bestätigen, schlummern und lösen sind getrennte Verben.

Mandant

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

Isolation liegt auf der Firma, nicht auf der Rolle. Ein Mitglied von Firma A liest Firma B nicht. Innerhalb der Firma hat jeder Eingeladene vollen Betriebszugriff; Rolle ist ein Label.

Die Partner-API nimmt keinen Mandantennamen im Body. Der Schlüssel dlt_live_… ist 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

Berechtigung

Eine Berechtigung ist, was der Plan der Firma erlaubt: Decken (Fahrzeuge, Fahrer, Mitglieder) und Flaggen (Live-Tracking, Analytik, White-Label-Bereitschaft). Fehlende Berechtigung rendert keinen deaktivierten Knopf — die Funktion ist nicht da.

Live-Tracking ist in Starter, Growth und Pro. Analytik kommt höher. Eigene Domain ist als Pro-Bereitschaft vermerkt, nicht als arbeitende Karte in Integrationen.

Der Helfer neben Planlimits führt zu Limits.

Tour

Eine Tour (engl. run) ist der aktuelle Kurs des Fahrers: geordnete Stopps, die er jetzt trägt. Auf der Fahrerkarte als „Aktuelle Tour“. Eine leere Tour heißt: der Mensch 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.