Nowa strona

Medusa Platform v2.9 — jak działa silnik commerce

MEDUSA PLATFORM v2.9

Jak działa silnik commerce

Techniczna architektura + procesy biznesowe + kontenery na etapach wdrożenia
1 backend Medusa
N storefrontów
Własny magazyn
+ dropshipping
Źródła realizacji
Base / API / własny
AI + BI
+ Alert Center
Prezentacja dla zespołu — od konfiguracji do realizacji zamówienia
1

PODSUMOWANIE

Co budujemy — jeden silnik, wiele trybów sprzedaży

Medusa Platform v2.9
1
1 silnik commerce
Medusa jako źródło prawdy dla produktów, koszyka, zamówień, płatności, pricingu i admina.
2
1..N storefrontów
Storefront Registry mapuje Sales Channel, domenę, Strapi Site, locale i customer-facing URL-e.
3
Wiele źródeł realizacji
Własny magazyn oraz źródła supplierów obsługiwane przez Base.com lub bezpośrednie API; split/no-split i fallback.
4
Konfiguracja w Adminie
Routing, import, transformacje, cenniki, kampanie, alerty i BI bez przepisywania kodu.
Model docelowy: elastyczny silnik, nie jednorazowa integracja
2

ARCHITEKTURA

Widok całości — warstwy platformy

Medusa Platform v2.9
Storefronty i CMS
Commerce Core
Platform capabilities
Integracje i infrastruktura
Storefront A/B/N
Next.js + Sales Channel
Strapi Site
Layout, treść, SEO
Storefront Registry
URL + domeny + locale
Medusa Backend
API, Admin, modules
Product / Pricing
Ceny, koszt, Omnibus
Order Core
Checkout, order, payment
Inventory Core
Stock, reservations
DTP
Pipeline transformacji
AI Platform
Klasyfikacja, sugestie
Search
Meilisearch
BI + Alert Center
Metryki + zdarzenia
Adaptery źródeł
Base.com / Direct API
Tpay
Płatności + webhook
Kurierzy
Etykiety, tracking
Infra
PG, Redis, S3, AI
Zasada: każdy moduł ma własną odpowiedzialność; integracje korzystają z kontraktów, nie z wyjątków w kodzie.
Warstwy logiczne platformy
3

KONTENERY

Kontenery i infrastruktura runtime

Medusa Platform v2.9
Traefik :80/:443
shop-prod / shop-prod-net
Aplikacja
backend-server
backend-worker
backend-migrate
storefront
front
cms
Dane i cache
postgres
pgbouncer
redis
seaweedfs
meilisearch
Operacje
pg-backup
prometheus
grafana
redis-exporter
postgres-exporter
Zewnętrzne
ai.fuz.pl
Base.com
Tpay
kurierzy
API hurtowni
AI jest zdalną usługą HTTPS + Bearer token — nie kontenerem w sieci sklepu.
Warstwa kontenerów produkcyjnych
4

PROCES BIZNESOWY

Proces 1: produkt ze źródła do katalogu

Medusa Platform v2.9
Supplier Source
Base.com / Direct API / XML
Data Transformation
sanitize, normalize, validate
Product Enrichment
mapowanie źródeł i atrybutów
AI Classification
kategorie, cechy, sugestie
Medusa Catalog
produkt, warianty, kanały
Search Index
Meilisearch + aliasy
Kontenery / usługi używane na tym etapie
backend-worker
redis
postgres
meilisearch
ai.fuz.pl
import, batch, retry
queue / event bus
source + product state
index produktu
zewnętrzny LLM
Efekt: dane ze źródeł dostawców są normalizowane, wzbogacane i trafiają do katalogu oraz wyszukiwarki bez wyjątków per kanał integracji.
Import i wzbogacanie produktu
5

MULTI-STORE RUNTIME

Proces 2: wiele storefrontów na jednym backendzie

Medusa Platform v2.9
Storefront A
domain + publishable key
Storefront B
domain + publishable key
Storefront N
domain + publishable key
Storefront Registry
storefront_key, Sales Channel, locale, domain, typed routes
Strapi Site
layout + content
Medusa Sales Channel
commerce context
URL Resolver
PAYMENT_RETURN, ORDER, TRACKING
Strapi
prezentacja, layout, content
Medusa
commerce, order, payment
Registry
domeny i linki klienta
Storefront Registry: zero pajęczyny FRONTEND_URL w .env
6

INVENTORY + ROUTING

Proces 3: skąd realizujemy zamówienie?

Medusa Platform v2.9
Order line
produkt + ilość + Sales Channel
Source candidates
own + supplier sources + freshness
Routing Policy
OWN_FIRST / split / fallback
RoutingDecision
source + reason + version
Reservation
atomic stock lock
OWN_ONLY
tylko własny magazyn
SUPPLIER_ONLY
tylko wskazany dostawca
OWN_FIRST
TOP produkty lokalnie
PREFERRED_SUPPLIER
lista priorytetów
ALLOW_SPLIT
wiele fulfillment groups
NO_SPLIT
jedno źródło dla koszyka
Przykład: TOP 100 produktów → preferuj własny magazyn; long tail → supplier source przez Base.com albo Direct API; split tylko jeśli polityka na to pozwala.
Base.com jest kanałem integracji, a nie osobnym typem źródła biznesowego: Source → Adapter → System zewnętrzny.
Routing decyduje; Order Orchestration wykonuje decyzję
7

