# Faza 5: Storefronts - Multi-Storefront i Multi-Language (`next-intl`) ## 5.1. Svrha i Ciljevi Faze U ovoj fazi se uspostavljaju dva odvojena webshopa: - **Webshop DE (`apps/storefront-de`)**: Namijenjen tržištu Njemačke (valuta EUR, primarni jezik njemački). - **Webshop AT (`apps/storefront-at`)**: Namijenjen tržištu Austrije (valuta EUR, primarni jezik njemački, sa specifičnim cijenama i skladištem). Oba webshopa se baziraju na zvaničnom `@medusajs/nextjs-starter-template`. > [!IMPORTANT] > **Pravilo gotovih rješenja:** Strogo je zabranjeno pisati korpu, checkout, korisnički nalog (auth) ili pretragu od nule. Koriste se gotove komponente, server actions i Medusa JS SDK kuke koje dolaze sa zvaničnim starterom. Svaki storefront dobija svoj `NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY`, čime Medusa backend automatski servira samo proizvode, cijene i zalihe vezane za odgovarajući **Sales Channel**. --- ## 5.2. Postavljanje Storefront Aplikacija u Monorepou Iz korijena monorepoa kloniramo zvanični starter za oba webshopa: ```bash # Storefront za Njemačku npx create-next-app -e https://github.com/medusajs/nextjs-starter-template apps/storefront-de # Storefront za Austriju npx create-next-app -e https://github.com/medusajs/nextjs-starter-template apps/storefront-at # Instalacija next-intl paketa u oba storefronta pnpm --filter @umbrella/storefront-de add next-intl pnpm --filter @umbrella/storefront-at add next-intl ``` --- ## 5.3. Konfiguracija Environment Varijabli ### Storefront DE (`apps/storefront-de/.env.local`) ```env # Medusa Backend URL MEDUSA_BACKEND_URL=http://localhost:9000 NEXT_PUBLIC_MEDUSA_BACKEND_URL=http://localhost:9000 # Publishable API ključ dodijeljen Sales Channelu za Njemačku (dobijen iz Faze 2) NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY=pk_de_xxxxxxxxxxxxxxxxxxxxxxxxxxxx # Podrazumijevana regija za starter NEXT_PUBLIC_DEFAULT_REGION=de PORT=8000 ``` ### Storefront AT (`apps/storefront-at/.env.local`) ```env # Medusa Backend URL MEDUSA_BACKEND_URL=http://localhost:9000 NEXT_PUBLIC_MEDUSA_BACKEND_URL=http://localhost:9000 # Publishable API ključ dodijeljen Sales Channelu za Austriju (dobijen iz Faze 2) NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY=pk_at_yyyyyyyyyyyyyyyyyyyyyyyyyyyy # Podrazumijevana regija za starter NEXT_PUBLIC_DEFAULT_REGION=at PORT=8001 ``` --- ## 5.4. Integracija `next-intl` Multi-Language Sistema Zvanični starter koristi App Router sa parametrom regije (npr. `/[countryCode]`). Za uvođenje višejezičnosti (npr. njemački i engleski unutar istog webshopa), konfigurišemo `next-intl`: ### 1. Ruting Konfiguracija (`apps/storefront-de/src/i18n/routing.ts`) ```typescript import { defineRouting } from "next-intl/routing" import { createNavigation } from "next-intl/navigation" export const routing = defineRouting({ locales: ["de", "en"], defaultLocale: "de", localePrefix: "as-needed", }) export const { Link, redirect, usePathname, useRouter } = createNavigation(routing) ``` ### 2. Request Konfiguracija (`apps/storefront-de/src/i18n/request.ts`) ```typescript import { getRequestConfig } from "next-intl/server" import { routing } from "./routing" export default getRequestConfig(async ({ requestLocale }) => { let locale = await requestLocale if (!locale || !routing.locales.includes(locale as any)) { locale = routing.defaultLocale } return { locale, messages: (await import(`../../messages/${locale}.json`)).default, } }) ``` ### 3. Rječnici Prevoda (`apps/storefront-de/messages/de.json`) ```json { "General": { "search": "Pretraži suncobrane...", "cart": "Korpa", "account": "Moj Račun" }, "Product": { "specificationsTitle": "Tehničke Specifikacije Suncobrana", "uvProtection": "UV Zaštita", "windResistance": "Otpornost na vjetar", "fabricWeight": "Gramaža platna", "waterproof": "Vodoodbojni stub", "mastDiameter": "Promjer nosivog stuba", "warranty": "Fabrička garancija", "inStock": "Dostupno na stanju", "outOfStock": "Trenutno rasprodano", "addToCart": "Dodaj u korpu", "b2bInquiry": "Zatražite B2B / HoReCa ponudu" } } ``` ### 4. Rječnici Prevoda (`apps/storefront-de/messages/en.json`) ```json { "General": { "search": "Search parasols...", "cart": "Cart", "account": "My Account" }, "Product": { "specificationsTitle": "Technical Parasol Specifications", "uvProtection": "UV Protection", "windResistance": "Wind Resistance", "fabricWeight": "Fabric Density", "waterproof": "Water Column", "mastDiameter": "Mast Diameter", "warranty": "Manufacturer Warranty", "inStock": "In Stock", "outOfStock": "Out of Stock", "addToCart": "Add to Cart", "b2bInquiry": "Request B2B / HoReCa Quote" } } ``` ### 5. Kombinovani Middleware (`apps/storefront-de/src/middleware.ts`) Povezujemo `next-intl` obradu sa slanjem `x-publishable-api-key` zaglavlja: ```typescript import { NextRequest, NextResponse } from "next/server" import createIntlMiddleware from "next-intl/middleware" import { routing } from "./i18n/routing" const intlMiddleware = createIntlMiddleware(routing) export async function middleware(request: NextRequest) { const { pathname } = request.nextUrl // Propuštanje statičkih resursa i Next.js internih fajlova if ( pathname.startsWith("/_next") || pathname.startsWith("/api") || pathname.includes(".") ) { return NextResponse.next() } // 1. Obrada višejezičnog URL-a const response = intlMiddleware(request) // 2. Prosljeđivanje Publishable API ključa Medusa klijentu const publishableApiKey = process.env.NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY || "" response.headers.set("x-publishable-api-key", publishableApiKey) return response } export const config = { matcher: ["/((?!api|_next|.*\\..*).*)"], } ``` --- ## 5.5. Korak-po-Korak Pokretanje i Testiranje 1. **Pokretanje oba storefronta u paraleli:** ```bash pnpm dev ``` - Storefront DE se pokreće na `http://localhost:8000` - Storefront AT se pokreće na `http://localhost:8001` 2. **Provjera kataloga po prodajnom kanalu:** - Otvorite `http://localhost:8000/de`. - Proizvodi se učitavaju koristeći njemački prodajni kanal i valutu EUR. 3. **Provjera višejezičnosti:** - Otvorite `http://localhost:8000/en`. - Provjerite da li se interfejs prikazuje na engleskom jeziku sa istim proizvodima. --- ## 5.6. Kriterijumi Prihvatljivosti (Acceptance Criteria) - [ ] Oba storefronta se pokreću bez konflikata na definisanim portovima (8000 i 8001). - [ ] Svaki storefront šalje svoj `NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY` u zaglavlju svakog zahtjeva prema backendu. - [ ] `next-intl` omogućava prebacivanje jezika `/de` i `/en` bez gubitka artikala u korpi. - [ ] Standardni Medusa checkout, login i korpa funkcionišu bez ikakvih modifikacija koda startera.