Имплементација на случаи на употреба

ID	Use Case
1	Најава на корисник
2	Навигирање кон преглед на профил
3	Пополнување на форма со положени предмети и лични интереси
4	Преглед на резултати добиени од алгоритмот
5	Преглед, пребарување, филтрирање на сите предмети
6	Регистрација на корисник
7	Додавање на предмет во омилени
8	Оставање на оценка на препорачан предмет
9	Преглед на мои предмети

ИД: 1 - Најава на корисник

При клик на копчето најави се, се испраќа POST барање до backend-от.

Се проверува дали постои таков корисник, доколку постои се враќа автентикациски токен.

Откога ќе се добие токенот, најавувањето се довршува на клиентската страна со повик на оваа функција којашто ги зачувува токените на корисникот.

ИД: 2 - Навигирање кон преглед на профил

Кога корисникот првпат ќе навигира кон преглед на профилот ќе се испрати GET барање за информациите на корисникот, потоа тоа се зачувува во React Context и веќе не се прават барања до сервер кога корисникот сака да го пристапи.

Во backend-от се повикува соодветниот serializer за да се форматираат овие информации во JSON формат.

ИД: 3 - Пополнување на форма со положени предмети и лични интереси

Кога корисникот првпат ја пополнува формата со клик на копчето „Зачувај“ се испраќа POST барање, додека во сите следни пополнувања текстот во истото копче ќе биде „Ажурирај“ и ќе биде испратено PATCH барање.

Пред да се испрати барањето, без разлика кое од претходно наведените, информациите коишто студентот ги внел прво се валидираат. Доколку има грешка (непополнети предуслови за предмет, задолжително поле оставено празно...), барањето не се прави, туку се прикажува соодветна порака за грешка.

На backend-от, прво се проверува дали корисникот има такви пермисии.

Доколку информациите се валидни, се зачувуваат во база.

ИД: 4 - Преглед на резултати добиени од алгоритмот

Откога студентот ќе го притисне копчето за да добие препораки се испраќа GET барање кое како дополнителни параметри ги има сезоната (season - 0: летна, 1: зимска, 2: двете) и дали студентот сака да му се прикажуваат неактивирани предмети (not_activated - 0: не прикажувај, 1: прикажувај).

Се наоѓа уникатен клуч за студентот според неговите преференци и параметрите на барањето, доколку постои таков клуч во кеш табелата и вредноста е валидна, кешираните препораки се враќаат на корисникот без никакви дополнителни пресметки. Доколку не постои се извршуваат сите пресметки и препорачаните предмети се кешираат користејќи го истиот уникатен клуч пред да се вратат кон клиентот. Клучот се зема преку повик на функција.

Доколку нема кеширани препораки истите треба да се пресметаат. Прво се филтрираат предметите според неколку критериуми.

Се мапира секој предмет од исфилтрираните во својот соодветен вектор.

Се прави вектор за студентот.

Се оценуваат сите атрибути.

Посебна функција за оценување на таговите.

Се множат сите резултати со одредени тежини и се враќаат најдобрите N резултати до клиентот.

ИД: 5 - Преглед, пребарување, филтрирање на сите предмети

Доколку предметите не се земени од база, се испраќа GET барање и се зачувуваат во React Context и веќе не се прават барања до сервер кога корисникот сака да ги пристапи.

Логиката за филтрирање и пребарување на предметите.

ИД: 6 - Регистрација на корисник

При клик на копчето најави се, се испраќа POST барање до backend-от. Доколку успешно, корисникот е веднаш логиран на својот нов профил.

Се валидираат информациите внесени од корисникот. Доколку нема проблем со испратените информации се создава корисникот и се враќа инстанца од истиот, заедно со дополнителни токени за автентикација.

ИД: 7 - Додавање на предмет во омилени

Со клик на срцето се испраќа POST барање за тргање или додавање на предметот во листата на омилени.

Во backend-от истата функција се користи за справување со барања за додавање во омилени, позитивна оценка и негативна оценка. Се користат параметри во барањето за да може да се преземе соодветната акција.

ИД: 8 - Оставање на оценка на препорачан предмет

Со клик на копчето лајк се испраќа POST барање за додавање на предметот во листата на позитивни оценки. Доколку предметот претходно бил во листата на негативни оценки се испраќа и барање за истиот да се тргне од таа листа.

Истото важи и за негативните оценки.

На backend-от се повикува истата функција како и за додавање во омилени (види ИД 7 - слика 2)

ИД: 9 - Преглед на мои предмети

Кога корисникот првпат ќе навигира кон „Мои предмети“ ќе се испрати GET барање за неговите предмети, потоа тоа се зачувува во React Context и веќе не се прават барања до сервер кога корисникот сака да го пристапи.