Instalace

Požadavky

• Node.js kompatibilní s Angular 21
• npm 11 nebo kompatibilní verze
• dostupné MetacheckAPI
• web server pro statické soubory, např. Apache nebo Nginx

Instalace závislostí

V kořeni projektu spusťte:

npm install

Projekt používá package-lock.json, proto je pro reprodukovatelný build vhodné použít v CI nebo release procesu:

npm ci

Produkční build

Produkci sestavíte příkazem:

npm run build

Výstup vznikne v adresáři:

dist/metacheckclient/

Obsah výstupního adresáře nahrajte do adresáře, na který je nasměrovaný web server.

Lokální spuštění

Vývojový server spustíte:

npm run start

Angular CLI spustí aplikaci lokálně. Pro komunikaci s reálným backendem musí být dostupná API base URL nastavená v aplikaci nebo musí být provoz vyřešen proxy pravidlem na web serveru.

Nasazení na web server

MetaCheckClient je single page aplikace. Web server musí vracet index.html pro všechny routy, které neodpovídají existujícímu souboru.

Apache

V adresáři s aplikací lze použít .htaccess:

RewriteEngine On

RewriteCond %{REQUEST_FILENAME} -s [OR]
RewriteCond %{REQUEST_FILENAME} -l [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^(.+)$ - [S=1]

RewriteRule ^(.+)$ /index.html

Pokud je MetacheckAPI vystavené pod /api, doplňte proxy:

<IfModule mod_proxy.c>
    ProxyPass /api http://127.0.0.1:8080/metacheck
    ProxyPassReverse /api http://127.0.0.1:8080/metacheck
</IfModule>

Nginx

Příklad konfigurace:

server {
  listen 80;
  server_name metacheck.example.org;

  root /var/www/metacheck-client;
  index index.html;

  location / {
    try_files $uri $uri/ /index.html;
  }

  location /api/ {
    proxy_pass http://127.0.0.1:8080/metacheck/;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  }
}

Ověření instalace

Po nasazení ověřte:

1. otevření hlavní aplikace,
2. načtení seznamu dávek,
3. otevření detailu editovatelné dávky,
4. zobrazení obrazového náhledu objektu,
5. uložení změny metadat,
6. dostupnost endpointu pro ALTO XML a obrazová data.

Testy

Testy spustíte příkazem:

npm run test

Build před releasem ověřte příkazem:

npm run build