Funkcionalni zahtev - Balans5 CBA sistem - Revision history

Prusac at 10:57, 5 December 2025

2025-12-05T10:57:38Z

← Older revision		Revision as of 10:57, 5 December 2025
Line 23:		Line 23:
	<li>'''CSA''' - Cluster Super Admin (Super Administrator Cluster-a)</li>		<li>'''CSA''' - Cluster Super Admin (Super Administrator Cluster-a)</li>
	<li>'''CGA''' - Cluster Group Admin (Administrator Grupe) </li>		<li>'''CGA''' - Cluster Group Admin (Administrator Grupe) </li>
	<li~~><span class="zameniti>USER - Redovan korisnik sistema</span></li>~~		<li>'''USER''' - Redovan korisnik sistema</li>
	~~<li><span class="zamena"~~>'''~~Korisnik~~''' - Redovan korisnik sistema~~</span>~~</li>
	<li><span class="zameniti">Firma - Pojedinačna kompanija/tenant u sistemu</span></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="zamena">'''Firma''' - Pojedinačna kompanija (baza podataka) u sistemu</span></li>

Prusac at 09:52, 2 December 2025

2025-12-02T09:52:53Z

← Older revision		Revision as of 09:52, 2 December 2025
Line 1:		Line 1:
	{{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}}		{{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.		__NOTOC__ PRIVREMENO UKUNUT SADRŽAJ. Smeta prilikom editovanja.

Prusac at 09:52, 2 December 2025

2025-12-02T09:52:26Z

← Older revision		Revision as of 09:52, 2 December 2025
Line 1:		Line 1:
	{{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}}		{{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.		__NOTOC__ PRIVREMENO UKUNUT SADRŽAJ. Smeta prilikom editovanja.
			-->
	= 1. Uvod =		= 1. Uvod =

Prusac at 09:46, 2 December 2025

2025-12-02T09:46:47Z

← Older revision		Revision as of 09:46, 2 December 2025
Line 173:		Line 173:
	\|}		\|}

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

Prusac at 09:45, 2 December 2025

2025-12-02T09:45:34Z

← Older revision		Revision as of 09:45, 2 December 2025
Line 108:		Line 108:

	Sistem koristi tri tipa tokena:		Sistem koristi tri tipa tokena:
	* Cluster Token (24 sata) - generiše se nakon uspešnog login-a i sadrži listu dostupnih <span class="fw5">Firmi</span>.		* <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>.
	* Firm Token (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">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>.
	* Refresh Token (7 dana) - koristi se za obnavljanje oba access tokena bez ponovnog login-a.		* <span class="fw5">Refresh Token</span> (7 dana) - koristi se za obnavljanje oba access tokena bez ponovnog login-a.

Prusac at 09:42, 2 December 2025

2025-12-02T09:42:32Z

← Older revision		Revision as of 09:42, 2 December 2025
Line 186:		Line 186:

	== 4.1 Modul autentifikacije ==		== 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 ===		=== 4.1.1 Login Korisnika ===
Line 196:		Line 199:
	* 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>.		* 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>		<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 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>		<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:		Ulaz:
Line 205:		Line 210:

	Izlaz:		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>). ~~{{koment\|txt=Profil i dostupne firme/firma su custom fields u tokenima? Da li token sadrži profil i Firme?}}~~		* 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.		* Neuspeh: Error kod + poruka.

Line 231:		Line 236:
	* REQ-13: <span class="fw5">Refresh Token</span> MORA biti važeći 7 dana.		* 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.		* REQ-14: Sistem MORA validirati <span class="fw5">Refresh Token</span> pre obnavljanja access tokena.

	{{koment\|txt=REQ-12: ako sistem rotira/menja Refresh Token pri svakom osvežavanju access tokena da li to znači da Refresh Token tom prilikom dobija novih 7 dana validnosti? Username i password će koristiti samo oni koji više od 7 dana nisu ulazili u Balans?}}

	=== 4.1.4 Logout ===		=== 4.1.4 Logout ===
Line 327:		Line 330:
	* REQ-42: Sistem MORA omogućiti <span class="zameniti>bulk</span> <span class="zamena>masovnu</span> dodelu <span class="fw5">Firmi Grupi</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.		* 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 ===		=== 4.3.3 Dodela Korisnika Grupi ===
Line 414:		Line 419:
	== UC-003: CSV import Korisnika ==		== 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?}}.		<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?}}

Prusac at 09:21, 2 December 2025

2025-12-02T09:21:30Z

← Older revision		Revision as of 09:21, 2 December 2025
Line 197:		Line 197:

	<ul>		<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 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>		<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:		Ulaz:

Prusac at 09:18, 2 December 2025

2025-12-02T09:18:22Z

← Older revision		Revision as of 09:18, 2 December 2025
Line 110:		Line 110:
	* Cluster Token (24 sata) - generiše se nakon uspešnog login-a i sadrži listu dostupnih <span class="fw5">Firmi</span>.		* Cluster Token (24 sata) - generiše se nakon uspešnog login-a i sadrži listu dostupnih <span class="fw5">Firmi</span>.
	* Firm Token (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>.		* Firm Token (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>.
	* Refresh Token (7 dana) - koristi se za obnavljanje access tokena bez ponovnog login-a.		* Refresh Token (7 dana) - koristi se za obnavljanje oba access tokena bez ponovnog login-a.
	~~{{koment\|txt=Pitanje: i Cluster Token i Firm Token su access tokeni. Nama Refresh Token radi update oba?}}~~

	= 3. Uloge korisnika i dozvole =		= 3. Uloge korisnika i dozvole =

Prusac at 09:16, 2 December 2025

2025-12-02T09:16:04Z

← Older revision		Revision as of 09:16, 2 December 2025
Line 32:		Line 32:
	<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>'''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>'''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 access tokena (7 dana važnosti)</li>		<li>'''Refresh Token''' - Token za obnavljanje oba access tokena (7 dana važnosti)</li>
	</ul>		</ul>

Prusac at 15:52, 1 December 2025

2025-12-01T15:52:29Z

← Older revision		Revision as of 15:52, 1 December 2025
Line 563:		Line 563:
	\|}		\|}

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

Line 603:		Line 603:
	\|}		\|}

	{{koment\|txt=username_prefix nije obavezno polje, ali ~~gore~~ je pomenuto da se u nekim slučajevima Korisniku automatski dodaje Prefiks Grupe. Kako ako nije obavezno polje?}}		{{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?}}