# 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 1. **Pravilo #1 (Maksimalno korištenje zvaničnog ekosistema):** - Koristi se zvanični `@medusajs/nextjs-starter-template` za 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/ui` dizajn 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.). 2. **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-intl` unutar postojećeg Medusa starter template App Routera. 3. **Admin Izolacija:** - Zadržava se jedan zvanični Medusa Admin. - Pomoću backend middleware interceptora (`src/api/middlewares.ts`), admin korisnik vezan za `sales_channel_id` vidi isključivo narudžbe i kupce svoje države. 4. **B2B / HoReCa CRM Podaci:** - Veleprodajni cjenovnici putem Medusinih modula `Customer Groups` i `Price Lists`. - PIB/OIB, status verifikacije i bilješke agenta spremaju se u nativno `customer.metadata` polje. - Admin widget na stranici kupca za direktno ažuriranje CRM podataka preko Medusa JS SDK. - Webhook subscriber na `order.placed` za eksterni CRM (HubSpot / Brevo). --- ## 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`](./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`](./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`](./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`](./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`](./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`](./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`](./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] ```