maciej-szeremeta / duck-shop-be

Backend part of the rubber duck shop

Aplikacje backendowa sklepu z gumowymi kaczkami dla programistów www.duck-shop.pl

Pierwszy raz gumowa kaczka w świecie IT pojawiła się za sprawą legendarnej książki pt. “The Pragmatic Programmer” autorstwa Andrew Hunta i Davida Thomasa z 1999 roku, która do dziś otwiera głowy przyszłych adeptów sztuki codingu. To właśnie tam pierwszy raz padło pojęcie rubber duck debuggingu, czyli metoda gumowej kaczki dla programistów. Od tamtej pory żółty ptak stał się najlepszym przyjacielem programistów i świetnym pomysłem na prezent dla miłośników IT.

---

---

Stos technologiczny

• ExpressJS
• MySql
• TypeScript

Aplikacje można testować pobierając oraz importując plik .json do Insomni lub Postamana Link🦆

---

Skills

• Obsługa błędów 😊
• Tworzenie tokena z rolami (Admin,User)😊
• Weryfikacja użytkownika JWT (Admin,User)😊
• TypeScript😟
• Testy😮

---

Endpointy

---

USERS

Tabela Users

id	username	email	password	isAdmin
uuid()	user	[email protected]	hashedPassword	1

api/auth

• POST auth/register

Rejestracja użytkownika.

• POST auth/login

Logowanie użytkownika - informacją zwrotną jest TOKEN wykorzystywana z w celu autoryzacji i autentykacji ( dziwnie to brzmi po polsku 😉).

api/user

• GET user/find/:id (@User)

Pobranie jednego użytkownika.

• GET user?top=100 (@Admin)

Pobranie wielu użytkowników z możliwością ograniczenia ilości w parametrze.

• GET user/stats (@Admin)

Prosta statystyka ilość zarejestrowanych użytkowników w miesiącach.

• PATCH user/ (@User)

Aktualizacja danych użytkownika.

• DELETE user/:id (@Admin)

Usówanie użytkownika.

---

PRODUCTS

Tabela Products

id	title	description	img	size	colorId	price	inStock
uuid()	Batman Duck	Najlepsza kaczucha	batmanduck	M	211ae6be-238d-4334-bdac-ae0747fbc7a7	12,33	1

colorId relacja wiele-do-jednego

Tabela Products_categories

id	productId	categoryName
auto_increment	f9d4cb5f-1ac5-4ef5-915d-d10ce0d1841c	Junior
auto_increment	f9d4cb5f-1ac5-4ef5-915d-d10ce0d1841c	Senior

products_categories relacja wiele-do-wielu

Tabela Categories

id	name	title	img
uuid()	Senior	Senior developer	Senior Duck
uuid()	Junior	Junior developer	Junior Duck
uuid()	Mid	Mid developer	Mid Duck

Tabela Colors

id	name
uuid()	Czarna
uuid()	Czerwona

api/product

• POST product/ (@Admin)

Tworzenie produktu oraz aktualizacja tabeli products_categories (relacja wiele-do-wielu).

• PATCH product/:id (@Admin)

Aktualizacja produktu oraz aktualizacja tabeli products_categories (relacja wiele-do-wielu).

• GET product/find/:id (@All)

Pobranie jednego produktu.

• GET product?top=10&category=Mid (@All)

Pobranie wszystkich produktów w możliwością ograniczenia ilości oraz filtrowaniem po kategorii.

• DELETE product/:id (@Admin)

Usówanie produktu oraz aktualizacja tabeli products_categories (relacja wiele-do-wielu).

api/colors

• GET, POST, PATCH, DELETE (CRUD) (@Admin)

api/categories

• GET, POST, PATCH, DELETE (CRUD) (@Admin)

---

CART

Tabela Carts

id	title
uuid()	userId

Tabela Carts_products

id	cartID	productId	quantity
auto_increment	20116395-de80-44fd-b0e3-c56fcc329b4b	f089f588-3e84-4c46-8cc0-ab95e7ba9bcb	1

api/cart

• POST cart/ (@User)

Dodawanie do koszyka przez tworzenie nowego koszyka oraz relacji z przedmiotami w tabeli carts_products.

• PATCH product/:cartId (@User)

Aktualizacja ilości produktu (produkt podawany w parametrze).

• DELETE product/:cartId/:productId (@User)

Usówanie produktu z koszyka.

• DELETE product/:cartId (@User)

Usówanie całego koszyka.

• GET product/:userId (@User)

Pobranie koszyka użytkownika z informacja zwrotną z listą produktów, ilością pozycji w koszyku oraz wartością koszyka.

• GET product/ (@Admin)

Poranie wszystkich koszyków.

---

🦆🦆🦆🦆🦆🦆🦆🦆🦆🦆🦆🦆🦆🦆🦆🦆🦆🦆