Files
Suman/ANALIZA_PROJEKTA_SUMAN.md
Nermin Karic f5e2fcbf98 first commit
2026-11-22 21:49:17 +01:00

17 KiB
Raw Blame History

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)

  1. Prioritet 1 je HR Webshop (shop.suman.hr): Soft opening je 15. 01. 2027., a potpuna funkcionalna primopredaja do 15. 02. 2027.
  2. 2D Konfigurator suncobrana postaje sastavni dio webshopa sa direktnom kupovinom kroz korpu (nije zaseban sistem za upite).
  3. 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).
  4. PDF preliminarne ponude se izbacuje — umjesto toga kupac dobija standardnu email potvrdu narudžbe sa slikom i specifikacijom konfiguracije.
  5. 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/backend već ima konfigurisana oba kanala (Suman d.o.o. - Hrvatska i Suman d.o.o. - Bosna i Hercegovina), regije (EUR i BAM) i skladišta.
  • Šta treba uraditi:
    • apps/suman-hrvatska mora dobiti sve komponente i unificirani dizajn iz suman-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:
    1. Model suncobrana (npr. Prestige, Magnum, Console, Beach).
    2. Dimenzije / oblik (kvadratni, pravougaoni, okrugli).
    3. Boju i vrstu platna (akrilno platno, 10+ dezena).
    4. Boju konstrukcije (antracit, bijela, natur aluminijum, drvo dezen).
    5. Postolje / stalak (križno postolje, betonski utezi, ugradna prirubnica).
    6. 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 UmbrellaConfigurator unutar 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 metadata na stavci korpe: odabrane opcije, SKU kodovi, preview slika).

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/inquiries za prijem upita i njihovo evidentiranje u Medusa Adminu.

Tačka 5: Administracija i ovlasti po tržištu

  • Dogovoreno: Jedinstvena Medusa Admin aplikacija sa tri nivoa ovlasti:
    1. Glavni administrator: Puni pristup svemu (oba kanala, svi proizvodi, postavke, korisnici).
    2. Administrator HR: Vidi samo narudžbe, upite, magacin Zagreb i cijene u EUR za Hrvatsku (shop.suman.hr).
    3. 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.ts implementiran je presretač za narudžbe (/admin/orders).
  • Š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_id u user.metadata.

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.

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/summary koja agregira stavke iz otvorenih narudžbi po SKU kodu.
    • Dodati CSV export funkciju.

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.
  • Status u kodu: 30% IMPLEMENTIRANO.
  • Šta treba uraditi:
    • Definisati tačne shipping_options po regijama i profilima.
    • U checkoutu omogućiti odabir opcije "Lično preuzimanje" koja uklanja trošak dostave i postavlja adresu preuzimanja.

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-bosna ima lokalizovan sadržaj na bosanskom jeziku.
  • Šta treba uraditi:
    • Osigurati kompletnu lekturu i termine na hrvatskom jeziku za suman-hrvatska.

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.metadata ili billing_address.company.

Tačka 19 & 20: Vremenski plan i obaveze SUMAN-a

  • Dogovoreni rokovi iz ugovora:
    1. 15. 11. 2026. — Uplata avansa 30% i početak projekta.
    2. 01. 12. 2026. — SUMAN dostavlja prototip konfiguratora (Džafa) ili potvrđuje izradu po specifikaciji.
    3. 06. 12. 2026. — Odobrenje dizajna webshopa.
    4. 15. 12. 2026. — Popunjen Excel predložak kataloga i fotografije proizvoda.
    5. 20. 12. 2026. — Pristupni podaci platnog procesora i pravni tekstovi.
    6. 15. 01. 2027. — SOFT OPENING HR WEBSHOPA (stvarne narudžbe, praćenje i ispravke).
    7. 15. 02. 2027. — HR WEBSHOP POTPUNO FUNKCIONALAN I TESTIRAN (primopredaja i završna uplata).
    8. 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)

  1. Preslikavanje i prilagodba dizajna na HR Storefront:
    • Prenijeti komponente sa suman-bosna na suman-hrvatska (Header sa floating/classic modom, Video Hero, sekcije, footer).
    • Uskladiti jezik (hrvatski standard), valutu (EUR) i domenu (shop.suman.hr).
  2. 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).
  3. 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".
  4. 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

  1. 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

  1. Pregled za nabavku (Procurement View):
    • Zbirni pregled artikala po narudžbi i CSV export.
  2. Modul za upite (Inquiries):
    • Pregled i upravljanje pristiglim upitima za tende i pergole.
  3. Potpuna izolacija ovlasti:
    • Administrator HR vidi samo HR podatke; Administrator BA vidi samo BA podatke.

FAZA 4: Korporativni Web (nakon lansiranja webshopa)

  1. 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:

  1. 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.
  2. 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?
  3. Lično preuzimanje:
    • Tačne adrese i radno vrijeme lokacija u Zagrebu i Gračanici.
  4. 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?
  5. 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.
  6. Fiskalizacija i ERP:
    • Koji knjigovodstveni/ERP program koriste u HR i BiH za izdavanje i fiskalizaciju računa?
  7. Redoslijed puštanja BiH webshopa:
    • Da li se shop.suman.ba pušta u rad istovremeno sa HR webshopom (do 15. 02. 2027.) ili naknadno?

Dokument je generisan na osnovu zvanične ponude 2026-WEB-070 v3.0 i stanja koda u repozitorijumu suman-doo.