https://github.com/kamil20020/ksiegarnia-internetowa_bazy-danych-3_12-2022

https://github.com/kamil20020/ksiegarnia-internetowa_bazy-danych-3_12-2022

Last synced: 13 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/kamil20020/ksiegarnia-internetowa_bazy-danych-3_12-2022
• Owner: kamil20020
• Created: 2022-11-06T16:13:59.000Z (about 2 years ago)
• Default Branch: master
• Last Pushed: 2024-10-28T12:32:58.000Z (23 days ago)
• Last Synced: 2024-10-28T16:16:34.008Z (23 days ago)
• Language: TypeScript
• Size: 51.7 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Księgarnia internetowa (12.2022)

Aplikacja została zrealizowana w ramach zajęć projektowych z Internetowych baz danych na Politechnice Wrocławskiej. Szacujemy, że aplikację udało się zrealizować w około 90%.

## Cel projektu

Celem projektu były projekt, implementacja oraz wdrożenie księgarni internetowej dla wymyślonej firmy "Bookshop". Firma ta znajduje się na terenie Wrocławia oraz zajmuje się stacjonarną sprzedażą książek. Głównym powodem stworzenia systemu było usprawnienie pracy firmy oraz zapewnienie wygodnej i szybkiej obsługi klienta. 

## Plan projektu:

* Analiza SWOT,

* Wymagania funkcjonalne i niefunkcjonalne,

* Dobór narzędzi,

* Diagramy UML,

* Diagramy ERD,

* Prototypy interfejsu użytkownika.

### Implementacja:

* Baza danych,

* Aplikacja serwerowa,

* Aplikacja kliencka.

### Testowanie:

* Testy integracyjne backendu,

* Testy jednostkowe,

* Testy manualne interfejsu użytkownika,

* Testy automatyczne interfejsu użytkownika (zabrakło czasu).

### Na koniec:

* Wdrożenie całego systemu,

* Sporządzenie dokumentacji.

 

## Role użytkowników:

* Użytkownik - rola przypisywana każdemu użytkownikowi w systemie,

* Niezalogowany użytkownik,

* Zalogowany użytkownik,

* Klient - użytkownik zalogowany na koncie klienta,

* Pracownik - użytkownik zalogowany na koncie pracownika.



    



## Wymagania funkcjonalne:

* Użytkownik:

    * Przeglądanie listy dostępnych książek,

    * Wyświetlenie detali danej ksiązki.

* Niezalogowany użytkownik:

    * Założenie konta klienta (zabrakło czasu na podpięcie OAuth 2.0),

    * Zalogowanie się.

* Zalogowany użytkownik:

    * Wylogowanie się.

* Klient:

    * Modyfikacja danych osobowych,

    * Koszyk,

    * Złożenie zamówienia,

    * Sprawdzenie statusu własnego zamówienia,

    * Wycofanie wsłasnego zamówienia niebędącego jeszcze w trakcie realizacji.

* Pracownik:

    * Przeglądanie listy wszystkich książek,

    * Zarządzanie książkami (zabrakło czasu),

    * Dodanie / wycofanie książki z oferty (zabrakło czasu),

    * Przeglądanie listy zamówień,

    * Zmiana statusu zamówienia (Utworzone, Realizacja, Wycofane, Odebrane).

### Diagram przypadków użycia dla niezalogowanego oraz zalogowanego użytkownika:



    



### Diagram przypadków użycia dla klienta:



    



### Diagram przypadków użycia dla pracownika:



    



## Architektura systemu



    



Serewr aplikacji 1 odpowiada przede wszystkim za funkcje, z których mogą skorzystać klienci oraz pracownicy.

Serewr aplikacji 2 odpowiada za funkcje, z których mogą skorzystać wszyscy użytkownicy.

## Diagram ERD



    



## Technologie:

### Klient:

* Biblioteka do tworzenia UI - React (JavaScript),

* Statyczne typowanie - TypeScript,

* Biblioteka komponentów - MUI,

* Globalny stan aplikacji - Redux,

* IDE - Visual Studio Code.

### Serwer 1:

* Główny język - Java,

* Framework - Spring / Spring Boot (Java),

* Uwierzytelnianie - OAuth 2.0 (zabrakłko czasu),

* Środowisko - Itellij.

### Serwer 2:

* Główny język - Python,

* Framework - Django,

* Środowisko - PyCharm.

### Testowanie:

* Testy integracyjne oraz jednostkowe - JUnit, REST-assured,

* Testy automatyczne interfejsu użytkownika - Selenium (zabrakło czasu),

* Manualne testowanie wysyłania zapytań do serwerów - Postman.

### Wdrożenie:

* Chmura - Azure,

* Serwer webowy - Nginx,

* Docker.

### Pozostałe:

* Uwierzytelnianie - OAuth 2.0 (zabrakło czasu - jest uwierzytelnianie w pamięci a nie w bazie danych),

* Komunikacja między klientem a serwerami 1 oraz 2 - REST,

* Sporządzenie diagramów UML oraz ERD - Visual Paradigm,

* Projekt interfejsu użytkownika - Figma,

* Dokumentacja - Microsoft Word.

## Specyfikacja API:

### Backend 1:



    



### Backend 2:

* GET /books/all - pobranie danych wszystkich książek oraz kategorii książek

dostępnych w sklepie,

* GET /book/{bookId} - wyszukanie książki po id,

* GET /books/find/ - wyszukiwanie dostępnych książek według ustalonych

kryteriów (poprzez query params).

## Zrzuty ekranu:

Rejestracja:



    



Dla najwazniejszych pól wejściowych przeprowadzana jest walidacja np. dla rejestracji:



    



Logowanie:



    



Lista dostępnych książek:



    



Lista dostępnych książek z wypełnionymi kryteriami i filtrami:



    



Szczegółowe informacje o książce:



    



Wszystkie informacje o książce:



    



Zaimplementowano system powiadomień o sukcesie albo wystąpieniu błędu np. przy dodaniu produktu do koszyka:



    



Koszyk widziany przez niezalogowanego użytkownika:



    



Koszyk widziany przez zalogowanego użytkownika:



    



Jest brak możliwości złożenia zamówienia w przypadku brakujących produktów:



    



Składanie zamówienia:



    



Użytkownik może użyć danych podanych podczas rejestracji albo podać nowe.

Lista własnych zamówień:



    



Wyświetlenie wszystkich produktów z zamówienia:



    



Wyświetlenie danych odbiorcy przypisanego do zamówienia:



    



Wyszukiwarka zamówień:



    



Wyszukiwarka zamówień z wypełnionymi kryteriami i filtrami:



    



Zarządzanie zamówieniem: