Changes between Version 1 and Version 2 of UseCase001

Timestamp:

09/15/26 11:37:15 (2 weeks ago)

Author:

233149

Comment:

--

UseCase001

@@ -1 @@
-== UseCase001 - Најава на корисник
+== UC001 - Најава во системот
 
-=== Актери
- * Ненајавен корисник
+'''Иницијален актер:''' Посетител
 
-=== Чекори
- 1. Корисникот кликнува на копчето „Најави се“ (Log In)
- 2. На корисникот му се прикажува форма со две полиња - е-пошта и лозинка
- 3. Корисникот ја пополнува формата со податоците внесени при регистрација
- 4. Корисникот кликнува на копчето „Најави се“
- 5. Системот ја пребарува базата за корисник со внесената е-пошта
- 6. Внесената лозинка се споредува со хешираната лозинка во базата (BCrypt)
- 7. Доколку податоците се точни, системот генерира JWT и refresh токен
- 8. По успешна најава корисникот се пренасочува кон почетната страна според неговата улога
+'''Други актери:''' -
+
+Посетителот сака да се автентицира со е-пошта и лозинка и да добие пристап до
+функционалностите наменети за неговата улога. Целта е издаден пристапен токен со
+кој сите останати случаи на употреба знаат кој е корисникот и што смее да прави.
+
+=== Сценарио
+
+ 1. Посетителот ја отвора почетната страница и ги внесува е-поштата и лозинката.
+
+ 2. Системот го бара корисникот по е-пошта. Колоната email има ограничување UNIQUE, па барањето враќа најмногу еден ред.
+{{{#!sql
+SELECT id, email, password, role
+FROM project.users
+WHERE email = 'stefan.saveski@students.finki.ukim.mk';
+}}}
+
+ 3. Ако не е пронајден корисник, системот прикажува иста порака како и при погрешна лозинка, за да не се открие кои е-пошти постојат во системот.
+
+ 4. Системот ја споредува внесената лозинка со зачуваниот BCrypt hash. Споредбата се врши во апликацијата, бидејќи во базата се чува само hash-от.
+
+ 5. Ако лозинката е точна, системот издава пристапен токен (JWT) кој ги содржи идентификаторот, е-поштата и улогата на корисникот.
+
+ 6. Ако корисникот побарал да остане најавен, системот запишува и токен за освежување.
+{{{#!sql
+INSERT INTO project.token (user_id, token, expires_at, is_valid)
+VALUES (1, 'BCfXBUR-Q2E7Vkglwh5OmdbhHH0MS-askSO8M0W6sRk', now() + interval '1 month', TRUE);
+}}}
+
+ 7. Системот го пренасочува корисникот според улогата: студентите кон студентскиот дел, професорите кон професорскиот.
+
+ 8. При подоцнежно освежување на сесијата, системот го проверува токенот за освежување.
+{{{#!sql
+SELECT t.id, t.user_id, u.email, u.role
+FROM project.token t
+JOIN project.users u ON u.id = t.user_id
+WHERE t.token = 'BCfXBUR-Q2E7Vkglwh5OmdbhHH0MS-askSO8M0W6sRk'
+  AND t.is_valid = TRUE
+  AND t.expires_at > now();
+}}}
+
+ 9. При одјава, системот го поништува токенот без да го брише, за да остане трага.
+{{{#!sql
+UPDATE project.token
+SET is_valid = FALSE
+WHERE user_id = 1 AND is_valid = TRUE;
+}}}
+
+=== Алтернативни текови
+
+ * '''3а.''' Непостоечка е-пошта или погрешна лозинка - системот прикажува општа порака за неуспешна најава.
+ * '''8а.''' Токенот е истечен или поништен - барањето не враќа ниту еден ред и корисникот мора повторно да се најави.
+
+=== Забелешки
+
+ * Улогата се чува како набројувачки тип user_role со вредности 'student', 'prof' и 'admin', па во базата не може да се внесе непостоечка улога.