# Faza 6: Katalog Suncobrana - Opcije, Varijante i Tehničke Specifikacije ## 6.1. Svrha i Ciljevi Faze Katalog suncobrana zahtijeva specifičnu strukturu modeliranja podataka koja obuhvata: 1. **Promjenjive opcije (Medusa Product Options & Variants):** - Dimenzije (npr. *3x3m, 4x4m, Ø 4m*) - Boja platna (npr. *Antracit Siva, Prirodna Bež, Bordo Crvena*) - Materijal konstrukcije (npr. *Pojačani Aluminijum RAL 7016, Tikovina*) - Svaka kombinacija je zaseban `ProductVariant` sa sopstvenim SKU-om, cijenom i zalihama. 2. **Fiksne tehničke specifikacije (Medusa `product.metadata`):** - Karakteristike koje vrijede za model suncobrana bez obzira na boju (npr. *UV zaštita, otpornost na vjetar po Beaufort skali, vodoodbojnost, garancija*). 3. **B2B Cjenovnici (Medusa Price Lists):** - Veleprodajne cijene za HoReCa sektor povezane sa `Customer Groups`. > [!IMPORTANT] > **Pravilo minimalne intervencije u UI:** Ne mijenjamo postojeći raspored ili elemente zvaničnog startera. Prikaz tehničkih specifikacija dodajemo kao čistu deklarativnu komponentu unutar postojeće stranice proizvoda, oslanjajući se isključivo na `product.metadata`. --- ## 6.2. Model Podataka u Medusa Backend-u ### 1. Opcije i Varijante U Medusa Adminu (ili kroz našu seed skriptu iz Faze 2), proizvod se kreira sa tri dimenzije opcija: - **Opcija 1: Dimenzija** → Vrijednosti: `3x3m`, `4x4m`, `Ø 3.5m` - **Opcija 2: Boja platna** → Vrijednosti: `Antracit Siva`, `Prirodna Bež`, `Bordo Crvena` - **Opcija 3: Konstrukcija** → Vrijednosti: `Ojačani Aluminijum`, `Tikovina Drvo` ### 2. Tehničke Specifikacije u `product.metadata` U Medusa Adminu na formi proizvoda (sekcija **Metadata**) unose se ključevi: ```json { "uv_protection": "UPF 50+ (blokira preko 99% UV zračenja)", "wind_resistance": "Klasa 6 Beaufort (izdržava vjetar do 60 km/h)", "fabric_weight": "320 g/m² 100% spin-obojeni akril / Olefin", "water_column": "1200 mm (vodeni stub sa teflonskim premazom)", "mast_diameter": "Ø 60 mm debljina stijenke 3.5 mm ojačani aluminijum", "warranty_years": "5 godina fabričke garancije na konstrukciju i platno" } ``` --- ## 6.3. Prikaz Specifikacija u Zvaničnom Storefront Starteru Kreiramo čistu komponentu koja čita ove podatke direktno iz `product.metadata`. Kreirajte datoteku `apps/storefront-de/src/modules/products/components/product-specs/index.tsx`: ```tsx import { HttpTypes } from "@medusajs/framework/types" type ProductSpecsProps = { product: HttpTypes.StoreProduct } type SpecItem = { label: string value: string | undefined } export default function ProductSpecs({ product }: ProductSpecsProps) { const metadata = (product.metadata || {}) as Record const specifications: SpecItem[] = [ { label: "UV Zaštita", value: metadata.uv_protection }, { label: "Otpornost na vjetar", value: metadata.wind_resistance }, { label: "Gramaža i sastav platna", value: metadata.fabric_weight }, { label: "Vodoodbojnost (stub)", value: metadata.water_column }, { label: "Nosivi profil (stub)", value: metadata.mast_diameter }, { label: "Fabrička garancija", value: metadata.warranty_years }, ].filter((spec) => Boolean(spec.value)) // Ako proizvod nema tehničke specifikacije u metadata, ne prikazujemo praznu sekciju if (specifications.length === 0) { return null } return (

Tehničke Specifikacije Modela

{specifications.map((spec, index) => (
{spec.label}
{spec.value}
))}
) } ``` ### Uključivanje u Stranicu Proizvoda U postojećoj datoteci `src/app/[countryCode]/(main)/products/[handle]/page.tsx` unutar zvaničnog startera, dodajte komponentu ispod opisa proizvoda: ```tsx import ProductSpecs from "@modules/products/components/product-specs" // ... unutar ProductTemplate komponente: ``` --- ## 6.4. Postavljanje B2B Veleprodajnih Cjenovnika (Price Lists) Medusa v2 ima ugrađen sistem pravila za cjenovnike koji eliminiše potrebu za pisanjem custom B2B logike: 1. **Kreiranje B2B grupe kupaca:** - U adminu otvorite **Customers -> Customer Groups**. - Kreirajte grupu `HoReCa B2B Partneri`. 2. **Kreiranje B2B Cjenovnika:** - Otvorite **Pricing -> Price Lists** i kliknite **Create Price List**. - **Title:** `HoReCa Veleprodajni Cjenovnik - DE`. - **Type:** `Override` (zamjenjuje standardne maloprodajne cijene). - **Customer Groups Rule:** Odaberite grupu `HoReCa B2B Partneri`. - **Sales Channel:** Odaberite prodajni kanal `Suncobrani DE`. - **Unos Cijena:** Za svaki SKU suncobrana unesite ugovorenu veleprodajnu cijenu (npr. umjesto 550.00 EUR unesite 390.00 EUR). 3. **Automatsko Primjenjivanje na Storefrontu:** - Kada se kupac koji pripada ovoj grupi uloguje na storefrontu, Medusa SDK automatski šalje njegov auth token, a backend vraća B2B cijene u katalogu i u korpi. --- ## 6.5. Korak-po-Korak Testiranje i Verifikacija 1. **Provjera opcija i varijanti:** - Otvorite proizvod na `http://localhost:8000/de/products/gastro-master-suncobran`. - Promijenite dimenziju sa *3x3m* na *4x4m*. - **Provjera 1:** Cijena se automatski mijenja sa 550,00 EUR na 790,00 EUR. 2. **Provjera tehničkih specifikacija:** - **Provjera 2:** Prikazana je lista specifikacija (UV zaštita UPF 50+, Otpornost na vjetar Klasa 6 Beaufort, itd.). 3. **Provjera B2B cjenovnika:** - Prijavite se na webshopu sa B2B nalogom koji se nalazi u grupi `HoReCa B2B Partneri`. - **Provjera 3:** Na istoj stranici cijena suncobrana 3x3m se automatski prikazuje kao 390,00 EUR. --- ## 6.6. Kriterijumi Prihvatljivosti (Acceptance Criteria) - [ ] Sve varijante suncobrana (dimenzija, boja) imaju ispravne cijene i SKU kodove. - [ ] Tehničke specifikacije iz `product.metadata` se čisto renderuju bez grešaka ako nedostaju pojedinačna polja. - [ ] B2B kupac dobija veleprodajnu cijenu bez promjene checkout logike.