59 lines
4.0 KiB
Markdown
59 lines
4.0 KiB
Markdown
# 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]
|
|
```
|
|
|