Medusa.js e-commerce marketplace · 2025
Zaawansowana platforma e-commerce dla wielu sprzedawców na Medusa.js
Artovnia to innowacyjna, platforma e-commerce dla wielu sprzedawców na bazie Medusa.js, stworzona z myślą o artystach, twórcach i małych manufakturach. Zapewnia im nowoczesne, niezawodne i bogate w funkcje miejsce do prezentowania oraz sprzedaży swoich prac w internecie.
- Typ projektu
- Medusa.js e-commerce marketplace
- Rok
- 2025
- Technologie
- 9
- Status
- Wdrożone
Artovnia – marketplace z własnym systemem rozliczeń, pod skalowanie
Artovnia to platforma marketplace na Medusa.js dla artystów, twórców rękodzieła i małych marek, zaprojektowana od podstaw jako system dopasowany do realnych potrzeb sprzedawców i operacji e-commerce, nie jako warstwa nałożona na gotowe rozwiązanie.
Projekt rozpoczął się jako MVP, ale bardzo szybko rozwinął się w pełnoprawny system sprzedażowy z własną architekturą, logiką finansową i zestawem narzędzi dla sprzedawców. Kluczowym założeniem było stworzenie platformy, która nie będzie wymagała refaktoryzacji wraz ze wzrostem skali, tylko będzie na nią gotowa od początku.
Własny system płatności i rozliczeń marketplace
Jednym z najtrudniejszych i najważniejszych elementów projektu była implementacja własnego systemu rozliczeń opartego o Stripe Connect Express.
Platforma obsługuje:
- własna logika split payments między wielu sprzedawców w ramach jednej płatności
- opóźnione wypłaty (delayed payouts) powiązane z polityką zwrotów (14 dni)
- własną, w pełni konfigurowalną logikę prowizji (globalnie i per sprzedawca)
- system punktów lojalnościowych, w którym koszt punktów pokrywa platforma, nie sprzedawca
- system poleceń, automatycznie obniżający prowizję dla nowych i polecających sprzedawców na określony w konfigu czas
Środki są zarządzane przez Stripe i nie trafiają do banku do momentu pełnego rozliczenia transakcji, co upraszcza kwestie prawne i operacyjne.
To nie jest integracja gotowego rozwiązania, to dedykowany system finansowy zaprojektowany pod model marketplace.
Kliknij, aby powiększyć
Kliknij, aby powiększyć
Architektura marketplace i logika sprzedaży
Artovnia działa jako platforma multi-vendor z pełną separacją sprzedawców.
Osobne konta sprzedawców
Każdy sprzedawca posiada własny profil, ofertę i konfigurację sprzedaży.
Indywidualne ustawienia sprzedaży
Indywidualne ceny, promocje, dostawy i ustawienia sprzedaży.
Jeden koszyk, rozdzielone zamówienia
Jeden koszyk klienta, automatycznie rozdzielany na zamówienia per sprzedawca.
Jedna płatność, wiele rozliczeń
Jedna płatność, wiele rozliczeń w tle.
Landing pages sprzedawców
Sprzedawcy mogą tworzyć własne strony (landing pages) w ramach platformy, co znacząco zwiększa ich kontrolę nad prezentacją oferty.
Zaawansowany panel sprzedawcy i automatyzacje
Platforma oferuje rozbudowany panel sprzedawcy, który wspiera codzienną sprzedaż i operacje:
- zarządzanie produktami (w tym rich text editor i opisy SEO)
- zarządzanie zamówieniami, klientami i zwrotami
- system promocji (rabaty, darmowa dostawa, oferty dla konkretnych klientów)
- wykrywanie porzuconych koszyków i możliwość reakcji sprzedawcy
- system wiadomości i ticketów
- tryb urlopowy i dostępność sprzedawcy
- analizy sprzedaży i zarobków
- onboarding i automatyzacje procesów
To poziom funkcjonalności, który wykracza poza standardowe rozwiązania większości marketplace.
Kliknij, aby powiększyć
Kliknij, aby powiększyć
Wydajność i skalowanie
~1.4 s
LCP (desktop)
200-300 ms
TTFB strony produktowej
<100 ms
Większość requestów backendu
Architektura pod duży ruch
Platforma została zaprojektowana z myślą o skalowaniu od pierwszego dnia. Kluczowe elementy:
Cache warstwowy
Agresywne strategie cachowania (Redis, cache warstwowy).
Rewalidacja na żądanie
Rewalidacja danych na żądanie po zmianach w systemie.
ISR dla większości stron
ISR dla większości stron (Next.js).
Wyszukiwanie na Algolii
Integracja z Algolia dla wyszukiwania i listingów.
Optymalizacja requestów backendu
Optymalizacja requestów backendowych w całej platformie.
W trakcie rozwoju platformy backend przeszedł znaczącą optymalizację, od problemów z requestami na poziomie kilku sekund do stabilnego i przewidywalnego systemu.
AI w CMS i panelu sprzedawcy
Platforma wykorzystuje AI w praktyczny sposób:
- generowanie treści, SEO i artykułów w CMS (Sanity)
- kontekstowe wsparcie oparte o istniejące treści
- generowanie i optymalizacja opisów produktów w panelu sprzedawcy
- audyt jakości treści pod SEO
Nie jest to zbędny ficzer, tylko narzędzie zwiększające efektywność sprzedawców.
Kliknij, aby powiększyć
Kliknij, aby powiększyć
Integracje i systemy wspierające
Platforma została rozbudowana o wiele modułów i integracji. Architektura oparta jest na Medusa.js, rozszerzona o kilkadziesiąt dedykowanych modułów odpowiadających za konkretne funkcje biznesowe. Artovnia została zbudowana na Medusie, z Mercur jako otwartoźródłowym punktem startowym.
Frontend
Backend
Infrastruktura
Integracje
Podejście produktowe zamiast platformy dla wszystkich
Artovnia nie została zaprojektowana jako marketplace maksymalizujący przychody z reklam czy inwestorów.
To platforma:
- skupiona na sprzedawcach i ich kontroli nad sprzedażą
- transparentna pod względem kosztów
- zgodna z wymaganiami UE (GDPR, Omnibus, KYC/AML, DAC7)
- pozbawiona reklam i dark patterns
Celem było stworzenie środowiska, które realnie wspiera twórców, zamiast ich ograniczać.
Kliknij, aby powiększyć
Zakres odpowiedzialności
Jako full-stack developer odpowiadałem za całość implementacji, w tym:
Architektura backendu i systemu marketplace
System płatności i rozliczeń
Projekt i implementacja systemu płatności i rozliczeń.
Logika sprzedaży i moduły marketplace
Panel sprzedawcy i doświadczenie użytkownika
Optymalizacja wydajności i skalowalności
Integracje z systemami zewnętrznymi
Implementacja AI w CMS i panelu
Podsumowanie
Artovnia to projekt rozwijany iteracyjnie, od MVP do zaawansowanego systemu marketplace, w którym decyzje technologiczne były wynikiem realnych ograniczeń i potrzeb biznesowych, a nie wygody implementacji.
Dziś platforma obsługuje niezależnych twórców, 10 przewoźników w jednym systemie śledzenia przesyłek i 5 integracji z platformami sprzedażowymi i logistycznymi, a baza sprzedawców stale rośnie.
To przykład budowy platformy e-commerce od podstaw, z własną logiką finansową, operacyjną i produktową, zaprojektowanej z myślą o skalowaniu.
Planujesz własny marketplace?
Artovnia powstała od podstaw, z własną logiką finansową, operacyjną i produktową, zaprojektowana z myślą o skalowaniu.
Napisz do mnie