Master Plan Implementacije E-Commerce Platforme za Proizvođača Suncobrana
Ovaj master plan detaljno opisuje implementaciju multi-tenant e-commerce platforme bazirane na Medusa.js (v2), Next.js (App Router) i Turborepo monorepo arhitekturi.
Osnovni Principi Arhitekture
-
Pravilo #1 (Maksimalno korištenje zvaničnog ekosistema):
- Koristi se zvanični
@medusajs/nextjs-starter-templateza oba storefronta bez pisanja korpe, checkouta ili pretrage od nule. - Koristi se ugrađeni Medusa Admin v2 dashboard proširen isključivo zvaničnim mehanizmima (Admin Widgets i UI Routes).
- Stroga zabrana izmišljanja UI elemenata: Sve admin ekstenzije moraju koristiti isključivo zvanični
@medusajs/uidizajn sistem i komponente (Container,Heading,Text,Badge,Button,Input,Textarea,Select,Table,toast) uz semantičke klase (bg-ui-bg-base,text-ui-fg-subtle, itd.).
- Koristi se zvanični
-
Dva Webshopa iz Jedne Baze:
- Dva odvojena prodajna kanala (Sales Channels): Tržište DE i Tržište AT.
- Dva javna API ključa (Publishable API Keys): Svaki vezan za svoj prodajni kanal, čime Medusa automatski filtrira katalog, zalihe i cijene.
- Lokalizacija jezika putem
next-intlunutar postojećeg Medusa starter template App Routera.
-
Admin Izolacija:
- Zadržava se jedan zvanični Medusa Admin.
- Pomoću backend middleware interceptora (
src/api/middlewares.ts), admin korisnik vezan zasales_channel_idvidi isključivo narudžbe i kupce svoje države.
-
B2B / HoReCa CRM Podaci:
- Veleprodajni cjenovnici putem Medusinih modula
Customer GroupsiPrice Lists. - PIB/OIB, status verifikacije i bilješke agenta spremaju se u nativno
customer.metadatapolje. - Admin widget na stranici kupca za direktno ažuriranje CRM podataka preko Medusa JS SDK.
- Webhook subscriber na
order.placedza eksterni CRM (HubSpot / Brevo).
- Veleprodajni cjenovnici putem Medusinih modula
Indeks Faza Implementacije
Plan je podijeljen u 7 detaljno razrađenih faza. Svaka faza posjeduje sopstveni .md dokument:
| Faza | Naziv Dokumenta | Opis i Fokus |
|---|---|---|
| Faza 1 | phase-01-infrastructure-and-monorepo.md |
Docker Compose (Postgres 16, Redis 7), Turborepo struktura, radni prostori, varijable okruženja. |
| Faza 2 | phase-02-multichannel-core-and-seeding.md |
Prodajni kanali (DE/AT), skladišta (Stock Locations link), Publishable API ključevi, automatizovana seed skripta. |
| Faza 3 | phase-03-admin-isolation-by-country.md |
Sigurnosna izolacija admin korisnika po državama putem Medusa HTTP Middleware interceptora bez novog admin panela. |
| Faza 4 | phase-04-crm-b2b-and-admin-widgets.md |
B2B CRM podaci u customer.metadata, Admin UI Widget na stranici kupca (isključivo @medusajs/ui), event subscriber za webhook. |
| Faza 5 | phase-05-storefronts-and-next-intl.md |
Dva Next.js storefronta iz monorepoa, povezivanje Publishable API ključeva, integracija next-intl rječnika. |
| Faza 6 | phase-06-umbrella-catalog-and-specs.md |
Katalog suncobrana: Opcije (Dimenzija, Boja, Konstrukcija), varijante, tehničke specifikacije u metadata, B2B Price Lists. |
| Faza 7 | phase-07-testing-verification-and-deployment.md |
Kompletan QA protokol, verifikacija izolacije po kanalima, build i produkcijski deployment pipeline. |
Redoslijed Izvršavanja
[Faza 1: Baza i Monorepo]
↓
[Faza 2: Multi-Channel & Seeding]
↓
[Faza 3: Admin Izolacija] ────→ [Faza 4: CRM & Admin Widget]
↓ ↓
[Faza 5: Storefronts & i18n] ──→ [Faza 6: Katalog Suncobrana]
↓
[Faza 7: Testiranje & Produkcija]