Witaj w Deenruv

Deenruv to nowoczesna, headless platforma e-commerce zbudowana na NestJS i GraphQL. Zapewnia solidny i rozszerzalny fundament do budowania sklepów internetowych dowolnej skali — od małych sklepów po wielokanałowe marketplace z wieloma sprzedawcami.

Pierwszy raz z Deenruv? Zacznij od przewodnika instalacji, aby uruchomić platformę w kilka minut.

Szybki start

npx @deenruv/create my-shop

To polecenie tworzy nowy projekt, instaluje zależności i konfiguruje serwer deweloperski z bazą danych SQLite. Po uruchomieniu uzyskasz dostęp do:

Panel administracyjny pod adresem http://localhost:6100/admin
Shop API pod adresem http://localhost:6100/shop-api
Admin API pod adresem http://localhost:6100/admin-api

Przeglądaj dokumentację

Pierwsze kroki

Zainstaluj Deenruv, skonfiguruj bazę danych i uruchom serwer deweloperski.

Kluczowe koncepcje

Poznaj produkty, kolekcje, zamówienia, kanały i inne elementy.

Przewodnik dewelopera

Poznaj warstwę API, serwisy, pluginy, eventy i strategie.

Budowanie sklepu

Połącz się z Shop API i zbuduj sklep od strony klienta.

Wdrożenie

Wdróż na produkcję z Docker, skonfiguruj zasoby i skaluj horyzontalnie.

Podręcznik użytkownika

Codzienne zadania admina: zarządzanie produktami, zamówieniami i ustawieniami.

Kluczowe funkcje

Architektura headless — używaj dowolnego frameworka frontendowego (Next.js, Remix, Nuxt, Expo itp.)
API GraphQL — w pełni typowane Shop API i Admin API ze wsparciem dla generowania kodu
System pluginów — rozszerzaj każdy aspekt platformy bez forkowania
Wielokanałowość — sprzedawaj na wielu sklepach, w różnych walutach i językach z jednego backendu
TypeScript-first — pełne bezpieczeństwo typów w całym stosie technologicznym
Zadania w tle — odciąż ciężkie operacje (emaile, importy, indeksowanie wyszukiwania) na workery działające w tle

Przegląd architektury

Deenruv stosuje architekturę warstwową:

Warstwa	Opis
Warstwa API	Resolvery GraphQL obsługują przychodzące zapytania i delegują je do serwisów
Warstwa serwisów	Logika biznesowa, dostęp do bazy danych i publikowanie eventów
System pluginów	Rozszerzaj encje, API, serwisy i panel administracyjny
Worker	Przetwarzanie zadań w tle za pomocą BullMQ
Panel administracyjny	Panel admina oparty na React z rozszerzalnym interfejsem za pomocą pluginów

Uzyskaj pomoc

GitHub Issues — zgłaszanie błędów i propozycje funkcji
Kod źródłowy — przeglądaj repozytorium

Wprowadzenie