online-library-management-system

[](/online-library-management-system/translations/README.en.html) [](/online-library-management-system/translations/README.ita.html)

Online biblioteka | Veb aplikacija & API | Laravel 9

Šta je “Online biblioteka”?

Online biblioteka predstavlja projekat ICT Cortex akademije namijenjen učenicima srednjih škola kako bi se što bolje i efikasnije spremili za sve buduće izazove koje ih čekaju. Više informacija ispod…

Naša platforma se može pohvaliti širokim spektrom najsavremenijih funkcija, a sve su dizajnirane da revolucionišu proces upravljanja bibliotekom i podignu korisničko iskustvo na sledeći nivo.

Uz naš sistem, uživaćete u fleksibilnosti dodjeljivanja uloga i dozvola, obezbjeđujući optimalnu bezbjednost i kontrolu pristupa. Naša funkcija pretraživanja punog teksta omogućava brzo i lako otkrivanje sadržaja, dok naša API integracija pojednostavljuje upravljanje podacima.

Pored toga, naš sistem nudi neuporedive mogućnosti obrade slika, uključujući isjecanje, kompresovanje i kropovanje, što olakšava upravljanje slikama. Za lak pristup i pogodnost korisnika, nudimo besprekornu integraciju GitHub prijave i registracije, a uvoz podataka je brz zahvaljujući našoj funkciji uvoza CSV-a.

Ostanite povezani i držite svoje korisnike u toku pomoću naše funkcije biltena i osigurajte optimalnu sigurnost uz našu najsavremeniju reCAPTCHA integraciju. Sa našim inovativnim višejezičnim sistemom upravljanja školskim bibliotekama, mogućnosti su beskrajne!

dahboard-page book crop

Obavezno

PHP >= v.8.0
Composer >= v.2.4
Predlažemo da posjetite Laravel-ov oficijalni vebsajt

GD - php ekstenzija za manipulaciju fotografija

S obzirom da su korišćeni paketi za dinamično manipulisanje priloženih fotografija moguće je da se pojavi greška ukoliko Vam fajl “php.ini” nije ispravno konfigurisan. Ovaj fajl po default-u onemogućava određene ekstenzije, a time i pakete (dependencies) koje smo koristili u projektu. Sve što je potrebno jeste:
-> Da otvorite Vaš “php.ini” fajl kao tekstualni dokument (koristeći Notepad ili neki drugi slični softver)
-> Pronađite liniju ;extension=gd i izmijenite je u extension=gd
-> Restartujte Vaš apache server

Ukoliko ne znate da pronađete “php.ini” fajl.. najčešći path je C:\php. Možete ukucati i komandu: php --ini u command promt-u kako biste dobili još informacija

Moguća greška:

-> “Unsupported cipher or incorrect key length. Supported ciphers are…”
U pitanju je loše izgenerisani APP_KEY tj. enkripcioni ključ aplikacije. Otvorite “.env” fajl koji se nalazi u root-u projekta. Izbrišite upisanu vrijednost i pokrenite komandu:

php artisan key:generate

-> “SQLSTATE[HY000] [2002] No connection could be made because the target machine actively refused it”
Moguće je da niste startovali Vaš lokalni server. U zavisnosti koji softver koristite kao serverski paket pokrenite ga kao i Apache server i pokušajte ponovo. Poznati softveri: WAMP, XAMPP, ampps i tako dalje.

Moguća greška:

-> “Could not find driver (SQL: SHOW FULL TABLES WHERE table_type = ‘BASE TABLE’)..”
Poruka o grešci “Nije moguće pronaći drajver“ obično ukazuje na to da PHP ekstenzija za drajver baze podataka koju koristite nije instalirana ili omogućena na Vašem sistemu. Otvorite datoteku “php.ini” u uređivaču teksta i potražite red koji počinje sa ekstenzijom=. Dekomentarišite red tako što ćete ukloniti tačku i zarez (;) na početku reda i zamijenite imenom PHP ekstenzije koju ste instalirali u koraku 2.

extension=mysql

Instalacija

