# Faza 2: Backend Arhitektura, Sales Channels i Automatizovani Seeding ## 2.1. Svrha i Ciljevi Faze U ovoj fazi se postavlja temelj multi-tenant arhitekture u Medusa v2 backendu bez pisanja custom baza podataka. Medusa v2 koristi **Multichannel** koncept gdje svaki webshop predstavlja jedan **Sales Channel** povezan sa sopstvenim skladištem (**Stock Location**) i autentifikovan putem jedinstvenog javnog ključa (**Publishable API Key**). > [!CRITICAL] > **Prevencija "Out of Stock" blokade:** U Medusa v2, ukoliko prodajni kanal nije eksplicitno povezan sa barem jednom skladišnom lokacijom putem Remote Link mehanizma (`Modules.STOCK_LOCATION` <-> `Modules.SALES_CHANNEL`), svi artikli na storefrontu će imati status "Out of stock" i neće se moći dodati u korpu. --- ## 2.2. Zvanični Moduli i Workflows U ovoj fazi se koriste isključivo gotovi servisi i workflows iz Medusa v2 jezgra: - `createSalesChannelsWorkflow` iz `@medusajs/medusa/core-flows` - `createStockLocationsWorkflow` iz `@medusajs/medusa/core-flows` - `createApiKeysWorkflow` & `linkSalesChannelsToApiKeyWorkflow` iz `@medusajs/medusa/core-flows` - `createCustomerGroupsWorkflow` iz `@medusajs/medusa/core-flows` - `createUserWorkflow` iz `@medusajs/medusa/core-flows` - `createProductsWorkflow` iz `@medusajs/medusa/core-flows` - `ContainerRegistrationKeys.REMOTE_LINK` za povezivanje modula --- ## 2.3. Izvršna Skripta za Inicijalizaciju (`setup-umbrella-platform.ts`) Kreirajte datoteku `apps/backend/src/scripts/setup-umbrella-platform.ts`: ```typescript import { ExecArgs } from "@medusajs/framework/types" import { ContainerRegistrationKeys, Modules } from "@medusajs/framework/utils" import { createSalesChannelsWorkflow, createStockLocationsWorkflow, linkSalesChannelsToApiKeyWorkflow, createApiKeysWorkflow, createCustomerGroupsWorkflow, createProductsWorkflow, createUserWorkflow, } from "@medusajs/medusa/core-flows" export default async function setupUmbrellaPlatform({ container }: ExecArgs) { const logger = container.resolve(ContainerRegistrationKeys.LOGGER) logger.info("==================================================") logger.info("Pokrećem automatizovano postavljanje platforme...") logger.info("==================================================") // 1. KREIRANJE DVA PRODAJNA KANALA (Sales Channels) const { result: salesChannels } = await createSalesChannelsWorkflow(container).run({ input: { salesChannelsData: [ { name: "Suncobrani DE (Njemačka)", description: "Zvanični prodajni kanal za njemačko tržište", }, { name: "Suncobrani AT (Austrija)", description: "Zvanični prodajni kanal za austrijsko tržište", }, ], }, }) const [channelDE, channelAT] = salesChannels logger.info(`Kreiran kanal DE: ${channelDE.name} [ID: ${channelDE.id}]`) logger.info(`Kreiran kanal AT: ${channelAT.name} [ID: ${channelAT.id}]`) // 2. KREIRANJE SKLADIŠNIH LOKACIJA (Stock Locations) const { result: stockLocations } = await createStockLocationsWorkflow(container).run({ input: { locations: [ { name: "Centralni Magacin Minhen (DE)" }, { name: "Distributivni Centar Beč (AT)" }, ], }, }) const [locDE, locAT] = stockLocations logger.info(`Kreirana lokacija DE: ${locDE.name} [ID: ${locDE.id}]`) logger.info(`Kreirana lokacija AT: ${locAT.name} [ID: ${locAT.id}]`) // 3. POVEZIVANJE SKLADIŠTA SA PRODAJNIM KANALIMA (Remote Link) const remoteLink = container.resolve(ContainerRegistrationKeys.REMOTE_LINK) await remoteLink.create([ { [Modules.STOCK_LOCATION]: { stock_location_id: locDE.id }, [Modules.SALES_CHANNEL]: { sales_channel_id: channelDE.id }, }, { [Modules.STOCK_LOCATION]: { stock_location_id: locAT.id }, [Modules.SALES_CHANNEL]: { sales_channel_id: channelAT.id }, }, ]) logger.info("Uspješno povezana skladišta sa prodajnim kanalima.") // 4. KREIRANJE PUBLISHABLE API KLJUČEVA I DODJELA KANALIMA const { result: apiKeys } = await createApiKeysWorkflow(container).run({ input: { api_keys: [ { title: "Storefront DE Public Key", type: "publishable" }, { title: "Storefront AT Public Key", type: "publishable" }, ], }, }) const [keyDE, keyAT] = apiKeys await linkSalesChannelsToApiKeyWorkflow(container).run({ input: { id: keyDE.id, add: [channelDE.id], }, }) await linkSalesChannelsToApiKeyWorkflow(container).run({ input: { id: keyAT.id, add: [channelAT.id], }, }) // 5. KREIRANJE B2B CUSTOMER GRUPE (Za HoReCa kupce) const { result: customerGroups } = await createCustomerGroupsWorkflow(container).run({ input: { customerGroupsData: [ { name: "HoReCa B2B Partneri", metadata: { description: "Verifikovani hoteli, restorani i kafići sa veleprodajnim cijenama", }, }, ], }, }) logger.info(`Kreirana B2B grupa: ${customerGroups[0].name} [ID: ${customerGroups[0].id}]`) // 6. KREIRANJE REGIONALNIH ADMIN KORISNIKA SA IZOLACIJOM await createUserWorkflow(container).run({ input: { userData: { email: "admin.de@suncobrani.com", first_name: "Klaus", last_name: "Schmidt (DE Admin)", metadata: { sales_channel_id: channelDE.id }, }, }, }) await createUserWorkflow(container).run({ input: { userData: { email: "admin.at@suncobrani.com", first_name: "Stefan", last_name: "Weber (AT Admin)", metadata: { sales_channel_id: channelAT.id }, }, }, }) logger.info("Kreirani regionalni admin nalozi.") // 7. SEED PRIMJERA SUNCOBRANA SA METADATA SPECIFIKACIJAMA await createProductsWorkflow(container).run({ input: { products: [ { title: "Teleskopski Ugostiteljski Suncobran 'Gastro Master'", subtitle: "Ekstremno otporan na vjetar sa integrisanim teleskopskim zatvaranjem iznad stolova", handle: "gastro-master-suncobran", status: "published", sales_channels: [{ id: channelDE.id }, { id: channelAT.id }], metadata: { uv_protection: "UPF 50+ (EN 13758-1 standard)", wind_resistance: "Klasa 6 Beaufort (do 60 km/h u otvorenom stanju)", fabric_weight: "320 g/m² 100% obojeni akril sa Nano-teflon zaštitom", water_column: "1200 mm", mast_diameter: "Ø 60 mm debljina stijenke 3.5 mm ojačani aluminijum", warranty_years: "5 godina garancije na mehanizam i postojanost boje", }, options: [ { title: "Dimenzija", values: ["3x3m", "4x4m"] }, { title: "Boja platna", values: ["Antracit Siva (RAL 7016)", "Prirodna Bež"] }, ], variants: [ { title: "3x3m / Antracit Siva", sku: "GM-33-ANT", options: { Dimenzija: "3x3m", "Boja platna": "Antracit Siva (RAL 7016)" }, prices: [{ currency_code: "eur", amount: 550.00 }], }, { title: "4x4m / Antracit Siva", sku: "GM-44-ANT", options: { Dimenzija: "4x4m", "Boja platna": "Antracit Siva (RAL 7016)" }, prices: [{ currency_code: "eur", amount: 790.00 }], }, { title: "3x3m / Prirodna Bež", sku: "GM-33-BEZ", options: { Dimenzija: "3x3m", "Boja platna": "Prirodna Bež" }, prices: [{ currency_code: "eur", amount: 550.00 }], }, { title: "4x4m / Prirodna Bež", sku: "GM-44-BEZ", options: { Dimenzija: "4x4m", "Boja platna": "Prirodna Bež" }, prices: [{ currency_code: "eur", amount: 790.00 }], }, ], }, ], }, }) logger.info("==================================================") logger.info("KONFIGURACIJA ZA VAŠE STOREFRONT .ENV FAJLOVE:") logger.info(`Kanal DE Publishable Key: ${keyDE.token}`) logger.info(`Kanal AT Publishable Key: ${keyAT.token}`) logger.info("==================================================") } ``` --- ## 2.4. Korak-po-Korak Instrukcije za Izvršavanje 1. Pokrenite Medusa backend razvojni server ukoliko nije pokrenut: ```bash pnpm backend:dev ``` 2. U zasebnom terminalu unutar `apps/backend` pokrenite skriptu: ```bash cd apps/backend npx medusa exec ./src/scripts/setup-umbrella-platform.ts ``` 3. Kopirajte generisane tokene ključeva (`pk_...`) koji će biti ispisani u konzoli u `.env` datoteke storefrontova. --- ## 2.5. Kriterijumi Prihvatljivosti (Acceptance Criteria) - [ ] Skripta se uspješno izvršava bez grešaka i ispisuje dva različita tokena ključeva. - [ ] Izvršavanjem cURL komande sa ključem DE: ```bash curl -H "x-publishable-api-key: " http://localhost:9000/store/products ``` vraća se proizvod "Gastro Master". - [ ] Skladišta su mapirana na odgovarajuće kanale i varijante nisu označene kao "Out of stock".