View source for Funkcionalni zahtev - Balans5 CBA sistem

{{abstract|txt=Ovaj dokument definiše funkcionalne zahteve za Balans 5 CBA ({{#tip-text: Cluster|Kolekcija baza podataka kojom upravlja jedna instanca pokrenutog PostgreSQL servera.}} Based Authentication) sistem - centralizovani sistem za autentifikaciju i autorizaciju za {{#tip-text: multi-tenant sistem|Multi-tenant sistem je softverska arhitektura gde jedna instanca aplikacije služi višestrukim korisnicima. Podaci svakog korisnika se čuvaju izolovano, što im omogućava da dele resurse uz očuvanje sopstvenih podataka i preferenci.}}.|min=10}}


<!--
__NOTOC__ PRIVREMENO UKUNUT SADRŽAJ. Smeta prilikom editovanja.
-->
= 1. Uvod =

== 1.1 Svrha dokumenta ==

Ovaj dokument definiše funkcionalne zahteve za Balans 5 CBA ({{#tip-text: Cluster|Kolekcija baza podataka kojom upravlja jedna instanca pokrenutog PostgreSQL servera.}} Based Authentication) sistem - centralizovani sistem za autentifikaciju i autorizaciju za {{#tip-text: multi-tenant sistem|Multi-tenant sistem je softverska arhitektura gde jedna instanca aplikacije služi višestrukim korisnicima. Podaci svakog korisnika se čuvaju odvojeno i bezbedno, što im omogućava da dele resurse uz očuvanje privatnosti i opcija prilagođavanja.}}. 

== 1.2 Opseg ==

CBA (Cluster Based Authentication) je centralizovani sistem za autentifikaciju i autorizaciju za multi-tenant {{#tip-text: ERP sistem|Sistem za planiranje resursa u kompaniji. Enterprise Resource Planning (eng.)}} Balans5. <span class="zameniti>Sistem omogućava korisnicima da pristupe više firmi sa jednim setom kredencijala, umesto da imaju odvojen nalog u svakoj firmi.</span><span class="zamena">Sistem omogućava korisnicima sa više firmi da im pristupaju sa jedinstvenim nalogom, umesto da imaju odvojene naloge za svaku zasebnu firmu</span>

== 1.3 Definicije ==

<ul>
<li>
<span class="zamena">'''Cluster''' - Ovde se podrazumeva jedna aktivna instanca PostgreSQL servera koja može sadržati više raznih Balans baza podataka i obavezno sadrži bazu <code>blfpub</code>. U širem smislu u Cluster spadaju i servisi za autentifikaciju i autorizaciju.</span>
</li>
<li>'''CSA''' - Cluster Super Admin (Super Administrator Cluster-a)</li>
<li>'''CGA''' - Cluster Group Admin (Administrator Grupe) </li>
<li>'''USER''' - Redovan korisnik sistema</li>
<li><span class="zameniti">Firma - Pojedinačna kompanija/tenant u sistemu</span></li>
<li><span class="zamena">'''Firma''' - Pojedinačna kompanija (baza podataka) u sistemu</span></li>
<li><span class="zameniti">Grupa - Kolekcija firmi koje pripadaju istom klasteru</span></li>
<li><span class="zamena">'''Grupa''' - Grupa Firmi koje pripadaju istom Cluster-u</span></li>
<li><span class="zamena">'''Tenant''' - Baza podataka unutar Cluster-a sa podacima jedne Firme. Izolovana od baza drugih Firmi.</span></li>
<li><span class="zameniti">Prefix - Prefiks za korisničko ime koji se automatski dodaje na osnovu grupe (npr. bjn.petar_petrovic)</span></li>
<li><span class="zamena">'''Prefiks''' - Prefiks za korisničko ime koji se automatski dodaje na osnovu Grupe (npr. bjn.petar_petrovic)</span></li>
<li>'''Cluster Token''' - <span class="zamena">access</span> {{#tip-text: JWT token|JSON web token (JWT) omogućava bezbedan (kontrolisan) način slanja informacija između klijenta i servera. Uglavnom se koristi u web aplikacijama i API-jima za verifikaciju korisnika i sprečavanje neovlašćenog pristupa. JWT su JSON podaci zaštićeni kriptografskim potpisom.}} [https://datatracker.ietf.org/doc/html/rfc7519 RFC 7519] koji se generiše nakon login-a (24h važnosti)<span class="zamena">; služi za izbor Firme sa kojom će Korisnik raditi</span></li>
<li>'''Firm Token''' - <span class="zamena">access</span> JWT token koji se generiše nakon izbora Firme (8h važnosti)<span class="zamena">; služi za rad sa izabranom Firmom</span></li>
<li>'''Refresh Token''' - Token za obnavljanje oba access tokena (7 dana važnosti)</li>
</ul>

== 1.4 Glavne karakteristike ==

* Jedinstveni nalog za više <span class="fw5">Firmi</span>
* <span class="zameniti>Grupa-baziran pristup</span> <span class="zamena>Pristup baziran na <span class="fw5">Grupama</span></span> (<span class="fw5">Korisnici → Grupe → Firme</span>)
* Centralizovano upravljanje <span class="fw5">Korisnicima</span>
* <span class="zameniti>JWT token-based autentifikacija </span><span class="zamena>Autentifikacija bazirana na JWT tokenima</span>
* <span class="zameniti>Multi-tenant izolacija podataka</span><span class="zamena>Izolacija podataka na nivou <span class="fw5">Tenanta</span></span>


= 2. Pregled sistema =

== 2.1 Arhitektura sistema ==

Sistem se sastoji od tri glavna sloja:<ul class="zameniti">
<li>Autentifikacioni sloj - JWT token-based autentifikacija sa refresh token mehanizmom.</li>
<li>Autorizacioni sloj - Role-based access control (RBAC) sa grupama.</li>
<li>Tenant sloj - Izolacija podataka po firmama.</li>
</ul>

<ul class="zamena">
<li>Autentifikacioni sloj - Autentifikacija, bazirana na JWT tokenima  sa refresh token mehanizmom.</li>
<li>Autorizacioni sloj - Autorizacija autentifikovanih <span class="fw5">Korisnika</span> u skladu sa ulogama koje su im dodeljene unutar njihove <span class="fw5">Grupe</span> ({{#tip-text: RBAC|Kontrola pristupa zasnovana na ulogama (Role-based access control, RBAC) je model za ovlašćivanje krajnjih korisnika za pristup sistemima, aplikacijama i podacima na osnovu unapred definisane uloge korisnika.}}).</li>
<li><span class="fw5">Tenant</span> sloj - Pristup podacima, izolovanim po <span class="fw5">Firmama</span>.</li>
</ul>

== 2.2 Akteri sistema ==


{| class="mst mst-100 zameniti"
|-
! Akter
! Uloga
! Odgovornosti
|-
|| Super Admin
|| CSA
|| Kreiranje grupa, dodela firmi, upravljanje svim korisnicima.
|-
|| Group Admin
|| CGA
|| Upravljanje korisnicima unutar dodeljenih grupa.
|-
|| End User
|| USER
|| Pristup dodeljenim firmama, izvršavanje poslovnih operacija.
|-
|}


{| class="mst mst-100 zamena"
|-
! Akter
! Uloga
! Odgovornosti
|-
|| Super Admin
|| CSA
|| Kreiranje <span class="fw5">Grupa</span>, dodela <span class="fw5">Firmi Grupama</span>, upravljanje svim <span class="fw5">Korisnicima</span>.
|-
|| Group Admin
|| CGA
|| Upravljanje <span class="fw5">Korisnicima</span> unutar dodeljenih <span class="fw5">Grupa</span>.
|-
|| End User
|| Korisnik
|| Pristup dodeljenim <span class="fw5">Firmama</span>, izvršavanje poslovnih operacija.
|-
|}


== 2.3 Token sistem ==

Sistem koristi tri tipa tokena:
* <span class="fw5">Cluster Token</span> (24 sata) - generiše se nakon uspešnog login-a i sadrži listu dostupnih <span class="fw5">Firmi</span>.
* <span class="fw5">Firm Token</span> (8 sati) - generiše se nakon izbora <span class="fw5">Firme</span> i sadrži informacije o <span class="fw5">Firmi</span> i profilu <span class="fw5 zamena">Korisnika</span>.
* <span class="fw5">Refresh Token</span> (7 dana) - koristi se za obnavljanje oba access tokena bez ponovnog login-a.


= 3. Uloge korisnika i dozvole =

== 3.1 Matrica dozvola ==



{| class="mst mst-siva mst-100"
|-
! Funkcija
! CSA
! CGA
! USER
|-
|| Kreiranje <span class="fw5">Grupa</span>
|| ✓
|| -
|| -
|-
|| Dodela <span class="fw5">Firme Grupi</span>
|| ✓
|| -
|| -
|-
|| Kreiranje <span class="fw5">Korisnika</span>
|| ✓
|| ✓*
|| -
|-
|| Pristup podacima <span class="fw5">Firme</span>
|| ✓
|| ✓
|| ✓
|-
|| Upravljanje <span class="fw5">Grupama</span>
|| ✓
|| -
|| -
|-
|| Masovno kreiranje <span class="fw5">Korisnika</span>
|| ✓
|| ✓
|| -
|-
|| CSV import <span class="fw5">Korisnika</span>
|| ✓
|| ✓
|| -
|-
|| Mapiranje <span class="fw5">Korisnika</span> na <span class="fw5">Tenant</span>
|| ✓
|| ✓
|| -
|-
|| Pristup arhivi {{koment|txt=arhiviranim podacima Firme?}}
|| -
|| -
|| ✓**
|-
|}

<nowiki>*</nowiki> <span class="fw5">CGA</span> može kreirati <span class="fw5">Korisničke</span> naloge samo unutar svojih <span class="fw5">Grupa</span>.<br>
<nowiki>**</nowiki> <span class="fw5">Korisnik</span> može pristupiti arhivi samo svojih <span class="fw5">Firmi</span>.

== 3.2 Ograničenja po ulogama ==

* <span class="fw5">CSA</span>: Ima pristup svim <span class="fw5">Grupama, Firmama i Korisnicima</span>.
* <span class="fw5">CGA</span>: Može upravljati samo <span class="fw5">Korisnicima</span> u svojim dodeljenim <span class="fw5">Grupama</span>.
* <span class="fw5">Korisnik</span>: Može pristupiti samo <span class="fw5">Firmama</span> koje su dodeljene njegovim <span class="fw5">Grupama</span>.


= 4. Funkcionalni zahtevi =

== 4.1 Modul autentifikacije ==

{{wPoruka|txt=Imamo 4.1.1 Login Korisnika, imamo 4.1.2 Izbor Firme. Nedostaje scenario za Korisnika koji radi samo sa jednom Firmom (nema šta da bira). On ne vidi stranu /api/auth/select-firm ali dobija Firm Token.<br>
Ko mu vraća Firm Token - /api/auth/login ili /api/auth/select-firm?|naslov=Nedostaje treći slučaj}}

=== 4.1.1 Login Korisnika ===

* REQ-1: Sistem MORA obezbediti login ekran sa poljima za korisničko ime i lozinku.
* REQ-2: Sistem MORA validirati kredencijale koristeći centralnu CBA bazu podataka.{{koment|txt=centralna CBA baza podataka = <code>blfpub</code>?}}
* REQ-3: Sistem MORA zaključati nalog nakon 5 neuspešnih pokušaja login-a {{koment|txt=u kom vremenskom periodu su tih 5 neuspešnih? Ili nema vremenske odrednice već pratimo 5 uzastopnih?}}.
* REQ-4: Sistem MORA generisati <span class="zameniti">cluster_token</span> <span class="zamena fw5">Cluster Token</span> (24h) ili <span class="zameniti">firm_token</span> <span class="zamena fw5">Firm Token</span> (8h) nakon uspešnog login-a.
* REQ-5: Sistem MORA logovati sve uspešne pokušaje login-a (vreme, IP, rezultat).
* REQ-6: Sistem MORA automatski selektovati <span class="fw5">Firmu</span> ako <span class="fw5">Korisnik</span> ima pristup samo jednoj <span class="fw5">Firmi</span>.

<!--
<ul>
<li><span class="zamena">'''REQ-?''' Sistem MORA obezbediti ekran sa interfejsom za izbor <span class="fw5">Firme Korisniku</span> koji ima uloge u raznim <span class="fw5">Firmama</span>.</span></li>
<li><span class="zamena">'''REQ-?''' Sistem MORA generisati <span class="fw5">Firm Token</span> (8h) nakon izbora <span class="fw5">Firme</span> od strane <span class="fw5">Korisnika</span> koji ima uloge u više <span class="fw5">Firmi</span></span></li></ul>
-->

Ulaz:
* <span class="fw5">Korisničko</span> ime (string, obavezno, min 3 karaktera).
* Lozinka (string, obavezno, min 8 karaktera).

Izlaz:
* Uspeh: JWT token + <span class="fw5">Korisnički</span> profil  + dostupne <span class="fw5">Firme</span> (ili automatski izabrana <span class="fw5">Firma</span>).
* Neuspeh: Error kod + poruka.


Poslovna pravila:
* BR-001: Lozinka mora sadržati velika slova, mala slova, broj (specijalni karakteri opciono) {{koment|txt=Šta znači opciono? Ako klijent traži ili nešto drugo?}}.
* BR-002: Neaktivni nalozi ne mogu da se uloguju.
* BR-003: Zaključani nalozi ne mogu da se uloguju dok se ne otključaju.

{{koment|txt=Neko pojašnjenje za aktivne/neaktivne, otključane/zaključane naloge... ili nema potrebe?}}

=== 4.1.2 Izbor firme ===

* REQ-7: Sistem MORA prikazati listu dostupnih <span class="fw5">Firmi</span> nakon login-a (ako <span class="fw5">Korisnik</span> ima pristup u više <span class="fw5">Firmi</span>).
* REQ-8: Sistem MORA automatski selektovati <span class="fw5">Firmu</span> ako <span class="fw5">Korisnik</span> ima pristup samo jednoj.
* REQ-9: Sistem MORA generisati <span class="zameniti>firm_token</span> <span class="zamena fw5>Firm Token</span> (8h validan) nakon izbora <span class="fw5">Firme</span>.
* REQ-10: Sistem MORA <span class="zameniti>učitati firm-specifični profil i dozvole nakon izbora firme</span> <span class="zamena>nakon izbora <span class="fw5">Firme</span> učitati <span class="fw5">Korisnički</span> profil i prava za izabranu <span class="fw5">Firmu</span></span>.

{{koment|txt=prava ili dozvole za permissions?}}

=== 4.1.3 Obnavljanje tokena (Refresh Token) ===

* REQ-11: Sistem MORA obezbediti endpoint za obnavljanje access tokena.
* REQ-12: Sistem MORA <span class="zameniti>rotirati</span> <span class="zamena>generisati novi</span> <span class="fw5">Refresh Token</span> pri svakom <span class="zameniti>refresh-u</span> <span class="zamena>obnavljanju access tokena</span>.
* REQ-13: <span class="fw5">Refresh Token</span> MORA biti važeći 7 dana.
* REQ-14: Sistem MORA validirati <span class="fw5">Refresh Token</span> pre obnavljanja access tokena.

=== 4.1.4 Logout ===

* REQ-15: Sistem MORA obezbediti logout funkcionalnost koja revokuje sesiju. {{koment|txt=opoziva sesiju? anulira sesiju?}}
* REQ-16: Sistem MORA <span class="zameniti>invalidirati</span> <span class="zamena>da poništi</span> <span class="fw5">Refresh Token</span> nakon logout-a.


== 4.2 Modul upravljanja Korisnicima ==


=== 4.2.1 Kreiranje Korisnika ===

* REQ-17: Sistem MORA obezbediti formu sa obaveznim poljima: korisničko ime, email, lozinka, uloga<span class="zamena"> (CSA, CGA, Korisnik)</span>.
* REQ-18: Sistem MORA validirati format email-a i jedinstvenost.
* REQ-19: Sistem MORA automatski dodati <span class="fw5">Prefiks</span> Korisničkom imenu na osnovu <span class="fw5">Grupe</span>.{{koment|txt=šta ako nije u grupi, ako radi samo sa jednom firmom? A inače u 8.2 piše da <code>username_prefix</code> nije obavezno polje}}
* REQ-20: Sistem MORA omogućiti <span class="fw5">CGA</span>-u eksplicitni izbor <span class="fw5">Grupe</span> za <span class="fw5">Prefiks</span> ako se <span class="fw5">Korisnik</span> nalazi u više <span class="fw5">Grupa</span>.
* REQ-21: Sistem MORA automatski koristiti <span class="fw5">Prefiks</span> iz prve <span class="fw5">Grupe</span> ako nije eksplicitno izabran.

Ulaz:
* Korisničko ime (bez prefiksa).
* Email.
* Lozinka (ili generisana privremena).
* Uloga (<span class="fw5">CSA, CGA, Korisnik</span>).
* Lista <span class="fw5">Grupa</span> (groupIds).
* <span class="fw5">Grupa</span> za <span class="fw5">Prefiks</span> (prefixGroupId) - opciono.

{{koment|txt=groupIds i prefixGroupId su neke kolone iz neke tabele iz neke baze ili promenljive iz neke forme? }}

Izlaz:
* Kreiran <span class="fw5">Korisnik</span> sa <span class="fw5">Prefiksom</span> u korisničkom imenu.
* Dodeljene <span class="fw5">Grupe</span>. {{koment|txt=kome, kuda?}}
* Status kreiranja. {{koment|txt=a statusi su?}}

=== 4.2.2 Masovno kreiranje Korisnika ===

* REQ-24: Sistem MORA prihvatiti CSV fajl sa podacima <span class="fw5">Korisnika</span>.
* REQ-25: Sistem MORA validirati sve zapise pre obrade. 
* REQ-26: Sistem MORA kreirati maksimalno 100 <span class="fw5">Korisnika</span> po batch-u. (transakcija application.properties cba.bulk.timeout-seconds=300 / cba.bulk.batch-size=100 ) {{koment|txt=šta je ovo u zagradi i čemu služi?}}
* REQ-27: Sistem MORA generisati izveštaj sa uspehom/neuspehom <span class="zameniti>za svaki zapis</span> <span class="zamena>za svakog <span class="fw5">Korisnika</span> iz CSV fajla</span>.
* REQ-28: Sistem MORA rollback-ovati ceo batch u slučaju kritične greške (<span class="zameniti>all-or-nothing</span> <span class="zamena>sve ili ništa</span>).
** Ako bilo koji korisnik ne prođe validaciju ili procesiranje, cela transakcija se rollback-uje
** Sve greške se prikazuju sa pozicijama <span class="fw5">Korisnika</span>
** Format greške: "Greška na poziciji <span class="zameniti>#X</span> <span class="zamena>br. x</span> (<span class="fw5">Korisnik</span> 'username'): detaljna poruka"
* REQ-29: Sistem MORA omogućiti eksplicitni izbor <span class="fw5">Grupe</span> za <span class="fw5">Prefiks</span> u <span class="zameniti>bulk</span> <span class="zamena>masovnim</span> operacijama. 
* REQ-30: Sistem MORA podržati različite profile po <span class="fw5">Firmama</span> za istog <span class="fw5">Korisnika</span> (profilePerFirm <span class="zamena">- kolona u CSV-u</span>).

{{koment|txt=srpska reč za rollback?}}

CSV Format:
* Email (obavezno).
* Username (obavezno, bez prefiksa).
* GroupId (obavezno).
* ProfilePerFirm (JSON mapa: {"firmId": profileId}).


=== 4.2.3 Upravljanje Korisnicima ===

* REQ-31: Sistem MORA omogućiti pregled svih <span class="fw5">Korisnika</span> (<span class="fw5">CSA</span> vidi sve, <span class="fw5">CGA</span> vidi samo svoje <span class="fw5">Grupe</span>).
* REQ-32: Sistem MORA omogućiti ažuriranje korisničkih podataka.
* REQ-33: Sistem MORA omogućiti otključavanje zaključanih naloga.
* REQ-34: Sistem MORA omogućiti reset lozinke.
* REQ-35: Sistem MORA omogućiti deaktivaciju <span class="fw5">Korisnika</span>.

== 4.3 Modul upravljanja Grupama ==

=== 4.3.1 Kreiranje Grupe ===

<ul>
<li>REQ-36: Sistem MORA omogućiti kreiranje <span class="fw5">Grupe</span> sa nazivom i <span class="fw5">Prefiksom</span> za korisničko ime.</li>
<li>REQ-37: Sistem proverava jedinstvenost <span class="fw5">Prefiksa</span>. Ako <span class="fw5">Prefiks</span> već postoji, sistem vraća grešku i sprečava kreiranje <span class="fw5">Grupe</span>. Na nivou <span class="fw5">Cluster-a</span> postoji {{#tip-text: UNIQUE constraint|PostgreSQL UNIQUE constraint osigurava da su sve vrednosti u određenoj koloni različite u svim redovima tabele, sprečavajući dupliranje unosa. Ovo je korisno za održavanje integriteta podataka, kao što je osiguravanje da su email adrese ili korisnička imena jedinstveni.}} koji garantuje jedinstvenost.</li>
<li>REQ-38: Sistem automatski kreira posebnu <span class="fw5">Grupu</span> sa nazivom "ALL" koja sadrži sve <span class="fw5">Korisnike</span> iz <span class="fw5">Firmi</span> koje su joj dodeljene. Ova <span class="fw5">Grupa</span> se kreira pri inicijalizaciji sistema ili kada se prva <span class="fw5">Firma</span> dodeli ovoj <span class="fw5">Grupi</span>. "ALL" grupa nema <span class="fw5">Prefiks</span> jer se koristi samo za organizaciju <span class="fw5">Korisnika</span>.</li>
<li>REQ-39: Sistem sinhronizuje "ALL" <span class="fw5">Grupu</span> hibridnim pristupom:
<ul>
<li>'''Instant Sync''': Automatski se pokreće kada se <span class="fw5">Firma</span> dodeli "ALL" <span class="fw5">Grupi</span> ili kada se <span class="fw5">Korisnici</span> kreiraju/ažuriraju
<li>'''Scheduled Job''': Izvršava se automatski svakih 6 sati kao backup/cleanup mehanizam 
</ul>
</li>
</ul>
{{koment|txt=Šta se sa čim sinhronizuje? Korisnici iz Firmine baze/Tenanta sa blfpub tabelom ALL kada se ta firma doda nekoj Grupi?}}<br>

Ulaz:
* Naziv <span class="fw5">Grupe</span>.
* <span class="fw5">Prefiks</span> za korisničko ime (2-20 karaktera, <span class="zameniti>lowercase alphanumeric</span> <span class="zamena>alfnumerički sa malim slovima</span>).
* Opis (opciono).

Izlaz:
* Kreirana <span class="fw5">Grupa</span> sa ID-jem.

=== 4.3.2 Dodela firmi Grupi ===

* REQ-40: Sistem MORA omogućiti dodelu <span class="fw5">Firme Grupi</span>.
* REQ-41: Sistem MORA omogućiti uklanjanje <span class="fw5">Firme</span> iz <span class="fw5">Grupe</span>.
* REQ-42: Sistem MORA omogućiti <span class="zameniti>bulk</span> <span class="zamena>masovnu</span> dodelu <span class="fw5">Firmi Grupi</span>.
* REQ-43: Sistem MORA logovati ko je dodelio <span class="fw5">Firmu Grupi</span> i kada.

{{koment|txt=bulk dodela - masovna dodela ili grupna dodela?}}

=== 4.3.3 Dodela Korisnika Grupi ===

<ul>
<li>REQ-44: Sistem MORA omogućiti dodelu <span class="fw5">Korisnika Grupi</span> ({{#tip-text: M:N veza|Relacija mnogo-prema-mnogo (M:N) u SQL-u nastaje kada se više zapisa u jednoj tabeli može odnositi na više zapisa u drugoj tabeli, i obratno.}}).</li>
<li>REQ-45: Sistem MORA omogućiti uklanjanje <span class="fw5">Korisnika</span> iz <span class="fw5">Grupe</span>.</li>
<li>REQ-46: Sistem MORA omogućiti <span class="zameniti>bulk</span> <span class="zamena>masovnu</span> dodelu <span class="fw5">Korisnika Grupama</span>.</li>
<li>REQ-47: Sistem MORA logovati ko je dodelio <span class="fw5">Korisnika Grupi</span> i kada.</li>
</ul>

== 4.4 Modul mapiranja Korisnika ==

=== 4.4.1 Mapiranje na Tenant ===

* REQ-48: Sistem MORA omogućiti mapiranje <span class="fw5">CBA Korisnika</span> na <span class="fw5">Tenant korisnika</span> (korid, profile_id {{koment|txt=- kolone iz koje tabele / kojih tabela?}}). 
* REQ-49: Sistem MORA omogućiti <span class="zameniti>bulk</span> <span class="zamena>masovno</span> mapiranje <span class="fw5">Korisnika</span>.
* REQ-50: Sistem MORA omogućiti automatsko mapiranje na osnovu email-a ili korisničkog imena.
* REQ-51: Sistem MORA prikazati nemapirane <span class="fw5">Korisnike</span>.
* REQ-52: Sistem MORA omogućiti različite profile po <span class="fw5">Firmama</span> za istog <span class="fw5">Korisnika</span>.


= 5. Korisničke priče =

== 5.1 Autentifikacione priče ==

=== US-001: Osnovni Login ===

Kao <span class="fw5">Korisnik</span>, želim da se ulogujem sa jednim <span class="zameniti">setom kredencijala</span><span class="zamena"> nalogom</span>, tako da mogu pristupiti svim dodeljenim <span class="fw5">Firmama</span> bez više lozinki.

<div style="color:#4f81bd;margin-left:1.651cm;margin-right:1.651cm;">'''''Kriterijumi prihvatanja:'''''</div>
* Login stranica prikazuje polja za korisničko ime i lozinku.
* Uspešan login preusmerava na izbor <span class="fw5">Firme</span> (više <span class="fw5">Firmi</span>) ili direktno u <span class="fw5">Firmu</span> (jedna <span class="fw5">Firma</span>).
* Neuspešan login prikazuje specifičnu poruku o grešci.
* Nalog se zaključava nakon 5 neuspešnih pokušaja.{{koment|txt=Uzastopnih ili tokom nekog vremenskog perioda?}}

=== US-002: Automatski izbor Firme ===

Kao <span class="fw5">Korisnik</span> sa pristupom samo jednoj <span class="fw5">Firmi</span>, želim da budem automatski ulogovan u tu <span class="fw5">Firmu</span>, tako da ne moram da prolazim kroz dodatni korak izbora.

=== US-003: Obnavljanje sesije ===

<span class="zameniti">Kao <span class="fw5">Korisnik</span>, želim da moja sesija bude automatski obnovljena bez ponovnog login-a, tako da ne gubim radni tok.</span><br>

{{koment|txt=Kao Korisnik, ja nemam pojma ni šta je sesija ni šta su kredencijali.}}

<span class="zamena">Kao <span class="fw5">Korisnik</span>, želim da tokom rada menjam <span class="fw5">Firme</span> sa kojima radim bez unošenja korisničkog imena i lozinke prilikom svake promene.</span>

== 5.2 Admin priče ==

=== US-004: Masovno kreiranje Korisnika ===

Kao <span class="fw5">CGA</span>, želim da kreiram više <span class="fw5">Korisnika</span> odjednom, tako da mogu <span class="zameniti>efikasno da onboardujem</span> <span class="zamena>brzo da dodajem</span> nove timove.

=== US-005: Izbor Prefiksa za korisničko ime ===

Kao <span class="fw5">CGA</span> sa više <span class="fw5">Grupa</span>, želim da eksplicitno izaberem iz koje <span class="fw5">Grupe</span> želim <span class="fw5">Prefiks</span> za korisničko ime, da imam kontrolu nad generisanim korisničkim imenima.
{{koment|txt=Koja je razlika između "eksplicitno izaberem" i samo "izaberem"?}}

=== US-006: Različiti profili po Firmama ===

Kao <span class="fw5">CGA</span>, želim da dodelim različite profile <span class="fw5">Korisniku</span> u različitim <span class="fw5">Firmama</span>, tako da <span class="fw5">Korisnik</span> ima različite dozvole u različitim <span class="fw5">Firmama</span>.


= 6. Scenariji korišćenja =

== UC-001: Tok login-a {{koment|txt=prijavljivanja?}}==

Primarni akter: <span class="zameniti>End User</span> <span class="zamena>krajnji <span class="fw5">Korisnik</span></span>.

Preduslovi: <span class="fw5">Korisnik</span> ima aktivan nalog.

Postuslovi: <span class="fw5">Korisnik</span> je autentifikovan i ima važeći access token.

Glavni tok:
# <span class="fw5">Korisnik</span> otvara login stranicu i unosi korisničko ime i lozinku.
# Sistem validira kredencijale i status naloga.
# Sistem generiše odgovarajući token (<span class="zameniti>cluster_token ili firm_token</span> <span class="zamena fw5>Cluster Token</span> ili <span class="zamena fw5>Firm Token</span>).
# Sistem vraća token i listu <span class="fw5">Firmi</span> (ili automatski izabranu <span class="fw5">Firmu</span>).

== UC-002: Kreiranje Korisnika sa Prefiks Grupom ==

Primarni akter: <span class="fw5">CGA</span>.

<span class="fw5">CGA</span> unosi podatke, bira jednu ili više <span class="fw5">Grupa</span> i opciono bira <span class="fw5">Grupu</span> za <span class="fw5">Prefiks</span>; sistem dodaje <span class="fw5">Prefiks</span>, kreira <span class="fw5">Korisnika</span> i dodeljuje ga <span class="fw5">Grupama</span>.

== UC-003: CSV import Korisnika ==

<span class="fw5">CGA</span> upload-uje CSV fajl, sistem validira zapise, kreira <span class="fw5">Korisnike</span> u transakciji i generiše izveštaj. U slučaju greške radi se rollback {{koment|txt=povratak u početno stanje?}}


= 7. Poslovna pravila =

== 7.1 Autentifikaciona pravila ==


{| class="mst mst-siva mst-100"
|-
! ID
! Naziv
! Opis
|-
|| BR-001
|| Kompleksnost lozinke
|| Min 8 karaktera, 1 veliko slovo, 1 malo slovo, 1 broj (specijalni karakteri opciono).
|-
|| BR-002
|| Zaključavanje naloga
|| Zaključavanje nakon 5 neuspešnih pokušaja.
|-
|| BR-003
|| Važnost tokena
|| <span class="fw5">Cluster Token</span> 24h, <span class="fw5">Firm Token</span> 8h, <span class="fw5">Refresh Token</span> 7 dana.
|-
|| BR-004
|| Format korisničkog imena
|| {prefix}.{username} (npr. bjn.petar_petrovic).
|-
|| BR-005
|| Prefix logika
|| Ako je prosleđen prefixGroupId koristi se taj <span class="fw5">Prefiks</span>, inače <span class="fw5">Prefiks</span> prve <span class="fw5">Grupe</span> u listi.
|-
|}


== 7.2 Pravila za Grupe ==


{| class="mst mst-siva mst-100"
|-
! ID
! Naziv
! Opis
|-
|| BR-006
|| Jedinstvenost <span class="fw5">Prefiksa</span>
|| Svaka <span class="fw5">Grupa</span> mora imati jedinstveni <span class="fw5">Prefiks</span>.
|-
|| BR-007
|| ALL <span class="fw5">Grupa</span>
|| Sistem automatski kreira ALL <span class="fw5">Grupu</span> koja sadrži sve <span class="fw5">Korisnike</span>.
|-
|| BR-008
|| Sinhronizacija ALL <span class="fw5">Grupe</span>
|| ALL <span class="fw5">Grupa</span> se automatski sinhronizuje hibridnim pristupom: instant sync pri dodeli <span class="fw5">Firme</span>/kreiranju <span class="fw5">Korisnika</span> + scheduled job svakih 6 sati.
|-
|}



== 7.3 Pravila za korisnike ==


{| class="mst mst-siva mst-100"
|-
! ID
! Naziv
! Opis
|-
|| BR-009
|| Ograničenje <span class="fw5">CGA</span>
|| <span class="fw5">CGA</span> može kreirati samo <span class="fw5">Korisničke</span> naloge unutar svojih <span class="fw5">Grupa</span>.
|-
|| BR-010
|| Bulk operacije
|| Maksimalno 100 <span class="fw5">Korisnika</span> po batch-u.
|-
|| BR-011
|| Transakcijski pristup
|| CSV import je all-or-nothing (sve ili ništa).
|-
|| BR-012
|| Različiti profili
|| <span class="fw5">Korisnik</span> može imati različite profile u različitim <span class="fw5">Firmama</span>.
|-
|}


= 8. Zahtevi za podatke =

== 8.1 Podaci o Korisniku ==


{| class="mst mst-siva mst-100"
|-
! Polje
! Tip
! Obavezno
! Validacija
|-
|| acc_id
|| UUID
|| Da
|| Auto-generisan, jedinstven.
|-
|| username
|| VARCHAR(50)
|| Da
|| Jedinstven, format: prefix.name.
|-
|| email
|| VARCHAR(100)
|| Da
|| Validan email format.
|-
|| password_hash
|| VARCHAR(255)
|| Da
|| Bcrypt hash.
|-
|| role_type
|| ENUM
|| Da
|| CSA (2), CGA (1), USER (0).
|-
|| status
|| INTEGER
|| Da
|| 0=active, 1=inactive, 2=locked, 3=suspended.
|-
|| failed_attempts
|| SMALLINT
|| Ne
|| Brojač neuspešnih pokušaja.
|-
|| created_at
|| TIMESTAMP
|| Da
|| Vremenska oznaka kreiranja.
|-
|| created_by
|| UUID
|| Ne
|| ID korisnika koji je kreirao.
|-
|}

{{koment|txt=Ima li smisla (potrebe) dodati TIMESTAMP status_from  -  informacija od kada je Korisnik u sadašnjem statusu?}}<br>
{{koment|txt=Da li se failed_attempts resetuje prilikom uspešnog prijavljivanja/logovanja?}}

== 8.2 Podaci o grupi ==


{| class="mst mst-siva mst-100"
|-
! Polje
! Tip
! Obavezno
! Validacija
|-
|| group_id
|| BIGINT
|| Da
|| Auto-generisan, jedinstven.
|-
|| name
|| VARCHAR(100)
|| Da
|| Jedinstven naziv.
|-
|| username_prefix
|| VARCHAR(20)
|| Ne
|| 2-20 lowercase alphanumeric.
|-
|| active
|| BOOLEAN
|| Da
|| Status aktivnosti.
|-
|| description
|| TEXT
|| Ne
|| Opis grupe.
|-
|}

{{koment|txt=username_prefix nije obavezno polje, ali ranije je pomenuto da se u nekim slučajevima Korisniku automatski dodaje Prefiks Grupe. Kako ako nije obavezno polje?}}


== 8.3 Junction tabele ==
<code>
cba_user_groups</code> (Korisnik ↔ Grupa):
* <code>acc_id</code> (UUID) - Referenca na Korisnika.
* <code>group_id</code> (BIGINT) - Referenca na Grupu.
* <code>assigned_at</code> (TIMESTAMP) - Vreme dodele.
* <code>assigned_by</code> (UUID) - Ko je dodelio.

<code>cba_group_firms</code> (Grupa ↔ Firma):
* <code>group_id</code> (BIGINT) - Referenca na Grupu.
* <code>firid</code> (BIGINT) - Referenca na Firmu.
* <code>assigned_at</code> (TIMESTAMP) - Vreme dodele.
* <code>assigned_by</code> (UUID) - Ko je dodelio.