Klonirajte ovaj repozitorijum sledećom komandom:

git clone https://github.com/ca-tim4-22/library.git

Uđite u root folder ukoliko već niste u njemu
Instalirajte/apdejtujte composer pakete
```
composer install | composer update
```
Kopirajte .env.example fajl u .env fajl i konfigurišite varijable u skladu sa vašim okruženjem (environment).
To možete uraditi sledećom komandom:
```
cp .env.example .env
```
S obzirom da ova aplikacija koristi Algoliu za pretraživanje moraćete pitati administratora za ključeve sledećih varijabli:
```
SCOUT_DRIVER | SCOUT_QUEUE | ALGOLIA_APP_ID | ALGOLIA_SECRET
```
Takođe, s obzirom da ova aplikacija koristi Laravel Socialite za registraciju/logovanje pomoću third party aplikacija/platformi poput Google-a, GitHub-a i sl. moraćete pitati administratora za ključeve sledećih varijabli:
```
GITHUB_CLIENT_ID | GITHUB_CLIENT_SECRET | GITHUB_REDIRECT_URL
```
Ukoliko želite da integrišete newsletter možete definisati svoje vrijednosti za navedene varijable:
```
MAILCHIMP_APIKEY | MAILCHIMP_LIST_ID
```
Koristimo newsletter mail servis: Mailchimp
Ukoliko želite da posjetite Vašu lokalnu bazu podataka na brz, efikasan i moderan način to možete veoma lako izvršiti pomoću adminera kojeg smo integrisali zajedno uz aplikaciju. Adminer UI možete posjetiti odlaskom na:
```
/adminer
```
Koristimo temu: Hydra Dark
Generišite enkripcioni ključ:
```
php artisan key:generate
```
Izvršite migracije
```
php artisan migrate 
```
Ukoliko Vam je baza podataka već ispunjena
```
php artisan migrate:fresh
```
Za testne potrebe, možete iskoristiti Laravel-ov već ugrađeni (built-in) server komandom:
```
php artisan serve
```

Nakon izvršenja svih gore navedenih komandi, trebalo bi da možete pokrenuti aplikaciju i vidjeti je na http::/localhost Vašeg domena u zavisnosti od konfiguracije.

Napomena 1.1: Ukoliko želite da pišete/izvršavate već postojeće testove budite sigurni da ste izmijenili env varijablu: APP_ENV=local -> APP_ENV=testing

Napomena 1.2: Ukoliko želite da napravite backup Vaše baze podataka, to možete uraditi pomoću integrisanog paketa komandom:
php artisan backup:run

Organizacija projekta

Cijeli progres se prati na sledećim platformama za project management:

Trello

monday.com

Asana
Svi board-ovi su sinhronizovani.

za link-ove kontaktirati administratora

Kredencijali

Možete se ulogovati sledećim kredencijalima:
- Email adresa: admin@gmail.com
- Lozinka: nekalozinka
Projektni Workflow
- Prilikom startovanja aplikacije prikazaće Vam se “welcome” stranica sa dodatnim informacijama
- Kada se ulogujete, bićete redirektovani ka “dashboard” stranici gdje možete vidjeti više stvari poput najnovijih aktivnosti (isti dan), najnovije rezervacije knjige, statistiku knjiga i slično
- Na ovoj stranici možete otići na druge stranice koristeći meni sa strane (sidebar), ući u svoj profil, odjaviti se i tako dalje
- Kliknite na sliku u gornjem desnom ćošku kako biste ušli u Vaš profil ili se odjavili
- Svaki korisnik može da izbriše svoj nalog, uz prethodno potvrđeni (dialog box) nakon čega ga aplikacija redirektuje na posebnu stranicu “good-bye”
Dostupne su tri role:
administrator, bibliotekar i učenik

Role

Administrator/ka

Administrator ima pristup svemu na aplikaciji

Bibliotekar/ka

Mogućnost kreiranja, izmjene i brisanja:
učenika / učenice
knjige
autora / autorke
kategorija, žanrova, izdavača, poveza, formata, pisama
Dostupne radnje - operacije:
Da izda primjerak knjige
Da otpiše primjerak knjige
Da vrati primjerak knjige
Da rezerviše primjerak knjige

