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

На следната табела се прикажани корисничките сценарија за кои ќе го прикажам кодот во контролерите:

ID	Use Case Scenario	Actor
7	Пребарување низ ментори	Најавен корисник
9	Автоматско совпаѓање (match) со ментор	Студент
10	Контактирање на ментор	Студент
11	Пишување мислење за ментор	Студент
12	Прифати или одби барање за контакт	Ментор
13	Прифати или одби мислење на студент	Ментор

---

Најавен корисник

Пребарување низ ментори

Најпрво имаме преглед на ментори без применето филтрирање, каде сите ментори се прикажани во грид.

Имплементацијата на кодот е следна:

Метод IsStudent() - заштитен (protected) метод кој проверува дали моментално најавениот корисник е од тип Student.

Прво го зема ID-то на најавениот корисник преку User.Identity.GetUserId(). Потоа, преку Entity Framework ја пребарува табелата Users, но само корисници од тип Student (користејќи OfType<Student>()). Методот Any враќа true ако постои студент со истото ID, во спротивно false. Овој метод се користи за контрола на логиката во View (на пример, да се прикажат одредени функционалности само за студенти).

Метод ViewMentors(...) - ActionResult метод кој враќа View со листа на ментори и поддржува повеќе параметри за пребарување и филтрирање: име, презиме, предмет, тема и достапност.

Се креира нов ApplicationDbContext и се вчитуваат сите ментори заедно со нивните предмети (Subjects) и теми (Topics) користејќи Include. Податоците од ентитетот Mentor се мапираат во EditMentorModel (ViewModel). Потоа следуваат условни филтри:

• Ако е внесено име, се проверува дали името или презимето на менторот го содржи внесениот текст (без разлика на големи/мали букви).
• Ако е внесено презиме, се филтрира само по презиме.
• Ако е внесен предмет, се проверува дали некој од предметите на менторот го содржи внесениот текст.
• Ако е внесена тема, се проверува истото за темите.
• Ако е внесена вредност за available, таа се парсира во bool и се филтрираат само ментори со соодветна достапност.

Во ViewBag.IsStudent се сместува резултатот од методот IsStudent() за да може View-то да знае дали корисникот е студент. Потоа, View-то се враќа со филтрираната листа на ментори.

По примена на филтрирање според предмет, ги имаме следните резултати:

Корисникот може да филтрира според повеќе критериуми одеднаш.

---

Студент

Автоматско совпаѓање (match) со ментор

Корисниците кои се студенти можат да направат автоматско совпаѓање со ментор според предметите и интересите кои се во нивните профили.

Имплементација:

Овој HTTP GET метод служи за пронаоѓање на ментори кои најдобро одговараат на интересите и предметите на најавениот студент.

Најпрво го зема ID-то на тековниот корисник. Се вчитува студентот од базата, заедно со неговите предмети и теми. Доколку корисникот не е студент, се враќа HttpNotFound, а оваа функционалност е сокриена за ментори во View-то.

Потоа се вчитуваат сите достапни ментори со нивните предмети и интереси. Се екстрахираат листи од имиња на предмети и теми за студентот и за секој ментор се пресметува „score“ (оценка на совпаѓање) преку методот CalculateMatchScore. Се задржуваат само менторите со score поголем од 0 и се сортираат по опаѓачки редослед.

Резултатите повторно се мапираат во EditMentorModel и се враќа View-то ViewMentors, но овојпат со листа на најдобро совпаднати ментори.

CalculateMatchScore е имплементиран под него:

Ако matchType е "subjects" или "both", се пресметува пресекот помеѓу предметите на студентот и менторот. Секој заеднички предмет носи 2 поени.

Ако matchType е "interests" или "both", се пресметува пресекот помеѓу темите на интерес. Секоја заедничка тема носи 3 поени, така што темите имаат поголем приоритет од предметите.

На крај се враќа вкупниот резултат кон FindBestMatch.

Контактирање на ментор

На профилот на секој ментор се прикажани копчиња за контакт и пишување на свое мислење или искуство со менторот. Овие се видливи само за студенти:

При притискање на копчето за контакт се отвара следниот прозорец:

Откога ќе се пополни, се испраќа кон Inbox на менторот, каде што менторот одбира дали ќе го прифати или одбие барањето за контакт.

Имплементација:

Овој HTTP POST метод овозможува студент да испрати контакт-порака до ментор. Методот е заштитен со ValidateAntiForgeryToken за спречување CSRF напади.

На почеток се проверува дали е поставено MentorId. Доколку недостасува, во ModelState се додава грешка. Ако моделот не е валиден, се враќаат грешки како JSON објект ако барањето е AJAX, или повторно се враќа partial view-то ContactForm. Потоа се зема тековниот корисник и се проверува дали е студент. Доколку корисникот не е најавен како студент, се враќа грешка или Unauthorized. Ако сè е валидно, се поставува StudentId, се додава временска ознака (Timestamp), статусот се поставува на Pending се додека не одлучи менторот дали ќе го прифати или отфрли барањето, и на крај контактот се зачувува во базата.

Во зависност од типот на барањето (AJAX или не), методот враќа JSON порака за успех или редиректира кон профилот на менторот.

Пишување мислење за ментор

---

Ментор

Прифати или одби барање за контакт

Прифати или одби мислење на студент