Ein Haus als System
Heizung, Lüftung, Energie, Anzeige und Internetzeiten in einem privaten Haus: vollständig lokal, mit Logik auf den Geräten und reproduzierbarem Betrieb. An diesem überschaubaren System zeige ich, wie ich alle Ebenen zusammen entwerfe.
Ausgangslage
Ein Haus wird über Jahrzehnte genutzt. Fertige Smart-Home-Systeme verlagern Entscheidungen gern in eine Cloud. Fällt das Internet aus, endet der Hersteller-Support oder ändert sich das Geschäftsmodell, steht das Haus still.
Ich wollte ein System, das ohne Cloud und ohne Hersteller-Konto auskommt, das alle Bewohner bedienen können und das ich auch in einem Jahr noch verstehe und ändern kann. Das ist, im Kleinen, dieselbe Aufgabe wie bei einem Fachsystem im Unternehmen: Es soll im Alltag laufen, auch wenn etwas ausfällt, und es soll beherrschbar bleiben.
Das System in vier Schichten
Das System besteht aus vier Schichten. Jede hat eine klare Aufgabe und eine ebenso klare Liste von Dingen, die sie nicht tun darf.
| Schicht | Bausteine | Aufgabe | Darf nicht |
|---|---|---|---|
| Feld | Shelly-Skripte, Sensoren, Stromzähler, ESP32-Display | Unmittelbar schalten, messen, sicher ausfallen | Auf zentrale Dienste oder das Internet warten |
| Transport | Mosquitto auf dem Raspberry Pi | Nachrichten verteilen, letzte Werte vorhalten | Fachlogik interpretieren |
| Anwendung | Sechs Go-Dienste auf dem Raspberry Pi | Automatisieren, darstellen, übersetzen | Die Aufgaben anderer Dienste übernehmen |
| Beobachtung | Prometheus auf dem Homeserver | Zeitreihen sammeln | Steuern |
Der Zweck dieser Trennung ist einfach: Eine Störung in einer oberen Schicht darf die unteren nicht lahmlegen. Stürzt das Dashboard ab, heizt die Heizung weiter. Ist der Broker weg, funktioniert der Lüftungstaster weiter. Fällt Prometheus aus, fehlt nur die Historie.
Der Weg einer Bedienung
Am besten sieht man das Zusammenspiel an einem Beispiel: Jemand stellt im Dashboard einen Heizkreis auf „Auto“.
Drei Dinge sind daran typisch und kommen im ganzen System wieder vor:
- Die console entscheidet nicht über die Wirkung. Sie veröffentlicht nur einen Sollwert. Ob das Ventil öffnet, entscheidet der Shelly, abhängig von Temperatur, lokalem Schalter und Saison.
- Die Antwort an den Browser bestätigt die Annahme, nicht die Wirkung. Den tatsächlichen Zustand sieht der Browser erst mit dem nächsten Zustandswert.
- Der Sollwert bleibt im Broker gespeichert. Startet der Shelly neu, bekommt er ihn sofort wieder.
Fünf Entscheidungen, die den Rest bestimmen
Im Entwicklerhandbuch ist jede wichtige Entscheidung mit Kontext, Alternativen und Konsequenzen festgehalten. Fünf davon prägen das System am stärksten.
E-01 Vollständig lokaler Betrieb
Keine Grundfunktion darf ein Cloud-Konto, einen externen Dienst oder das Internet voraussetzen. Der Wetterdienst ist eine optionale, rein lesende Datenquelle.Verworfen: Ein fertiges System mit Cloud-Anbindung wäre schneller eingerichtet, macht das Haus aber von fremden Betriebsentscheidungen abhängig. Home Assistant wäre lokal, bringt aber eine große, generische Plattform mit, deren Verhalten sich bei Updates ändert und deren Konfiguration schwer versionierbar ist.
Preis: Jede Funktion wird selbst gebaut, getestet und betrieben.
E-02 MQTT als einziger Bus
Alle Komponenten sprechen zur Laufzeit nur über den Broker miteinander. Jeder Dienst kann einzeln neu starten, ohne andere zu stören.Verworfen: Direkte HTTP-Schnittstellen zwischen den Diensten oder eine gemeinsame Datenbank. Beides hätte die Dienste aneinander gekoppelt: Fällt der aufgerufene Dienst aus, scheitert der Aufrufer.
Preis: Es gibt keine synchronen Antworten. Die Wirkung eines Befehls zeigt sich als neuer Zustand.
E-06 Genau ein Erzeuger je Zustand
Jeder Zustandswert gehört genau einem Erzeuger. Die Herkunft eines Wertes lässt sich aus Pfad und Konfiguration ablesen, und die Zugriffsrechte am Broker sichern das technisch ab.Verworfen: „Wer zuletzt schreibt, gewinnt“ wäre einfacher zu konfigurieren, macht Fehler aber unsichtbar.
Preis: Jede Ausnahme muss ausdrücklich deklariert werden.
E-08 Steuerung auf dem Gerät, Ableitung im Zentrum
Schutz-, Bedien- und Regelungslogik läuft auf den Geräten. Die Zentrale liefert nur Sollwerte und abgeleitete Werte. Bei einem Ausfall der Zentrale funktionieren Taster, Feuchteautomatik, Heizungs-Override und Ventilschutz weiter.Verworfen: Alle Logik zentral zu halten wäre einfacher zu ändern und zu testen. Dann hinge aber jeder Tastendruck an Broker, WLAN und Raspberry Pi.
Preis: Die Logik liegt in zwei Sprachen (Go und Shelly-JavaScript), und Änderungen an den Skripten müssen auf die Geräte ausgerollt werden.
E-35 Architekturregeln als Test
Regeln, die nur im Dokument stehen, werden irgendwann gebrochen, meist aus Bequemlichkeit mit einem Import. Deshalb sind sie ein gewöhnlicher Test, der bei jeder Prüfung läuft: Dienste importieren einander nicht, die Plattform kennt keinen Dienst, jedes Programm nutzt dieselbe Kommandozeilen-Grundlage.Verworfen: Externe Werkzeuge wären mächtiger, aber eine weitere Abhängigkeit mit eigener Konfigurationssprache.
Preis: Neue Regeln muss ich selbst als Go-Code formulieren.
Betrieb
Betrieb ist hier kein Nachtrag, sondern Teil des Entwurfs.
- Ein Ablauf für alles. Ein Ansible-Playbook rollt Broker, Dienste und die Skripte auf allen Feldgeräten aus. Über Schlagwörter lässt sich gezielt nur ein Teil ausrollen. Jede Ausrollung ist wiederholbar und zeigt, was sich geändert hat.
- Der Pi als Appliance. Ein minimales Buildroot-Linux ohne Paketmanager. Die Go-Programme sind statisch gebaut und brauchen nichts außer dem Kernel.
- Strenge Konfiguration. Konfiguration besteht aus streng geprüften Dateien. Jeder Dienst kann sie vor dem Start validieren, und das Ausrollen validiert vor jedem Neustart.
- Wiederanlauf ohne Handarbeit. Der Broker hält alle Sollwerte. Nach einem Neustart findet jedes Gerät seinen letzten Sollwert wieder, und veraltete Messwerte werden nicht als aktuell behandelt.
- Beobachten, ohne einzugreifen. Prometheus sammelt Zeitreihen, kann aber nichts steuern. Das Dashboard zeigt bei jedem Messwert die Empfangszeit und markiert veraltete Werte.
- Diagnose von außen nach innen. Das Handbuch enthält Entscheidungsbäume vom Symptom („Heizung reagiert nicht“) zur Prüfung.
- Vorbereitet für KI-Werkzeuge. Das Repository enthält Architekturregeln, Prüfbefehle und ein Handbuch, das Entscheidungen erklärt. Regelbrüche fallen sofort als Testfehler auf. So kann KI Code vorschlagen, ohne dass die Architektur unbemerkt verbogen wird.
Was ich daraus für Unternehmen mitnehme
Ein Haus ist kein Unternehmen, aber die Entwurfsfragen sind dieselben. Die folgende Tabelle ist eine Übersetzung, kein Kundenergebnis.
| Im Haus | Im Unternehmen |
|---|---|
| Logik auf den Geräten, Zentrale liefert nur Sollwerte | Ein Fachprozess läuft weiter, wenn das Zentralsystem steht |
| MQTT als einziger Bus | Eine Integrationsschicht statt vieler Punkt-zu-Punkt-Verbindungen |
| Genau ein Erzeuger je Zustand | Klare Datenhoheit: ein führendes System je Stammdatum |
| Inventar und Konfiguration im Repository | Konfiguration als Code, Änderungen nachvollziehbar |
| Ein Ansible-Playbook für alles | Reproduzierbares Ausrollen, auch nach einem Totalausfall |
| Prometheus getrennt von der Steuerung | Überwachung ohne Eingriffsmöglichkeit, Historie getrennt vom Betrieb |
| Architekturregeln als Test | Qualitätsregeln, die automatisch prüfen statt in Dokumenten zu stehen |