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.
Faze u pregledu
| Faza | Što se radi | Trajanje | Tko |
|---|---|---|---|
| 0 | Odluke: slug, pravni naziv, paket aplikacije, država, valuta | 30 min | Tvrtka + platforma |
| 1 | Pravni minimum: OIB, žiro račun, fiskalni certifikat, uvjeti i privatnost | 5–15 radnih dana | Tvrtka |
| 2 | Otvaranje tvrtke (radi platforma) | 15 min | Platforma |
| 3 | Kapija „spremno za pogon" — 12 provjera | 1–2 h | Vlasnik tvrtke |
| 4 | Ljudi, flota, dokumenti | 1–3 dana | Dispečer |
| 5 | Novac: cjenik, zone, načini plaćanja, fiskalizacija | 1 dan + vanjski rokovi | Vlasnik |
| 6 | Brend za aplikacije | 2–4 h | Vlasnik |
| 7 | Gradnja aplikacija (Android, iOS) | 2–4 h prvi put | Platforma |
| 8 | Google Play: račun, popis, testiranje, objava | 2–6 tjedana | Tvrtka |
| 9 | Apple App Store — paralelno, isti papiri | 1–3 tjedna | Tvrtka |
| 10 | Pilot i puštanje u rad | 1–2 tjedna | Svi |
Otvaranje tvrtke u sustavu
- Otvaranje tvrtke radi platforma: slug, puni i prikazni naziv, e-mail, OIB, država, paket, e-mail i ime vlasnika.
- Konzola jednom pokaže privremenu lozinku vlasnika. Predaje se sigurnim kanalom, nikada e-poštom u čistom tekstu.
- Vlasnik otvori
/company/, prijavi se i mora postaviti novu lozinku (najmanje 12 znakova). - 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.
| # | Provjera | Točno znači | Gdje se ispunjava | Blokira |
|---|---|---|---|---|
| 1 | companyProfile | pravni naziv, adresa, grad, e-mail | Profil tvrtke | da |
| 2 | brand | naziv i boja brenda | Brend studio | da |
| 3 | legalDocs | popunjeni uvjeti i privatnost | Profil tvrtke | da |
| 4 | serviceTypes | barem jedna vrsta usluge | Cijene | da |
| 5 | rates | svaka vrsta ima cjenik | Cijene | da |
| 6 | paymentMethods | svaka vrsta ima način plaćanja | Cijene | da |
| 7 | zones | barem jedna zona | Zone | ne (kapija) |
| 8 | drivers | barem jedan aktivan vozač | Flota | da |
| 9 | vehicles | barem jedno aktivirano vozilo | Flota | da |
| 10 | serviceArea | radijus preuzimanja | Profil tvrtke / Zone | da |
| 11 | invoicing | uključen barem jedan kanal izdavanja | Fiskalizacija / Obračun | da |
| 12 | fiscal | HR: certifikat, OIB, prostor i uređaj, operater, način Proizvodnja | Fiskalizacija | da, tvrdo |
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):
# 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.
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.