##########################
##########################
>>> Installation Guide <<<
##########################
##########################

#############################
### AR Mobile Application ###
#############################

1. Unity Account machen und runterladen (gibt ne Version für Studenten):
https://store.unity.com/academic/unity-student

2. Unity starten und im Unity Hub auf "Add" klicken und da den folder
"stolpersteine-ar-app" auswählen, den du nach dem clonen des Git repos haben solltest.

3. Mal schauen, ob wenn du das Projekt startest, irgendwelche
Fehlermeldungen kommen. So warnungen für outdated MapBox scripts in der
Konsole sind normal, die hatte ich auch immer.
Ggf. kann es passieren dass MapBox einen Access Token verlangt, dieser sollte
aber normalerweise vorhanden sein.

4. Um die App auf nen Handy zu bringen, mit USB verbinden. Bei Android
die Developer Options aktivieren und USB debugging anmachen
(https://www.isunshare.com/android/how-to-enable-usb-debugging-on-android.html).
Bzw.: Tablet vom Lehrstuhl verwenden, das sollte USB Debugging bereits aktiviert haben.

###############
### Backend ###
###############

1. Python installieren, falls noch nicht vorhanden (Version 3.8 funktioniert auf jeden Fall)

2. Siehe README für Installations- und Verwendungshinweise

3. Dann kannst du auf http://127.0.0.1:8000/ die Website anschauen. Siehe unten für Login 
credentials. Unter localhost:8000/admin können weitere User hinzugefügt werden und existierende
verwaltet werden. Account mit Adminzugriff (superuser) ist dafür notwendig.

4. Falls du den Server für andere Geräte aus deinem Heimnetz zugänglich
machen willst, kannst du ihn mit 'python manage.py runserver
<ip_addr>:8000' starten, mit der ip adresse von dem gerät auf dem er
gestartet wird.

Außerdem musst du erst noch diese IP adresse in die List der
"ALLOWED_HOSTS" in "settings.py" einfügen. Meine Firewall
hatte zusätzlich den Zugriff von außen auf den Port geblockt, weshalb
ich den freigeben musste mit 'sudo ufw allow 8000', aber das ist bei dir
vermutlich anders, wenn du auf Windows arbeitest.

Virtual Environments erlauben dir alle libraries, die du für ein projekt
benötigst, zusammenzufassen. Dann gibts keine Konflikte, wenn du z.b. in
nem anderen Projekt eine andere Version der gleichen Library benutzt.

Aber wenn du sonst eigentlich eh nicht viel mit Python machst, brauchst
du das auch nicht zwingend und kannst die module einfach global
installieren. Dann fällt der schritt mit virtual environment
installieren und aktivieren einfach weg und du machst einfach 'pip
install -r requirements.txt' in dem entsprechenden folder.

########################################
### Frontend (Stolpersteine Manager) ###
########################################

tl;dr: Die Anweisungen für das Setup hier befolgen: https://angular.io/guide/setup-local

1. nodejs installieren 

2. npm package manager installieren 

3. Angular CLI installieren mit: "npm install -g @angular/cli"

4. in das geklonte git Projekt(Ordner: stolpersteine-ar-manager) gehen 
und dort in der Kommandozeile am Besten beim ersten Mal: "npm install" ausführen

5. Nachdem alle packages installiert wurden kann die App lokal mit "ng serve" gestartet werden
und unter "localhost:4200" angesehen werden. Für weitere Infos siehe auch die README des Projekts 
bzw. die offizielle Dokumentation von Angular unter https://angular.io/

(6. Zum Lernen des Angular Frameworks empfiehlt es sich die "Tour of Heroes" Tutorial Applikation
zu implementieren, zu finden unter "Tutorials" auf der Angular Webseite. Dabei lernt man die wichtigsten 
Konzepte von Angular innerhalb eines Nachmittags.)

### Credentials für Dev (lokale Anwendung) und Production Umgebung ###

# Production Umgebung Stolpersteine Manager/Backend:

User: chevron PW: djangotroll (superuser)
User: editor  PW: stolpersteine-editor1 (global_editor)

# Dev Umgebung Stolpersteine Manager/Backend: 
User: chevron PW: djangotroll (superuser)

# AR App read access:
User: app_access PW: XzjhKxLeC7Uu5xa 
(Token 04c696a540743ac5e7242e57368a707cb7585c1e)