docs: Architekturplan, ADRs, Spezifikationen und Umsetzungsplan

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-11 14:00:36 +02:00
commit fef930d176
15 changed files with 854 additions and 0 deletions
@@ -0,0 +1,14 @@
+# ADR-0005: Deterministisches Autohealing, Kernlogik im Service statt in n8n
+
+- Status: angenommen
+- Datum: 2026-10-11
+
+## Entscheidung
+- Der Healer arbeitet eine **Regeltabelle** ab (`config/healer-rules.yaml`). Für jedes Alert-Muster gibt es eine Eskalationsleiter von Aktionen, jeweils mit Versuchsbudget und Cooldown. Sind alle Versuche erschöpft, wird ein Mensch benachrichtigt.
+- Alertmanager liefert **direkt** an den Router-Service, nicht über n8n. So funktioniert das Healing auch, wenn n8n ausfällt.
+- Die Schleife aus Routing, Ausführung, Verifikation und Eskalation steckt testbar im Service (`/v1/run`). n8n übernimmt Trigger, Authentifizierung, Antwort, Benachrichtigung und die HITL-Kanäle.
+- Alle Aktionen laufen standardmäßig im **Dry-Run**, bis sie pro Aktionstyp freigeschaltet werden.
+
+## Folgen
+- Weniger Logik in n8n, dafür Unit-Tests für die gesamte Entscheidungslogik.
+- Ein Ausfall von n8n betrifft nur die Eingangskanäle, nicht das Healing.