Web razvoj
ReactArhitekturaRBACAdministratorske pločeB2B SaaSTestiranjeRevizijski zapisiFeature flagovi

Arhitektura React administratorske nadzorne ploče: RBAC, revizijski zapisi, navigacija i skalabilni moduli

AO
Adrijan Omićević
·14 min čitanja

# Š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čjePreporukaZašto
AuthOIDC ili JWT sesija s kratko-živućim access tokenimaSmanjuje opseg štete kod curenja tokena
AutorizacijaProvodi se na backendu za svaki zahtjevFrontend provjere nisu sigurnost
Frontend RBACZrcaljene dozvole za upravljanje UI-jemSprječava zbunjujući UX i smanjuje opterećenje podrške
Revizijski zapisiNeizmjenjivi, append-onlyUsklađenost i odgovor na incidente
FlagoviServer-driven, cacheani na klijentuSigurna uvođenja i značajke po tenantima
TestiranjeRute s dozvolama + API auth testoviSprječ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žiUčestalost promjena
Top-levelDomene: Users, Billing, IntegrationsRijetko
Drugi nivoTokovi rada: Invite, Roles, API keysPonekad
Duboke straniceEkrani 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.

TypeScript
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.

KonceptPrimjerSpremljeno gdje
Dozvolausers.invite, billing.updateBackend policy store
UlogaAdmin, Billing managerBackend, tenant-scoped
DodjelaKorisnik ima uloge u tenantuBackend
Efektivne dozvole“Spljoštena” lista dozvolaBackend 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 dozvole
  • canAll([...]) za stroge radnje
  • canAny([...]) za UI sekcije
TypeScript
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 se treba izvoditi iz mape ruta plus:

  • efektivne dozvole
  • uključeni feature flagovi
  • trenutni tenant kontekst
TypeScript
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.

TSX
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
ScenarijFlagDozvolaRezultat
Značajka u beta faziOffDodijeljenaSkriveno i nedostupno
Plaćeni add-on za tenantOnNije dodijeljenaVidljivo samo ako želite upsell UI, ali radnje blokirane
Normalna značajkaOnDodijeljenaPotpuni 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
TypeScript
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.

PoljeTipPrimjerZašto je važno
idstringevt_01J...Stabilna referenca
occurredAtISO datetime2026-11-07T10:30:12ZRekonstrukcija vremenske linije
tenantIdstringtnt_123Izolacija multi-tenanta
actorobjectuser id, type, emailAtribucija
actionstringusers.inviteAgregacija i filteri
entityobjecttype user, id usr_9Praćenje utjecaja
outcomestringsuccess ili deniedSigurnosna analiza
ipstring203.0.113.9Istraga
userAgentstringMozilla/...Forenzika
requestIdstringreq_abcKorelacija s app logovima
changesobjectbefore/after subsetRazumjeti što se promijenilo
metadataobjectplan, role id, reasonPoslovni kontekst

Primjer payload-a audit događaja#

Diff neka bude minimalan. Logirajte samo polja koja su se promijenila i izbjegavajte osjetljive vrijednosti.

JSON
{
  "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.

SlojPosjedujeNe smije posjedovati
app-shellrouter, layout, nav, providersdomensku logiku
modules ili featuresstranice, komponente, hookove, api klijente za domenuglobalne UI primitive
shared uibuttons, inputs, table, modalbusiness rules
shared coreauth client, ability, flags, http clientfeature-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:

  1. 1
    Navigacija ne bi trebala prikazivati rute kojima korisnik ne može pristupiti.
  2. 2
    Router ipak mora štititi direktan pristup URL-u.

Strategija route guard-a#

Pouzdan obrazac:

  • svaka ruta ima requiredPermissions i requiredFlags
  • router ih provjerava prije renderiranja komponente stranice
  • neautorizirane korisnike pošaljite na posebnu 403 stranicu, ne na prazan ekran
TSX
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 testaFokusPrimjer asercije
Unit testoviability i flag logikacanAll je true samo kad su svi prisutni
Component testoviuvjetni UIgumb “Invite user” je skriven bez users.invite
Router testovirute s dozvolamanavigacija na /billing preusmjerava na 403
Integracijski testovi s MSWend-to-end tokoviAPI vraća 403, UI prikazuje error stanje
API testoviserver autorizacijazabranjena radnja odbijena bez obzira na UI

Primjer: testiranje rute s kontrolom pristupa#

Koristite in-memory router, ubacite auth stanje i provjerite ispravnu stranicu.

TSX
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#

TSX
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/permissions i /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:

  1. 1
    Dodajte domenski modul s rutama, potrebnim dozvolama i potrebnim flagovima.
  2. 2
    Dodajte API client metode za tu domenu i osigurajte da backend provodi autorizaciju.
  3. 3
    Dodajte stavke navigacije izvedene iz definicija ruta.
  4. 4
    Dodajte audit log događaje za ključne radnje, posebno destruktivne ili one vezane uz promjene dozvola.
  5. 5
    Dodajte UI wrapere vođene dozvolama za kontrole.
  6. 6
    Dodajte 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

Share
A
Adrijan OmićevićOsnivač i senior developer

Osnivač i senior developer u Samiodi. 8+ godina iskustva u izradi React, Next.js, Flutter i n8n rješenja za klijente diljem Europe.

Trebate pomoć s projektom?

Gradimo prilagođena rješenja koristeći tehnologije iz ovog članka. Senior tim, fiksne cijene.