Učenik/ca

Dostupne radnje - operacije:
Da rezerviše primjerak knjige i to samo jednu u jednom momentu
Ukoliko učenik/ca ima:
aktivnu rezervaciju ili rezervaciju na čekanju, ne može poslati zahtjev za rezervaciju knjige
ukoliko ima odbijenu ili isteklu rezervaciju, može poslati zahtjev za rezervaciju knjige

Tabelarni prikaz:

Funckionalnost	Administrator/ka	Bibliotekar/ka	Učenik/ca
Gašenje aplikacije	✔️	❌	❌
Aktivacija aplikacije	✔️	❌	❌
Upravljanje bazom - CSV	✔️	❌	❌
Izmjena meta informacija	✔️	❌	❌
Izmjena globalnih varijabli	✔️	❌	❌
CRUD nad administratorima	✔️	❌	❌
CRUD nad bibliotekarima	✔️	✔️	❌
CRUD nad učenicima	✔️	✔️	❌
CRUD nad knjigama	✔️	✔️	❌
CRUD nad autorima	✔️	✔️	❌
CRUD nad podešavanjima	✔️	✔️	❌
Izmjena svog profila	✔️	✔️	✔️
Prikaz dostupnih knjiga	✔️	✔️	✔️
Izdate knjige	✔️	✔️	❌
Vraćene knjige	✔️	✔️	❌
Knjige u prekoračenju	✔️	✔️	❌
Aktivne rezervacije knjiga	✔️	✔️	✔️
Arhivirane rezervacije knjiga	✔️	✔️	✔️
Rezervacija knjige	✔️	✔️	✔️

Napomena:

Ukoliko rezervaciju izvrši bibliotekar/ka, ona odmah dobija status “Prihvaćena”, a ukoliko je izvrši učenik/ca dobija status “Na čekanju” sve dok je bibliotekar/ka ne prihvati

Vraćanje knjige

Radnja - operacija vraćanja knjige je dostupna samo ukoliko je knjiga izdata

Otpisivanje knjige

Radnja - operacija otpisivanja knjige je dostupna samo ukoliko je knjiga u prekoračenju

Rezervacije - statusi

Rezervacije imaju 5 statusa:

Prihvaćena

Odbijena

Na čekanju

Arhivirana

Istekla

Session - flash poruke - statusi

Info
Uspješno
Bezuspješno

Zaštita

Middleware zaštita na svim rutama (web i api)
CSRF token - protekcija
Korišćene polise
Hash-ovanje lozinki - bcrypt
Zaštita na tri nivoa.. po rolama -> administrator/ka, bibliotekar/ka i učenik/ca
Honeypot
XSS zaštita

Cron jobs

Postoje 3 “zadatka”:

Prvi zadatak koji se izvršava na dnevnom nivou i koji aktivne istekle rezervacije automatski arhivira

Drugi zadatak koji se izvršava na mjesečnom nivou i koji automatski briše korisnike koji se nisu ulogovali duže od 365 dana

Treći zadatak se izvršava dvaput dnevno i automatski mijenja status biblioteke u radnom smislu. Kada je biblioteka zatvorena status je ‘0’, a kada je otvorena ‘1’. Sa definisanim radnim vremenom, početak i kraj u satima, ovaj zadatak se izvršava u tim terminima i mijenja status

Shutdown mode

Administrator može “poslati” aplikaciju u tzv. “shutdown” mode. Laravel u sebi ima ugrađenu komandu “php artisan down” koja “gasi” aplikaciju. Na našoj aplikaciji to radimo pomoću web rute “/shutdown” koja je zaštićena.

Koraci:

Kada želite ugasiti aplikaciju -> Otići na URL “/shutdown” ! napomena: morate biti ulogovani i biti “administrator”

Kada želite upaliti aplikaciju -> Otići na URL “/live.php” nakon čega će vam se pojaviti “redirect” stranica