first commit
This commit is contained in:
@@ -0,0 +1,79 @@
|
||||
# Faza 01: HR Webshop i Multi-Channel Sinhronizacija (`apps/suman-hrvatska`)
|
||||
**Prioritet projekta:** PRIORITET 1 (Soft opening: 15. 01. 2027. / Primopredaja: 15. 02. 2027.)
|
||||
|
||||
---
|
||||
|
||||
## 1. Cilj Faze
|
||||
U skladu sa ugovorom (Tačka 1 i Tačka 19), **webshop za Hrvatsku (`shop.suman.hr`) je primarni fokus projekta**.
|
||||
Trenutno je sav napredni UI dizajn implementiran u `apps/suman-bosna`, dok je `apps/suman-hrvatska` ostao na bazičnom Medusa starter predlošku. Cilj ove faze je prenos i potpuna adaptacija modernog dizajna na HR storefront sa hrvatskom terminologijom, valutom EUR i povezivanjem na magacin Zagreb.
|
||||
|
||||
---
|
||||
|
||||
## 2. Zadaci za Implementaciju
|
||||
|
||||
### 2.1. Prenos UI komponenti na `apps/suman-hrvatska`
|
||||
Kopirati i prilagoditi komponente iz `apps/suman-bosna/src/modules/home/components/` u `apps/suman-hrvatska/src/modules/home/components/`:
|
||||
- `hero` (Full width sa opcijom videa ili slike, podrška za floating header overlay)
|
||||
- `partners-ticker` (Marquee sa partnerima)
|
||||
- `product-showcase` (Slajder sa 4 glavne kategorije suncobrana)
|
||||
- `mission-section` (Kartice: tradicija, vizija, standardi kvaliteta)
|
||||
- `cta-banner` (Full-bleed poziv na akciju)
|
||||
- `latest-news` (Horizontalni news slajder sa karticama)
|
||||
- `faq-section` (Dvo-kolonski harmonika FAQ)
|
||||
- `nav` (Verzija 1: Floating zaobljeni header + Verzija 2: Klasični puni header)
|
||||
- `footer` (Partnerski banner kartica + 4 kolone navigacije)
|
||||
|
||||
### 2.2. Lokalizacija na Hrvatski Jezik (HR) i Valuta EUR
|
||||
U `apps/suman-hrvatska/src/config/`:
|
||||
- `navigation.json`: "Košarica", "Moj račun", "Svi proizvodi", "Suncobrani", "Pergole", "Tende".
|
||||
- `footer.json`: Linkovi na hrvatske zakonske stranice ("Uvjeti poslovanja", "Dostava i povrat", "Privatnost podataka").
|
||||
- `hero.json`, `banner.json`, `mission.json`, `faq.json`: Lektura teksta na hrvatski standard (npr. *tjedana* umjesto *sedmica*, *uvjeti* umjesto *uslovi*, *cijene* sa oznakom € / EUR).
|
||||
|
||||
### 2.3. Povezivanje sa Medusa Backendom
|
||||
U `apps/suman-hrvatska/.env.local`:
|
||||
```env
|
||||
NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY=pk_031702290a2f70f73ecc0cf0663bf7382ee625cb2098d10d34c4b5c6623c044c
|
||||
NEXT_PUBLIC_MEDUSA_BACKEND_URL=http://localhost:9000
|
||||
NEXT_PUBLIC_DEFAULT_REGION=hr
|
||||
NEXT_PUBLIC_BASE_URL=http://localhost:8002
|
||||
```
|
||||
- Potvrditi da Publishable Key filtrira katalog isključivo za kanal `Suman d.o.o. - Hrvatska`.
|
||||
- Potvrditi da se cijene automatski prikazuju u **EUR (€)** sa stopom PDV-a od **25%**.
|
||||
- Potvrditi da se dostupnost računa prema skladištu `Distributivni Centar Suman Zagreb (HR)`.
|
||||
|
||||
---
|
||||
|
||||
## 3. Fajlovi koji se Kreiraju / Mijenjaju
|
||||
|
||||
```
|
||||
apps/suman-hrvatska/
|
||||
├── src/
|
||||
│ ├── config/
|
||||
│ │ ├── banner.json
|
||||
│ │ ├── faq.json
|
||||
│ │ ├── footer.json
|
||||
│ │ ├── hero.json
|
||||
│ │ ├── mission.json
|
||||
│ │ ├── navigation.json
|
||||
│ │ ├── news.json
|
||||
│ │ └── products-showcase.json
|
||||
│ ├── components/ui/
|
||||
│ │ ├── logo.tsx
|
||||
│ │ ├── section-header.tsx
|
||||
│ │ └── dynamic-icon.tsx
|
||||
│ ├── modules/
|
||||
│ │ ├── home/components/...
|
||||
│ │ └── layout/templates/
|
||||
│ │ ├── nav/index.tsx
|
||||
│ │ └── footer/index.tsx
|
||||
│ └── app/[countryCode]/(main)/page.tsx
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. Kriteriji Uspješnosti (DoD - Definition of Done)
|
||||
1. Storefront `apps/suman-hrvatska` se pokreće na portu `8002` bez ijedne greške.
|
||||
2. Naslovna stranica vizuelno je 100% identična visokokvalitetnom dizajnu sa plutajućim headerom, responsive prikazom i konzistentnim razmacima.
|
||||
3. Sve cijene su u EUR (€).
|
||||
4. Sav tekst na navigaciji, dugmadima, sekcijama i footeru je na standardnom hrvatskom jeziku.
|
||||
|
||||
179
docs/faze-implementacije/FAZA-02-prodajni-scenariji-i-upiti.md
Normal file
179
docs/faze-implementacije/FAZA-02-prodajni-scenariji-i-upiti.md
Normal file
@@ -0,0 +1,179 @@
|
||||
# Faza 02: Tri Prodajna Scenarija i Novi Medusa Modul za Proizvode na Upit
|
||||
**Referenca ugovora:** Tačka 3, 4, 6 i 7 (Pojašnjenje ponude 2026-WEB-070 v3.0)
|
||||
|
||||
---
|
||||
|
||||
## 1. Cilj Faze
|
||||
Suman prodaje proizvode kroz tri potpuno različita poslovna toka:
|
||||
1. **Scenarij 1a (Na zalihi)**: Roba je fizički na zalihi u skladištu (Zagreb ili Gračanica). Direktna kupovina kroz korpu i brza isporuka.
|
||||
2. **Scenarij 1b (Po narudžbi)**: Roba se proizvodi po narudžbi kupca. Kupac normalno plaća kroz checkout, uz istaknut rok izrade/isporuke (npr. *„Po narudžbi — isporuka za 10–14 radnih dana“*).
|
||||
3. **Scenarij 2 (Na upit)**: **Isključivo za tende, pergole i nestandardne projekte**. Nema automatske cijene i nema dugmeta za dodavanje u korpu. Umjesto toga, razvija se **novi Medusa v2 modul za upite** koji se maksimalno oslanja na postojeći Medusa ekosistem (katalog, kanale, administraciju i widgete).
|
||||
|
||||
---
|
||||
|
||||
## 2. Novi Medusa v2 Modul za Proizvode i Upite (`inquiry` modul)
|
||||
|
||||
Kako bi se maksimalno iskoristio Medusa.js framework bez improvizovanih vanjskih baza ili nepovezanih skripti, kreira se formalni Medusa v2 modul:
|
||||
📁 `apps/backend/src/modules/inquiry/`
|
||||
|
||||
```
|
||||
apps/backend/src/modules/inquiry/
|
||||
├── index.ts # Definicija modula (Module Definition)
|
||||
├── models/
|
||||
│ └── inquiry.ts # Data Model definisan preko model.define
|
||||
├── service.ts # InquiryModuleService (nasljeđuje MedusaService)
|
||||
└── migrations/ # Automatske MikroORM migracije za PostgreSQL
|
||||
```
|
||||
|
||||
### 2.1. Data Model Upita (`apps/backend/src/modules/inquiry/models/inquiry.ts`)
|
||||
Definisanje modela korištenjem zvaničnog `@medusajs/framework/utils`:
|
||||
```typescript
|
||||
import { model } from "@medusajs/framework/utils"
|
||||
|
||||
export const Inquiry = model.define("inquiry", {
|
||||
id: model.id().primaryKey(),
|
||||
name: model.text(),
|
||||
email: model.text(),
|
||||
phone: model.text(),
|
||||
company_name: model.text().nullable(),
|
||||
city: model.text(),
|
||||
dimensions: model.text().nullable(), // npr. "6x4m, terasa restorana"
|
||||
message: model.text(),
|
||||
status: model.enum([
|
||||
"new", // Novi neobrađeni upit
|
||||
"contacted", // Kupac kontaktiran
|
||||
"quote_sent", // Ponuda pripremljena i poslata
|
||||
"won", // Realizovana prodaja
|
||||
"lost", // Otkazano / Nerealizovano
|
||||
"archived" // Arhivirano
|
||||
]).default("new"),
|
||||
notes: model.text().nullable(), // Interne zabilješke komercijaliste
|
||||
metadata: model.json().nullable(), // Dodatna polja (tip montiranja, boja fasade, itd.)
|
||||
})
|
||||
```
|
||||
|
||||
### 2.2. Remote Links — Povezivanje sa Postojećim Medusa Entitetima
|
||||
Maksimalno iskorištavamo postojeće Medusa v2 module putem Remote Links mehanizma (`defineLink`):
|
||||
`apps/backend/src/links/inquiry-links.ts`
|
||||
|
||||
1. **Veza sa Medusa Katalogom Proizvoda (`Modules.PRODUCT`)**:
|
||||
- Svaki upit se povezuje sa postojećim Medusa proizvodom (npr. *Regulus Bioklimatska Pergola*, *Atika Tenda*).
|
||||
- Koriste se već uneseni nazivi, opisi, tehničke specifikacije i galerije slika iz Medusa baze.
|
||||
2. **Veza sa Prodajnim Kanalom (`Modules.SALES_CHANNEL`)**:
|
||||
- Upit se veže za prodajni kanal (`Suman d.o.o. - Hrvatska` ili `Suman d.o.o. - Bosna i Hercegovina`).
|
||||
- Ovo automatski omogućava **izolaciju ovlasti**: administrator u Zagrebu vidi samo upite sa `shop.suman.hr`, a administrator u Gračanici samo sa `shop.suman.ba`.
|
||||
3. **Veza sa Kupcem (`Modules.CUSTOMER`)**:
|
||||
- Ako je kupac već registrovan u Medusi, upit se automatski veže za njegov profil i CRM historiju.
|
||||
|
||||
---
|
||||
|
||||
## 3. Upravljanje Proizvodima na Upit u Medusa Adminu
|
||||
|
||||
Kako bi administratori mogli jednostavno označiti koji proizvodi idu preko upita i pratiti pristigle upite, koriste se zvanične Medusa Admin ekstenzije (`@medusajs/admin-sdk` i `@medusajs/ui`):
|
||||
|
||||
### 3.1. Admin Widget na Detaljima Proizvoda (`product.details.after`)
|
||||
`apps/backend/src/admin/widgets/product-inquiry-widget.tsx`
|
||||
- Ubacuje se direktno na Medusinu ugrađenu stranicu proizvoda (`/app/products/:id`).
|
||||
- Sadrži:
|
||||
- **Prekidač (Switch / Toggle)**: *"Prodajni scenarij: Proizvod na upit (Quote Only)"*.
|
||||
- **Polja za postavke upita**: Oznaka dugmeta (npr. *"Zatražite izmjeru i ponudu"*), zahtijevana polja (npr. traži unos dimenzija prostora).
|
||||
- **Pregled upita za taj proizvod**: Mini-tabela sa svim kupcima koji su poslali upit specifično za taj model tende ili pergole.
|
||||
|
||||
### 3.2. Namjenska Admin Stranica: `/app/inquiries` (Pregled Svih Upita)
|
||||
`apps/backend/src/admin/routes/inquiries/page.tsx`
|
||||
- Kreira novu stavku u glavnom meniju Medusa Admina: **"Upiti i Ponude"**.
|
||||
- Prikazuje tabelu sa svim prispjelim upitima sa filtriranjem po:
|
||||
- **Tržištu** (Hrvatska / BiH)
|
||||
- **Statusu** (`Novi`, `Kontaktiran`, `Ponuda poslata`, `Završeno`)
|
||||
- **Proizvodu** (Pergole, Kasetne tende, Vertikalne tende)
|
||||
- **Datumu prijema**
|
||||
- Klikom na red u tabeli otvara se bočni panel (**Drawer**) sa kompletnim podacima kupca, porukom, dimenzijama i mogućnošću unosa internih bilješki i promjene statusa.
|
||||
|
||||
---
|
||||
|
||||
## 4. Workflows i Automatske Notifikacije
|
||||
|
||||
### 4.1. Medusa Workflow: `createInquiryWorkflow`
|
||||
`apps/backend/src/workflows/create-inquiry.ts`
|
||||
1. **Validacija ulaznih podataka**: Provjera ispravnosti emaila, telefona i postojanja proizvoda.
|
||||
2. **Kreiranje zapisa u bazi**: Upis u tabelu `inquiry` preko `InquiryModuleService`.
|
||||
3. **Povezivanje Remote Linkova**: Automatsko vezivanje za proizvod i prodajni kanal.
|
||||
4. **Emitovanje događaja**: `eventBus.emit("inquiry.created", { id, sales_channel_id })`.
|
||||
|
||||
### 4.2. Subscriber za Email Notifikacije (`subscribers/inquiry-notifier.ts`)
|
||||
- **Email komercijali Sumana**: Obavještava prodajni tim o novom upitu sa svim detaljima (dimenzije, grad, telefon, link direktno u Medusa Admin).
|
||||
- **Email potvrde kupcu**: *"Zahvaljujemo na interesu za [Naziv Proizvoda]. Vaš upit je zaprimljen i naš komercijalni tim će vas kontaktirati u roku od 24 radna sata."*
|
||||
|
||||
---
|
||||
|
||||
## 5. Storefront Prikaz (Korisničko Iskustvo na Webu)
|
||||
|
||||
### 5.1. Tri Prodajna Scenarija na PDP Stranici (`ProductActions`)
|
||||
Na stranici proizvoda u `apps/suman-hrvatska` i `apps/suman-bosna`, komponenta automatski prepoznaje prodajni model:
|
||||
|
||||
1. **Scenarij 1a (`in_stock`) — Na zalihi**:
|
||||
- Zeleni bedž: `✓ Na zalihi` (dostava 2–4 radna dana).
|
||||
- Standardni prikaz cijene i dugme *"Dodaj u košaricu"*.
|
||||
2. **Scenarij 1b (`made_to_order`) — Po narudžbi**:
|
||||
- Narandžasti bedž: `⏱ Po narudžbi — isporuka za {lead_time}`.
|
||||
- Prikaz cijene i dugme *"Naruči uz izradu"*.
|
||||
- U korpi i na računu jasno istaknut rok isporuke za tu stavku.
|
||||
3. **Scenarij 2 (`quote_only`) — Proizvod na upit (Tende i Pergole)**:
|
||||
- **Cijena je sakrivena** (nema polja za cijenu niti nula KM/EUR).
|
||||
- **Dugme za korpu je uklonjeno**.
|
||||
- Prikazuje se istaknuto primarno dugme: *"Zatražite ponudu i savjetovanje"*.
|
||||
- Klikom se otvara responzivna forma prilagođena proizvodu.
|
||||
|
||||
### 5.2. Forma za Slanje Upita (`InquiryModal` / `InquiryForm`)
|
||||
`src/modules/products/components/inquiry-modal/index.tsx`
|
||||
- Polja:
|
||||
- Ime i prezime
|
||||
- Naziv firme (opciono)
|
||||
- E-mail i Broj telefona
|
||||
- Grad / Lokacija ugradnje
|
||||
- Okvirne dimenzije prostora (širina x izbačaj u metrima)
|
||||
- Poruka / Opis prostora (terasa, dvorište, balkon)
|
||||
- Podaci se šalju na `POST /store/inquiries`.
|
||||
- Kupac odmah dobija potvrdu na ekranu sa brojem upita.
|
||||
|
||||
---
|
||||
|
||||
## 6. Fajlovi koji se Kreiraju / Mijenjaju
|
||||
|
||||
```
|
||||
apps/backend/
|
||||
├── src/
|
||||
│ ├── modules/inquiry/ # NOVI MEDUSA V2 MODUL
|
||||
│ │ ├── index.ts
|
||||
│ │ ├── models/inquiry.ts
|
||||
│ │ ├── service.ts
|
||||
│ │ └── migrations/...
|
||||
│ ├── links/inquiry-links.ts # Remote Links (Product & SalesChannel)
|
||||
│ ├── api/
|
||||
│ │ ├── store/inquiries/route.ts # Storefront POST API
|
||||
│ │ └── admin/inquiries/route.ts # Admin GET & PATCH API
|
||||
│ ├── workflows/create-inquiry.ts # Medusa workflow za unos upita
|
||||
│ ├── subscribers/inquiry-notifier.ts # Email obavijesti
|
||||
│ └── admin/
|
||||
│ ├── routes/inquiries/page.tsx # Samostalni Admin ekran za upite
|
||||
│ └── widgets/product-inquiry-widget.tsx # Widget na detaljima proizvoda
|
||||
|
||||
apps/suman-hrvatska/ & apps/suman-bosna/
|
||||
├── src/
|
||||
│ ├── modules/products/
|
||||
│ │ ├── components/
|
||||
│ │ │ ├── product-actions/index.tsx # Prepoznavanje quote_only scenarija
|
||||
│ │ │ ├── product-price/index.tsx # Sakrivanje cijene za quote_only
|
||||
│ │ │ ├── sale-scenario-badge/index.tsx # Bedževi raspoloživosti
|
||||
│ │ │ └── inquiry-modal/index.tsx # Responzivna forma za slanje upita
|
||||
│ │ └── templates/index.tsx # Layout stranice proizvoda
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 7. Kriteriji Uspješnosti (DoD)
|
||||
1. **Medusa Admin ima novu stavku "Upiti i Ponude"** sa tabelom, statusima i bočnim Drawerom.
|
||||
2. **Na svakom proizvodu u Medusa Adminu postoji widget** kojim se proizvod može jednim klikom postaviti kao "Na upit", uz uvid u sve upite za taj artikal.
|
||||
3. Za tende i pergole na webshopu **nema cijene niti dugmeta za kupovinu** — prikazuje se dugme *"Zatražite ponudu"*.
|
||||
4. Popunjavanje i slanje forme na webshopu automatski kreira zapis u Medusa bazi, povezuje ga sa proizvodom i kanalom, te šalje email notifikacije.
|
||||
5. Administrator za Hrvatsku vidi samo upite sa `shop.suman.hr`, a administrator za BiH samo sa `shop.suman.ba`.
|
||||
@@ -0,0 +1,159 @@
|
||||
# Faza 03: Dinamički 2D Konfigurator Suncobrana (Medusa-Driven & Responsive)
|
||||
**Referenca ugovora:** Tačka 2, 12, 13 i 17 (Pojašnjenje ponude 2026-WEB-070 v3.0)
|
||||
|
||||
---
|
||||
|
||||
## 1. Cilj Faze
|
||||
Implementirati **2D Konfigurator suncobrana** direktno integrisan u webshop sa mogućnošću trenutne kupovine konfigurisane stavke kroz standardnu korpu i checkout.
|
||||
|
||||
> [!IMPORTANT]
|
||||
> ### KLJUČNI ZAHTJEV ZA DINAMIČNOST I VIZUELNI PRIKAZ
|
||||
> 1. **Trenutni vizuelni prikaz**: Budući da klijent još nije dostavio konačne 2D PNG rendere (rok po ugovoru je 01. 12. 2026.), konfigurator mora **već sada imati živu vizuelnu interakciju** — odabir boje platna u realnom vremenu mijenja boju kupole suncobrana, odabir konstrukcije mijenja izgled stuba/krakova, a odabir postolja mijenja bazu suncobrana pomoću slojevitog SVG/Canvas/CSS renderovanja.
|
||||
> 2. **Medusa-Driven (Bez programiranja)**: Arhitektura mora biti u potpunosti dinamička. Sve opcije, boje, cijene i postolja čitaju se iz Medusa baze. Kada administrator u Medusa Adminu doda novu boju platna ili novi tip postolja, **konfigurator to automatski prikazuje bez potrebe za izmjenom koda na frontendu**.
|
||||
> 3. **100% Responsive**: Besprijekoran prikaz i lakoća korištenja na mobilnim telefonima, tabletima i velikim desktop ekranima.
|
||||
|
||||
---
|
||||
|
||||
## 2. Arhitektura Podataka u Medusa Backend-u
|
||||
|
||||
Konfigurator koristi standardni Medusa v2 sistem opcija i varijanti (`ProductOption` i `ProductVariant`), dopunjen sa vizuelnim atributima u `metadata`:
|
||||
|
||||
### 2.1. Definicija Opcija Proizvoda (`ProductOptions`)
|
||||
Za svaki model suncobrana (npr. *Suncobran Prestige*, *Suncobran Magnum*, *Suncobran Console*), u Medusi se kreiraju opcije:
|
||||
|
||||
1. **`Dimenzija i Oblik`**:
|
||||
- Vrijednosti: `3.0 x 3.0 m Kvadratni`, `3.5 x 3.5 m Kvadratni`, `4.0 x 4.0 m Kvadratni`, `Ø 4.0 m Okrugli`
|
||||
2. **`Boja Platna`**:
|
||||
- Vrijednosti sa `metadata` bojom:
|
||||
- `Antracit siva` (`color_hex: "#2B2D2F"`)
|
||||
- `Bež / Natur` (`color_hex: "#E8D8C8"`)
|
||||
- `Bordo crvena` (`color_hex: "#6B1D2F"`)
|
||||
- `Tamno plava / Navy` (`color_hex: "#012555"`)
|
||||
- `Bijela` (`color_hex: "#F5F5F5"`)
|
||||
- `Crna` (`color_hex: "#1A1A1A"`)
|
||||
3. **`Boja Konstrukcije`**:
|
||||
- Vrijednosti sa `metadata` teksturom:
|
||||
- `Eloksirani natur aluminij` (`color_hex: "#C0C0C0"`)
|
||||
- `Antracit plastificirani` (`color_hex: "#33373B"`)
|
||||
- `Bijeli plastificirani` (`color_hex: "#FFFFFF"`)
|
||||
4. **`Postolje i Učvršćenje`**:
|
||||
- Vrijednosti:
|
||||
- `Križno postolje (osnovno, bez ploča)`
|
||||
- `Križno postolje sa 4 betonske ploče (120 kg)`
|
||||
- `Podna ugradna prirubnica (za betoniranje u podlogu)`
|
||||
- `Mobilno postolje sa točkovima i kočnicom`
|
||||
5. **`Dodatna Oprema`**:
|
||||
- Vrijednosti: `Bez dodataka`, `Zaštitna navlaka sa patentom`, `LED rasvjeta na krakovima`, `Navlaka + LED rasvjeta`
|
||||
|
||||
### 2.2. Pravila Kompatibilnosti (`compatibility_rules`)
|
||||
U `product.metadata.configurator_rules` definišu se pravila:
|
||||
```json
|
||||
{
|
||||
"forbidden_combinations": [
|
||||
{
|
||||
"dimenzija": "4.0 x 4.0 m Kvadratni",
|
||||
"postolje": "Križno postolje (osnovno, bez ploča)",
|
||||
"reason_hr": "Za suncobran dimenzija 4x4m obavezno je postolje sa betonskim pločama ili podna prirubnica zbog stabilnosti na vjetru.",
|
||||
"reason_ba": "Za suncobran dimenzija 4x4m obavezno je postolje sa betonskim pločama ili podna prirubnica zbog stabilnosti na vjetru."
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3. Slojeviti 2D Canvas/SVG Engine (Frontend)
|
||||
|
||||
Komponenta `UmbrellaVisualizer` radi na principu **4 vizuelna sloja (Layers)**:
|
||||
|
||||
```
|
||||
┌────────────────────────────────────────────────────────┐
|
||||
│ Layer 4: Dodatna oprema (Navlaka / LED sjaj) │
|
||||
├────────────────────────────────────────────────────────┤
|
||||
│ Layer 3: Platno suncobrana (SVG kupola sa CSS bojom) │
|
||||
├────────────────────────────────────────────────────────┤
|
||||
│ Layer 2: Konstrukcija (Stub, zglobovi, krakovi) │
|
||||
├────────────────────────────────────────────────────────┤
|
||||
│ Layer 1: Postolje (Križ, betonske ploče ili prirubnica)│
|
||||
└────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
- **Dinamičko bojenje platna**: Boja platna se primjenjuje kao dinamička CSS maska ili SVG fill preko bazne teksture sjenčenja (`mix-blend-mode: multiply` sa realističnim naborima tkanine).
|
||||
- **Zamjena slojeva kada stignu Džafini renderi**: Kada klijent dostavi finalne PNG rendere (rok 01. 12.), u Medusa varijante se jednostavno upisuju URL-ovi gotovih PNG slojeva u `metadata.layer_image_url`, i vizuelizator automatski prelazi na fotografske slojeve bez izmjene koda!
|
||||
|
||||
---
|
||||
|
||||
## 4. Korisnički Doživljaj (UX) i Responsivnost
|
||||
|
||||
### 4.1. Desktop Prikaz (2 Kolone)
|
||||
- **Lijeva kolona (Sticky 60%)**:
|
||||
- Veliki interaktivni 2D prikaz suncobrana.
|
||||
- Dugmad za brzi pregled (Rotacija/ugao, prikaz otvoren/zatvoren suncobran, zumiranje detalja tkanine).
|
||||
- **Desna kolona (40% sa skrolovanjem)**:
|
||||
1. Naziv modela i oznaka raspoloživosti (*Na zalihi* ili *Po narudžbi — isporuka za 14 dana*).
|
||||
2. Koraci konfiguracije sa vizuelnim swatch krugovima za boje i karticama za opremu.
|
||||
3. Cijena koja se ažurira u realnom vremenu pri svakom kliku (EUR u HR, KM u BiH).
|
||||
4. Dugme *"Dodaj u košaricu"* sa sažetkom konfiguracije.
|
||||
|
||||
### 4.2. Mobilni Prikaz (Prilagođeno dodiru)
|
||||
- **Gornji dio (fiksiran ili polu-sticky)**: 2D vizuelni preview suncobrana koji se odmah ažurira.
|
||||
- **Donji dio**: Horizontalni koraci (*1. Krov → 2. Platno → 3. Boja konstrukcije → 4. Postolje → 5. Dodaci*).
|
||||
- **Fiksno donje dno (Sticky Bottom Bar)**:
|
||||
- Prikaz trenutne ukupne cijene u EUR/KM.
|
||||
- Dugme *"Dodaj konfiguraciju u košaricu"*.
|
||||
|
||||
---
|
||||
|
||||
## 5. Integracija sa Medusa Korpom i Checkoutom
|
||||
|
||||
Kada kupac klikne *"Dodaj u košaricu"*:
|
||||
1. Front-end pronalazi tačnu `ProductVariant` ili kreira stavku sa specifikacijom.
|
||||
2. U `CartLineItem.metadata` upisuju se:
|
||||
```json
|
||||
{
|
||||
"is_configured": true,
|
||||
"configured_options": {
|
||||
"model": "Suncobran Prestige",
|
||||
"dimension": "3.5 x 3.5 m Kvadratni",
|
||||
"fabric_color": "Antracit siva (#2B2D2F)",
|
||||
"frame_color": "Eloksirani natur aluminij",
|
||||
"base": "Križno postolje sa 4 betonske ploče",
|
||||
"accessories": "Zaštitna navlaka sa patentom"
|
||||
},
|
||||
"generated_sku": "SUM-PRES-3535-ANT-NAT-BASE4-COV",
|
||||
"preview_snapshot_url": "..."
|
||||
}
|
||||
```
|
||||
3. Cijena se verifikuje na Medusa backendu iz cjenovnika pripadajuće regije.
|
||||
4. U korpi, na checkoutu, u email potvrdi i u Medusa Adminu prikazuje se kompletan spisak opcija i slika konfiguracije.
|
||||
|
||||
---
|
||||
|
||||
## 6. Fajlovi koji se Kreiraju / Mijenjaju
|
||||
|
||||
```
|
||||
apps/suman-hrvatska/ & apps/suman-bosna/
|
||||
├── src/
|
||||
│ ├── modules/configurator/
|
||||
│ │ ├── components/
|
||||
│ │ │ ├── umbrella-configurator.tsx # Glavni kontejner konfiguratora
|
||||
│ │ │ ├── umbrella-visualizer.tsx # 2D Canvas/SVG slojeviti prikaz
|
||||
│ │ │ ├── option-selector-tabs.tsx # Koraci odabira (platno, postolje...)
|
||||
│ │ │ ├── color-swatch-picker.tsx # Izbor boje platna i konstrukcije
|
||||
│ │ │ ├── compatibility-alert.tsx # Upozorenje na nedozvoljene kombinacije
|
||||
│ │ │ └── configurator-sticky-bar.tsx # Mobilna traka sa cijenom i korpom
|
||||
│ │ └── lib/
|
||||
│ │ ├── compatibility-checker.ts # Logika pravila kompatibilnosti
|
||||
│ │ └── price-calculator.ts # Proračun cijene konfiguracije
|
||||
│ └── app/[countryCode]/(main)/products/[handle]/page.tsx
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 7. Kriteriji Uspješnosti (DoD)
|
||||
1. Konfigurator je dostupan na stranici suncobrana i odmah vizuelno reaguje na promjenu svake opcije (boja platna, konstrukcija, postolje).
|
||||
2. Dodavanje nove boje ili novog postolja u Medusa Adminu automatski se pojavljuje u konfiguratoru na frontendu.
|
||||
3. Nedozvoljene kombinacije (npr. preveliko platno bez adekvatnog postolja) su onemogućene sa jasnom porukom kupcu.
|
||||
4. Konfigurisani proizvod se dodaje u korpu sa tačnim SKU-om, cijenom i spiskom opcija, te se može kupiti kroz standardni checkout.
|
||||
5. Prikaz na mobilnom telefonu je potpuno fluidan, brz i jednostavan za korištenje jednim prstom.
|
||||
|
||||
@@ -0,0 +1,103 @@
|
||||
# Faza 04: Dostavne Zone, Lično Preuzimanje i Pravna Lica (R1 Račun)
|
||||
**Referenca ugovora:** Tačka 9 i 18 (Pojašnjenje ponude 2026-WEB-070 v3.0)
|
||||
|
||||
---
|
||||
|
||||
## 1. Cilj Faze
|
||||
1. **Dostavne zone i lično preuzimanje**: Suncobrani i postolja su glomazna i teška roba. Za Hrvatsku je obavezno razdvajanje dostave na **Kopno** i **Otoke** (zbog trajektnog transporta), kao i opcija **Ličnog preuzimanja u Zagrebu (0 EUR)**. Za BiH se postavlja zona **Cijela BiH** i **Lično preuzimanje u Gračanici (0 KM)**.
|
||||
2. **Kupovina za pravna lica (R1 Račun)**: Značajan dio kupaca Sumana su ugostitelji, hoteli i preduzeća. U checkoutu je obavezno omogućiti unos podataka za firmu: **OIB za Hrvatsku** (uz validaciju od 11 cifara) te **JIB i PDV broj za BiH**.
|
||||
3. **PDV obračun**: Jasno iskazan PDV (25% za HR, 17% za BiH) na svim koracima korpe i checkouta.
|
||||
|
||||
---
|
||||
|
||||
## 2. Implementacija Dostave i Ličnog Preuzimanja
|
||||
|
||||
### 2.1. Konfiguracija Shipping Opcija u Medusi
|
||||
U Medusa backendu se za regije konfigurišu namjenske opcije dostave:
|
||||
|
||||
#### Za Hrvatsku (`region_hr`):
|
||||
1. **Dostava na adresu — Kopno**:
|
||||
- Cijena: npr. 25,00 € (besplatno za narudžbe iznad zadanog iznosa, npr. 500 €).
|
||||
- Rok isporuke: 2–4 radna dana.
|
||||
2. **Dostava na adresu — Otoci**:
|
||||
- Cijena: prilagođena otočna tarifa (npr. 45,00 €).
|
||||
- Rok isporuke: 3–7 radnih dana.
|
||||
3. **Lično preuzimanje — Distributivni centar Zagreb**:
|
||||
- Cijena: **0,00 € (Besplatno)**.
|
||||
- Adresa: *Suman d.o.o. Zagreb, Hrvatska*.
|
||||
- Uputstvo kupcu: Roba se može preuzeti nakon primitka email obavijesti da je narudžba spremna.
|
||||
|
||||
#### Za Bosnu i Hercegovinu (`region_ba`):
|
||||
1. **Standardna brza dostava — Cijela BiH**:
|
||||
- Cijena: npr. 15,00 KM (besplatno iznad zadanog iznosa).
|
||||
- Rok isporuke: 24/48h radnim danima.
|
||||
2. **Lično preuzimanje — Centrala Gračanica**:
|
||||
- Cijena: **0,00 KM (Besplatno)**.
|
||||
- Adresa: *Branilaca grada bb, 75320 Gračanica, BiH*.
|
||||
|
||||
---
|
||||
|
||||
## 3. Kupovina za Pravna Lica (R1 Račun u Checkoutu)
|
||||
|
||||
### 3.1. Checkout Korak: Podaci o Kupcu i Računu
|
||||
U komponentu `ShippingAddress` i `BillingAddress` na checkoutu dodaje se:
|
||||
|
||||
```
|
||||
[ ] Kupujem kao pravna osoba / Trebam R1 račun za firmu
|
||||
--------------------------------------------------------
|
||||
(Ako je označeno, otvaraju se polja):
|
||||
* Naziv tvrtke / obrta: [ ]
|
||||
* OIB (Hrvatska): [ 11 cifara ] (za shop.suman.hr)
|
||||
* JIB / PDV broj (BiH): [ 13 cifara / 12 cifara ] (za shop.suman.ba)
|
||||
* Ime i prezime kontakt osobe: [ ]
|
||||
```
|
||||
|
||||
### 3.2. Validacija OIB-a (Hrvatska)
|
||||
Implementirati matematičku validaciju OIB-a prema standardu **ISO 7064 (MOD 11, 10)**:
|
||||
- Tačno 11 brojčanih znakova.
|
||||
- Kontrolna cifra se provjerava prije nastavka checkouta.
|
||||
- Ako OIB nije ispravan, kupac dobija jasnu poruku: *"Uneseni OIB nije valjan. Molimo provjerite unos."*
|
||||
|
||||
### 3.3. Pohrana u Bazi (`Order Metadata`)
|
||||
Podaci o firmi se spremaju u `order.metadata`:
|
||||
```json
|
||||
{
|
||||
"is_business_order": true,
|
||||
"company_name": "Ugostiteljstvo d.o.o.",
|
||||
"tax_id": "12345678901",
|
||||
"tax_id_type": "OIB",
|
||||
"vat_rate": 0.25,
|
||||
"pickup_location": "Zagreb DC"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. Fajlovi koji se Kreiraju / Mijenjaju
|
||||
|
||||
```
|
||||
apps/backend/
|
||||
├── src/
|
||||
│ ├── scripts/setup-shipping-zones.ts # Kreiranje zona Kopno, Otoci, Zagreb, Gračanica
|
||||
│ └── workflows/validate-tax-id.ts # Validacija OIB / JIB
|
||||
|
||||
apps/suman-hrvatska/ & apps/suman-bosna/
|
||||
├── src/
|
||||
│ ├── lib/util/oib-validator.ts # Algoritam za validaciju OIB-a
|
||||
│ ├── modules/checkout/
|
||||
│ │ ├── components/
|
||||
│ │ │ ├── addresses/index.tsx # R1 checkbox i polja za firmu
|
||||
│ │ │ ├── shipping/index.tsx # Prikaz zona i ličnog preuzimanja
|
||||
│ │ │ └── review/index.tsx # Prikaz podataka za R1 račun
|
||||
│ │ └── templates/checkout-summary/index.tsx # Prikaz PDV-a i dostave
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 5. Kriteriji Uspješnosti (DoD)
|
||||
1. Kupac u Hrvatskoj može odabrati dostavu na Kopno, Otoke ili besplatno preuzimanje u Zagrebu.
|
||||
2. Kupac u BiH može odabrati dostavu u BiH ili besplatno preuzimanje u Gračanici.
|
||||
3. Označavanjem opcije za R1 račun otvaraju se polja za firmu i OIB/JIB.
|
||||
4. Neispravan OIB zaustavlja prelazak na plaćanje uz jasnu poruku greške.
|
||||
5. Na potvrdi narudžbe i u emailu jasno su ispisani podaci firme, OIB, odabrana zona i iznos PDV-a.
|
||||
|
||||
@@ -0,0 +1,81 @@
|
||||
# Faza 05: Načini Plaćanja (Kartice, Pouzeće i Virman)
|
||||
**Referenca ugovora:** Tačka 10 (Pojašnjenje ponude 2026-WEB-070 v3.0)
|
||||
|
||||
---
|
||||
|
||||
## 1. Cilj Faze
|
||||
U skladu sa ugovorom, kupcima na oba webshopa moraju biti omogućena tri ravnopravna načina plaćanja:
|
||||
1. **Kartično online plaćanje (Kreditne i debitne kartice)**: Integracija jednog platnog procesora (Monri WebPay, CorvusPay, WSPay ili Stripe) sa 3D Secure 2.0 zaštitom.
|
||||
2. **Plaćanje pouzećem (Gotovinom kuriru pri preuzimanju)**: Uključeno bez dodatnog troška.
|
||||
3. **Plaćanje uplatom na račun (Virman / Opća uplatnica)**: Uključeno bez dodatnog troška, od izuzetnog značaja za pravna lica (B2B).
|
||||
|
||||
---
|
||||
|
||||
## 2. Implementacija Načina Plaćanja
|
||||
|
||||
### 2.1. Plaćanje Uplatom na Račun (Virman / Transakcijski Račun)
|
||||
Kada kupac odabere *"Uplata na račun / Virmansko plaćanje"*:
|
||||
- Narudžba se kreira sa statusom plaćanja `awaiting_payment`.
|
||||
- Na ekranu potvrde i u automatskom emailu kupac dobija generisane podatke za uplatu:
|
||||
- **Za Hrvatsku (`shop.suman.hr`)**:
|
||||
- Primalac: *Suman d.o.o., Zagreb*
|
||||
- IBAN: *HR... (račun u EUR)*
|
||||
- Model i poziv na broj: *HR01 {broj_narudžbe}*
|
||||
- Iznos: *{ukupno_eur} €*
|
||||
- Opis plaćanja: *Narudžba suncobrana br. {broj_narudžbe}*
|
||||
- **Za Bosnu i Hercegovinu (`shop.suman.ba`)**:
|
||||
- Primalac: *„SUMAN“ d.o.o. Gračanica*
|
||||
- Transakcijski račun: *161... (BAM / KM)*
|
||||
- Poziv na broj: *{broj_narudžbe}*
|
||||
- Iznos: *{ukupno_km} KM*
|
||||
|
||||
### 2.2. Plaćanje Pouzećem (Gotovina pri Preuzimanju)
|
||||
- Za kupce koji žele platiti kuriru prilikom dostave.
|
||||
- Narudžba se kreira sa statusom plaćanja `pending_cod`.
|
||||
- Na potvrdi se ispisuje napomena: *"Pripremite tačan iznos gotovine za kurirsku službu prilikom preuzimanja pošiljke."*
|
||||
|
||||
### 2.3. Kartični Platni Procesor (Online Plaćanje)
|
||||
- Kreira se Medusa Payment Provider modul:
|
||||
`apps/backend/src/modules/payment-gateway/`
|
||||
- Podržava standardni tok:
|
||||
1. `initiatePayment`: Kreira sesiju plaćanja sa iznosom, valutom i ID-em korpe.
|
||||
2. `authorizePayment`: Preusmjerava na formu procesora ili ugrađeni 3DS modal.
|
||||
3. Webhook endpoint `POST /store/payment-webhook` koji prima obavijest od procesora i automatski označava narudžbu kao `captured` (plaćena).
|
||||
|
||||
> [!NOTE]
|
||||
> **Preporuka za procesor:** Ukoliko Suman posluje u HR i BiH, **Monri Payments** je regionalni lider sa direktnom podrškom za banke u obje države, ili **CorvusPay** / **WSPay** za tržište Hrvatske.
|
||||
|
||||
---
|
||||
|
||||
## 3. Email Notifikacije Kupcima
|
||||
Koristi se ugrađeni notification modul sa predlošcima:
|
||||
1. **Potvrda narudžbe**: Detaljna specifikacija konfigurisanog suncobrana, slika, rok isporuke i instrukcije za uplatu.
|
||||
2. **Narudžba u proizvodnji / nabavi**: Obavijest kupcu da je izrada počela.
|
||||
3. **Narudžba spremna za isporuku / preuzimanje**: Sadrži broj pošiljke (tracking) ili lokaciju skladišta za preuzimanje.
|
||||
|
||||
---
|
||||
|
||||
## 4. Fajlovi koji se Kreiraju / Mijenjaju
|
||||
|
||||
```
|
||||
apps/backend/
|
||||
├── src/
|
||||
│ ├── modules/payment/
|
||||
│ │ ├── bank-transfer-provider.ts # Virman / uplatnica
|
||||
│ │ ├── cash-on-delivery-provider.ts # Pouzeće
|
||||
│ │ └── card-payment-provider.ts # Kartični gateway (Monri/Corvus/Stripe)
|
||||
│ └── subscribers/order-placed-mailer.ts # Slanje potvrde i uplatnice
|
||||
|
||||
apps/suman-hrvatska/ & apps/suman-bosna/
|
||||
├── src/
|
||||
│ ├── modules/checkout/components/payment/index.tsx
|
||||
│ └── modules/order/templates/order-completed-template.tsx
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 5. Kriteriji Uspješnosti (DoD)
|
||||
1. Kupac u checkoutu može odabrati: Karticu, Pouzeće ili Uplatu na račun.
|
||||
2. Odabirom uplate na račun, kupac odmah na ekranu i u emailu dobija tačne instrukcije (IBAN/račun, poziv na broj, model).
|
||||
3. Testna kartična transakcija uspješno prolazi kroz 3DS verifikaciju i narudžba se automatski bilježi kao plaćena u Medusa Adminu.
|
||||
|
||||
@@ -0,0 +1,87 @@
|
||||
# Faza 06: Medusa Admin Proširenja (Nabavni Pregled, Upiti i Izolacija)
|
||||
**Referenca ugovora:** Tačka 5 i 8 (Pojašnjenje ponude 2026-WEB-070 v3.0)
|
||||
|
||||
---
|
||||
|
||||
## 1. Cilj Faze
|
||||
1. **Pregled narudžbi za nabavu (Tačka 8)**: Za proizvode koji se rade po narudžbi, nabavnoj službi i proizvodnji Sumana potreban je poseban ekran koji **sabira iste stavke iz svih otvorenih narudžbi po SKU šifri**, uz mogućnost izvoza u Excel/CSV.
|
||||
2. **Evidencija upita za tende i pergole (Tačka 3 & 4)**: Pregled i obrada pristiglih upita za proizvode na upit unutar Medusa Admina.
|
||||
3. **Izolacija ovlasti po tržištu (Tačka 5)**: Administrator za Hrvatsku ne smije vidjeti narudžbe iz BiH i obrnuto, dok Glavni administrator ima uvid u sve.
|
||||
|
||||
---
|
||||
|
||||
## 2. Implementacija Nabavnog Pregleda (Procurement View)
|
||||
|
||||
### 2.1. API Ruta: `GET /admin/procurement`
|
||||
Backend kreira namensku agregacijsku rutu:
|
||||
`apps/backend/src/api/admin/procurement/route.ts`
|
||||
- Filtrira narudžbe koje imaju status `U proizvodnji / nabavi`.
|
||||
- Prolazi kroz sve stavke (`items`) i sabira količine prema `SKU` i konfiguraciji:
|
||||
- Npr:
|
||||
- `SUM-PRES-3535-ANT`: 18 komada (Suncobran Prestige 3.5x3.5m antracit)
|
||||
- `BASE-CONCR-120KG`: 14 komada (Betonske ploče 120kg)
|
||||
- `COVER-WATERPROOF`: 22 komada (Zaštitne navlake)
|
||||
- Vraća JSON sa zbirnim podacima i omogućava preuzimanje CSV datoteke (`?format=csv`).
|
||||
|
||||
### 2.2. Medusa Admin Custom UI Stranica
|
||||
Pomoću Medusa Admin SDK-a kreira se nova stranica u meniju:
|
||||
`apps/backend/src/admin/routes/procurement/page.tsx`
|
||||
- **Filteri**: Po tržištu (Hrvatska / BiH), po modelu suncobrana, po vremenskom periodu.
|
||||
- **Tabela zbirnih stavki**: Slika, SKU, Naziv modela, Odabrana konfiguracija, Ukupno naručeno komada, Rok isporuke.
|
||||
- **Dugme za izvoz**: *"Izvezi u Excel (CSV)"*.
|
||||
|
||||
---
|
||||
|
||||
## 3. Modul za Upite (Tende i Pergole)
|
||||
> [!NOTE]
|
||||
> *Arhitektura data modela, Remote Links i backend servisa za upite definisana je u [FAZA-02.md](./FAZA-02-prodajni-scenariji-i-upiti.md). Ova faza pokriva integraciju uloge i sigurnosnu izolaciju administratorskog pregleda.*
|
||||
|
||||
### 3.1. Admin Stranica: `/admin/inquiries`
|
||||
`apps/backend/src/admin/routes/inquiries/page.tsx`
|
||||
- Prikazuje sve pristigle upite sa webshopa (`shop.suman.hr` i `shop.suman.ba`).
|
||||
- Kolone: Datum, Tržište, Kupac (Ime, Email, Telefon), Proizvod (Pergola / Tenda), Dimenzije, Status obrade.
|
||||
- **Statusi obrade**:
|
||||
- `Novi upit` (plavo)
|
||||
- `Kupac kontaktiran` (žuto)
|
||||
- `Ponuda poslata` (ljubičasto)
|
||||
- `Završeno / Realizovano` (zeleno)
|
||||
- `Otkazano` (sivo)
|
||||
|
||||
---
|
||||
|
||||
## 4. Potpuna Sigurnosna Izolacija Ovlasti po Tržištu
|
||||
|
||||
Proširuje se postojeći middleware u `apps/backend/src/api/middlewares.ts`:
|
||||
|
||||
1. **Uloge administratora**:
|
||||
- `super_admin`: Vidi oba prodajna kanala, sve narudžbe, oba skladišta.
|
||||
- `admin_hr`: `user.metadata.sales_channel_id === "sc_suman_hr"`. Automatski filtrira `/admin/orders`, `/admin/inquiries`, `/admin/procurement` samo na Hrvatsku.
|
||||
- `admin_ba`: `user.metadata.sales_channel_id === "sc_suman_ba"`. Automatski filtrira podatke samo na Bosnu i Hercegovinu.
|
||||
2. **Pokušaj pristupa tuđoj narudžbi**: Ako HR administrator pokuša otvoriti narudžbu iz BiH, backend vraća `403 Forbidden`.
|
||||
|
||||
---
|
||||
|
||||
## 5. Fajlovi koji se Kreiraju / Mijenjaju
|
||||
|
||||
```
|
||||
apps/backend/
|
||||
├── src/
|
||||
│ ├── api/
|
||||
│ │ ├── admin/
|
||||
│ │ │ ├── procurement/route.ts # Agregacija i CSV export
|
||||
│ │ │ └── inquiries/route.ts # Pregled i izmjena statusa upita
|
||||
│ │ └── middlewares.ts # Sigurnosna izolacija po rolama
|
||||
│ └── admin/
|
||||
│ └── routes/
|
||||
│ ├── procurement/page.tsx # UI ekran za nabavku
|
||||
│ └── inquiries/page.tsx # UI ekran za upite
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 6. Kriteriji Uspješnosti (DoD)
|
||||
1. U Medusa Adminu se u bočnom meniju pojavljuju stavke *"Nabavka (Po narudžbi)"* i *"Upiti"*.
|
||||
2. Klikom na *"Izvezi u Excel"* preuzima se CSV datoteka sa tačno sabranim količinama po SKU šiframa.
|
||||
3. Upiti poslani sa forme za pergole odmah se prikazuju u listi upita sa statusom *"Novi"*.
|
||||
4. Administrator iz Hrvatske prijavljen u Admin vidi samo podatke za tržište Hrvatske.
|
||||
|
||||
@@ -0,0 +1,75 @@
|
||||
# Faza 07: Testiranje, Soft Opening i Priprema za Korporativni Web
|
||||
**Referenca ugovora:** Tačka 14, 19, 22, 23, 24 i 25 (Pojašnjenje ponude 2026-WEB-070 v3.0)
|
||||
|
||||
---
|
||||
|
||||
## 1. Cilj Faze
|
||||
1. **Sprovođenje rigorozne check-liste testiranja (Tačka 25)** prije zvanične primopredaje.
|
||||
2. **Soft Opening HR Webshopa (15. 01. 2027.)**: Puštanje `shop.suman.hr` u rad za prve stvarne narudžbe, uz praćenje rada sistema i brze ispravke.
|
||||
3. **Korisničko testiranje (UAT) i Primopredaja (do 15. 02. 2027.)**: Zajednički prolazak kroz protokol primopredaje sa SUMAN timom i potpisivanje zapisnika.
|
||||
4. **Priprema za Fazu 2 (Korporativni web do 31. 03. 2027.)**: Višejezični sajt na 4 jezika (BS, HR, DE, EN).
|
||||
|
||||
---
|
||||
|
||||
## 2. Checklista Testiranja Cijelog Kupovnog Toka (Tačka 25)
|
||||
|
||||
Prije primopredaje, obavezno se prolazi sljedeća verifikacija:
|
||||
|
||||
- [ ] **2D Konfiguracija suncobrana**:
|
||||
- Promjena platna, konstrukcije i postolja ažurira 2D prikaz bez greške.
|
||||
- Pravila kompatibilnosti onemogućavaju nedozvoljene spojeve.
|
||||
- Cijena se tačno računa i prenosi u korpu.
|
||||
- [ ] **Košarica i Checkout**:
|
||||
- Stavke nose sve odabrane opcije, SKU kod i specifikaciju.
|
||||
- Miješana korpa (artikli sa zalihe i po narudžbi) ispravno prikazuje rokove isporuke za svaku stavku.
|
||||
- [ ] **Dostavne zone i preuzimanje**:
|
||||
- Tačan obračun dostave za HR Kopno, HR Otoci i 0 EUR za Lično preuzimanje u Zagrebu.
|
||||
- [ ] **Pravna lica (R1 račun)**:
|
||||
- Validacija OIB-a (11 cifara) u Hrvatskoj; ispravan unos JIB/PDV u BiH.
|
||||
- Podaci firme ispisani na potvrdi narudžbe.
|
||||
- [ ] **Plaćanja**:
|
||||
- Kartično plaćanje testirano stvarnom transakcijom (uz automatski povrat/refund).
|
||||
- Plaćanje pouzećem uredno evidentirano.
|
||||
- Plaćanje uplatom na račun generiše tačan IBAN i poziv na broj.
|
||||
- [ ] **Email obavijesti**:
|
||||
- Kupac i komercijala odmah dobijaju email potvrde sa slikom i stavkama.
|
||||
- [ ] **Medusa Admin obrada**:
|
||||
- Narudžba vidljiva administratoru odgovarajućeg tržišta.
|
||||
- Zaliha u magacinu (Zagreb ili Gračanica) se automatski umanjuje / rezerviše.
|
||||
- Promjena statusa (*U proizvodnji → Spremno → Isporučeno*) šalje email kupcu.
|
||||
- Stavke se sabiraju u Nabavnom pregledu i izvoze u CSV.
|
||||
- [ ] **Responsivnost i brzina**:
|
||||
- Testirano na iPhone (Safari), Android (Chrome) i Desktop računarima.
|
||||
|
||||
---
|
||||
|
||||
## 3. Korporativni Web (Faza 2 — Rok: 31. 03. 2027.)
|
||||
|
||||
Nakon što se HR webshop uspješno pusti u rad 15. 02. 2027., pristupa se dovršetku korporativnog weba:
|
||||
|
||||
1. **Domene i jezici**:
|
||||
- `suman.ba`: Bosanski (BS) i Engleski (EN)
|
||||
- `suman.hr`: Hrvatski (HR) i Njemački (DE)
|
||||
2. **Sadržaj**:
|
||||
- Prezentacija kompanije (30+ godina tradicije, reference, proizvodni pogoni u Gračanici, certifikati kvaliteta ISO/CE).
|
||||
- Katalog svih sistema zaštite od sunca (uključujući zimske bašte, fasadne brisoleje, pergole i tende).
|
||||
- B2B portal za arhitekte i projektante (DWG / BIM fajlovi).
|
||||
|
||||
---
|
||||
|
||||
## 4. Održavanje i Sigurnosne Kopije (Hosting & SLA)
|
||||
|
||||
Prema Tačkama 22 i 23 ugovora:
|
||||
- **Server**: Ubuntu Cloud server u EU (2 vCPU, 8 GB RAM, 80 GB NVMe, SSL certifikati).
|
||||
- **Sigurnosne kopije (Backup)**: Dnevni backup baze i slika na odvojenu lokaciju (čuvanje 30 dana) + sedmični snapshot cijelog servera.
|
||||
- **SLA rokovi reakcije**:
|
||||
- Kritičan kvar (webshop ili plaćanje ne rade): reakcija unutar **4 radna sata**, otklanjanje najkasnije **1 radni dan**.
|
||||
- Visok prioritet: reakcija **1 radni dan**, otklanjanje **3 radna dana**.
|
||||
|
||||
---
|
||||
|
||||
## 5. Kriteriji Uspješnosti (DoD)
|
||||
1. 15. 01. 2027. uspješno pokrenut Soft Opening za `shop.suman.hr`.
|
||||
2. Do 15. 02. 2027. uspješno otklonjene sve uočene greške i potpisan zapisnik o primopredaji.
|
||||
3. Klijentu predan kompletan Git repozitorij, baza podataka i administratorski pristupi (Tačka 24).
|
||||
|
||||
33
docs/faze-implementacije/README.md
Normal file
33
docs/faze-implementacije/README.md
Normal file
@@ -0,0 +1,33 @@
|
||||
# Plan Implementacije po Fazama: SUMAN d.o.o. E-Commerce Platforma
|
||||
**Zasnovano na zvaničnom dokumentu: "Pojašnjenje ponude 2026-WEB-070 v3.0"**
|
||||
*Prioritet 1: HR Webshop (`shop.suman.hr`) | Rok: 15. 01. 2027. (Soft opening) / 15. 02. 2027. (Primopredaja)*
|
||||
|
||||
---
|
||||
|
||||
## 📌 Pregled Faza i Roadmap
|
||||
|
||||
Implementacija je podijeljena u **7 samostalnih faza**, gdje svaka faza ima definisane ciljeve, fajlove koji se mijenjaju, arhitekturu i kriterije uspješnosti:
|
||||
|
||||
| Faza | Naziv Faze | Glavni Fokus | Prioritet & Rok | Dokument |
|
||||
| :---: | :--- | :--- | :---: | :--- |
|
||||
| **01** | **HR Webshop & Multi-Channel Sinhronizacija** | Prenos UI dizajna na `suman-hrvatska`, HR jezik, EUR valuta, povezivanje kanala i magacina Zagreb | **Hitno (Faza 1)** | [FAZA-01.md](./FAZA-01-hr-webshop-sinhronizacija.md) |
|
||||
| **02** | **Tri Prodajna Scenarija & Medusa Modul za Upite** | Novi Medusa v2 modul za upite, widget za označavanje proizvoda na upit, Remote Links sa katalogom/kanalima, forma za tende/pergole | **Visok** | [FAZA-02.md](./FAZA-02-prodajni-scenariji-i-upiti.md) |
|
||||
| **03** | **Dinamički 2D Konfigurator Suncobrana** | Medusa-driven opcije (boje platna, konstrukcija, stalak, oprema), živi 2D slojeviti preview, pravila kompatibilnosti i direktna kupovina | **Visok (do 01.12.)** | [FAZA-03.md](./FAZA-03-dinamicki-2d-konfigurator-suncobrana.md) |
|
||||
| **04** | **Dostavne Zone, Preuzimanje i R1 Pravna Lica** | HR Kopno vs Otoci, Lično preuzimanje (Zagreb/Gračanica 0 EUR), R1 checkout (OIB / JIB) i PDV | **Srednji** | [FAZA-04.md](./FAZA-04-dostava-licno-preuzimanje-i-r1-pravna-lica.md) |
|
||||
| **05** | **Plaćanja: Kartice, Pouzeće i Virman** | Integracija platnog procesora (Monri/Corvus/WSPay/Stripe), Gotovina pri preuzimanju, Virmanska uplatnica sa IBAN podacima | **Srednji (do 20.12.)** | [FAZA-05.md](./FAZA-05-placanja-kartice-virman-pouzece.md) |
|
||||
| **06** | **Medusa Admin: Nabavka, Upiti i Izolacija** | Zbirni pregled stavki po narudžbi (procurement view) sa CSV izvozom, modul za upite, RBAC prava pristupa | **Srednji** | [FAZA-06.md](./FAZA-06-medusa-admin-nabavka-i-izolacija.md) |
|
||||
| **07** | **Testiranje, Soft Opening i Korporativni Web** | UAT testiranje stvarnih narudžbi (15. 1.), primopredaja (15. 2.), priprema za Korporativni web (do 31. 3.) | **Krajnji cilj** | [FAZA-07.md](./FAZA-07-testiranje-soft-opening-i-korporativni-web.md) |
|
||||
|
||||
---
|
||||
|
||||
## 🧭 Ključna Pravila za Sve Faze
|
||||
|
||||
1. **Prioritet u razvoju ima `apps/suman-hrvatska` (`shop.suman.hr`)**, a `apps/suman-bosna` (`shop.suman.ba`) je njegova direktna preslika.
|
||||
2. **2D Konfigurator je 100% dinamičan i responsive**:
|
||||
- Sve opcije (platna, konstrukcija, postolja, cijene) čitaju se iz Medusa baze. Administratori mogu u svakom trenutku u Medusa Adminu dodati novu boju ili model bez diranja programskog koda.
|
||||
- Prikaz na mobilnim uređajima i desktopu mora biti besprijekorno responzivan.
|
||||
3. **Tende i pergole nemaju korpu**:
|
||||
- Prikazuju se isključivo kao proizvodi "Na upit" sa namjenskim obrascem.
|
||||
4. **Pravna lica i R1 račun**:
|
||||
- Checkout mora omogućiti unos Naziva kompanije i OIB-a (11 cifara) za Hrvatsku, odnosno JIB-a i PDV broja za Bosnu i Hercegovinu.
|
||||
|
||||
Reference in New Issue
Block a user