# Faza 3: Admin Izolacija po Državama (Backend Middleware Interceptor) ## 3.1. Svrha i Ciljevi Faze Zvanični Medusa Admin v2 je zamišljen kao centralizovani panel sa globalnim uvidom u sve podatke. Cilj ove faze je implementacija **potpune izolacije podataka po državama** bez pravljenja novog admin panela ili račvanja (forkovanja) koda zvaničnog dashboarda. Rješenje se implementira na backend nivou kroz **Medusa HTTP Middleware Interceptore** koji presreću administratorske API zahtjeve i filtriraju narudžbe i kupce prema prodajnom kanalu dodijeljenom ulogovanom korisniku. --- ## 3.2. Sigurnosna Arhitektura ``` [Admin Korisnik (Klaus - DE Admin)] ↓ [Zahtjev: GET /admin/orders] ↓ [Medusa Autentifikacija: Session / Bearer Token] ↓ [Custom Middleware: isolateSalesChannelMiddleware] ├── Provjerava req.auth_context.actor_id ├── Učitava user.metadata.sales_channel_id ├── Ako postoji restricirani ID: │ ├── GET /admin/orders → Injektuje req.query.sales_channel_id = [id] │ └── GET /admin/orders/:id → Ako narudžba ne pripada kanalu → 403 Forbidden └── Ako je null (Super Admin) → Propušta zahtjev bez izmjena ↓ [Medusa Core API Handler] → [Vraća samo narudžbe za DE] ``` --- ## 3.3. Implementacija Middleware Interceptora Uredite ili kreirajte datoteku `apps/backend/src/api/middlewares.ts`: ```typescript import { defineMiddlewares, AuthenticatedMedusaRequest, MedusaResponse, MedusaNextFunction, } from "@medusajs/framework/http" import { ContainerRegistrationKeys, MedusaError } from "@medusajs/framework/utils" /** * Middleware koji provjerava da li admin korisnik ima restrikciju * na specifičan prodajni kanal i nameće filtriranje. */ async function enforceAdminSalesChannelIsolation( req: AuthenticatedMedusaRequest, res: MedusaResponse, next: MedusaNextFunction ) { const userId = req.auth_context?.actor_id // Ako korisnik nije autentifikovan, standardni guard će ga odbiti if (!userId) { return next() } const query = req.scope.resolve(ContainerRegistrationKeys.QUERY) // 1. Dobavljanje korisničkih metapodataka const { data: [user], } = await query.graph({ entity: "user", fields: ["id", "metadata"], filters: { id: userId }, }) const restrictedChannelId = user?.metadata?.sales_channel_id as string | undefined // Ako korisnik ima dodijeljen prodajni kanal (Regionalni Admin) if (restrictedChannelId) { // A) Zahtjev za listu narudžbi (GET /admin/orders) if (req.method === "GET" && !req.params.id) { // Forsiramo filtriranje po sales channelu req.query.sales_channel_id = [restrictedChannelId] } // B) Zahtjev za pojedinačnu narudžbu (GET /admin/orders/:id) if (req.method === "GET" && req.params.id) { const { data: [order], } = await query.graph({ entity: "order", fields: ["id", "sales_channel_id"], filters: { id: req.params.id }, }) if (order && order.sales_channel_id !== restrictedChannelId) { throw new MedusaError( MedusaError.Types.NOT_ALLOWED, "Zabranjen pristup: Nemate ovlaštenje za pregled narudžbi iz ovog prodajnog kanala." ) } } } // Super Admini (bez sales_channel_id u metadata) vide sve narudžbe return next() } export default defineMiddlewares({ routes: [ { matcher: "/admin/orders*", method: ["GET"], middlewares: [enforceAdminSalesChannelIsolation], }, ], }) ``` --- ## 3.4. Dodjela i Ažuriranje Kanala Korisnicima u Bazi Regionalnom adminu se kanal može dodijeliti programski ili kroz skriptu `setup-umbrella-platform.ts`. Ukoliko želite postojećem korisniku dodijeliti ili promijeniti kanal, koristi se zvanični `updateUserWorkflow`: ```typescript // Primjer skripte za dodjelu kanala korisniku: await updateUserWorkflow(container).run({ input: { id: "usr_01J...", user: { metadata: { sales_channel_id: "sc_germany_01J...", }, }, }, }) ``` --- ## 3.5. Korak-po-Korak Testiranje i Verifikacija 1. **Kreirajte dvije testne narudžbe:** - Jednu narudžbu preko Storefronta DE (kanal `channelDE.id`). - Drugu narudžbu preko Storefronta AT (kanal `channelAT.id`). 2. **Prijavite se u Medusa Admin (`http://localhost:9000/app`) sa nalogom `admin.de@suncobrani.com`:** - Otvorite sekciju **Orders**. - **Provjera 1:** U tabeli narudžbi se prikazuje isključivo narudžba iz Njemačke. Narudžba iz Austrije se uopšte ne pojavljuje. 3. **Pokušaj direktnog pristupa austrijskoj narudžbi preko URL-a:** - U browseru unesite direktan link austrijske narudžbe: `http://localhost:9000/app/orders/order_austria_id`. - **Provjera 2:** Backend odbija zahtjev sa statusom `403 NOT_ALLOWED` i porukom o zabrani pristupa. 4. **Prijavite se sa nalogom Super Admina:** - Otvorite **Orders**. - **Provjera 3:** Super Admin vidi narudžbe iz obje države. --- ## 3.6. Kriterijumi Prihvatljivosti (Acceptance Criteria) - [ ] Middleware se uspješno kompajlira bez TypeScript grešaka (`pnpm --filter @dtc/backend build`). - [ ] Regionalni admin Njemačke ne može vidjeti listu narudžbi niti detalje pojedinačne narudžbe iz Austrije. - [ ] Zvanični Medusa Admin interfejs ostaje netaknut i stabilan (nema grešaka u konzoli niti rušenja aplikacije).