Next.js 13 w Praktyce: Prisma schema i relacje w bazie

0:00Teraz przejdziemy do modelowania naszych danych w schemacie Primy.

0:04Natomiast zanim to polecam Ci zainstaluj

0:07sobie extension do Visual Studio Code o nazwie Prisma.

0:11To dodaje Syntax Lighting w plikach, które są właśnie plikami schematu Primy.

0:17Jest wtedy łatwiej pisać schemat.

0:19Nasz kod wygląda bardziej czytelnie, jest automatycznie sformatowany.

0:23Także przejdźmy teraz do podstawowego pliku z schematem Prisma.

0:27To co mamy tutaj na początku to jest tylko

0:29provider, z którym możemy sobie ustalić custom.

0:32My w naszym projekcie będziemy używać default owego providera z Primy.

0:38Dodatkowo mamy tutaj.

0:39Jeżeli chodzi o Data Source DB Provider nasza baza danych to jest cool.

0:44No i URL to jest pliku dot

0:46database URL to jest to co mamy w naszym pliku do ten co już sobie zrobiliśmy.

0:51Przejdźmy teraz do przenoszenia tego co mieliśmy tutaj w tym schemacie.

0:56Mianowicie dokładnie tu musimy sobie to przenieść na schemat w piśmie.

1:02Tak ja sobie zostawię tą prawą stronę

1:04otwartą, żebyśmy wiedzieli o czym w danym momencie mówimy.

1:08I teraz jeżeli chodzi o model, wpiszmy no to robimy model i nazwiemy to user.

1:15To będzie model naszego użytkownika.

1:17Będziemy potrzebowali jakiegoś ID, jakiś identyfikator naszych

1:21użytkowników, czyli niech to będzie pole ID o typie string.

1:25I tutaj oznaczymy sobie, że jest to ID i to jest.

1:29Definiujemy parametr, który jest primary

1:32key w naszej tabeli, czyli w wprost w relacyjnych baza danych Primary key to

1:37jest identyfikator danego rekordu w danej tabeli.

1:42Czyli my sobie zaznaczymy, że to jest ID

1:44właśnie tutaj dla nas i chcemy żeby to było.

1:48Nie chcemy, żeby to się powtarzało.

1:51Dodatkowo co będziemy potrzebować dla

1:53każdego usera potrzebujemy jakiś name, niech to będzie też string.

1:58Tutaj nie musimy nic zaznaczać, nie musi to być unikalne.

2:01Możemy mieć użytkowników o tej samej nazwie.

2:03Nie ma tego problemu, bo użytkowników

2:05będziemy identyfikować za pomocą ich pola ID.

2:09No i jeszcze najlepiej żeby był email

2:11to też będzie string i tu też musimy sobie zrobić silnik.

2:16Nie chcemy mieć dwóch użytkowników z tym samym mailem.

2:19Nie powinno być to możliwe, żeby dwóch

2:21użytkowników o tym samym emailu stworzyło sobie konta na naszej aplikacji.

2:25Dlatego już musimy tutaj w modelu

2:27zaznaczyć, że to jest unik i nie dopuszczamy takiej sytuacji, że

2:31jest dwóch użytkowników o tym samym adresie e-mail.

2:34Teraz przejdźmy sobie do montażu subskrypcji.

2:36To jest bardziej skomplikowany model co my tutaj potrzebujemy?

2:41Oczywiście model, nie model.

2:42I tak każda subskrypcja na pewno też będzie miała ID.

2:46Czyli tu mamy string i też będzie to pole.

2:49ID możemy zrobić jako default.

2:53To jest format, który sobie zakładamy, że

2:55będzie formatem określającym jak powinno wyglądać ID w naszej bazie danych.

3:00Teraz mamy name.

3:02Każda subskrypcja powinna mieć name

3:04w naszym modelu, który sobie założyliśmy po prawej stronie.

3:08Będzie to przydatne do tego, żeby wyświetlać alfabetycznie.

3:13Price też jest potrzebny i to będzie float number.

3:18Chcemy umożliwić użytkownikowi ceny po przecinkach.

3:23Jeżeli chodzi o kolejne wartości to potrzebujemy jakąś

3:27walutę czyli currency i tutaj już wprowadzimy pojęcie enum.

3:33W modelach Primy z.

3:37Te rejsy.

3:40I oczywiście na chwilę obecną to nie

3:42istnieje i dlatego musimy sobie stworzyć taki enum o takiej nazwie.

3:48I w tym momencie możemy już sobie wykorzystać.

3:51Tutaj już będziemy testować błędy,

3:52natomiast tutaj prostych enum ów nie możemy tworzyć.

3:55Do tego jeżeli chodzi o waluty, które będziemy obsługiwać w naszej aplikacji.

4:00Niech to będą złotówki, niech to będą

