Projektowanie aplikacji internetowych — projekt nr 2

To również jest projekt indywidualny. Będziecie Państwo rozpatrywać to samo zagadnienie biznesowe, które wybraliście jako temat projektu nr 1, ale zamiast HTML-owej witryny trzeba będzie stworzyć backendowy serwis z REST-owym API. Podobnie jak poprzednio najpierw trzeba opracować specyfikację API, a dopiero potem stworzyć serwis implementujący to API.

Specyfikacja ma być plikiem w formacie PDF. Powinna zawierać:

• jednoakapitowy opis wybranego tematu
• funkcjonalność serwisu
• szczegółowy opis danych przetwarzanych przez serwis
• właściwą specyfikację API, czyli listę REST-owych endpointów wraz z ich szczegółowymi opisami

W trzech pierwszych punktach proszę zrobić copy-paste z projektu nr 1 i nanieść niezbędne poprawki („serwis” zamiast „witryna” itp.).

Specyfikację API będziecie Państwo musieli napisać od zera. Trzeba m.in. opracować strukturę URL-i, JSON-ową reprezentację przesyłanych danych, rozważyć możliwe sytuacje wyjątkowe i to, jakie odpowiedzi serwis ma wtedy zwracać.

Dopuszczone narzędzia i pakiety:

• Node.js LTS oraz Express
• pakiet cors (expressowe middleware), bo choć CORS można samodzielnie obsłużyć w kilku liniach kodu, to po co ryzykować popełnienie błędu?
• Sequelize ze sqlite3 jako sterownikiem bazodanowym

Projekt nie obejmuje frontendu, macie stworzyć tylko backend. Aby móc sprawdzić, czy backend poprawnie działa, będzie potrzebne narzędzie do testowania REST-owych serwisów. Może to być:

• curl — domyślnie instalowany w Windows i większości dystrybucji Linux
• Postman REST Client — okienkowa aplikacja pod Windows, wygodniejsza w użyciu niż curl
• dowolny inny program pozwalający na specyfikowanie wszystkich składowych wysyłanego zapytania HTTP i wyświetlający całą odebraną odpowiedź HTTP łącznie z nagłówkami

Harmonogram projektu:

• 30 marca — rozpoczęcie prac
• 8 kwietnia (środa) — oddanie specyfikacji
• 20 kwietnia 24 kwietnia (piątek) — oddanie finalnej specyfikacji i serwisu