| 
				
					
						 | 
			||
|---|---|---|
| serwer | ||
| .gitignore | ||
| Licence.md | ||
| macOs-i-Linux.sh | ||
| readme.md | ||
| windows.cmd | ||
		
			
				
				readme.md
			
		
		
			
			
		
	
	Domyślne dane dostępowe:
Login: szef 
Hasło: szef 
Domyślnie działa na ADRESIP:8880
Jeżeli chcesz korzystać za darmo, w stopka musi pozostać niezmieniona, a także widoczna na każdej stronie z wyjątkiem stron druku list
WOŚP APP by KRY008
Pomocnik dla sztabu przy rozliczeniach wolontariuszy
Wymagania
- Minimum 8 GB RAM (aplikacja zużywa sama w sobie mało, ale ze względu na obecne systemy i dockera, aby chodziło wszystko płynnie)
 - Docker desktop (wybrać Docker Personal na stronie https://www.docker.com/products/docker-desktop i założyć darmowe konto)
 - Instalując na Windows zaznaczyć opcję "Use the WSL 2 instead of Hyper-V" w oknie instalatora.
 
Sprzęt na którym został program sprawdzony
| Model | System operacyjny | RAM | Procesor | Działa? | 
|---|---|---|---|---|
| Raspberry Pi 4B | Ubuntu 20.04 | 4 GB | 4x 1.5 GHz | Tak | 
| Raspberry Pi 02w* | RaspberryPi OS Lite | 0.5 GB | 4x 1.2 GHz | Tak | 
| MacBook M1 | MacOS | 16 GB | 8x 3.2 GHz | Tak | 
| Laptop z 2015 DELL | Windows 10 | 8 GB | i7-7Uth 2x 2.0 GHz | Tak | 
| Laptop z 2015 DELL | Ubuntu 24.04 | 8 GB | i7-7Uth 2x 2.0 GHz | Tak | 
- najtańsza możliwa wersja dedykowana dla programu
 
Instalacja
- Zainstalować Docker desktop zgodnie z Wymaganiami
 - Pobrać kod z https://git.kry008.xyz/kry008/WOSP-APP/releases lub https://github.com/kry008/WOSP-APP/releases
 - Utworzyć folder i wypakować pliki do niego
 - Wejść w folder 
serwer(z rozpakowanej paczki) - Skopiować plik 
example.envi nazwać go.env - Uzupełnić pola 
MYSQL_ROOT_PASSWORDorazMYSQL_PASSWORDw pliku.env - Skopiować plik 
example.prod.envi nazwać goprod.env - Zmienić oznaczone linie na własne dane
 - Uruchomić skrypt odpowiednio dla systemu operacyjnego:
- Windows: 
windows.cmd - MacOS lub Linux: 
macOs-i-Linux.sh 
 - Windows: 
 
Jak znaleźć adres IP
- Linux i MacOS: skrypt na końcu pokaże adres IP wraz z adresem url aby dostać się do aplikacji z sieci lokalnej
 - Windows:
- Wejść w ustawienia systemu
 - Wejść w sieć i internet
 - Na górze kliknąć właściwości
 - Przewinąć w dół i znaleźć adres IPv4
 - Adres do łącznia się z aplikacją to 
http://ADRESIP:8880 
 
Znane problemy Windows
- Zamykająca się od razu konsola Jeżeli skryp od razu zamyka się, trzeba uruchomić powershell (menu start i zacząć wpisywać powershell) jako administrator i wpisać komendę:
 
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
- Inne urządzenia w sieci lokalnej nie mogą się połączyć W takim przypadku trzeba wyłączyć lub zezwolić innym urządzeniom na łączenie się przez zaporę systemową na Windowsie lub w systemia antywirusowym. Przykładowo Eset:
 
- Otwórz program ESET Security
 - Kliknij na Narzędzia
 - Inspekcja sieci
 - Jeżeli wyjdzie niezaufana sieć zmienić na "Zmień na typ sieci zaufaną"
 - Kliknąć na urządzenie, które ma być zaufane
 - W regułach kliknąć "Zezwól/Odblokuj" przy "Docker for Windows" lub "WSL"
 
Podoba się program?
Wesprzyj mnie na Patronite lub Ko-fi
Postanowienia licencyjne
https://git.kry008.xyz/kry008/WOSP-APP/src/branch/main/Licence.md