Postavljanje mog klijenta
Kratki sažetak
Postavljanje mog klijenta je ruta /my-client za organizacije koje još nemaju associatedClientID. Stranica prikazuje upozorenje i full-page CreateClientWizard koji šalje assignToOrganisation: true.
Najvažnije koristi:
- Novi korisnik može unijeti podatke svoje organizacije prije nastavka rada.
- Backend može povezati kreiranog klijenta s trenutnom organizacijom.
- Nakon uspjeha aplikacija se ponovno učitava i guard može preusmjeriti na klijenta.
Kada koristiti ovu značajku
Koristite postavljanje mog klijenta kada želite:
- dovršiti onboarding organizacije,
- kreirati klijenta koji predstavlja vašu firmu ili obrt,
- riješiti stanje u kojem organizacija nema povezani klijent.
Ova značajka je posebno korisna za:
- vlasnike poslovanja koji prvi put ulaze u aplikaciju,
- administratore novih organizacija,
- podršku koja pomaže korisniku završiti početno postavljanje.
Prije nego što počnete
Prije korištenja provjerite sljedeće:
- prijavljeni ste u organizaciju,
- organizacija nema
associatedClientID, - imate podatke o vlastitoj organizaciji.
Napomena: CheckMissingOrganisationClient automatski vodi korisnika na /my-client kada trenutna organizacija nema povezanog klijenta.
Brzi početak
U ovom primjeru pokazujemo kako završiti setup vlastitog klijenta.
- Otvorite aplikaciju.
- Ako organizacija nema klijenta, aplikacija vas vodi na
/my-client. - Pročitajte poruku upozorenja.
- Ispunite čarobnjak.
- Kliknite Spremi.
- Pričekajte ponovno učitavanje aplikacije.
Nakon toga trebali biste vidjeti: povezani klijent organizacije ili preusmjeravanje na njegovu početnu stranicu.
Detaljne upute
Korak 1: Otvorite setup stranicu
Stranica je skrivena od glavne navigacije (hideNav: true) i prikazuje samo alert i full-page wizard.
Primjer:
/my-clientSnimka zaslona
stranica /my-client s upozorenjem
Alt tekst: Stranica za postavljanje mog klijenta s upozorenjem i čarobnjakom.
Korak 2: Unesite podatke organizacije
Upozorenje kaže da treba unijeti podatke o organizaciji kako biste mogli nastaviti koristiti aplikaciju. Čarobnjak koristi iste korake kao kreiranje klijenta.
Snimka zaslona
full-page čarobnjak na stranici /my-client
Alt tekst: Čarobnjak za unos podataka organizacije na stranici my-client.
Korak 3: Spremite i pričekajte reload
onSuccess poziva window.location.reload(). Backend, ako je assignToOrganisation true, povezuje klijenta s organizacijom.
Primjer iz prakse
Zamislimo da vlasnik obrta prvi put otvara aplikaciju.
Scenarij:
- Korisnik: vlasnik obrta
- Cilj: početi koristiti aplikaciju za vlastiti obrt
- Problem: organizacija još nema povezanog klijenta
- Rješenje:
/my-clienttraži podatke i kreira povezani klijent
Rezultat:
Nakon spremanja, organizacija dobiva klijenta i korisnik može nastaviti u radni prostor.
Showcase: kako značajka izgleda u aplikaciji
Pregled zaslona
Snimka zaslona
full-page onboarding stranica
Što korisnik vidi:
- informativni alert,
- formu preko širine stranice,
- korake osnovnih podataka, računa i kontakata.
Primjer konfiguracije
Snimka zaslona
popunjeni podaci vlastite organizacije
Preporučena konfiguracija za početnike:
| Postavka | Preporučena vrijednost | Zašto je korisna |
|---|---|---|
| Tip firme | Stvarni tip vaše organizacije | Utječe na module |
| OIB | OIB vaše organizacije | Backend ga validira |
| Kontakt | Glavni kontakt | Pomaže kasnijoj administraciji |
Najčešće radnje
Kako doći do setup stranice
- Prijavite se.
- Ako nema povezanog klijenta, guard vas vodi na
/my-client. - Ako već postoji klijent, guard može vratiti na
/client/:id/pocetna.
Kako spremiti vlastitog klijenta
- Ispunite sva tri koraka.
- Kliknite Spremi.
- Pričekajte reload.
Kako nastaviti nakon setupa
- Nakon reloada aplikacija dohvaća trenutnu organizaciju.
- Ako je
associatedClientIDpostavljen, vodi na početnu stranicu klijenta. - Provjerite naziv klijenta u zaglavlju.
Dobre prakse
Za najbolje rezultate:
- unosite podatke točno kako su u službenim registrima,
- koristite javni registar za automatsko popunjavanje,
- dodajte kontakt i bankovni račun ako ih imate,
- ne prekidajte reload nakon spremanja.
Izbjegavajte:
- unos tuđeg klijenta kao vlastite organizacije,
- ručno zaobilaženje
/my-clientkada nema povezanog klijenta, - zatvaranje stranice prije završetka spremanja.
Napredne mogućnosti
Ako trebate više kontrole, možete koristiti:
Guard za missing client
CheckMissingOrganisationClient preusmjerava na /my-client kada je associatedClientID === null.
Assign to organisation
Full-page wizard šalje assignToOrganisation: true, a backend poziva AssignClient za trenutnu organizaciju.
Povratno preusmjeravanje
Ako korisnik ode na /my-client, a organizacija već ima klijenta, guard vodi na /client/{associatedClientID}/pocetna.
Dozvole i pristup
Za korištenje ove značajke potrebne su sljedeće dozvole:
| Radnja | Potrebna uloga/dozvola |
|---|---|
Pregled /my-client | Prijavljeni korisnik |
| Kreiranje povezanog klijenta | Auth i organizacijski pristup |
| Dodjela klijenta organizaciji | Backend assignToOrganisation tok; detaljna uloga [POTREBNO DOPUNITI] |
| Izvoz / dijeljenje | [POTREBNO DOPUNITI] |
Ako ne vidite ovu značajku, moguće je da:
- nemate odgovarajuću dozvolu,
- značajka nije uključena u vašem paketu,
- administrator je ograničio pristup,
- integracija ili modul nije aktiviran.
Ograničenja
Trenutna ograničenja značajke:
- stranica nema vlastitu navigaciju,
- uspjeh pokreće reload umjesto prikaza detaljne potvrde,
- detaljne poruke validacije ovise o čarobnjaku i backend odgovoru.
Rješavanje problema
| Problem | Mogući uzrok | Rješenje |
|---|---|---|
Stalno se vraćate na /my-client | Organizacija nema povezan klijent | Dovršite čarobnjak |
| Nakon spremanja nema promjene | Dodjela organizaciji nije uspjela | Osvježite i kontaktirajte podršku |
Preusmjereni ste s /my-client | Organizacija već ima klijenta | Nastavite na početnoj stranici klijenta |
Česta pitanja
Tko vidi /my-client?
Korisnici čija trenutna organizacija nema povezani associatedClientID, prema guard komponenti.
Je li ovo isto kao dodavanje klijenta iz popisa?
Koristi isti čarobnjak, ali full-page tok šalje assignToOrganisation: true i povezuje klijenta s organizacijom.
Što ako sam računovodstveni ured s više klijenata?
Ova stranica je namijenjena missing-client setupu. Za redovno dodavanje poslovnih klijenata koristite Dodaj na popisu klijenata.
Povezane značajke
Sljedeći korak
Ako tek počinjete, preporučujemo da prvo napravite sljedeće:
- Pripremite OIB i adresu organizacije.
- Ispunite čarobnjak na
/my-client. - Nakon reloada provjerite početnu stranicu klijenta.
Nakon toga možete prijeći na: Radni prostor klijenta.