Zusammenspiel

Kurz zusammengefasst, wie ein Commit am Ende zu einer echten TemperaturĂ€nderung im GebĂ€ude fĂŒhrt:

  1. Commit auf GitHub löst die Jenkins-Pipeline aus.
  2. Jenkins lĂ€dt den Code, baut ein Docker-Image (inklusive QualitĂ€ts-Checks — Lint, Typecheck, Tests) und deployt den Container auf dem Server.
  3. Das laufende Programm holt sich periodisch die Buchungen aus ChurchTools ĂŒber einen technischen Nutzer.
  4. FĂŒr jede relevante Buchung wird der beste Heizzeitplan berechnet (siehe Heizungslogik fĂŒr die fachliche ErklĂ€rung).
  5. Bei Bedarf wird eine Anfrage an HomematicIP geschickt, um die Zieltemperatur zu setzen.
  6. ZusĂ€tzlich hĂ€lt das System eine WebSocket-Verbindung zu HomematicIP, ĂŒber die es laufend Updates zu Gruppen, GerĂ€ten und Wetter erhĂ€lt.
  7. Alle Daten — sowohl aus der Berechnung als auch aus dem WebSocket — werden dauerhaft in InfluxDB gespeichert.
  8. Grafana greift auf InfluxDB zu und stellt die Daten als Graphen dar (siehe Grafana-Dashboards).
flowchart TD A["GitHub Commit"] --> B["Jenkins Pipeline
Build + Quality Gates"] B --> C["Docker-Deployment
auf dem Server"] C --> D["Cron: ChurchTools-
Buchungen lesen"] D --> E["Heizplan berechnen"] E --> F["HomematicIP:
Temperatur setzen"] C --> G["WebSocket: HomematicIP-Updates
Gruppe / GerÀt / Wetter"] F --> H["InfluxDB"] G --> H H --> I["Grafana"]

FĂŒr die genaue Modul-Architektur (welche Datei was macht) siehe das englische docs/architecture.md im Repository.