Instalacja

Wymagania

Node.js v18 lub nowszy, ze wsparciem dla parzystych wersji Node.js.
Wspierana wersja TypeScript jest ustalana podczas instalacji. Aktualizacja do nowszej wersji TypeScript może powodować błędy kompilacji.
Jeśli chcesz używać MySQL, MariaDB lub Postgres jako bazy danych, będziesz potrzebować lokalnie dostępnej instancji. Jednak jeśli dopiero testujesz Deenruv, zalecamy użycie SQLite, która nie wymaga żadnych zewnętrznych zależności.
Jeśli używasz Yarn, wymagany jest Yarn 2 (Berry) lub nowszy.

Zalecanym sposobem na rozpoczęcie pracy z Deenruv jest użycie narzędzia @deenruv/create. Jest to narzędzie wiersza poleceń, które utworzy strukturę nowego projektu Deenruv, skonfiguruje go i zainstaluje wszystkie zależności.

1. Uruchom polecenie

npx @deenruv/create my-shop

2. Wybierz bazę danych

Deenruv obsługuje kilka różnych baz danych. Narzędzie @deenruv/create poprosi Cię o wybranie jednej z nich.

Aby szybko przetestować Deenruv, zalecamy użycie SQLite, która nie wymaga żadnych zewnętrznych zależności. Zawsze możesz przełączyć się na inną bazę danych później, zmieniając plik konfiguracyjny.

Jeśli wybierzesz MySQL, MariaDB lub Postgres, upewnij się, że:

serwer bazy danych jest uruchomiony i dostępny
utworzyłeś bazę danych do użytku przez Deenruv
znasz nazwę użytkownika i hasło z dostępem do tej bazy danych

3. Wypełnij danymi

Ostatnie pytanie dotyczy tego, czy wypełnić nowy serwer Deenruv przykładowymi danymi produktów.

Zalecamy to zrobić, ponieważ da Ci to dobry punkt wyjścia do eksploracji API, które omówimy w sekcji Wypróbuj API, a także dostarczy dane do wykorzystania przy budowaniu własnego sklepu.

4. Zakończ konfigurację

Następnie zostanie utworzona struktura projektu i zainstalowane zależności. Może to potrwać kilka minut.

Po zakończeniu zobaczysz komunikat podobny do tego:

5. Uruchom serwer

Postępuj zgodnie z instrukcjami, aby przejść do nowo utworzonego katalogu projektu i uruchomić serwer:

cd my-shop

yarn dev
# lub
npm run dev

Teraz powinieneś mieć dostęp do:

Deenruv Admin GraphQL API: http://localhost:6100/admin-api
Deenruv Shop GraphQL API: http://localhost:6100/shop-api
Panel administracyjny Deenruv: http://localhost:6100/admin

Gratulacje! 🥳 Masz teraz w pełni działający serwer Deenruv uruchomiony lokalnie.

Teraz możesz eksplorować Deenruv, postępując zgodnie z naszym przewodnikiem Wypróbuj API, aby dowiedzieć się, jak komunikować się z serwerem.

Jeśli jesteś nowy w GraphQL, powinieneś również zapoznać się z naszym Wprowadzeniem do GraphQL.

Otwórz panel administracyjny pod adresem http://localhost:6100/admin w przeglądarce i zaloguj się danymi superadmina, które podałeś. Domyślne dane to:

login: superadmin
hasło: superadmin

Użyj npx deenruv add, aby zacząć dodawać pluginy i niestandardowe funkcjonalności do swojego serwera Deenruv.

Rozwiązywanie problemów

Jeśli napotkasz jakiekolwiek problemy podczas instalacji, możesz uzyskać bardziej szczegółowe dane wyjściowe, ustawiając poziom logowania na verbose:

npx @deenruv/create my-shop --log-level verbose

Konfiguracja sklepu

Gdy serwer Deenruv jest już uruchomiony, możesz skonfigurować sklep, który będzie się z nim komunikować!

Mamy dostępnych kilka zestawów startowych do budowy sklepów — przejdź na stronę Zestawy startowe sklepów, aby dowiedzieć się więcej.

Na tej stronie