155 lines
6.4 KiB
Markdown
155 lines
6.4 KiB
Markdown
# 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<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:
|
|
|
|
```tsx
|
|
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.
|
|
|