Driveoskatalog platforme

Što je čije: tvrtka, platforma i podaci

Zašto jedna platforma može držati više tvrtki i što od svega pripada tvrtki, a što platformi. Objašnjeno bez tehničkih riječi, na primjeru DEMO-TAXI.

Zamislite zgradu s više stanova. Zgrada je platforma: struja, voda, lift i krov zajednički su i njima se nitko posebno ne bavi. Stan je tvrtka: u njemu se živi, uređuje se po svom ukusu i plaća se najam. Susjed ne ulazi u vaš stan, a vi ne dirate njegov namještaj.

RazinaŠto jePrimjer
PlatformaVlasnik sustava: tvrtke, paketi, moduli, naplata, nadzor, dizajn sustavDriveos
Tvrtka (tenant)Taksi udruženje ili prijevoznik s vlastitim brendom i podacimaDEMO-TAXI, slug taxi-a
Ljudi i imovinaVlasnik, dispečer, operater, vozači, vozila, putnicivozač D-014, vozilo ZG-1234-AB

Izolacija između tvrtki

Sve tvrtke dijele jednu bazu, ali ne dijele podatke. Svaki zapis koji pripada tvrtki nosi tenantId, a pristup je ograničen na dvije razine:

  1. Aplikacijska provjera — sesija nosi tvrtku korisnika; upitnik nikad ne prima tenantId iz zahtjeva, nego ga uzima iz sesije.
  2. RLS u bazi — PostgreSQL Row Level Security pušta samo retke te tvrtke, pa i greška u kodu ostaje unutar tvrtke.
  3. Ključ API-ja pripada jednoj tvrtki — isti princip za server-server pristup; nema parametra kojim se bira tvrtka.
Provjereno, ne pretpostavljenoIzolaciju mjere namjenske provjere (node web/tests/run.mjs skupine company-isolation-check, platform-tenant-check, api-permissions-check): pokušaj čitanja tuđeg zapisa mora vratiti 404, ne 403.

Što je čije

StvarVlasnikŠto to znači
Podaci o vožnjama, vozačima, putnicimaTvrtkaNikad se ne miješaju između tvrtki
Brend: naziv, boja, logo, ikona aplikacijeTvrtkaUređuje se u Brend studiju konzole tvrtke
Aplikacije u trgovinamaTvrtkaTvrtka je izdavač; računi u trgovinama su njezini
Slug tvrtkeTvrtka, trajnoOdređuje adresu i identitet aplikacije; ne mijenja se nakon objave
Cjenik, zone, pravila vožnjeTvrtkaCijena se računa na poslužitelju, ne u aplikaciji
Uvjeti i privatnostTvrtkaTekstove popunjava tvrtka; platforma daje predložak
Sustav, moduli, naplata platformePlatformaModul se uključuje po tvrtki; osnovni su uvijek uključeni

Što brend stvarno mijenja

Brend nije samo boja gumba. Iz podataka tvrtke izvode se naziv u aplikacijama, boja i nijanse, logo i ikona, naziv aplikacije na početnom ekranu, adresa praćenja vožnje, potpis u e-pošti i izgled računa.

PodatakGdje se vidiMijenja li se bez nove gradnje
Prikazni nazivZaglavlja aplikacija, računi, obavijestiDa
Boja brendaGumbi, oznake, karta, elementi sučeljaDa
Logo i ikonaPrijava, zaglavlja, ikona u trgoviniDa, osim ikone u trgovini
Naziv aplikacije ispod ikonePočetni ekran telefonaNe — traži novu gradnju i objavu
Paket aplikacije (bundle ID)Trgovine, push, duboke povezniceNe — trajno
Pravilo koje se ne kršiNaziv platforme u aplikaciji smije stajati samo uz broj verzije (npr. „Driveos 1.0.7”), nikad kao naziv proizvoda prema putniku. Putnik vidi tvrtku, ne platformu.

Uloge i prava

UlogaRazinaŠto smije
OWNERTvrtkaSve u tvrtki, uključujući brend, korisnike, objavu u trgovinama i račune
DISPATCHERTvrtkaVožnje, dispečerska ploča, karta, dodjela vozača
OPERATORTvrtkaTelefonske narudžbe i pozivni centar
ACCOUNTANTTvrtkaNovac: izvještaji, plaćanja, obračun
SUPER_ADMIN, ADMIN, SUPPORTPlatformaTvrtke, korisnici, naplata, nadzor — ulaz u podatke vožnji ostaje u reviziji

DEMO-TAXI u primjerima

Svi primjeri, snimke i kod koriste jednu tvrtku: DEMO-TAXI, slug taxi-a, grad Zagreb, valuta EUR, jezik hr. Cjenik ima tri vrste usluge (Standard, Comfort, Start), vozila nose zagrebačke registracije, a vozači imena koja se ne podudaraju sa stvarnim osobama.

jsonGET /api/public/companies/taxi-a — dio odgovora
{
  "company": {
    "slug": "taxi-a",
    "displayName": "DEMO-TAXI",
    "brandName": "DEMO-TAXI",
    "brandTagline": "Vaš grad, vaše ime.",
    "brandColor": "#4B63DD",
    "currencyCode": "EUR",
    "countryCode": "HR",
    "locale": "hr",
    "mapProvider": "MAPBOX",
    "rating": { "average": 4.9, "count": 284 },
    "serviceAreas": [
      { "label": "Zagreb", "center": { "latitude": 45.815, "longitude": 15.9819 }, "radiusMeters": 25000 }
    ]
  },
  "serviceTypes": [
    { "id": "a1", "name": "Standard", "meterMode": "KM", "paymentMethods": ["CASH", "CARD"], "seatCount": 4 },
    { "id": "a2", "name": "Comfort",  "meterMode": "KM", "paymentMethods": ["CASH", "CARD"], "seatCount": 4 },
    { "id": "a3", "name": "Start",    "meterMode": "KM", "paymentMethods": ["CASH", "CARD"], "seatCount": 4 }
  ]
}

Taj odgovor je ulaz u obje aplikacije: prije prijave aplikacija dozna ime, boju, jezik, karte i vrste usluge. Zato promjena brenda u konzoli vrijedi odmah, bez nove verzije aplikacije.