@golemio/pid 6.0.1-dev.2901184022 → 6.0.1-dev.2912471131

package/docs/architecture/diagrams/context.mmd

@@ -0,0 +1,114 @@
+---
+title: PID Polohy – kontextový diagram (zdroje → Golemio → odběratelé)
+config:
+  htmlLabels: false
+  flowchart:
+    curve: basis
+    wrappingWidth: 400
+    nodeSpacing: 35
+    rankSpacing: 60
+---
+flowchart LR
+    %% Legenda: plná šipka = zdroj data posílá (push), přerušovaná = Golemio si data stahuje (pull)
+
+    subgraph vehicles["Vozidla PID"]
+        direction TB
+        busOther["Autobusy mimo DPP,<br/>přívozy"]
+        train@{ img: "../../assets/logos/ceske-drahy.svg", label: "Vlaky (ČD a další dopravci)", pos: "b", h: 24, constraint: "on" }
+        busArriva@{ img: "../../assets/logos/arriva.svg", label: "Autobusy Arriva City a Arriva City Neratovice", pos: "b", h: 30, constraint: "on" }
+        tramDpp["Tramvaje DPP"]
+        busDpp["Autobusy a trolejbusy DPP"]
+        metroDpp["Metro DPP"]
+    end
+
+    subgraph operatorServers["Palubní a dispečerské systémy"]
+        direction TB
+        mikro@{ img: "../../assets/logos/mikroelektronika.png", label: "Server Mikroelektronika", pos: "b", h: 36, constraint: "on" }
+        telmaxOther@{ img: "../../assets/logos/telmax.png", label: "Servery Telmax (vč. Arriva City)", pos: "b", h: 36, constraint: "on" }
+        otherServers["… další servery dopravců"]
+        cdt@{ img: "../../assets/logos/cd-telematika.png", label: "Server ČD Telematika", pos: "b", h: 36, constraint: "on" }
+        doris@{ img: "../../assets/logos/dpp.svg", label: "Dispečink DPP – DORIS (tramvaje)", pos: "b", h: 36, constraint: "on" }
+        audis@{ img: "../../assets/logos/dpp.svg", label: "Dispečink DPP – AUDIS (autobusy)", pos: "b", h: 36, constraint: "on" }
+        metroData@{ img: "../../assets/logos/dpp.svg", label: "Data z linek metra", pos: "b", h: 36, constraint: "on" }
+    end
+
+    mpvnet@{ img: "../../assets/logos/chaps.png", label: "MPVnet (ROPID, dodavatel CHAPS) a jeho proxy", pos: "b", h: 36, constraint: "on" }
+
+    subgraph staticSources["Statická a doplňková data"]
+        direction TB
+        ropidFtps@{ img: "../../assets/logos/ropid.svg", label: "ROPID FTPS: GTFS, CIS, OIS, oběhy", pos: "b", h: 36, constraint: "on" }
+        vymi["VYMI (JIS): události a infotexty"]
+        tabulator["Tabulátor: presety odjezdových tabulí"]
+        staticFiles["Statická data: kolejové obvody metra,<br/>ukazatele směru, neveřejná vozidla"]
+        seznamAutobusu["Seznam autobusů: popis vozidel"]
+        loki@{ img: "../../assets/logos/grafana-loki.png", label: "Grafana Loki: požadavky na presety tabulí", pos: "b", h: 36, constraint: "on" }
+    end
+
+    golemio@{ img: "../../assets/logos/golemio.svg", label: "Datová platforma Golemio (OICT) – modul pid", pos: "b", h: 60, constraint: "on" }
+
+    subgraph consumers["Odběratelé"]
+        direction TB
+        stopPanels["Odjezdové tabule na zastávkách"]
+        vehiclePanels["Přestupní a informační panely ve vozidlech"]
+        mapaPid@{ img: "../../assets/logos/pid.svg", label: "Mapa PID", pos: "b", h: 36, constraint: "on" }
+        litacka@{ img: "../../assets/logos/pid-litacka.svg", label: "PID Lítačka (/v2/public, GTFS-RT)", pos: "b", h: 36, constraint: "on" }
+        googleMaps@{ img: "../../assets/logos/google-maps.svg", label: "Google Maps", pos: "b", h: 24, constraint: "on" }
+        pubtran@{ img: "../../assets/logos/seznam.svg", label: "Jízdní řády Seznam.cz (dříve PubTran)", pos: "b", h: 24, constraint: "on" }
+        citymove@{ img: "../../assets/logos/citymove.png", label: "Škoda Citymove", pos: "b", h: 24, constraint: "on" }
+        catchApp@{ img: "../../assets/logos/catch.png", label: "Catch", pos: "b", h: 30, constraint: "on" }
+        ropidMonitoring@{ img: "../../assets/logos/ropid.svg", label: "Dohledové centrum ROPID (DCIP)", pos: "b", h: 36, constraint: "on" }
+        eventWebhooks["Odběratelé událostí JIS (webhook)"]
+    end
+
+    busOther --> mikro & telmaxOther & otherServers
+    train --> cdt
+    busArriva --> telmaxOther
+    tramDpp --> doris
+    busDpp --> audis
+    metroDpp --> metroData
+
+    mikro -- "XML MPV" --> mpvnet
+    telmaxOther -- "XML MPV" --> mpvnet
+    otherServers -- "XML MPV" --> mpvnet
+    cdt -- "XML" --> mpvnet
+    doris -- "TCP XML" --> golemio
+    audis -- "TCP XML" --> golemio
+    metroData -- "UDP XML" --> mpvnet
+
+    mpvnet -- "HTTP XML (autobusy mimo DPP vč. Arriva City, vlaky, přívozy)" --> golemio
+    mpvnet -- "TCP XML (metro)" --> golemio
+    golemio -- "přeposílání TCP toků DPP" --> mpvnet
+
+    ropidFtps -. "FTPS" .-> golemio
+    vymi -- "HTTP JSON (push)" --> golemio
+    vymi -. "HTTP JSON (pull)" .-> golemio
+    tabulator -- "HTTP JSON (push presetů)" --> golemio
+    golemio -. "GTFS zastávky (pull)" .-> tabulator
+    golemio -. "GTFS linky, zastávky, presety (pull)" .-> vymi
+    staticFiles -. "HTTP CSV/JSON" .-> golemio
+    seznamAutobusu -. "HTTP JSON" .-> golemio
+    loki -. "HTTP JSON" .-> golemio
+
+    golemio -. "HTTP JSON/XML (URL proxy)" .-> stopPanels
+    golemio -. "HTTP JSON" .-> vehiclePanels
+    golemio -. "HTTP JSON" .-> mapaPid
+    golemio -. "HTTP JSON, GTFS-RT" .-> litacka
+    golemio -. "GTFS-RT" .-> googleMaps
+    golemio -. "GTFS-RT" .-> pubtran
+    golemio -. "GTFS-RT" .-> citymove
+    golemio -. "GTFS-RT" .-> catchApp
+    golemio -- "logy odjezdových tabulí (push)" --> ropidMonitoring
+    golemio -- "HTTP JSON (webhook)" --> eventWebhooks
+
+    classDef external fill:#fdecea,stroke:#c0392b,color:#1f2328
+    classDef intermediary fill:#fff4e0,stroke:#d68910,color:#1f2328
+    classDef golemio fill:#e3eefc,stroke:#1d4ed8,color:#1f2328
+    classDef consumer fill:#e6f6ea,stroke:#15803d,color:#1f2328
+    class busOther,train,busArriva,tramDpp,busDpp,metroDpp,mikro,telmaxOther,otherServers,cdt,doris,audis,metroData,vymi,tabulator,staticFiles,seznamAutobusu,ropidFtps,loki external
+    class mpvnet intermediary
+    class golemio golemio
+    class stopPanels,vehiclePanels,mapaPid,litacka,googleMaps,pubtran,citymove,catchApp,ropidMonitoring,eventWebhooks consumer
+    style vehicles fill:#fafafa,stroke:#9ca3af
+    style operatorServers fill:#fafafa,stroke:#9ca3af
+    style staticSources fill:#fafafa,stroke:#9ca3af
+    style consumers fill:#fafafa,stroke:#9ca3af