Knjigomat

Projekt Knjigomat omogoča izposojo knjig na knjigomatih, ki se nahajajo na večih lokacijah po mestu Maribor. Uporabnikom je omogočeno naročevanje knjig na knjigomat, ki jim je najbližji ali kar direktna izposoja knjig, ki so na voljo v knjigomatu - okoli 50 knjig. Za prevzem ima vsak uporabnik svojo QR kodo na telefonu in vsak knjigomat ima bralnik QR kod. Knjige (tudi iz knjižnice) lahko uporabnik vrne na knjigomat. Na vsaki napravi beležimo katere knjige so najbolj izposojene in s tem žanrom nato avtomat napolnimo.

Kazalo

• Kaj omogoča
• Tehnološki sklad
• Nastavitev virtualnega stroja
• Priprava razvojnega okolja knjižnice
• Priprava okolja knjigomat
• Avtorji
• Napake in težave
• Licence

Kaj omogoča

Knjižnica omogoča:

- dodajanje, iskanje, brisanje, urejanje, naročanje in pregled vseh knjig;
- dodajanje, brisanje, upravljanje uporabnikov in spreminjanje njihovih pravic;
- pošiljanje potrditev naročil uporabniku na mail, ki vključuje QR za dostop do naročila na knjigomatu.

Knjigomat omogoča:

- pregled vseh knjig na voljo v knjigomatu;
- vračanje knjig v knjigomat s QR kodo, ki je unikatna za vsako knjigo (vrnemo lahko tudi knjige sposojene v knjižnici);
- prevzem naročenih knjig na izbranem knjigomatu;
- prijava uporabnika z uporabo QR kode;

Tehnološki sklad

Grajeno z:

• PHP - UI knjigomat, UI uporabnik
• Bootstrap - UI knjigomata na mobilni napravi, tablićnem računalniku in vključen pri PHP
• JSF - vnos, brisanje, urejanje knjig in uporabnikov v knjižnici
• JQuery - Vključeno pri JSF
• HTML - Vključeno pri knjigomatu
• JavaScript - vključeno pri knjigomatu
• CSS - Vključeno pri knjigomatu
• Java - Hranjenje podatkov v ozadju
• MySQL - Podatkovna baza
• Wildfly - Strežnik za JPA - hranjenje podatkov in slik (uporabljeno pri razvoju!)
• WAMP - Strežnik za UI knjigomata (uporabljeno pri razvoju!)

Arhitektura:

Nastavitev Virtualnega stroja in uporaba brez njega

Ne glede na naš način uporabe je potrebno slediti vsem naslednjim navodilom glede nastavitve strežnikov in razvojnih okolj!

Prenos paketa virtualnega stroja dostopno na: https://drive.google.com/file/d/12ucvdLA_tGxi0pue3N29grWOugGdah4G/view?usp=sharing

---

Nastavitev strežnika Wildfly:

Vodnik za nastavitve

---

Dodajanje uporabnika v Wildfly:

Vodilo za dodajanje uporabnika

ali

1. Poiščemo Bin direktorij v datoteki strežnika WIldfly
2. Zaženemo skripto za dodajanje uporabnika: Linux./add-user.sh
                                             Windowsadd-user.bat
3. Dodamo uporabnika z uporabniškim imenom in geslom z željenimi pravicami

---

Deployment projekta:

Vodilo za deployment projekta

ali

1. Nastavljen in zagnan strežnik WIldfly
2. V privzetem brskalniku odpremo lokacijo Localhost:8080 (priveta lokacija za Wildfly ali tisto na katero smo spremenili)
3. Odpremo administrativno konzolo
4. Pod Deployments projekt
5. Zaženemo "bin/standalone.bat"
6. Projekt je dostopen na: ip/projekt/faces (ip preverimo s cmd > ipconfig)

---

Dostop:

VM

Geslo: Passw0rd!

Wildfly

Uporabnik: user
Geslo: user

---

Priprava razvojnega okolja knjižnice

1. Razvijalno okolje Eclipse ali IntelliJ s strežnikom Wildfly(JBOSS)
2. V razvojnem okolju Datoteka > Uvozi > GIT > URI "https://github.com/zigalepi/Praktikum.git" > Kloniraj
3. V Eclipsu uporaba git bash terminala:
   a) Nastavitve > Orodja > Terminal
   b) Shell Path, navedemo pot do bash.exe datoteke, ki jo najdemo v */Git/bin/bash.exe 4.Uporabimo lahko tudi "Ekipa" a) Desni klik na projekt > Ekipa > Git
4. Konfiguriranje strežnika Wildfly: a) Prenos paketa strežnika Wildfly
   b) V razvijalnem okolju odpremo zavihek Strežniki > Novo > Izberemo prenešeno datoteko in poimenujemo strežnik > Dodaj projekt > Zaženi c) Uporabnika dodamo v AddUser.bat datoteki strežnika Wildfly
5. Lokalna podatkovna baza v MySQL, v Persistence.xml poimenovana PraktikumDS
6. Aplikacija je dostopna na Localhost:8080
7. Za posodobitev sprememb ponovno zaženemo kot aplikacijo na strežniku

Priprava okolja knjigomat

1. Razvijalno okolje ATOM z XAMPP / WAMP strežniško rešitvijo
2. V razavijalnem okolju New project > Desni klik na ustvarjen projekt > GIT > URI "https://github.com/GasperReher/Klient_php.git" > Kloniraj / Pull
3. Knjigomat dostopen na: https://github.com/zigalepi/knjigomat_masina
4. Klient dostopen na: https://github.com/GasperReher/Klient_php.git

Napake in težave

Zasledite napako ali težavo v pri delovanju? Prijavite napako ali težavo na našem GitHub projektu.

Avtorji

Žiga Sušin	Gašper Reher	Toni Haramija I.	Bard Grujič
https://github.com/zigalepi	https://github.com/GasperReher	https://github.com/Tonskii	https://github.com/GrujicBard
Šefe	Glavni razvijalec	RN - PR - razvijalec	Bard

Licence

MIT licenca