Š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 je | Primjer |
|---|---|---|
| Platforma | Vlasnik sustava: tvrtke, paketi, moduli, naplata, nadzor, dizajn sustav | Driveos |
| Tvrtka (tenant) | Taksi udruženje ili prijevoznik s vlastitim brendom i podacima | DEMO-TAXI, slug taxi-a |
| Ljudi i imovina | Vlasnik, dispečer, operater, vozači, vozila, putnici | vozač 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:
- Aplikacijska provjera — sesija nosi tvrtku korisnika; upitnik nikad ne prima
tenantIdiz zahtjeva, nego ga uzima iz sesije. - RLS u bazi — PostgreSQL Row Level Security pušta samo retke te tvrtke, pa i greška u kodu ostaje unutar tvrtke.
- Ključ API-ja pripada jednoj tvrtki — isti princip za server-server pristup; nema parametra kojim se bira tvrtka.
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
| Stvar | Vlasnik | Što to znači |
|---|---|---|
| Podaci o vožnjama, vozačima, putnicima | Tvrtka | Nikad se ne miješaju između tvrtki |
| Brend: naziv, boja, logo, ikona aplikacije | Tvrtka | Uređuje se u Brend studiju konzole tvrtke |
| Aplikacije u trgovinama | Tvrtka | Tvrtka je izdavač; računi u trgovinama su njezini |
| Slug tvrtke | Tvrtka, trajno | Određuje adresu i identitet aplikacije; ne mijenja se nakon objave |
| Cjenik, zone, pravila vožnje | Tvrtka | Cijena se računa na poslužitelju, ne u aplikaciji |
| Uvjeti i privatnost | Tvrtka | Tekstove popunjava tvrtka; platforma daje predložak |
| Sustav, moduli, naplata platforme | Platforma | Modul 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.
| Podatak | Gdje se vidi | Mijenja li se bez nove gradnje |
|---|---|---|
| Prikazni naziv | Zaglavlja aplikacija, računi, obavijesti | Da |
| Boja brenda | Gumbi, oznake, karta, elementi sučelja | Da |
| Logo i ikona | Prijava, zaglavlja, ikona u trgovini | Da, osim ikone u trgovini |
| Naziv aplikacije ispod ikone | Početni ekran telefona | Ne — traži novu gradnju i objavu |
| Paket aplikacije (bundle ID) | Trgovine, push, duboke poveznice | Ne — trajno |
Uloge i prava
| Uloga | Razina | Što smije |
|---|---|---|
OWNER | Tvrtka | Sve u tvrtki, uključujući brend, korisnike, objavu u trgovinama i račune |
DISPATCHER | Tvrtka | Vožnje, dispečerska ploča, karta, dodjela vozača |
OPERATOR | Tvrtka | Telefonske narudžbe i pozivni centar |
ACCOUNTANT | Tvrtka | Novac: izvještaji, plaćanja, obračun |
SUPER_ADMIN, ADMIN, SUPPORT | Platforma | Tvrtke, 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.
{
"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.