Driveoskatalog platforme

Uvođenje tvrtke

Od papira do prve vožnje: što treba složiti prije nego tvrtka pusti prvu vožnju, koliko koja faza traje i što se dogodi ako nešto nedostaje.

Uvođenje tvrtke nije jedan klik. Neke stvari traju danima i ovise o drugima — banka, porezna, tiskara, trgovine s aplikacijama. Zato je redoslijed važan: tehnički dio traje jedan do tri dana, a papiri i trgovine idu paralelno i traju tjednima.

Faza 0 blokira sve ostaloSlug tvrtke i paket aplikacije (bundle id) donose se prije otvaranja tvrtke. Slug se poslije ne mijenja jer ulazi u adresu, identitet aplikacije i duboke poveznice; promjena bi značila novu aplikaciju u trgovini.

Faze u pregledu

FazaŠto se radiTrajanjeTko
0Odluke: slug, pravni naziv, paket aplikacije, država, valuta30 minTvrtka + platforma
1Pravni minimum: OIB, žiro račun, fiskalni certifikat, uvjeti i privatnost5–15 radnih danaTvrtka
2Otvaranje tvrtke (radi platforma)15 minPlatforma
3Kapija „spremno za pogon" — 12 provjera1–2 hVlasnik tvrtke
4Ljudi, flota, dokumenti1–3 danaDispečer
5Novac: cjenik, zone, načini plaćanja, fiskalizacija1 dan + vanjski rokoviVlasnik
6Brend za aplikacije2–4 hVlasnik
7Gradnja aplikacija (Android, iOS)2–4 h prvi putPlatforma
8Google Play: račun, popis, testiranje, objava2–6 tjedanaTvrtka
9Apple App Store — paralelno, isti papiri1–3 tjednaTvrtka
10Pilot i puštanje u rad1–2 tjednaSvi

Otvaranje tvrtke u sustavu

  1. Otvaranje tvrtke radi platforma: slug, puni i prikazni naziv, e-mail, OIB, država, paket, e-mail i ime vlasnika.
  2. Konzola jednom pokaže privremenu lozinku vlasnika. Predaje se sigurnim kanalom, nikada e-poštom u čistom tekstu.
  3. Vlasnik otvori /company/, prijavi se i mora postaviti novu lozinku (najmanje 12 znakova).
  4. U Profil tvrtke upiše adresu, kontakt i pravne podatke; u Brend studio naziv i boju brenda.

Time se automatski dobiva probni period iz paketa, osnovni moduli, račun vlasnika s ulogom OWNER i zapis u reviziji. Za objavu u trgovinama mora biti uključen modul addon.store_launch_support — bez njega se panel Objava u trgovinama ne otvara, a vidi ga samo vlasnik.

Kapija „spremno za pogon"

Dok nešto nedostaje, otvaranje smjene i stvaranje vožnje vraćaju 400 s kodom errors.launchNotReady i popisom praznina. Kapija nije birokracija — bez cjenika ili aktivnog vozača vožnja ne može nastati ispravno.

#ProvjeraTočno značiGdje se ispunjavaBlokira
1companyProfilepravni naziv, adresa, grad, e-mailProfil tvrtkeda
2brandnaziv i boja brendaBrend studioda
3legalDocspopunjeni uvjeti i privatnostProfil tvrtkeda
4serviceTypesbarem jedna vrsta uslugeCijeneda
5ratessvaka vrsta ima cjenikCijeneda
6paymentMethodssvaka vrsta ima način plaćanjaCijeneda
7zonesbarem jedna zonaZonene (kapija)
8driversbarem jedan aktivan vozačFlotada
9vehiclesbarem jedno aktivirano voziloFlotada
10serviceArearadijus preuzimanjaProfil tvrtke / Zoneda
11invoicinguključen barem jedan kanal izdavanjaFiskalizacija / Obračunda
12fiscalHR: certifikat, OIB, prostor i uređaj, operater, način ProizvodnjaFiskalizacijada, tvrdo
Iznimka postoji, ali nije putPlatforma može privremeno pustiti tvrtku („Prisilno osposobi tvrtku") uz razlog i datum do kojeg vrijedi. Kad datum prođe, blokada se vraća sama. Služi za pilot i migraciju, ne za redovan rad.

Brend i gradnja aplikacija

Brend se uređuje u Brend studiju (Tvrtka → Brend i aplikacije). Čarobnjak pokazuje stvarne ekrane obje aplikacije s novim bojama prije spremanja, a naziv, boja, logo i slogan vrijede odmah — bez nove verzije, jer ih aplikacija dohvaća pri pokretanju.

Gradnja aplikacija ide jednom skriptom, s profilom tvrtke izvan repozitorija (Apple Team ID, keystore, Firebase, paketi):

bashgradnja obje aplikacije za tvrtku DEMO-TAXI
# provjeri alate i ispiši sve nedostatke odjednom
node tools/build-apps.mjs --slug taxi-a --mode release --bundle --check

# Android (AAB za Play) i iOS (IPA za App Store)
node tools/build-apps.mjs --slug taxi-a --mode release --bundle

# brza probna gradnja za uređaj
node tools/build-apps.mjs --slug taxi-a --app driver --platform ios --mode debug

Artefakti idu u dist/taxi-a/, a logovi u build-logs/. Skripta prije gradnje provjeri Flutter, JDK 17, Android SDK, Firebase konfiguraciju, potpis i Apple Team te ispiše sve greške odjednom, umjesto da stane na prvoj.

Trgovine: što stvarno traži

  • Google Play: račun otvara tvrtka (ne platforma), uz DUNS ili OIB podatke; aplikacija prolazi testiranje sa zatvorenim kanalom prije javne objave.
  • Apple: isti papiri, plus godišnje članstvo; recenzija traži objašnjenje lokacije u pozadini (vozačka aplikacija) i razlog pristupa lokaciji.
  • Popis u trgovini: ikona, snimke zaslona po veličinama, opis, kategorija, politika privatnosti na javnoj adresi.
  • Nakon objave: verzija se diže samo kad se mijenja ponašanje aplikacije. Brend, cijene i sadržaj u aplikaciji ne traže novu objavu.
Najčešći razlog odbijanjaAplikacija koja traži dopuštenje bez objašnjenja u samom sučelju (lokacija uvijek, obavijesti, kamera). Svako dopuštenje ima tekst na jeziku tvrtke i objašnjenje u trenutku traženja.

Kontrolna lista prije prve vožnje

  • Kapija spremnosti je zelena (12/12) ili je iznimka zapisana s datumom.
  • Cjenik pokriva sve vrste usluge, uključujući međuzonske fiksne cijene ako ih tvrtka ima.
  • Barem jedan vozač ima aktivnu smjenu, a vozilo je aktivirano i ima važeće dokumente.
  • Uvjeti i privatnost su objavljeni na adresi tvrtke, a poveznice rade iz obje aplikacije.
  • Probna vožnja prošla je cijeli krug: narudžba → dodjela → preuzimanje → završetak → račun.
  • Fiskalni račun izdan je u načinu Proizvodnja i vidljiv je u obračunu.