6.4 KiB
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:
- 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
ProductVariantsa sopstvenim SKU-om, cijenom i zalihama.
- 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).
- B2B Cjenovnici (Medusa Price Lists):
- Veleprodajne cijene za HoReCa sektor povezane sa
Customer Groups.
- Veleprodajne cijene za HoReCa sektor povezane sa
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:
{
"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:
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<string, string | undefined>
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 (
<div className="mt-8 border-t border-gray-200 pt-6">
<h3 className="text-base font-semibold text-gray-900 mb-4">
Tehničke Specifikacije Modela
</h3>
<dl className="grid grid-cols-1 gap-x-4 gap-y-4 sm:grid-cols-2">
{specifications.map((spec, index) => (
<div key={index} className="border-b border-gray-100 pb-3">
<dt className="text-xs text-gray-500 font-medium uppercase tracking-wider">
{spec.label}
</dt>
<dd className="mt-1 text-sm font-medium text-gray-900">
{spec.value}
</dd>
</div>
))}
</dl>
</div>
)
}
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:
import ProductSpecs from "@modules/products/components/product-specs"
// ... unutar ProductTemplate komponente:
<ProductInfo product={product} />
<ProductSpecs product={product} />
<ProductActions product={product} region={region} />
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:
- Kreiranje B2B grupe kupaca:
- U adminu otvorite Customers -> Customer Groups.
- Kreirajte grupu
HoReCa B2B Partneri.
- 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).
- 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
- 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.
- Otvorite proizvod na
- Provjera tehničkih specifikacija:
- Provjera 2: Prikazana je lista specifikacija (UV zaštita UPF 50+, Otpornost na vjetar Klasa 6 Beaufort, itd.).
- 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.
- Prijavite se na webshopu sa B2B nalogom koji se nalazi u grupi
6.6. Kriterijumi Prihvatljivosti (Acceptance Criteria)
- Sve varijante suncobrana (dimenzija, boja) imaju ispravne cijene i SKU kodove.
- Tehničke specifikacije iz
product.metadatase čisto renderuju bez grešaka ako nedostaju pojedinačna polja. - B2B kupac dobija veleprodajnu cijenu bez promjene checkout logike.