Dette prosjektet er laget i samarbeid med HVL og masterlinjen Anvendt datateknologi og ingeniørvitenskap, og er en del av faget ADA502 Cloud Computing and Software Systems.
Prosjektet går ut på å videreutvikle et tidligere prosjekt angående brannfarestatus i Norge, oppgaven vår er å lage en "Cloud service" for eventuelle brukere hvor vi kan sende en verdi for brannfare til brukeren.
Grunnet den korte tiden vi hadde til prosjektet er ikke produktet ferdigstilt enda, men under vil det bli forklart hvordan du kan teste den nåværende Webapplikasjonen.
For å kjøre prosjektet vil jeg anbefale følgende verktøy:
-
Beekeeper (eller annen database GUI) https://www.beekeeperstudio.io/
-
Docker desktop https://www.docker.com/products/docker-desktop/
-
VSCode (Eller annen IDE) https://code.visualstudio.com/
For å klone dette repositoriet, kjør følgende kommando i terminalen:
git clone https://github.com/ADA502-gruppe8/ADA502-kode.git
Dette laster ned hele prosjektet, og gjør deg klar!
Det burde nå være en struktur som følger med mappene:
- src
- tests
Resten av filene
Er det en mappe med navn "data", så må den slettes. Hvis den ikke er der, så hopp over denne linjen.
Det må opprettes en .env fil, som ligger i den ytterste mappen "ADA502-Kode" .env filen må opprettes, og innholde disse feltene
Du må fylle ut linje 2 og 3 med din Postgres konto.
DATABASE_HOST='localhost'
DATABASE_USERNAME=''
DATABASE_PASSWORD=''
DATABASE_PORT='5555'
DATABASE_LOGIN='login'
DATABASE_FIRERISK='firerisk'
SECRET_KEY ="jeppepåberget"
Secret_key er ikke i bruk, så den er ikke viktig nå. Dette er for å slippe en feilmelding.
.env filen skal ligge yterst i mappen slik:
For å kjøre prosjektet, skriv følgende i terminal
docker compose build
docker compose up
Dette starter docker container, som inneholder 2 sub conteinere
- En for web app, og en for database
Det vil dukke opp en folder "data", som vil være databasen, og lagd i prosjektet
Etter å kjørt docker compose build/up, burde man finne dette inne i docker desktop
Du kan bruke uansett hvilket sql verktøy, men vi viser i beekeeper studio
"New connection" i venstre hjørnet
velg "Postgres" som connection type
Deretter bruker du:
Host = localhost
port = 5555
User = "navn fra .env fil"
Password = "passord fra .env fil"
Default Database = "login" eller "firerisk"
Dette vil gi de 2 bildene under.
Anbefaler å gi de navn, og lagre forbindelsene til neste gang
Du ser forskjellen i siste linje mellom login og firerisk i bildene under.
Webappen kjører og du skal finne den på "localhost:5000"
Når du kjører appen så kommer den med "Uvicorn running on http://0.0.0.0:5000" , men du må bruke (http://localhost:5556/)
Der vil du komme til ulike interface
Den vil kunne kjøre mellom de ulik nettsidene.
For å logge inn må feltet være != 0 i logginn
Ved opprettelse vil det komme i databasen, og lage en bruker & gå videre til neste
Location vil kunne gi deg mulighet til å skrive inn en lokasjon, eller bruke gps. Begge disse vil gi deg resultatsiden, som ikke viser noe data enda.
Dette fordi vi ikke har gjort ferdig denne delen av logikken.
Du kan alltid slette brukeren, men slettes ikke nå i databasen.
Håper alt fungerte!