Pojęcia

Każdy nagłówek wyjaśnia jedno słowo z panelu. Przycisk ? w panelu prowadzi do jednego z tych nagłówków.

Okno ETA

Klient widzi przedział minut, nie pojedynczą minutę. Im pewniejszy sygnał GPS i wolniejszy ruch, tym węższe okno. Jedna liczba na stronie śledzenia sugerowałaby dokładność, której nie ma, i niepokoiłaby klienta, gdy minuta się przesunie.

Wycena z API (POST /api/v1/quotes) zwraca to samo jako minMinutes i maxMinutes, z guaranteed: false. Partner, który pokazuje jedną liczbę, zmienia sens okna ETA, a nie tylko jego wygląd.

flowchart TD
  q["Wycena z API, zanim jest zamowienie"] --> sum["przygotowanie + zaladunek + dojazd + zapas"]
  sum --> win["Okno minut, guaranteed false"]
  live["Zamowienie w drodze"] --> need{"pozycja GPS i punkt B"}
  need -->|"brak ktoregos"| none["Bez ETA, strona zyje"]
  need -->|"oba sa"| route{"Trasa Google"}
  route -->|"jest klucz i odpowiedz"| road["Czas drogi"]
  route -->|"brak albo blad"| hav["Linia prosta"]
  road --> shown["Klient widzi okno, nie jedna minute"]
  hav --> shown

ETA na żywo na /o/… pojawia się tylko wtedy, gdy zamówienie jest w drodze i znamy pozycję kierowcy oraz punkt B. Jeśli czegoś brakuje, strona działa dalej, tylko bez okna.

Bez Floty okna nie ma wcale: strona śledzenia pokazuje wtedy sam status. Zobacz Link śledzenia.

Limity planu

Każdy plan ma limit pojazdów, kierowców i członków zespołu. Po osiągnięciu limitu nie dodasz nowego wpisu, dopóki nie zmienisz planu albo nie zwolnisz miejsca. To nie błąd formularza, tylko uprawnienie firmy.

Komunikat w panelu mówi, który limit został osiągnięty. Przycisk ? przy planie prowadzi tutaj, a nie do cennika.

Link śledzenia

Adres /o/… (krótki kod zamówienia) działa, dopóki zamówienie jest w systemie. Adres jest na hoście firmy: identyfikator.delieta.pl/o/…, albo — na planie Pro — na własnym hoście po CNAME. Po dostawie strona otwiera się jako zakończona, a nie jako błąd 404. Kto zna link, widzi tę dostawę, ale strona nie ujawnia imienia, telefonu ani adresu klienta.

Link ma dwa warianty. Z Flotą pokazuje mapę, kierowcę i okno ETA. Bez Floty — albo przy odbiorze osobistym, gdzie nikt nie jedzie — pokazuje sam status: kroki zamówienia i nazwę firmy. Pozycja kierowcy i adres docelowy w ogóle nie trafiają wtedy na stronę, więc nie ma czego odsłonić. Zobacz Strona śledzenia.

Adres innej firmy z Twoim kodem nic nie pokazuje. Stary link na delieta.pl/o/… nadal działa.

To nie jest token kierowcy. Link kopiujesz z karty zamówienia i wysyłasz odbiorcy. Jak to zrobić w panelu: Jak wysłać link śledzenia. Partner dostaje ten sam URL jako trackingUrl w odpowiedzi 201. DNS i diagnostyka: Domena śledzenia.

GPS kierowcy

Telefon kierowcy wysyła pozycję z użyciem klucza drv_…. Dopóki nie ma pierwszego sygnału, flota pokazuje „Czeka na GPS”. Pierwszy sygnał to ważny moment, a nie techniczny szczegół.

Klucz zostaje na telefonie. Wymiana klucza unieważnia stary adres. Nie wysyłaj drv_… klientowi — klient dostaje link śledzenia.

Token śledzenia

Token śledzenia to ten sam klucz drv_… na telefonie kierowcy. Tej nazwy używamy w kodzie i na ekranie podłączania telefonu. Nie jest identyfikatorem zamówienia, nie otwiera /o/…, nie działa jako hasło do panelu.

To dwa różne tokeny: drv_… wskazuje kierowcę, a /o/{shortId} jedną dostawę. Pomyłka ujawniłaby lokalizację kierowcy osobom, które miały zobaczyć tylko jedną dostawę.

