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

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 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]