Netzwerksolution Documentation Report

HUMAN-READABLE-TEST-CONTRACT-MODEL

Modell für menschenlesbare Testverträge#

Enterprise Solution Engineering Runtime Beziehung: constrains; Pfeilrichtung: ADR-004-HUMAN-READABLE-AND-STABILIZING-TESTS → HUMAN-READABLE-TEST-CONTRACT-MODELconstrains ADR-004 – Menschenlesbare und stabilisierende Tests — Bedeutung (meaning) · EnterpriseBedeutung (meaning)ADR-004 –Menschenlesbare und st… Modell für menschenlesbare Testverträge — Artefakt (artifact) · Enterprise. Strukturkontext öffnen.Artefakt (artifact)Modell fürmenschenlesbare Testvert…
Übersicht · 2: zweite Ebene · Ziehen/Klicken: navigieren

Zweck#

Tests sind ausführbare Spezifikationen. Sie müssen für Menschen verständlich ausdrücken, welches Verhalten, welche Invariante oder welches Risiko sie schützen.

Verbindliche Regeln#

  1. Jeder Testname beschreibt Ausgangslage, Handlung und erwartetes Ergebnis.
  2. Wichtige Tests erklären in einem kurzen Kommentar, welche fachliche Invariante sie schützen.
  3. Unit-, Component-, Integration-, Contract- und E2E-Tests bleiben unterscheidbar.
  4. Happy Paths allein genügen nicht.
  5. Schreibende Use Cases prüfen mindestens Validierung, Autorisierung, Nebenläufigkeit, Transaktion, Grenzwerte, Unicode und Audit-/Outbox-Folgen, soweit anwendbar.
  6. Regressionen erhalten einen dauerhaft verständlich benannten Test.
  7. Manifests verknüpfen Use Cases mit Testkategorien und Testpfaden.
  8. Testberichte verwenden fachliche Beschreibungen statt ausschließlich technische Funktionsnamen.

Testkategorien#

Stabilitätsprinzip#

Ein Test schützt nicht nur eine Implementierung, sondern eine explizite Erwartung. Wird die Erwartung geändert, muss zuerst die zugehörige Architektur- oder Requirement-Entscheidung angepasst werden.