17 KiB
17 KiB
Detaljna Analiza Obima Projekta: ŠUMAN d.o.o. — E-Commerce i Web Platforma
Dokumentacija usklađenosti i GAP analiza na osnovu dokumenta: "Pojašnjenje ponude 2026-WEB-070 v3.0"
Datum analize: Novembar 2026. | Pripremio: Antigravity AI tim
1. Izvršni Rezime i Strateški Fokus
Dokument "Pojašnjenje ponude 2026-WEB-070 (Verzija 3.0)" od 08. 11. 2026. godine definiše ključne izmjene u prioritetima, obimu i poslovnom modelu projekta za naručioca "SUMAN" d.o.o. Gračanica:
Important
KLJUČNA PROMJENA PRIORITETA (CRITICAL SHIFT)
- Prioritet 1 je HR Webshop (
shop.suman.hr): Soft opening je 15. 01. 2027., a potpuna funkcionalna primopredaja do 15. 02. 2027.- 2D Konfigurator suncobrana postaje sastavni dio webshopa sa direktnom kupovinom kroz korpu (nije zaseban sistem za upite).
- Tende i pergole se u ovoj fazi izbacuju iz konfiguratora i vode se isključivo kao proizvodi "na upit" (bez dugmeta za kupovinu i bez automatskog obračuna cijene).
- PDF preliminarne ponude se izbacuje — umjesto toga kupac dobija standardnu email potvrdu narudžbe sa slikom i specifikacijom konfiguracije.
- Korporativni web (
suman.ba / suman.hr) na 4 jezika (BS, HR, DE, EN) razvija se tek nakon lansiranja HR webshopa (rok: do 31. 03. 2027.) i ne smije odgoditi online prodaju.
2. Brzi Pregled Stanja: Šta Imamo vs. Šta Treba Uraditi
| Oblast | Šta je već implementirano (Imamo) | Šta treba izmijeniti (Izmjene) | Šta tek treba implementirati (Nedostaje) |
|---|---|---|---|
| Arhitektura | Medusa v2 backend + PostgreSQL + Turborepo monorepo + Docker Compose. | Uskladiti tehnološki naziv (u ponudi stoji Astro, u kodu je moderniji i zvanični Next.js 15/16). | Postavljanje produkcijskog Ubuntu servera sa SSL-om, Redisom i dnevnim backupom. |
| Prodajni kanali i regije | Kreirana 2 prodajna kanala (BiH i HR), 2 regije (BA u KM, HR u EUR) i 2 skladišta (Gračanica i Zagreb). | suman-hrvatska je trenutno samo osnovni starter; mora preuzeti primat u razvoju i kompletan dizajn. |
Povezivanje domena shop.suman.hr i shop.suman.ba sa odgovarajućim kanalima. |
| Dizajn i Landing stranica | Razvijen vrhunski UI na suman-bosna: Floating Header, Video Hero sa tranzicijom pergole, Partners ticker, Product showcase, Mission sekcija, CTA banner, Latest news, FAQ i Footer. |
Ovaj dizajn preslikati na suman-hrvatska (jer je HR webshop prioritet 1). |
Stranice pojedinačnih proizvoda prilagoditi za direktnu kupovinu i prikaz 3 prodajna scenarija. |
| 2D Konfigurator suncobrana | Inicijalni prikaz kartica u Product Showcase slajderu. | Izbaciti konfiguraciju za tende i pergole (one idu samo na upit). | Pravi 2D vizuelni konfigurator na stranici suncobrana: odabir platna, boje konstrukcije, stalka/postolja, opreme, živi 2D preview, pravila kompatibilnosti i direktno dodavanje u korpu. |
| Prodajni scenariji | Osnovni e-commerce model (proizvod na zalihi / rasprodano). | Ukloniti cijenu i dugme "Kupi" za tende i pergole. | 3 prodajna modela: (1a) Na zalihi, (1b) Po narudžbi sa rokom (npr. "isporuka za 14 dana"), (2) Na upit sa formom. |
| Administracija i ovlasti | Medusa Admin radi; osnovni middleware za filtriranje narudžbi po sales_channel_id. |
Proširiti izolaciju na proizvode, zalihe i upite. | Uloge: Glavni admin (sve), Administrator HR (samo HR narudžbe i zalihe), Administrator BA (samo BiH). |
| Upravljanje nabavom | Narudžbe se bilježe u Medusi. | — | Pregled "Narudžbe po narudžbi": zbirno sabiranje stavki po SKU šiframa i izvoz u CSV/Excel za nabavnu službu. |
| Dostava i preuzimanje | Default shipping profil u bazi. | Zamijeniti generičke kurire specifičnim zonama. | Zone za HR ("Kopno" i "Otoci"), zona za BiH ("Cijela BiH"), lično preuzimanje (Zagreb / Gračanica 0 KM) i prag za besplatnu dostavu. |
| Plaćanje | Mock provider (pp_system_default). |
— | Kartični platni procesor (Monri / CorvusPay / WSPay / Stripe) + Plaćanje pouzećem + Plaćanje virmanom/uplatnicom. |
| Fiskalizacija i pravna lica | Poreske stope (HR 25%, BA 17%) u regijama. | — | Polja u checkoutu za pravna lica (Naziv firme, OIB za HR / JIB za BiH) i Webhookovi za vanjski računovodstveni program. |
| Korporativni web | Imamo bogatu početnu stranicu na suman-bosna. |
Korporativni web odvojen je za Fazu 2 (rok 31. 03. 2027.). | Višejezičnost (BS, HR, DE, EN) na korporativnim stranicama. |
3. Detaljna Analiza po Tačkama Ugovora (Tačke 1 – 26)
Tačka 1: Dva zasebna webshopa (shop.suman.hr i shop.suman.ba)
- Dogovoreno: Dva odvojena webshopa koji rade na jednoj Medusa instalaciji kao dva prodajna kanala. Isti dizajn, katalog i mogućnosti, ali odvojene valute (EUR / KM), jezici (HR / BS), magacini (Zagreb / Gračanica) i administratori.
- Status u kodu: 75% IMPLEMENTIRANO.
apps/backendveć ima konfigurisana oba kanala (Suman d.o.o. - HrvatskaiSuman d.o.o. - Bosna i Hercegovina), regije (EUR i BAM) i skladišta.
- Šta treba uraditi:
apps/suman-hrvatskamora dobiti sve komponente i unificirani dizajn izsuman-bosna.- Podesiti jezične postavke (HR terminologija: "Košarica", "Kupnja", "Uvjeti poslovanja" za HR; "Korpa", "Kupovina", "Uslovi poslovanja" za BA).
Tačka 2: 2D Konfigurator suncobrana integrisan u webshop
- Dogovoreno: Konfigurator se odnosi isključivo na suncobrane. Kupac na stranici suncobrana bira:
- Model suncobrana (npr. Prestige, Magnum, Console, Beach).
- Dimenzije / oblik (kvadratni, pravougaoni, okrugli).
- Boju i vrstu platna (akrilno platno, 10+ dezena).
- Boju konstrukcije (antracit, bijela, natur aluminijum, drvo dezen).
- Postolje / stalak (križno postolje, betonski utezi, ugradna prirubnica).
- Dodatnu opremu (zaštitna navlaka, LED rasvjeta, infra grijači).
- Prikaz se mijenja uživo (2D PNG slojevi).
- Pravila kompatibilnosti sprječavaju nemoguće kombinacije (npr. preveliko platno na lagano postolje).
- Automatski proračun cijene i prikaz dostupnosti ("Na zalihi" ili "Po narudžbi — isporuka za X dana").
- Direktno dodavanje u korpu: u korpi i administraciji konfigurisani proizvod nosi tačan spisak opcija, sliku konfiguracije i SKU.
- Status u kodu: 20% (SAMO OSNOVNI PRIKAZ).
- Šta treba uraditi:
- Izgraditi namensku komponentu
UmbrellaConfiguratorunutar storefronta. - Implementirati logiku kombinovanja 2D slojeva (Canvas ili slojeviti SVG/PNG).
- Na backendu definisati opcije i cijene doplatnih stavki (postolja, navlake, specijalne boje).
- Povezati konfiguraciju sa Medusa korpom (
custom metadatana stavci korpe: odabrane opcije, SKU kodovi, preview slika).
- Izgraditi namensku komponentu
Tačka 3 & 4: Tende i pergole "Na upit" & Uklanjanje PDF ponude
- Dogovoreno:
- PDF preliminarne ponude je izbačen iz projekta. Umjesto toga ide standardni checkout ili upit.
- Tende i pergole su izbačene iz konfiguratora.
- Tende i pergole u webshopu imaju status "Na upit": kupac vidi galeriju, tehničke specifikacije i opis, ali nema dugme "Dodaj u korpu", već formu za slanje upita komercijali.
- Status u kodu: 30% IMPLEMENTIRANO.
- Šta treba uraditi:
- Na stranici proizvoda provjeriti
product.metadata.sale_scenario. Ako je"quote_only":- Sakriti selektor količine i dugme za korpu.
- Prikazati dugme "Pošaljite upit za ponudu" koje otvara formu (Ime, Email, Telefon, Lokacija, Dimenzije prostora, Poruka).
- Na backendu kreirati endpoint
POST /store/inquiriesza prijem upita i njihovo evidentiranje u Medusa Adminu.
- Na stranici proizvoda provjeriti
Tačka 5: Administracija i ovlasti po tržištu
- Dogovoreno: Jedinstvena Medusa Admin aplikacija sa tri nivoa ovlasti:
- Glavni administrator: Puni pristup svemu (oba kanala, svi proizvodi, postavke, korisnici).
- Administrator HR: Vidi samo narudžbe, upite, magacin Zagreb i cijene u EUR za Hrvatsku (
shop.suman.hr). - Administrator BA: Vidi samo narudžbe, upite, magacin Gračanica i cijene u KM za BiH (
shop.suman.ba).
- Status u kodu: 50% IMPLEMENTIRANO.
- U
apps/backend/src/api/middlewares.tsimplementiran je presretač za narudžbe (/admin/orders).
- U
- Šta treba uraditi:
- Proširiti middleware izolaciju na rute za zalihe (
/admin/inventory-items), lokacije skladišta i upite. - Dokumentovati kreiranje administratorskih naloga sa pripadajućim
sales_channel_iduuser.metadata.
- Proširiti middleware izolaciju na rute za zalihe (
Tačka 6 & 7: Tri prodajna scenarija i rok isporuke
- Dogovoreno:
- Scenarij 1a (Na zalihi): Artikal je na stanju u lokalnom magacinu. Prikazuje se zeleni bedž "Na zalihi", standardno vrijeme isporuke (npr. 2–4 radna dana).
- Scenarij 1b (Po narudžbi): Artikal se proizvodi ili naručuje. Prikazuje se plavi/narandžasti bedž "Po narudžbi — isporuka za X dana". Kupac normalno kupuje i plaća kroz webshop.
- Praćenje statusa: Zaprimljena → U nabavi/proizvodnji → Spremna za isporuku → Isporučena.
- Automatske email notifikacije kupcu pri svakoj promjeni statusa.
- Scenarij 2 (Na upit): Za tende, pergole i custom projekte. Nema cijene ni korpe, samo forma za upit.
- Miješana korpa: U istoj korpi mogu biti i proizvodi sa zalihe i proizvodi po narudžbi (u korpi se jasno vidi rok za svaku stavku).
- Upravljanje u Adminu: Suman administratori mogu sami mijenjati prodajni model i upisivati rok isporuke (dani/sedmice) za svaki proizvod i varijantu, odvojeno za HR i BA.
- Status u kodu: 20% (NIJE POTPUNO IMPLEMENTIRANO).
- Šta treba uraditi:
- Dodati polja u metadata proizvoda:
sale_scenario(in_stock|made_to_order|quote_only),lead_time_days(npr. 14),auto_switch_on_zero_stock(true/false). - Prilagoditi prikaz na karticama i stranici proizvoda u oba storefronta.
- Implementirati workflow za statuse narudžbe po narudžbi i email notifikacije.
- Dodati polja u metadata proizvoda:
Tačka 8: Pregled narudžbi za nabavu (Procurement View)
- Dogovoreno: Poseban administratorski modul / ekran za internu nabavnu službu SUMAN-a:
- Filtriranje narudžbi po statusu "Po narudžbi".
- Zbirni prikaz stavki: Sistem automatski sabira identične artikle/komponente po SKU šiframa (npr. ukupno 24 komada platna 3.5x3.5m antracit, 12 križnih postolja).
- Izvoz u Excel / CSV jednim klikom za internu proizvodnju i nabavu.
- Status u kodu: 0% (TREBA IMPLEMENTIRATI).
- Šta treba uraditi:
- Kreirati Medusa Admin Custom Page (
apps/backend/src/admin/routes/procurement/page.tsx). - Napraviti API rutu
GET /admin/procurement/summarykoja agregira stavke iz otvorenih narudžbi po SKU kodu. - Dodati CSV export funkciju.
- Kreirati Medusa Admin Custom Page (
Tačka 9: Dostavne zone, cijene i lično preuzimanje
- Dogovoreno:
- Hrvatska:
- Zona 1: "Kopno" (standardna cijena, besplatno iznad definisanog iznosa).
- Zona 2: "Otoci" (prilagođena cijena zbog trajektnog transporta glomazne robe).
- Lično preuzimanje: Distributivni centar Zagreb (0 EUR).
- Bosna i Hercegovina:
- Zona: "Cijela BiH".
- Lično preuzimanje: Centralno skladište Suman Gračanica (0 KM).
- Prikaz procijenjenog roka dostave u checkoutu.
- Hrvatska:
- Status u kodu: 30% IMPLEMENTIRANO.
- Šta treba uraditi:
- Definisati tačne
shipping_optionspo regijama i profilima. - U checkoutu omogućiti odabir opcije "Lično preuzimanje" koja uklanja trošak dostave i postavlja adresu preuzimanja.
- Definisati tačne
Tačka 10: Plaćanje (Kartice, Pouzeće, Virman)
- Dogovoreno:
- Ugovorena integracija jednog platnog procesora za kartice (npr. Monri WebPay, CorvusPay, WSPay ili Stripe).
- Plaćanje pouzećem (Gotovina pri preuzimanju) uključeno bez doplate.
- Plaćanje uplatom na račun (Virman / Opća uplatnica) uključeno bez doplate: kupac na ekranu potvrde i u emailu dobija podatke za uplatu (IBAN, model, poziv na broj).
- Status u kodu: 20% (SAMO MOCK PROVIDER).
- Šta treba uraditi:
- Implementirati ili konfigurisati payment provider za odabrani procesor.
- Konfigurisati
pp_manual(pouzeće i virman) sa specifičnim uputstvima za uplatu po tržištu (HR IBAN u EUR, BiH transakcijski račun u KM).
Tačka 14: Jezici i višejezičnost
- Dogovoreno:
shop.suman.hr: Hrvatski jezik (HR).shop.suman.ba: Bosanski jezik (BS).- Korporativni web (
suman.ba / suman.hr): 4 jezika (BS, HR, DE, EN) — Faza 2 (do 31. 03. 2027.).
- Status u kodu: 60% IMPLEMENTIRANO.
suman-bosnaima lokalizovan sadržaj na bosanskom jeziku.
- Šta treba uraditi:
- Osigurati kompletnu lekturu i termine na hrvatskom jeziku za
suman-hrvatska.
- Osigurati kompletnu lekturu i termine na hrvatskom jeziku za
Tačka 18: Zakonske obaveze, PDV i pravna lica (R1 račun)
- Dogovoreno:
- Zaseban obračun PDV-a: 25% za HR, 17% za BiH. Cijene u webshopu jasno istaknute sa uračunatim PDV-om.
- Checkout mora sadržavati opciju: "Kupujem kao pravno lice (R1 / račun za firmu)".
- Za HR: Unos Naziva firme i OIB-a (11 cifara, uz validaciju).
- Za BiH: Unos Naziva firme, JIB-a (13 cifara) i PDV broja (12 cifara).
- Pripremljeni webhookovi za povezivanje sa vanjskim ERP/knjigovodstvenim sistemom.
- Status u kodu: 40% IMPLEMENTIRANO (PDV stope u regijama postoje, polja u checkoutu nedostaju).
- Šta treba uraditi:
- Proširiti checkout formu u oba storefronta sa poljima za firmu i poreski broj.
- Skladištiti podatke o firmi u
order.metadatailibilling_address.company.
Tačka 19 & 20: Vremenski plan i obaveze SUMAN-a
- Dogovoreni rokovi iz ugovora:
- 15. 11. 2026. — Uplata avansa 30% i početak projekta.
- 01. 12. 2026. — SUMAN dostavlja prototip konfiguratora (Džafa) ili potvrđuje izradu po specifikaciji.
- 06. 12. 2026. — Odobrenje dizajna webshopa.
- 15. 12. 2026. — Popunjen Excel predložak kataloga i fotografije proizvoda.
- 20. 12. 2026. — Pristupni podaci platnog procesora i pravni tekstovi.
- 15. 01. 2027. — SOFT OPENING HR WEBSHOPA (stvarne narudžbe, praćenje i ispravke).
- 15. 02. 2027. — HR WEBSHOP POTPUNO FUNKCIONALAN I TESTIRAN (primopredaja i završna uplata).
- 31. 03. 2027. — Korporativni višejezični web (
suman.ba / suman.hr).
4. Akcioni Plan: Šta Tačno Moramo Implementirati i Izmijeniti
FAZA 1: Fokus na HR Webshop (apps/suman-hrvatska) i Backend Core (Hitno)
- Preslikavanje i prilagodba dizajna na HR Storefront:
- Prenijeti komponente sa
suman-bosnanasuman-hrvatska(Header sa floating/classic modom, Video Hero, sekcije, footer). - Uskladiti jezik (hrvatski standard), valutu (EUR) i domenu (
shop.suman.hr).
- Prenijeti komponente sa
- Implementacija 3 prodajna scenarija na Storefrontu:
- Bedževi i logika: Na zalihi, Po narudžbi (rok isporuke), Na upit.
- Forma za upit za tende i pergole (umjesto dugmeta za korpu).
- Checkout za pravna lica i dostavne zone:
- Dodati checkbox "Trebam R1 račun" sa poljima za firmu i OIB (za HR) / JIB (za BA).
- Dodati opcije dostave: "Kopno", "Otoci", "Lično preuzimanje Zagreb".
- Plaćanja:
- Povezati Pouzeće i Virmansku uplatu sa tačnim instrukcijama za uplatu.
- Pripremiti modul za kartično plaćanje prema odabiru klijenta.
FAZA 2: 2D Konfigurator Suncobrana
- Razvoj konfiguratora za suncobrane:
- Interaktivna stranica za konfiguraciju modela suncobrana.
- Slojeviti 2D preview (platno, konstrukcija, postolje, oprema).
- Pravila kompatibilnosti i automatska kalkulacija cijene.
- Povezivanje sa korpom sa SKU specifikacijom.
FAZA 3: Medusa Admin Proširenja
- Pregled za nabavku (Procurement View):
- Zbirni pregled artikala po narudžbi i CSV export.
- Modul za upite (Inquiries):
- Pregled i upravljanje pristiglim upitima za tende i pergole.
- Potpuna izolacija ovlasti:
- Administrator HR vidi samo HR podatke; Administrator BA vidi samo BA podatke.
FAZA 4: Korporativni Web (nakon lansiranja webshopa)
- Višejezična podrška (BS, HR, DE, EN) na korporativnim prezentacionim stranicama.
5. Pitanja za Klijenta (SUMAN) — Blokatori za Konačnu Konfiguraciju
Kako je navedeno u Tački 8 samog ugovora, SUMAN mora dostaviti odgovore na sljedeća pitanja:
- Vođenje zaliha konfigurisanog suncobrana:
- Pitanje: Da li se zalihe vode kao gotov artikal (SKU po kombinaciji) ili po komponentama (platno, stalak, postolje)?
- Preporuka tima: Varijanta (a) — Gotov artikal po kombinaciji, jer je jednostavnija, pouzdanija i ne zahtijeva komplikovanu proizvodnu BOM logiku.
- Dostavne zone i cijene:
- Koje su tačne cijene dostave za HR (Kopno vs. Otoci) i BiH? Koji je iznos narudžbe za besplatnu dostavu?
- Lično preuzimanje:
- Tačne adrese i radno vrijeme lokacija u Zagrebu i Gračanici.
- Kurirske službe:
- Sa kojim kurirskim službama sarađuju u HR (GLS, DPD, Overseas) i u BiH (Express One, EuroExpress, Pošta)? Da li je potrebna automatska API integracija ili manualno kreiranje adresnica?
- Platni procesor za kartice:
- Koji platni procesor biraju za HR, a koji za BiH (npr. Monri, CorvusPay, WSPay, Stripe)? Napomena: Ugovaranje sa bankom i procesorom traje 2–3 sedmice i mora se pokrenuti odmah.
- Fiskalizacija i ERP:
- Koji knjigovodstveni/ERP program koriste u HR i BiH za izdavanje i fiskalizaciju računa?
- Redoslijed puštanja BiH webshopa:
- Da li se
shop.suman.bapušta u rad istovremeno sa HR webshopom (do 15. 02. 2027.) ili naknadno?
- Da li se
Dokument je generisan na osnovu zvanične ponude 2026-WEB-070 v3.0 i stanja koda u repozitorijumu suman-doo.