Instalační dokumentace¶

• Projekt je dostupný na GitLabu - https://gitlab.kiv.zcu.cz/aswi/aswi-2021/aswi2021codebakers

Vývojové prostředí¶

• Pro vývoj byl použito vývojové prostředí InteliJ IDEA Ultimate
• Pro zprovoznění projektu na lokálním zařízení je ještě potřeba instalace npm a ng cli
• Návod na zprovoznění vývojového prostředí zde

Nasazení¶

Pro nasazení webové aplikace se používá Docker. Docker slouží pro spuštění aplikace v izolovaném prostředí. Konfigurace Dockeru se nacházi ve složce Dockerfile. Pro vytvoření nového container a jeho nasazením se zadá následující příkaz:

docker compose up --build --force-recreate

Dockerfile¶

FROM node:15.14.0-alpine3.10 AS angularApp
WORKDIR /usr/src/app
COPY package.json package-lock.json ./
RUN npm install
COPY . .
RUN npm run build

FROM nginx:1.19.6-alpine
COPY nginx.conf /etc/nginx/nginx.conf
COPY --from=angularApp /usr/src/app/dist/SensLog /usr/share/nginx/html

Změna URL¶

Pro změnu cílové IP adresy je potřeba změnit údaje v souboru proxy-config.json a nginx.conf

proxy-config.json¶

{
  "/analytics": {
    "target": "http://51.15.45.95:9090",
    "secure": false
  },
  "/senslog15": {
    "target": "http://51.15.45.95:8080",
    "secure": false
  }
}

nginx.conf¶

location /analytics {
              proxy_set_header X-Forwarded-Host $host;
              proxy_set_header X-Forwarded-Server $host;
              proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
              #proxy_pass http://<ContainerName>:<PortNumber>;
              # In our case Container name is as we setup in docker-compose `beservice` and port 8080
              proxy_pass http://51.15.45.95:9090;
              proxy_max_temp_file_size "1024m";
              proxy_read_timeout       "60s";

              add_header X-Frame-Options SAMEORIGIN always;
    }

    location /senslog15 {
              proxy_set_header X-Forwarded-Host $host;
              proxy_set_header X-Forwarded-Server $host;
              proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
              #proxy_pass http://<ContainerName>:<PortNumber>;
              # In our case Container name is as we setup in docker-compose `beservice` and port 8080
              proxy_pass http://51.15.45.95:8080;
              proxy_max_temp_file_size "1024m";
              proxy_read_timeout       "60s";

              add_header X-Frame-Options SAMEORIGIN always;
    }

Automatické testy¶

Testy se pouští příkazem:

protractor protractor.conf.js ve slozce ./e2e

Po zadání tohoto příkazu jsou spuštěny všechny testy, co jsou definovány v protractor.conf.js pod atributem 'specs' (aktuálně se spouští testy ve složce /e2e/src/**, které se jmenují *.e2e-spec.ts)

Testovací scénaře¶

• Zobrazení přihlašovacího formuláře
• Přihlášení do aplikace
• Zobrazení dashboardu po přihlášení
• Přidaní nového uživatele
• Přidání nové jednotky se senzorem
• Přidání senzoru
• Editace senzoru
• Odstranění senzoru
• Přidání nové pozice pro jednotku
• Editace jednotky
• Odstranění jednotky
• Zobrazení grafu sensoru (graf senzoru se zobrazí, změna časového intervalu, zobrazení agregace a tlačítka pro získání dat)
• Zobrazení grafu jednotky (graf jednotky se zobrazí pro každý typ sensorů, změna časového intervalu, zobrazení agregare a tlačítka pro získání dat)