Full-page čarobnjak za kreiranje klijenta

Kratki sažetak

Full-page čarobnjak za kreiranje klijenta prikazuje CreateClientWizard bez modala na ruti /my-client. Razlikuje se od modalnog dodavanja po tome što prima isFullPage i pri spremanju šalje assignToOrganisation: true.

Najvažnije koristi:

• Korisnik dovršava onboarding bez dodatne navigacije.
• Klijent se automatski povezuje s organizacijom u backend transakciji.
• Isti set polja i koraka koristi se kao kod redovnog dodavanja klijenta.

Kada koristiti ovu značajku

Koristite full-page čarobnjak kada želite:

• završiti setup organizacije bez povezanog klijenta,
• kreirati vlastitu firmu ili obrt kao klijenta aplikacije,
• izbjeći modalni prikaz tijekom onboardinga.

Ova značajka je posebno korisna za:

• nove organizacije,
• vlasnike poslovanja,
• podršku koja vodi korisnika kroz prvi setup.

Prije nego što počnete

Prije korištenja provjerite sljedeće:

• nalazite se na /my-client,
• organizacija nema već povezanog klijenta,
• spremni ste unijeti osnovne podatke, račune i kontakte.

Brzi početak

U ovom primjeru pokazujemo kako završiti full-page kreiranje.

1. Otvorite /my-client.
2. Pročitajte informativni alert.
3. Ispunite prvi korak osnovnih podataka.
4. Dodajte bankovne račune.
5. Dodajte kontakte.
6. Kliknite Spremi i pričekajte reload.

Nakon toga trebali biste vidjeti: organizaciju povezanu s kreiranim klijentom.

Detaljne upute

Korak 1: Ispunite osnovne podatke

Full-page način koristi širi grid s dva stupca za osnovne i poslovne podatke. To olakšava pregled većeg broja polja.

Primjer:

isFullPage: true
assignToOrganisation: true

Alt tekst: Full-page čarobnjak za kreiranje klijenta s osnovnim podacima u dva stupca.

Korak 2: Dodajte račune i kontakte

Drugi i treći korak isti su kao u modalnom čarobnjaku: bankovni računi i kontakti dodaju se u lokalne field arraye prije slanja.

Alt tekst: Full-page čarobnjak na koraku bankovnih računa.

Korak 3: Spremite povezivanje

Na submitu čarobnjak dodaje assignToOrganisation: true. Backend tada dohvaća trenutnu organizaciju i poziva dodjelu klijenta organizaciji.

Primjer iz prakse

Zamislimo da samostalni korisnik nakon registracije mora unijeti podatke vlastite firme.

Scenarij:

• Korisnik: vlasnik firme
• Cilj: povezati firmu s korisničkom organizacijom
• Problem: bez povezanog klijenta aplikacija nema poslovni kontekst
• Rješenje: full-page čarobnjak kreira klijenta i dodjeljuje ga organizaciji

Rezultat:

Nakon reloada korisnik može nastaviti u radnom prostoru svog klijenta.

Showcase: kako značajka izgleda u aplikaciji

Pregled zaslona

Što korisnik vidi:

• alert s uputom,
• stepper s tri koraka,
• široki raspored forme.

Primjer konfiguracije

Preporučena konfiguracija za početnike:

Najčešće radnje

Kako primijeniti podatke iz registra

1. U prvom koraku upišite OIB ili naziv.
2. Odaberite rezultat.
3. Kliknite Primijeni podatke.

Kako dodati predloženi račun

1. Otvorite korak Bankovni računi.
2. Kliknite Dodaj.
3. Označite Predlaže se za glavni račun.

Kako završiti onboarding

1. Dovršite korak Kontakti.
2. Kliknite Spremi.
3. Pričekajte reload i preusmjeravanje.

Dobre prakse

Za najbolje rezultate:

• unesite vlastitu organizaciju, ne klijenta računovodstvenog ureda,
• provjerite da OIB pripada vašem subjektu,
• ne zatvarajte karticu tijekom spremanja,
• nakon reloada provjerite radni prostor klijenta.

Izbjegavajte:

• korištenje full-page toka za redovno dodavanje dodatnih klijenata,
• spremanje nepotpunih matičnih podataka,
• prekidanje reloada nakon uspjeha.

Napredne mogućnosti

Ako trebate više kontrole, možete koristiti:

Razlika od modala

Modalni tok zatvara modal na uspjeh, dok full-page tok ponovno učitava aplikaciju.

Backend povezivanje

Backend nakon kreiranja klijenta, postavki, računa, kontakata i godine dodjeljuje klijenta organizaciji ako je AssignToOrganisation true.

Discord onboarding obavijest

Kada se klijent dodijeli organizaciji, backend šalje async Discord obavijest s podacima o organizaciji i klijentu.

Dozvole i pristup

Za korištenje ove značajke potrebne su sljedeće dozvole:

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:

• nema posebne završne stranice nakon spremanja,
• koristi generički toast iz useCreateClient,
• detaljna poslovna pravila za tko smije dodijeliti klijenta organizaciji nisu dokaziva u frontendu.

Rješavanje problema

Česta pitanja

Zašto postoji full-page verzija ako već postoji modal?

Full-page verzija služi onboarding toku gdje korisnik mora prvo kreirati i povezati vlastitog klijenta prije nastavka rada.

Što radi isFullPage?

Utječe na layout prvog koraka i uzrokuje slanje assignToOrganisation: true u zahtjevu.

Mogu li ovaj tok koristiti za dodatne klijente?

Za redovno dodavanje dodatnih klijenata koristite modal Dodaj na stranici Poslovni klijenti.

Povezane značajke

• Postavljanje mog klijenta
• Čarobnjak za kreiranje klijenta
• Dodavanje klijenta

Sljedeći korak

Ako tek počinjete, preporučujemo da prvo napravite sljedeće:

1. Pročitajte upozorenje na /my-client.
2. Popunite podatke vlastite organizacije.
3. Nakon reloada otvorite početnu stranicu klijenta.

Nakon toga možete prijeći na: Radni prostor klijenta.