# Što ćete izgraditi (i zašto je važno)#
Čvrsta arhitektura React admin nadzorne ploče nije stvar odabira UI kita. Radi se o smanjenju rizika u B2B okruženju gdje su pogreške skupe: curenje podataka, narušeni tragovi usklađenosti (compliance) i regresije dozvola koje se pokažu tek u produkciji.
Ovaj vodič daje praktičan nacrt za B2B admin panele uz:
- informacijsku arhitekturu koja se skalira iznad 10 ekrana
- navigaciju i UI vođene dozvolama
- produkcijski spreman model događaja revizijskih zapisa
- feature flagove koji rade s RBAC-om, a ne protiv njega
- jasne granice modula i pristupe testiranju za rute s kontrolom pristupa
Za širi pogled fokusiran na SaaS, pročitajte i: Next.js arhitektura B2B SaaS admin panela s RBAC-om i revizijskim zapisima. Za obrasce dizajna modula, pogledajte: Moderna React frontend arhitektura s feature sliceovima i modulima.
# Pretpostavke i stvari o kojima nema pregovora#
Admin nadzorne ploče su “interne” samo dok to više nisu. Tretirajte ih kao javne aplikacije s jačim kontrolama.
| Područje | Preporuka | Zašto |
|---|---|---|
| Auth | OIDC ili JWT sesija s kratko-živućim access tokenima | Smanjuje opseg štete kod curenja tokena |
| Autorizacija | Provodi se na backendu za svaki zahtjev | Frontend provjere nisu sigurnost |
| Frontend RBAC | Zrcaljene dozvole za upravljanje UI-jem | Sprječava zbunjujući UX i smanjuje opterećenje podrške |
| Revizijski zapisi | Neizmjenjivi, append-only | Usklađenost i odgovor na incidente |
| Flagovi | Server-driven, cacheani na klijentu | Sigurna uvođenja i značajke po tenantima |
| Testiranje | Rute s dozvolama + API auth testovi | Sprječava regresije tijekom refaktora |
⚠️ Upozorenje: Skrivanjem gumba ne radite autorizaciju. Ako API prihvaća zabranjenu radnju, vaš admin panel je već kompromitiran.
# Informacijska arhitektura koja se skalira#
Većina admin panela propada jer rastu kao kuhinjska ladica s “svaštarijama”: svaka nova funkcionalnost doda stavku menija i rutu, a rezultat je navigacijsko stablo koje nitko ne razumije.
Skalabilna informacijska arhitektura kreće od grupiranja po domenama, a ne po ekranima.
Definirajte domene, ne stranice#
Česte B2B admin domene:
- Organizacija i tenanti
- Korisnici, uloge, dozvole
- Naplata i pretplate
- Upravljanje podacima ili katalog
- Integracije i webhookovi
- Sigurnost, revizijski zapisi, postavke
- Alati za podršku
Dobar signal da su domenske granice ispravne: svaku domenu može “posjedovati” tim i može se isporučivati iza feature flaga bez razbijanja drugih dijelova.
Model navigacije: stabilan vrh, fleksibilna djeca#
Neka top-level navigacija bude stabilna. U većini B2B proizvoda, 6 do 9 top-level sekcija je praktičan maksimum; iznad toga korisnici se više oslanjaju na pretragu nego na menije.
| Sloj navigacije | Što sadrži | Učestalost promjena |
|---|---|---|
| Top-level | Domene: Users, Billing, Integrations | Rijetko |
| Drugi nivo | Tokovi rada: Invite, Roles, API keys | Ponekad |
| Duboke stranice | Ekrani specifični za entitet: detalji korisnika, detalji računa | Često |
Praktična struktura mape ruta#
Koristite mapu ruta koja je data-driven i svjesna dozvola. Ona postaje jedino mjesto gdje razmišljate o vidljivosti, pristupu i breadcrumbovima.
export type AppRoute = {
id: string;
path: string;
label: string;
navGroup?: string;
requiredPermissions?: string[];
requiredFlags?: string[];
children?: AppRoute[];
};
export const routes: AppRoute[] = [
{
id: "users",
path: "/users",
label: "Users",
navGroup: "Identity",
requiredPermissions: ["users.read"],
children: [
{
id: "user-details",
path: "/users/:userId",
label: "User details",
requiredPermissions: ["users.read"],
},
],
},
];Ovo se isplati kad dodate:
- novi plan tenanta koji skriva Billing
- compliance funkcionalnost koja dodaje Audit Logs
- promjenu uloge koja uklanja pristup upravljanju korisnicima
💡 Savjet: Tretirajte mapu ruta kao artefakt proizvoda. Držite labele, grupe i breadcrumbove na jednom mjestu kako biste izbjegli “drift navigacije” između menija i stranica.
# RBAC nacrt: UI vođen dozvolama bez kaosa#
RBAC u frontend kodu obično zakaže jer su provjere dozvola razbacane posvuda. Rješenje je centralizirati semantiku dozvola i zadržati UI logiku deklarativnom.
RBAC model: uloge su UX, dozvole su kontrola#
Koristite dozvole kao atomsku jedinicu. Uloge su skupovi dozvola radi lakšeg administriranja.
| Koncept | Primjer | Spremljeno gdje |
|---|---|---|
| Dozvola | users.invite, billing.update | Backend policy store |
| Uloga | Admin, Billing manager | Backend, tenant-scoped |
| Dodjela | Korisnik ima uloge u tenantu | Backend |
| Efektivne dozvole | “Spljoštena” lista dozvola | Backend odgovor pri loginu i refreshu |
U većini B2B SaaS-a, dozvole su tenant-scoped. Nemojte tretirati “Admin” kao globalno osim ako je vaš proizvod doista single-tenant.
Centralizirajte provjere dozvola#
Napravite malu autorizacijsku površinu na frontendu:
can(permission)za provjeru jedne dozvolecanAll([...])za stroge radnjecanAny([...])za UI sekcije
export type Permission = string;
export function createAbility(effective: Permission[]) {
const set = new Set(effective);
return {
can: (p: Permission) => set.has(p),
canAll: (ps: Permission[]) => ps.every((p) => set.has(p)),
canAny: (ps: Permission[]) => ps.some((p) => set.has(p)),
};
}Navigacija vođena dozvolama#
Navigacija se treba izvoditi iz mape ruta plus:
- efektivne dozvole
- uključeni feature flagovi
- trenutni tenant kontekst
export function filterRoutesForUser(
allRoutes: AppRoute[],
ability: { canAll: (ps: string[]) => boolean },
flags: { hasAll: (fs: string[]) => boolean }
) {
return allRoutes
.filter((r) => !r.requiredPermissions || ability.canAll(r.requiredPermissions))
.filter((r) => !r.requiredFlags || flags.hasAll(r.requiredFlags))
.map((r) => ({
...r,
children: r.children ? filterRoutesForUser(r.children, ability, flags) : undefined,
}));
}UI vođen dozvolama: jedan wrapper, mnogo koristi#
Koristite mali RequirePermission wrapper za uvjetno renderiranje. Neka bude “glup” i predvidljiv.
type RequirePermissionProps = {
all?: string[];
any?: string[];
fallback?: React.ReactNode;
children: React.ReactNode;
};
export function RequirePermission(props: RequirePermissionProps) {
const ability = useAbility();
const okAll = props.all ? ability.canAll(props.all) : true;
const okAny = props.any ? ability.canAny(props.any) : true;
if (!okAll || !okAny) return props.fallback ?? null;
return props.children;
}Koristite ga za:
- action gumbe
- opasne kontrole
- cijele panele unutar stranice
Nemojte ga koristiti kao “sigurnosnu granicu”. Ta granica je API.
# Feature flagovi: sigurna uvođenja i varijante po tenantima#
Feature flagovi u admin dashboardima nisu opcionalni kad imate više tenanata, cjenovne razrede ili postupna uvođenja. Omogućuju da isporučite kod u produkciju bez izlaganja funkcionalnosti.
Pravilo: flagovi određuju dostupnost, dozvole određuju pristup#
Praktično kombinirano pravilo za UI je:
- prikaži značajku samo ako je flag uključen
- dopusti korištenje samo ako je dozvola dodijeljena
- za rute: provodi oba uvjeta
| Scenarij | Flag | Dozvola | Rezultat |
|---|---|---|---|
| Značajka u beta fazi | Off | Dodijeljena | Skriveno i nedostupno |
| Plaćeni add-on za tenant | On | Nije dodijeljena | Vidljivo samo ako želite upsell UI, ali radnje blokirane |
| Normalna značajka | On | Dodijeljena | Potpuni pristup |
Ako želite upsell UX, odvojite dozvole “vidi upsell” od “koristi značajku”, ili koristite varijantu rute poput /integrations koja prikazuje ograničen sadržaj.
ℹ️ Napomena: Neka flagovi budu server-driven radi ispravnosti po tenantima. Client-only flagovi su ok za UI eksperimente, ali ne i za enforcement planova.
Minimalni flag klijent#
Jednostavan pristup:
- dohvatite flagove pri bootu ili promjeni tenanta
- cacheajte u memoriji
- osvježavajte periodično ili kad dobijete 409 ili 412 od backenda kao signal zastarjele konfiguracije
export type FlagKey = string;
export function createFlagSet(enabled: FlagKey[]) {
const set = new Set(enabled);
return {
has: (k: FlagKey) => set.has(k),
hasAll: (ks: FlagKey[]) => ks.every((k) => set.has(k)),
};
}# Revizijski zapisi: model događaja koji stvarno pomaže u incidentima#
Revizijski zapisi vrijede samo ako odgovaraju na pitanja tko je što napravio, kada, odakle i što se promijenilo. Mnogi timovi zabilježe “User updated settings” i tu stanu, a onda ne mogu istražiti stvarni incident.
Model događaja revizijskog zapisa#
Spremite audit događaje kao neizmjenjive zapise. Izbjegavajte “samo slobodni tekst poruke”. Neka bude pretraživo.
| Polje | Tip | Primjer | Zašto je važno |
|---|---|---|---|
| id | string | evt_01J... | Stabilna referenca |
| occurredAt | ISO datetime | 2026-11-07T10:30:12Z | Rekonstrukcija vremenske linije |
| tenantId | string | tnt_123 | Izolacija multi-tenanta |
| actor | object | user id, type, email | Atribucija |
| action | string | users.invite | Agregacija i filteri |
| entity | object | type user, id usr_9 | Praćenje utjecaja |
| outcome | string | success ili denied | Sigurnosna analiza |
| ip | string | 203.0.113.9 | Istraga |
| userAgent | string | Mozilla/... | Forenzika |
| requestId | string | req_abc | Korelacija s app logovima |
| changes | object | before/after subset | Razumjeti što se promijenilo |
| metadata | object | plan, role id, reason | Poslovni kontekst |
Primjer payload-a audit događaja#
Diff neka bude minimalan. Logirajte samo polja koja su se promijenila i izbjegavajte osjetljive vrijednosti.
{
"occurredAt": "2026-11-07T10:30:12Z",
"tenantId": "tnt_123",
"actor": { "type": "user", "id": "usr_1", "email": "ops@acme.com" },
"action": "roles.update",
"entity": { "type": "role", "id": "role_billing_manager" },
"outcome": "success",
"requestId": "req_c9f2a",
"ip": "203.0.113.9",
"changes": {
"permissions": {
"before": ["billing.read"],
"after": ["billing.read", "billing.update"]
}
},
"metadata": { "reason": "Access needed for subscription changes" }
}UI revizijskih zapisa: filtriranje koje podržava stvaran rad#
U praksi, najkorišteniji filteri su:
- vremenski raspon
- actor
- action
- tip entiteta i id
- outcome: denied vs success
Dodajte deep linkove s entitetskih stranica. Primjer: s User details, link “Prikaži audit događaje za ovog korisnika” koji filtrira po entity.type = user i entity.id = usr_9.
🎯 Ključna poruka: Dizajnirajte shemu revizijskog zapisa za istrage, ne za dashboarde. Pretraživost je važnija od lijepih poruka.
# Skalabilni moduli i granice komponenti#
Admin paneli brzo rastu. Ako ne povučete granice rano, završit ćete sa shared komponentama koje postanu globalne ovisnosti i usporavaju isporuku.
Praktična granica modula je: domenski slice posjeduje svoje rute, API pozive, UI stanje i zahtjeve dozvola.
Predloženi layout mapa#
Izbjegavajte “ravnu” components mapu koja postane odlagalište. Koristite feature module i tanki app shell.
| Sloj | Posjeduje | Ne smije posjedovati |
|---|---|---|
| app-shell | router, layout, nav, providers | domensku logiku |
| modules ili features | stranice, komponente, hookove, api klijente za domenu | globalne UI primitive |
| shared ui | buttons, inputs, table, modal | business rules |
| shared core | auth client, ability, flags, http client | feature-specific endpointove |
Primjer strukture:
src/app-shell/src/shared/core/ability/src/shared/core/flags/src/shared/ui/src/modules/users/src/modules/billing/src/modules/audit-log/
Za dublji pogled u obrasce modularizacije, pogledajte: Moderna React frontend arhitektura s feature sliceovima i modulima.
Eksplicitno definirajte module contracts#
Svaki modul treba izložiti:
- definicije ruta
- stavke navigacije
- opcionalne fragmente sidebara
- listu dozvola koje modul koristi
To app-shell čini jednostavnim: on kompozira module, filtrira po abilityju i flagovima te renderira.
# Rute s kontrolom pristupa: obrasci koji se ne raspadaju tijekom refaktora#
Postoje dvije kontrolne točke za pristup rutama:
- 1Navigacija ne bi trebala prikazivati rute kojima korisnik ne može pristupiti.
- 2Router ipak mora štititi direktan pristup URL-u.
Strategija route guard-a#
Pouzdan obrazac:
- svaka ruta ima
requiredPermissionsirequiredFlags - router ih provjerava prije renderiranja komponente stranice
- neautorizirane korisnike pošaljite na posebnu 403 stranicu, ne na prazan ekran
type GuardedRouteProps = {
requiredPermissions?: string[];
requiredFlags?: string[];
children: React.ReactNode;
};
export function GuardedRoute(props: GuardedRouteProps) {
const ability = useAbility();
const flags = useFlags();
const okPerms = props.requiredPermissions ? ability.canAll(props.requiredPermissions) : true;
const okFlags = props.requiredFlags ? flags.hasAll(props.requiredFlags) : true;
if (!okFlags) return <NotFoundPage />;
if (!okPerms) return <ForbiddenPage />;
return props.children;
}Koristite Not Found za isključene flagove kako biste izbjegli “otkrivanje” neobjavljenih značajki, a Forbidden za probleme s dozvolama gdje značajka postoji, ali je korisnik ne smije koristiti.
# Nacrt testiranja: rute s kontrolom pristupa i UI kontrole#
Logika dozvola je notorno krhka jer se širi preko ruta, navigacije, gumbi i API poziva. Strategija testiranja treba ciljati točke odluke, a ne samo snapshote.
Za kompletan testing setup s Vitest, React Testing Library i MSW, pogledajte: React strategija testiranja s Vitest, React Testing Library i MSW.
Što testirati (visoka vrijednost, nisko održavanje)#
| Tip testa | Fokus | Primjer asercije |
|---|---|---|
| Unit testovi | ability i flag logika | canAll je true samo kad su svi prisutni |
| Component testovi | uvjetni UI | gumb “Invite user” je skriven bez users.invite |
| Router testovi | rute s dozvolama | navigacija na /billing preusmjerava na 403 |
| Integracijski testovi s MSW | end-to-end tokovi | API vraća 403, UI prikazuje error stanje |
| API testovi | server autorizacija | zabranjena radnja odbijena bez obzira na UI |
Primjer: testiranje rute s kontrolom pristupa#
Koristite in-memory router, ubacite auth stanje i provjerite ispravnu stranicu.
import { render, screen } from "@testing-library/react";
import { MemoryRouter } from "react-router-dom";
import { App } from "./App";
test("blocks billing route without permission", async () => {
render(
<MemoryRouter initialEntries={["/billing"]}>
<TestProviders auth={{ permissions: ["users.read"] }}>
<App />
</TestProviders>
</MemoryRouter>
);
expect(await screen.findByText("Forbidden")).toBeInTheDocument();
});Neka TestProviders bude jedina ulazna točka za mockanje:
- efektivnih dozvola
- uključenih flagova
- tenant konteksta
⚠️ Upozorenje: Ako vaši testovi mockaju provjere dozvola tako da svugdje mockaju
can(), ne testirate stvarno ponašanje. Radije ubacite efektivne dozvole i pustite da ability sloj izračuna odluke.
Primjer: testiranje gumba vođenog dozvolama#
import { render, screen } from "@testing-library/react";
import { UserToolbar } from "./UserToolbar";
test("hides Invite button without users.invite", () => {
render(
<TestProviders auth={{ permissions: ["users.read"] }}>
<UserToolbar />
</TestProviders>
);
expect(screen.queryByText("Invite user")).toBeNull();
});Contract testovi između frontenda i backenda#
Najčešći produkcijski bug je neslaganje između permission stringova i backend enforcementa. Dodajte lagani contract:
- frontend permission konstante žive na jednom mjestu
- backend izlaže
/me/permissionsi/me/flags - CI validira da su frontend permission ključevi podskup backendu poznatih ključeva
To može biti jednostavno kao JSON lista koju backend generira tijekom builda ili test endpoint u stagingu.
# Sve zajedno: praktičan nacrt#
Koristite ovaj redoslijed da sigurno implementirate novi modul:
- 1Dodajte domenski modul s rutama, potrebnim dozvolama i potrebnim flagovima.
- 2Dodajte API client metode za tu domenu i osigurajte da backend provodi autorizaciju.
- 3Dodajte stavke navigacije izvedene iz definicija ruta.
- 4Dodajte audit log događaje za ključne radnje, posebno destruktivne ili one vezane uz promjene dozvola.
- 5Dodajte UI wrapere vođene dozvolama za kontrole.
- 6Dodajte testove na tri razine: ability, route guard i barem jedan integracijski tok.
Ovako zadržavate brzinu, a istovremeno sprječavate regresije dozvola kad dashboard naraste s 15 na 150 ekrana.
# Ključne poruke#
- Tretirajte mapu ruta kao podatke: uključite labele, dozvole i flagove, pa iz nje izvodite navigaciju i breadcrumbove.
- Provodite autorizaciju na backendu, a efektivne dozvole zrcalite u frontendu kako biste imali UI vođen dozvolama.
- Dizajnirajte audit događaje za istrage: actor, action, entity, outcome, request id i minimalne diffove.
- Koristite feature flagove za dostupnost, a dozvole za pristup; za osjetljive rute zahtijevajte oba.
- Podijelite dashboard u domenske module koji posjeduju rute, API pozive i zahtjeve dozvola kako biste izbjegli međusobnu spregu funkcionalnosti.
- Testirajte rute s kontrolom pristupa pomoću in-memory routera i ubrizganih efektivnih dozvola, te to poduprite API testovima autorizacije.
# Zaključak#
Održiv React admin dashboard je sustav: informacijska arhitektura, navigacija vođena RBAC-om, auditabilnost, flagovi, granice modula i testovi međusobno se pojačavaju. Ako implementirate samo jedan dio, najslabija karika postaje izvor incidenata i support ticketa.
Ako želite provjerenu osnovu za svoj B2B admin panel, Samioda vam može pomoći definirati granice modula, RBAC model, shemu audit događaja i strategiju testiranja koja sprječava regresije dozvola dok se proizvod skalira. Javite se putem Samioda i pretvorit ćemo ovaj nacrt u funkcionalan codebase.
FAQ
Osnivač i senior developer u Samiodi. 8+ godina iskustva u izradi React, Next.js, Flutter i n8n rješenja za klijente diljem Europe.
Više iz kategorije Web razvoj
Sve →Next.js App Router autentikacija sa sesijama: cookie sesije, middleware i obrasci osvježavanja
Praktičan vodič za Next.js App Router autentikaciju sa sesijama koristeći httpOnly cookie sesije, middleware zaštite i obrasce osvježavanja ili rotacije — uz siguran logout, smjernice za CSRF i napomene o Vercel runtimeu.
Obavijesti u stvarnom vremenu u Next.js-u (App Router): SSE vs WebSockets, fanout i jamstva isporuke
Izgradite produkcijski spremne Next.js obavijesti u stvarnom vremenu s App Routerom. Usporedite SSE i WebSockets, dizajnirajte trajni inbox i stanja pročitanosti, sigurno skalirajte fanout te dodajte fallback polling uz React Query ili SWR.
Next.js višestanarijska autentifikacija u App Routeru: razrješavanje tenant-a, prebacivanje i sigurnost
Praktični vodič za Next.js višestanarijsku autentifikaciju u App Routeru: razrješavanje tenant-a putem poddomene, putanje ili zaglavlja, opseg sesija, siguran UX za prebacivanje tenant-a i obrasci koda koji sprječavaju curenje podataka između tenant-a.
Trebate pomoć s projektom?
Gradimo prilagođena rješenja koristeći tehnologije iz ovog članka. Senior tim, fiksne cijene.
Povezani članci
Arhitektura Next.js administratorskog panela za B2B SaaS: RBAC, revizijski zapisi, impersonacija i sigurne masovne radnje
Praktična referentna arhitektura za Next.js admin panele: modeliranje dozvola, revizijski zapisi, sigurna impersonacija i sigurnosne kontrolne liste za masovne radnje, izvoze i rukovanje PII podacima.
React višekoračni obrasci u velikom opsegu: spremanje skice, nastavak kasnije, validacija i navigacija po koracima
Praktičan vodič za izgradnju React višekoračnog obrasca koji podržava spremanje skice, nastavak na drugom uređaju, uvjetne korake i robusnu validaciju uz React Hook Form + Zod, uz perzistenciju na serveru i analitiku.
Testiranje ugovora za React komponente: MSW + Storybook kao živi API mockovi
Praktičan vodič za testiranje ugovora React komponenti pomoću zajedničkih MSW handlera u Storybooku i automatiziranim testovima kako biste spriječili razilaženje mockova, nestabilan UI i regresije u CI-u.