Changes between Version 19 and Version 20 of UseCaseImplementations
- Timestamp:
- 10/01/25 01:31:01 (2 weeks ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
UseCaseImplementations
v19 v20 20 20 21 21 == ИД 1 - Регистрација на нов корисник == 22 Ако корисникот испрати податоци (POST), формуларот се валидира; ако е валиден, се креира нов корисник и се зачувува во базата. Потоа корисникот се аутентицира и, ако е успешна аутентикацијата, автоматски се логира и се пренасочува на почетната страница. Ако барањето не е POST, се прикажува празен регистрациски формулар. 23 22 24 [[Image(register.jpg)]] 23 25 [[Image(registracija_kod.2.jpg)]] 24 26 25 27 == ИД 2 - Најава на корисник == 28 За регистрацијата е креиран URL кој го поврзува register view-то со соодветниот шаблон. Формуларот RegisterForm се користи за внес на корисничките податоци и нивна валидација. По успешно пополнување и зачувување на податоците, корисникот автоматски се логира, слично како кај LoginView, и се пренасочува на почетната страница. 29 26 30 [[Image(najava.jpg)]] 27 31 [[Image(najava_kod1.jpg)]] … … 29 33 30 34 == ИД 3 - Преглед на сите продукти == 35 Преглед на сите продукти: ова view ја прикажува листата на сите продукти со опции за пребарување, филтрирање по категории, продавници, цена и попусти, сортирање по различни критериуми, пагинација, прикажување слични продукти и одбележување на омилените продукти за логирани корисници. 36 31 37 [[Image(katalog.jpg)]] 32 38 [[Image(productlist_kod1.jpg)]] … … 37 43 38 44 == ИД 4 - Филтрирање на продукти == 45 Овој JavaScript го управува филтерот за продукти. Секциите со филтри можат да се отвораат и затвораат, а при кликање надвор од филтрите тие автоматски се затвораат. Слајдерот за максимална цена ја прикажува моменталната вредност во реално време, а кога корисникот менува категории, продавници или сортирање, формуларот се испраќа автоматски за да се апдејтира листата на продукти без рефреш на страницата. 46 39 47 [[Image(filter.jpg)]] 40 48 [[Image(filter_kod1.jpg)]] … … 43 51 44 52 == ИД 5 - Преглед детали за еден продукт == 53 Ова view ја прикажува деталната страница на еден продукт. Се вчитува продуктот по неговото ID, се извлекува историјата на цените од базата за креирање график, и се наоѓаат слични продукти. Сите овие податоци се проследуваат на шаблонот product_detail.html за прикажување на информациите и графикот со цените. 54 45 55 [[Image(detalen_produkt.jpg)]] 46 56 [[Image(productdetail_kod.jpg)]] 47 57 48 58 == ИД 6 - Додавање продукт во листа == 59 Овој JavaScript го управува додавањето продукти во корисничката листа. Кога корисникот кликне на копчето ‘add to list’, се зема ID-то на продуктот и се праќа POST барање до /add-to-list/ преку fetch со JSON тело и CSRF токен за заштита. Серверот враќа JSON со статус; ако е успешен, се прикажува известување дека продуктот е додаден, а ако не, се прикажува грешка. На овој начин целата операција се случува без рефреш на страницата, што ја прави интеракцијата побрза и поинтерактивна. 60 49 61 [[Image(dodadi_vo_lista1.jpg)]] 50 62 [[Image(dodadivolista_kod1.jpg)]] … … 52 64 53 65 == ИД 7 - Креирање нова листа на продукти == 66 Овој JavaScript управува создавањето на нови листи: при кликање на копчето за креирање се прикажува формуларот, а при кликање на ‘откажи’ се сокрива. Формуларот за листа се валидара локално (име не смее да е празно или подолго од 100 карактери) и се испраќа преку AJAX повик без рефреш на страницата. 67 54 68 [[Image(kreiraj_lista.jpg)]] 55 69 [[Image(kreirajlista_kod1.jpg)]] … … 58 72 59 73 == ИД 8 - Преглед на сите листи на корисникот == 74 Ова view го прикажува сите листи на тековниот корисник. Ако корисникот е логирани, се вчитуваат неговите листи од базата и се прикажуваат во шаблонот lists.html. 75 60 76 [[Image(pregled_listi.jpg)]] 61 77 [[Image(prikazlisti_kod.jpg)]] 62 78 63 79 == ИД 9 - Уредување/бришење листа == 80 Овој view овозможува корисникот да ја избрише конкретната шопинг листа. Серверот најпрво ја наоѓа листата што соодветствува на дадениот list_id и припаѓа на тековниот корисник, а потоа, ако е примено POST барање, ја брише од базата и го пренасочува корисникот на прегледот на останатите листи. 81 64 82 [[Image(brishenje_lista1.jpg)]] 65 83 [[Image(brishenjelista_kod.jpg)]] 66 84 67 85 == ИД 10 - Додавање продукт во омилени == 86 Овој use case овозможува корисникот да додава или отстранува производи од својата листа на омилени. Кога корисникот кликне на иконата за омилени, JavaScript-от праќа POST барање до серверот, кој проверува дали производот веќе е омилен и соодветно го додава или отстранува од базата. Статусот на омилените производи се прикажува веднаш на интерфејсот со промена на иконата и бојата, а ако корисникот е на страницата „Омилени“, се освежува листата за да се прикаже актуелната содржина. 87 68 88 [[Image(dodadi_fav1.jpg)]] 69 89 [[Image(favorite_kod1.jpg)]] … … 74 94 75 95 == ИД 11 - Преглед на омилени продукти == 96 Овој код ја прикажува листата на омилени продукти за тековниот најавен корисник. Тој ги влече омилените продукти од базата и ги предава на шаблонот favorites.html за прикажување на страницата. 97 76 98 [[Image(dodadi_fav2.jpg)]] 77 99 [[Image(pregledfav_kod1.jpg)]] … … 81 103 82 104 == ИД 13 - Статистика/агрегација на продукти == 105 Функцијата stats_view ја прикажува статистиката за цените на одреден производ во избрана продавница. Таа ја пребарува базата според името на производот и продавницата, наоѓа точен натпревар или слични производи, и ги зема податоците за цените во зададен временски период. Потоа пресметува тековна, минимална, максимална и просечна цена, и ги предава овие информации за прикажување во шаблонот (stats.html). 106 83 107 [[Image(statistika.jpg)]] 84 108 [[Image(stats_kod1.jpg)]] … … 90 114 91 115 == ИД 14 - Сортирање == 116 Кога корисникот избира нов критериум од select полето, се ажурира URL-от со новиот параметар sort и ресетира page на 1. На тој начин страницата се освежува и прикажува продукти сортирани според избраниот критериум без потреба за повторно рачно пребарување. 117 92 118 [[Image(sortiranje.jpg)]] 93 119 [[Image(sort_kod.jpg)]] 94 120 95 121 == ИД 15 - Приказ на флаери за продукти кои се на попуст == 122 Овој скрипт управува со модален прозорец кој прикажува сите продукти на попуст за одредена продавница. Кога корисникот кликне на „Види ги сите“ копчето, се испраќа AJAX барање до backend (/get-store-products/) за да се добијат продуктите на попуст. Добиените продукти се прикажуваат динамички во модалниот прозорец со слики, имиња, стара и нова цена и процент на попуст. Доколку нема продукти на попуст, се прикажува порака „Нема достапни попусти“. 123 96 124 [[Image(flaeri.jpg)]] 97 125 [[Image(flaeri_kod1.jpg)]] … … 100 128 101 129 == ИД 16 - Пребарување продукти со прилагодлив алгоритам == 130 За овој use case се користи комбинација од backend и frontend логика. На backend-от, функцијата get_similar_products (Python) ги наоѓа сличните продукти според име и категорија користејќи SentenceTransformer за векторско претставување на имињата и пресметка на косинусна сличност. Дополнително се земаат предвид клучни зборови, бонус за специфични категории и различни продавници, а резултатите се сортираат по вкупен скор за да се прикажат најрелевантните продукти. На frontend-от, JavaScript кодот ги нормализира пребарувањата на корисникот со преведување од латиница во кирилица и автоматска корекција на честите печатни грешки. Ова овозможува пребарување без разлика дали корисникот внесува текст на латиница, кирилица или со грешки, а резултатот се испраќа до backend-от за да се прикажат соодветните продукти. 131 102 132 [[Image(prebaruvanje.jpg)]] 103 133 [[Image(alg_kod1.jpg)]]
