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