Files
Suman/docs/implementation-plan/phase-06-umbrella-catalog-and-specs.md
Nermin Karic f5e2fcbf98 first commit
2026-11-22 21:49:17 +01:00

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:

  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:

{
  "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:

  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.