ZAMÓWIENIE

Proces 4: od checkoutu do dostawy

Medusa Platform v2.9
Checkout
cart + channel
Tpay
return + webhook
Order
payment captured
Routing
source decision
Fulfillment
groups + supplier order
Courier
label + tracking
BI + Alerts
events + metrics
Klient / Storefront
zamówienie i komunikaty
Medusa Backend
checkout, payment, order
Worker
routing, fulfillment, integracje
Zewnętrzne
Tpay, Base.com, API hurtowni, kurierzy
Jeden order klienta może generować wiele wewnętrznych realizacji
8

PRICING

Proces 5: cena, koszt, promocja, Omnibus

Medusa Platform v2.9
Supplier Cost
koszt zakupu, opłaty DS, pakowanie, koszt źródła
Medusa Pricing
cena sprzedaży, price lists, region/channel
Promotions
campaign, discount, conditions, readiness
Omnibus
historia ceny i snapshot obniżki
Rozdział odpowiedzialności
• Cena sprzedaży nie steruje wyborem dostawcy — do routingu trafia Supplier Cost.
• Promocja nie nadpisuje Omnibus — historia ceny jest canonical eventem.
• Kampanie mają readiness checks: marża, Omnibus, kanał, treść, zakres produktów.
Zyskowność = cena sprzedaży − koszty źródła − koszty operacyjne
9

PLATFORM CAPABILITIES

Proces 6: dane, AI, wyszukiwanie i analityka

Medusa Platform v2.9
Data Transformation Platform
profile, pipeline, preview, versioning
Base Import
HTML, EAN, SKU
Search
aliases, fragments
AI Platform
pre/postprocessing
BI
status, facts, metrics
Migrations
schema changes
Export
target format
Zasada: moduły domenowe wskazują profil; DTP wykonuje wersjonowany pipeline i zwraca wynik + warnings + metadata.
Wspólna capability zamiast parserów rozproszonych po modułach
10

OPERACJE

Co konfiguruje administrator w Medusa Admin?

Medusa Platform v2.9
Storefronts
domena, Sales Channel, locale, Strapi Site, routes
Data Transformations
profile importu, preview, wersje, error policies
Inventory & Routing
sources, OWN_FIRST, split/no-split, symulacja
Suppliers / Adapters
źródła, mapowania, Base.com / Direct API
Pricing / Promotions
cenniki, kampanie, Omnibus, readiness
Search / BI / Alerts
synonimy, jakość wyników, KPI, zdarzenia
Cel UX Admina: zmienić tryb pracy sklepu bez zmiany kodu i bez mnożenia zmiennych .env.
Admin jako panel konfiguracji silnika
11

OBSERVABILITY

Sterowanie i bezpieczeństwo operacyjne

Medusa Platform v2.9
Events
canonical event registry
Alert Center
routing, import, payment, stock
Metrics
Prometheus + Grafana
Runbooks
instrukcje dla admina / wdrożeniowca
routing.no_source_available
payment.callback.failed
transformation.execution.failed
search.quality_regression
supplier.stock_stale
order.fulfillment.failed
Definition of Done każdego etapu: CODE + TESTS + OBSERVABILITY + ADMIN GUIDE + DEPLOY GUIDE + RUNBOOK.
Monitoring procesu biznesowego i technicznego
12

ROADMAP

Kolejność wdrożenia — etapy i kontenery

Medusa Platform v2.9
0
0. Standardy
STD, UI, events
backend-server, postgres
1
1. Product + DTP
import i pipeline
backend-worker, redis, postgres
2
2. Storefront Runtime
N frontów + URL
front/storefront, cms
3
3. Inventory + Routing
źródła i decyzje
backend-worker, postgres, redis
4
4. Order + Payments
Tpay + fulfillment
backend-server, worker
5
5. Search + BI + Alerts
jakość operacji
meilisearch, prometheus, grafana
6
6. Testy + Go-live
E2E, k6, runbook
cały stack
Etapy zgodne z projektem Tasko v2.9
13

ORGANIZACJA PRACY

Jak to pokazać zespołowi — decyzje i role

Medusa Platform v2.9
Backend
moduły Medusa, workflows, events, RBAC
Frontend
storefront, UX checkout, tracking, search
Admin/Operations
konfiguracja sources, routing, alerty, runbooki
Data/AI
DTP, klasyfikacja, BI, search quality
DevOps
Traefik, kontenery, backup, monitoring
Rekomendacja: prowadzić wdrożenie z Tasko v2.9, etapami zamykając każdy moduł dokumentacją Admin Guide / Deploy Guide / Runbook.
Następny krok: przegląd zespołowy i akceptacja kolejności wdrożenia.
Podsumowanie
14

1 / 14

Medusa Platform v2.9 — jak działa silnik commerce

MEDUSA PLATFORM v2.9

Ustawienia prywatności