flowchart LR
  drv["klucz drv_ na telefonie kierowcy"] --> gps["pozycja i zadanie kierowcy"]
  page["strona /o/ plus krotki kod"] --> glance["jedna dostawa bez imienia i telefonu"]
  drv -.->|"nie otwiera"| glance
  page -.->|"nie steruje"| gps

Ważność alertu

Kolor mówi, jak pilny jest alert. Nie oznacza, czy alert przeczytano albo rozwiązano.

• Pilne (czerwony): dzieje się teraz — kierowca zniknął z mapy albo sam zgłasza problem.
• Ryzyko (bursztyn): zaraz będzie za późno — dojazd minie obiecane okno ETA.
• Operacyjne (szary): do załatwienia w tej zmianie — bezczynny kierowca, słaba bateria, kolejka bez przypisania.

Potwierdzenie, drzemka i rozwiązanie to trzy osobne działania. Przeczytany szary alert nadal jest operacyjny, dopóki ktoś go nie zamknie.

Najemca

Najemca to firma: pizzeria, kwiaciarnia, serwis. Konto osoby i firma to nie to samo — jedna osoba może być zaproszona, firma ma plan, flotę i produkty.

Dane są oddzielone między firmami, a nie między rolami. Członek firmy A nie widzi danych firmy B. Wewnątrz firmy każdy zaproszony ma pełny dostęp operacyjny; rola jest etykietą.

Partner API nie przyjmuje nazwy firmy w body. Klucz dlt_live_… sam wskazuje firmę.

flowchart LR
  session["Panel: sesja zalogowanego"] --> doorA["Drzwi firmy"]
  key["Partner: Bearer dlt_live"] --> doorB["Drzwi firmy"]
  doorA --> co["Firma A"]
  doorB --> co
  co -.-> miss["Firma B nie istnieje dla tego wywolania"]
  pub["Klucz publikowalny"] -->|"tylko catalog:read"| menu["GET /menu"]
  role["Rola czlonka"] -.->|"etykieta, nie bramka"| co

Moduł

Moduł to zestaw ekranów i funkcji, który firma ma albo nie ma: Sklep, Flota, Rezerwacje, Catering, Tłumaczenia, Płatności online. Sklep i Flota to ścieżki, reszta to dodatki, które wymagają Sklepu.

Moduł jest włączony tylko wtedy, gdy są spełnione trzy warunki naraz: abonament go obejmuje, przełącznik właściciela w Ustawienia → Moduły jest włączony i moduły, których potrzebuje, też działają. Wyłączony moduł znika z menu, a jego dane zostają. Pełny opis: Moduły i abonament.

flowchart LR
  plan["Abonament obejmuje modul"] --> on{"Wszystkie trzy naraz"}
  sw["Przelacznik wlasciciela wlaczony"] --> on
  need["Wymagane moduly dzialaja"] --> on
  on -->|"tak"| shown["Modul w menu i na Pulpicie"]
  on -->|"nie"| hidden["Znika z menu, dane zostaja"]

Uprawnienie

Uprawnienie to wszystko, na co plan pozwala firmie: limity (pojazdy, kierowcy, członkowie) i funkcje (śledzenie na żywo, analityka, gotowość white-label oraz cechy sklepu: zamówienia, rezerwacje i catering). Bez uprawnienia nie zobaczysz wyłączonego przycisku, bo funkcji po prostu nie ma. Uprawnienie to tylko pierwszy z trzech warunków modułu.

Śledzenie na żywo jest w Starter, Growth i Pro. Analityka jest w wyższych planach. Własna domena działa w planie Pro: konfigurujesz ją w Ustawienia → Dla programistów w karcie z domeną, krok po kroku w Domenie śledzenia. Inne karty w Integracjach opisują klucze i adres lokalu.

Przycisk ? przy limitach planu prowadzi do limitów; „uprawnienie” to szersze słowo, które obejmuje też funkcje, a nie tylko limity. Aktualne limity i ceny: Ustawienia → Abonament.

Tura

Tura (ang. run) to bieżący kurs kierowcy: kolejne przystanki, które teraz obsługuje. Na karcie kierowcy widać ją jako „Bieżąca tura”. Pusta tura znaczy, że kierowca jest na zmianie, ale nic mu nie przypisano — to inny stan niż brak GPS.

Tura nie jest zamówieniem. Zamówienie może czekać w kuchni bez tury; tura może mieć kilka zamówień. Publiczny link śledzenia zawsze należy do jednego zamówienia, nie do całej tury.