lmkr / ada502-2024-group8

ADA502 - Cloud - firerisk

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.

Pre-requisites

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/

Cloning the Repository

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!

Struktur

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.

.env fil

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:

Kjøring

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

Docker

Etter å kjørt docker compose build/up, burde man finne dette inne i docker desktop

Beekeeper

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.

Webapp

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!