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

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.