Rječnik pojmova
Riječi koje sustav rabi svaki dan, objašnjene običnim jezikom: vožnja, ponuda, smjena, zona, cjenik, modul i ostalo.
Kad svi rabe iste riječi za iste stvari, manje je nesporazuma — između vozača, dispečera, knjigovodstva i platforme. Ove riječi vrijede u cijeloj tvrtki.
| Pojam | Znači |
|---|---|
| Tvrtka (tenant) | Pravni subjekt koji radi pod svojim brendom; ima svoje podatke, cijene i aplikacije |
| Slug | Kratki strojni naziv tvrtke (npr. taxi-a); trajan, dio adrese i identiteta aplikacije |
| Platforma | Vlasnik sustava: otvara tvrtke, uključuje module, naplaćuje i nadzire |
| Modul | Skupina značajki uključena za jednu tvrtku (core.* uvijek, addon.* uz naknadu) |
| Vožnja | Narudžba od preuzimanja do odredišta, s brojem R-… i poviješću statusa |
| Status | Stanje vožnje: REQUESTED, OFFERED, ASSIGNED, ACCEPTED, ARRIVING, ARRIVED, IN_PROGRESS, COMPLETED, CANCELLED, NO_SHOW, FAILED |
| Ponuda | Vožnja poslana vozaču na prihvat, s rokom; istek šalje ponudu dalje |
| Dodjela | Postupak kojim vožnja dobiva vozača — automatski po pravilima ili ručno |
| Smjena | Razdoblje u kojem je vozač na dužnosti i prima ponude |
| Čekanje | Vrijeme od dolaska vozača do ulaska putnika; ulazi u cijenu po pravilima tvrtke |
| Zona | Područje na karti s dozvolom i područjem preuzimanja; potražnja u zoni diže množitelj samo za tu zonu |
| Cjenik | Start, kilometar, vrijeme, množitelj i pravila po vrsti usluge |
| Najviša cijena | Iznos koji putnik vidi prije potvrde; konačna cijena može biti niža, nikad viša |
| Kapija spremnosti | 12 provjera bez kojih tvrtka ne može primati vožnje (errors.launchNotReady) |
| Brend studio | Mjesto u konzoli tvrtke gdje se mijenjaju naziv, boja, logo i slogan |
| Brend u aplikaciji | Podaci koje aplikacija dohvati pri pokretanju — vrijede bez nove verzije |
| API ključ | Tajna koja pripada tvrtki i nosi opsege (read, rides, book…) |
| Webhook | Zahtjev koji naš poslužitelj šalje vašem kad se vožnja promijeni; potpisan HMAC-om |
| Revizija | Zapis tko je što promijenio, kada i odakle |
| RLS | Pravilo u bazi koje pušta samo retke vlastite tvrtke, i kad bi kod pogriješio |
Ako se pojam ne slažeSučelja se prevode na hrvatski, engleski, slovenski i njemački. Ako u prijevodu nešto zvuči drukčije od ovog rječnika, mjerodavan je hrvatski izvornik i kod u API-ju (
errors.*, statusi, kodovi modula).