Architecture

Architecture.md

Architecture

Mermaid sequence diagram architektury

sequenceDiagram
    participant ExtApp as External App
    participant Manager as Manager REST API
    participant Worker as Worker
    participant JVM as External JVM (Plugin)

    ExtApp->>Manager: schedule(process, payload)
    Worker->>Manager: getNextScheduledProcess()
    Manager-->>Worker: process + payload
    Worker->>JVM: start PluginStarter with payload
    JVM-->>Worker: execution result
    Worker->>Manager: update process state (RUNNING, FINISHED, FAILED...)

Loading

Manager

• Tomcat REST aplikace s Swagger dokumentací

• Registry:

  • pcp_node – registrované Workery
  • pcp_plugin – registrované pluginy
  • pcp_profile – profily pluginů

• Scheduling:

  • externí aplikace volají schedule → proces PLANNED
  • Worker si proces vyzvedne → NOT_RUNNING
  • Worker spouští JVM → RUNNING → reportuje stav → FINISHED/FAILED/KILLED

• Batch / subprocesy:

  • Plugin může sám schedulovat další procesy (getScheduledProfiles())
  • Manager preferuje batch affinity

• REST endpointy pro informace z tabulek, download logů, delete/kill procesů

• Dashboard UI

Databázové tabulky

Manager používá několik hlavních tabulek v databázi:

Tabulka	Popis
pcp_node	Registrované Workery a jejich metadata
pcp_plugin	Registrované pluginy
pcp_profile	Profily pluginů, včetně JVM parametrů a payload definic
pcp_process	Naplánované a běžící procesy, jejich stav, batch_id, payload a logy

Worker a pluginy

• Worker = framework + pluginy – Worker je aplikační framework, který poskytuje běhové prostředí:

  • Polling smyčka, REST API, logování
  • PluginStarter a PluginContext pro spuštění pluginů v separátním JVM

• Plugin – konkrétní úloha, kterou Worker dokáže spustit (např. import, index)

• Profil – konfigurace spuštění pluginu, obsahuje:

  • payload, JVM parametry
  • subprocesy, které plugin sám spouští (např. Import spouští Index)

• Worker načte profile.json každého pluginu při startu a registruje schopnosti u Managera

• Polling workflow:

  • Worker se dotazuje Managera na naplánované procesy (getNextScheduledProcess)
  • Spustí externí JVM pro daný plugin
  • Reportuje stav procesu zpět do Managera

Odkazy: Home, Plugin Build & Worker Build