4:04waluta euro i niech to będzie waluta USD, czyli dolary.

4:08Już nie mamy żadnych problemów z naszą walutą.

4:12Kolejne pole, które będziemy potrzebować to Start date.

4:15I to będzie typ datetime.

4:18Widzisz, że nazwa pola i typ Tak określamy schemat bazy danych w prime nazwa, pole,

4:24typ i jeszcze mamy dodatkowe dekorator, które pozwalają nam

4:28wykorzystywać możliwości danej danego typu bazy danych, który mamy tutaj.

4:32Wszystko to jest opisane w dokumentacji.

4:35Staram się pokazać w jaki sposób możesz

4:37sobie modelować dane za pomocą właśnie identyfikatora rodzaju.

4:42Jaki to jest typ danych no i dekoratorów, które mamy dostępne.

4:46Za chwilkę przejdziemy się do relacji.

4:47To jest dosyć skomplikowaną sprawą.

4:49Schemat jest trudny do załapania, ale za chwilkę Ci to wytłumaczę.

4:54Pójdźmy teraz dalej.

4:55Kolejnym polem, które będziemy potrzebować na pewno jest End Date i to będzie pole

5:01opcjonalne, czyli DateTime i znak zapytania.

5:05Czyli to może być.

5:06Nie musi być subskrypcja, może być np.

5:09tak jak Netflix jest odprawiana

5:10miesięcznie, dlatego end date nie mamy za bardzo.

5:13Natomiast jeżeli ktoś wykupi sobie jakiś serwis na dany czas np.

5:17na rok, to możemy od razu zaznaczyć

5:19odpowiednie powiadomienie w naszej aplikacji.

5:22Jeżeli chodzi o kolejne rzeczy to mamy billing period.

5:26Czyli tutaj też kolejny enum, który

5:28będziemy wykorzystywać w naszej aplikacji jest subskrypcją.

5:33Piling.

5:35J.

5:37I stworzymy sobie ten enum tutaj.

5:41I tu potrzebujemy

5:43zależności w jaki sposób będziemy umożliwiać użytkownikowi wpisywanie.

5:49Właśnie tego okresu rozliczania się, co następuje.

5:52My załóżmy, że w naszej aplikacji mamy monthly kwartalny

5:58i roczne, czyli mamy miesięczne subskrypcje kwartalne i roczne.

6:02To są możliwości, które użytkownik może sobie wykorzystać.

6:06W naszej aplikacji możesz sobie tu

6:07zaznaczyć co ile musi płacić za daną subskrypcję.

6:11Następne rzeczy, które potrzebujemy to tak naprawdę jest next payment that.

6:18To też jest bardzo ważna informacja, którą

6:20musieli musimy wyświetlać na naszych ekranach.

6:23Jeżeli chodzi zobacz mamy ekran

6:25subskrypcji i tutaj jest informacja związana z next payment.

6:28Dlatego musimy sobie to zawrzeć w naszym modelu danych.

6:31Next.

6:33Pigment.

6:35To także.

6:38Kolejna rzecz to jest kategoria.

6:41To może być string, zwykły awatar, URL też może być string zwykły walidację.

6:49Jeżeli chodzi o to, możemy zrobić po

6:51stronie klienta we wpisywaniu, albo możemy tak ograć nasz

6:56system, że klient będzie podawał tylko i wyłącznie stronę np.

7:01www do danej subskrypcji, a my z tej

7:03strony będziemy otrzymywali logo i używanie tego jako naszego awatara.

7:07Możliwości tutaj jest mnóstwo tak naprawdę, które można sobie wykorzystać.

7:13Kolejną rzeczą, którą będziemy potrzebować w naszej subskrypcji jest status.

7:17I tutaj też kolejny enum subskrypcji.

7:20No bo mamy przykład, że może być aktywna,

7:23kontrolowana, spasowana, nieaktywna i jeżeli chodzi o statusy.

7:29Na chwilę obecną stworzymy sobie dwa, że będzie aktywna i nieaktywna Activ Active.

7:39I potrzebujemy teraz budować nasze relacje.

7:42Mianowicie każda subskrypcja powinna mieć.

7:46Ja sobie zapisze ten plik.

7:48Widzisz, ładnie mi się sformatowałem

7:49dzięki temu rozszerzeniu, które przed chwilą, o którym przed chwilą mówiliśmy.

7:53Każda subskrypcja powinna mieć jednego właściciela, czyli usera.

7:57Relacje w schemacie buduje się za pomocą dwóch pól.

8:03Zawsze musimy użyć pola, które jest polem referencyjnym do relacji, czyli w tym

8:10przypadku zrobienie sobie one id i to będzie string.

8:15Dlaczego typ String?

8:16Dlatego, że typ pola id usera to też jest string.

