Architektura

Architektura

MetacheckAPI je serverová část aplikace Metacheck. Poskytuje REST rozhraní pro klientskou aplikaci, spravuje zpracování dávek, čte a zapisuje metadata a komunikuje s externí službou Metakat.

Přehled komponent

flowchart LR
    Client[Klientská aplikace] -->|HTTP REST /rest/v1| API[MetacheckAPI WAR]
    Admin[Správce] -->|Swagger UI /swagger| API
    API -->|JNDI jdbc/proarc| DB[(PostgreSQL / ProArc DB)]
    API -->|HTTP API| Metakat[Metakat API]
    API -->|čtení a zápis| BatchFS[Dávkové soubory]
    API -->|čtení| Config[METACHECK_HOME / metacheck.cfg]

Loading

Tok zpracování dávky

sequenceDiagram
    participant U as Uživatel
    participant A as MetacheckAPI
    participant M as Metakat
    participant D as Databáze
    participant F as Souborový systém

    U->>A: POST /rest/v1/batch
    A->>D: založení záznamu dávky
    A->>F: kontrola vstupní složky
    A->>M: založení Metakat jobu
    A->>M: periodické dotazování na stav
    M-->>A: výsledek zpracování
    A->>F: načtení metakat.json a souvisejících souborů
    A->>D: uložení stavu dávky
    U->>A: GET/POST metadata objektů

Loading

Hlavní odpovědnosti

Komponenta	Odpovědnost
Klientská aplikace	Uživatelské rozhraní pro kontrolu a editaci metadat.
MetacheckAPI	REST API, orchestrace dávek, čtení konfigurace, komunikace s databází a Metakatem.
PostgreSQL / ProArc DB	Perzistence záznamů dávek, objektů, stavů a vazeb na ProArc.
Metakat API	Automatizované zpracování a generování metadat.
Souborový systém	Importní složky, obrazová data, ALTO XML, OCR texty a soubory metakat.json.
METACHECK_HOME	Externí konfigurace nezávislá na nasazeném WAR balíčku.

Důležité rozhraní

Rozhraní	Účel
/rest/v1/application	Ověření běhu aplikace a základní informace.
/rest/v1/batch	Správa dávek.
/rest/v1/object	Práce s objekty dávky.
/rest/v1/object/metadata	Čtení a zápis metadat objektu.
/swagger/	Interaktivní dokumentace API.

Provozní hranice

WAR balíček by měl být považován za neměnný artefakt aplikace. Prostředí, hesla, API klíče, cesty k datům a klientská konfigurace patří mimo WAR do Tomcatu, databáze a adresáře METACHECK_HOME.