Aplikacja ma na celu umożliwić dla użytkownika wygenerowanie presonalizwanego oraz aktualnego planu lekcji z wykorzystaniem bazy danych Degry.
Użytkownik może:
- zaktualizować swoje dane (kierunek studiów, semestr, grupy ćwiczeniowe itp.)
- wygenerować plan (zawierający przedmioty wyłącznie podanych grup)
Każdorazowe uruchomienie aplikacji powoduje pobranie aktualnej bazy danych z https://degra.wi.pb.edu.pl/.
Dane te są filtrowane oraz segregowane na podstawie dokonanych wyborów oraz zapisywane w pliku config.json.
Plik ten umożliwia zapisanie profilu użytkownika, aby wybory wykonywane były wyłącznie przy pierwszym uruchomieniu, lub w wypadku chęci zmiany danych.
Jednym z wyzwań była prawidłowa integracja bibliotek.
Wprowadzenie zaawansowanych tabel oraz kolorów do aplikacji konsolowej sprawiło zaskakująco wiele trudu.
Po długim debugowaniu oraz kontaktowaniu sie z twórcą jednej z bibliotek, udało się znaleźć sprytne rozwiązanie występujących błędów.
Głównym trudem zadania niewątpliwie było zrozumienie oraz prawidłowe wykorzystanie danych z Degry.
Aplikacja napisana jest w języku Typescript będącego nadzbiorem języka Javascript.
Dzięki temu projekt posiada statyczne typowanie co czyni go bardziej odpornym na nieoczekiwane błędy.
Aby uruchomic aplikację należy w pierwszej kolejności pobrac i rozpakować powyższe repozytorium. (https://github.com/viperva/kck-cli)
Aby umożliwić uruchomienie projektu, na komputerze powinno być zainstalowane środowisko uruchomieniowe Node.js (https://nodejs.org/en/download/)
Należy uruchomić konsolę i wejsc do katalogu projektu.
Następnie wykonać polecenia:
npm install oraz node src/index.js.
W przypadku systemu windows drugie polecenie wyglądać będzie następująco:
node \src\index.js
Zakładając poprawne wykonanie kroków poprzedniego punktu, nie przewiduje się dodatkowych kroków potrzebnych do prawidłowego działania aplikacji.
Korzystanie z programu jest wybitnie proste. Jak zresztą informuje erkan powitalny,
sterowanie odbywa się jedynie za pomocą strzałek oraz klawisza 'Enter' służącego do potwierdzania prezentowanych wyborów.
Aplikacja jest mała i prosta w obsłudze. Oferuje aktualny, estetyczny plan lekcji.
Przewagę nad dostępnymi planami lekcji oferowanymi przez Degrę, stanowi możliwość personalizacji.
W projekcie jest miejsce na rozwój (np. dodanie wsparcia dla przedmiotów obieralnych), jednak na ten moment stanowi funkcjonalną całość. Interfejs jest prosty do nawigowania oraz zrozumienia. Małym kosztem energii uzyskujemy zadowalający rezultat. Aplikacja jest też estetyczna dzięki wykorzstaniu tabel oraz kolorów. Najprzyjemniejszym aspektem implementacji tego projektu jest fakt wykorzystywania przez niego realnych danych sprawiając, że ma on zastosowanie praktyczne. Aby zrobić miejsce dla odrobiny samokrytyki, chciałbym zauważyć, że ponowne drukowanie planu odbywa się poprzez, cóż, kolejne drukowanie planu. Mimo, że w praktyce użytkownik nie będzie miał w zwyczaju drukować kilku planów na raz, ciekawe byłoby umożliwenie nadpisania obecnie pokazanego planu. Na tą chwilę wykracza to jednak ponad moje możliwości ze względu na brak czasu jak i umiejętności.