8:20I to będzie dokładnie ta dana, która będzie zapisywana tutaj w tym polu,

8:26która będzie określała, który użytkownik jest właścicielem tej subskrypcji.

8:30Jeżeli chodzi o samą relację

8:32to musimy sobie wpisać owner i tutaj typ to będzie user.

8:38Żeby stworzyć relację w piśmie

8:40zrobimy sobie użyjemy sobie pola relation i tutaj mamy fields.

8:45To jest jedna rzecz, którą musimy określić.

8:47I kolejna rzecz, którą musimy określić, to jest referencje, czyli pola referencji.

8:55No i jeszcze my sobie określimy, że jeżeli usuniemy danego użytkownika, to chcemy też

9:01usunąć wszystkie subskrypcje związane z tym użytkownikiem.

9:06Normalnie powinniśmy flagowa subskrypcję w naszej aplikacji.

9:09Natomiast żeby uprościć troszkę tą sprawę

9:12ja sobie tutaj zaznaczę, że on the limit będzie Cascade, czyli

9:18wszystkie dzieci, rekordy dzieci, subskrypcje powinny zostać usunięte.

9:23Jeżeli to zostanie usunięta, czyli

9:24wszystkie płatności nie będziemy tego flagowe, co jest dobrą praktyką.

9:29Generalnie rzecz biorąc.

9:30Natomiast na potrzeby tego kursu zrobimy sobie kaskadowe usuwanie rekordów.

9:34Jeżeli usuniemy danego użytkownika z bazy

9:36danych One RAID, to będzie pole, które jest referencją

9:42filtrem, który określa relację, a referencja to będzie ID.

9:47To jest pole tego użytkownika.

9:51No i mamy naszą relację już stworzoną.

9:54No i teraz kolejna rzecz, którą

9:56subskrypcja będzie zawierała to płatności Payments tutaj.

10:04Wchodzi nowy model.

10:05To będzie tablica o typie payment.

10:09No i już musimy sobie stworzyć nowy model, który określi nam

10:13jak będzie wyglądała płatność w naszym modelu danych, czyli model payment.

10:21I tak payment na pewno też przydałoby się, żeby miał ID.

10:24Czyli zrobimy sobie na takiej samej zasadzie co nasza subskrypcja.

10:28Niech to będzie już ID format String.

10:33Że bardzo fajne jest to, że generalnie jak zapiszę to tutaj.

10:38Prisma jest na tyle inteligentna, że

10:40potrafi mi podsunąć pomysł jak powinna wyglądać moja relacja.

10:44Tak naprawdę prawie w stu procentach jest ona zbudowana tak, jak my byśmy chcieli.

10:47Jest tutaj kilka rzeczy, które chciałbym

10:49jeszcze zmienić, dlatego wyrzucimy sobie to tutaj i będziemy pisać

10:53sobie, żeby przećwiczyć sobie tą relację samemu.

10:55Natomiast zanim do relacji przejdziemy, to zapiszmy sobie najpierw

11:00amount, czyli to będzie ilość, koszt, wartość tego rachunku, wartość tego

11:05fragmentu, który chcemy pokazywać to będzie też wartość float.

11:09Dodatkowa rzecz date, czyli data płatności DateTime.

11:14I niech to będzie db that.

11:16Określamy jakby rodzaj danego pola w bazie danych.

11:21Status.

11:23Niech to będzie payment status i możemy sobie zaznaczyć wartość domyślną.

11:28W naszym przypadku niech to będzie odpłatne.

11:30Jeżeli ktoś tworzy jakiś nowy nową

11:32subskrypcję, to prawdopodobnie jeszcze nie będzie zapłacona ta opłata.

11:37Natomiast potrzebujemy oczywiście stworzyć

11:39sobie ten i nam tutaj będzie pat i not bad.

11:45Mamy payment status.

11:47Potrzebujemy jeszcze tutaj określić, że to jest wartość default w

11:52naszej bazie danych i ten default to będzie właśnie pat w naszym przypadku.

11:57I teraz przejdziemy do naszej relacji Subskrypcje paid to będzie string.

12:06No i jeżeli chodzi o relację to subskrypcja to jest pole subskrypcji.

12:12No i relację tworzymy poprzez to sam.

12:16Tę samą zasadę, którą mieliśmy tutaj.

12:18Czyli ja sobie zrobię kopiuj wklej na dół.

12:20I jeżeli chodzi o filc to jest git.

12:24W naszym przypadku to jest pole, które określa naszą relację.

12:27Jeżeli chodzi o referencję jest ok.

12:29Pole ID w subskrypcji istnieje i to jest

12:33nasza referencja do rekordu w tabeli Subskrypcje.

12:37I to by było na tyle.

12:38Mamy nasz model bazy danych i teraz

12:42przejdźmy do użycia tego modelu w praktyce.