Zusammenspiel
Kurz zusammengefasst, wie ein Commit am Ende zu einer echten TemperaturĂ€nderung im GebĂ€ude fĂŒhrt:
- Commit auf GitHub löst die Jenkins-Pipeline aus.
- Jenkins lĂ€dt den Code, baut ein Docker-Image (inklusive QualitĂ€ts-Checks â Lint, Typecheck, Tests) und deployt den Container auf dem Server.
- Das laufende Programm holt sich periodisch die Buchungen aus ChurchTools ĂŒber einen technischen Nutzer.
- FĂŒr jede relevante Buchung wird der beste Heizzeitplan berechnet (siehe Heizungslogik fĂŒr die fachliche ErklĂ€rung).
- Bei Bedarf wird eine Anfrage an HomematicIP geschickt, um die Zieltemperatur zu setzen.
- ZusĂ€tzlich hĂ€lt das System eine WebSocket-Verbindung zu HomematicIP, ĂŒber die es laufend Updates zu Gruppen, GerĂ€ten und Wetter erhĂ€lt.
- Alle Daten â sowohl aus der Berechnung als auch aus dem WebSocket â werden dauerhaft in InfluxDB gespeichert.
- 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"]
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.