Engineering · Medien vom Mond

Arbeitsprobe

HomeSupervisor

Betriebshandbuch, Werkzeugkasten und Evidenzschicht für einen selbst betriebenen Server

Kurzprofil

Worum es geht

Ein selbst betriebener Server ist ein Dauertest für Dokumentation: Sie veraltet schneller, als man sie liest. HomeSupervisor beantwortet das mit einer Regel – es gibt genau eine Datei mit Live-Zahlen – und mit Werkzeugen, die Widersprüche finden, statt sie zu verwalten.

Python / pytestPowerShellBashMarkdown als Single Source of TruthGit-SubmoduleDomain-CLI (domctl)Headless-Chrome-Prüfung
Reifegrad
produktiv betrieben
Veröffentlichung
beschrieben · Repo privat
Letzte Aktivität
2026-11-17
Repository
homesupervisor

Beleglage in Kurzform

  • Eine verbindliche Status-Quelle statt widersprüchlicher Einzeldokumente
  • Lesendes Audit-Werkzeug: Quellen, Befunde, Widersprüche, Coverage-Lücken
  • Domain-Betrieb: 12 Ziele geprüft, alle mit HTTP 200, keine Befunde
  • Link-Audit: 334 interne Verweise geprüft, 0 Fehlschläge
  • Barrierefreiheits-Prüfungen: Reflow bei 320 px, Textvergrößerung 150 %, Zoom 200 %

Architektur

Die Grundidee: eine Wahrheit, viele Ableitungen

  • Eine Status-Quelle für Live-Zahlen; alle anderen Dokumente leiten daraus ab.
  • Topologie getrennt von Betriebstiefe und von Entscheidungen.
  • Lesendes Audit: Quellen, Befunde, Widersprüche und Coverage-Lücken in einem Bericht.
  • Werkzeuge statt Prosa, wo Prüfungen wiederholbar sein müssen.

Die Regel „im kleinsten zuständigen Repository arbeiten“ verhindert, dass Änderungen an drei Stellen gleichzeitig passieren und am Ende keine davon stimmt.

Webbetrieb

Domain-Betrieb als Ingenieursaufgabe

Zwölf Domains, ein Prüfwerkzeug, ein reproduzierbarer Befund – ohne Klicken durch Oberflächen.

Für jede Domain existiert eine Soll-Beschreibung mit Inhaltsmarker. Ein Prüflauf vergleicht DNS-Auflösung, ausgelieferte Seite und Marker, prüft Sicherheitsheader, Rechtsseiten, Mail-Einträge und Zertifikate. Ergebnis: alle zwölf Ziele mit HTTP 200, neun Marker bestätigt, keine Befunde.

Beispielhafte Prüfungen aus dem Domain-Betrieb
PrüfungErgebnis
Erreichbarkeit (12 Ziele)12 von 12 mit HTTP 200
Interne Verweise334 geprüft, 0 Fehlschläge
Sicherheitsheader10 Seiten mit vollständigem Satz
Rechtstexte9 Impressum-Seiten live geprüft
Zertifikate12 gültig, Restlaufzeit überwacht
BarrierefreiheitReflow 320 px, Textvergrößerung 150 %, Zoom 200 %

Prinzip

Der Marker im Soll-Zustand ist der Trick: Er erkennt „hier läuft eine andere Seite“ – genau der Fehler, den reine HTTP-Statusprüfungen übersehen.

Abgrenzung

Was diese Seite nicht zeigt

Der Betriebsteil enthält Adressen, Hostnamen, Geräte und Zugangswege. Nichts davon steht auf dieser Website. Beschrieben werden Methode, Werkzeuge und öffentlich prüfbare Ergebnisse – nicht die interne Landkarte.

Veröffentlicht
Methode, Werkzeugidee, aggregierte Prüfergebnisse
Nicht veröffentlicht
Adressen, Zugangswege, Konfigurationsinhalte, Geräte- und Gästenamen
Reifegrad
produktiv betrieben (privat) – die Werkzeuge daraus sind dokumentiert

Belege

Provenienz

Welche Datei welche Aussage trägt.

Quellen dieser Projektseite
DateiAussageSHA-256
README.mdRollen und Einstieg
STATUS.mdverbindliche Live-Zahlen
docs/AUDIT-OVERVIEW.mdQuellen, Befunde, Widersprüche, Coverage
tools/hss-audit/README.mdlesendes Audit-Werkzeug