ET-VALIDATOR-FINDING-CONTRACT-001
Finding and Severity Contract#
Mindestinhalt eines Findings#
Ein GlossarbegriffTechnical documentation artifact.Glossareintrag vollständig lesen muss mindestens enthalten oder eindeutig ableitbar machen:
- verletzte Regel oder Prüfphase,
- betroffenes GlossarbegriffEin Artefakt ist jede eindeutig identifizierbare fachliche, technische, organisatorische oder reale Einheit, die in der Engineering-Landschaft modelliert wird. Alles Modellierbare wird als Artefakt geführt. Dazu gehören unter anderem Systeme, Beziehungen, Features, Dokumente, ADRs, Tests, UI-Buttons, Menüs, Farben, Icons, Konfigurationen, Diagramme, Runtime-Ressourcen, fachliche Objekte und reale Objekte wie ein Blumentopf, sofern sie modelliert werden. Knowledge ist keine Sonderklasse. UI- und Applikationsartefakte werden fachlich nach demselben Grundmodell behandelt.Glossareintrag vollständig lesen beziehungsweise betroffenen Pfad,
- konkrete Abweichung,
- Schwere oder statusbestimmende Wirkung.
Freie Fehlermeldungen ohne identifizierbares Ziel sind für automatisierte GlossarbegriffTechnical documentation artifact.Glossareintrag vollständig lesen ungeeignet.
Schweregrade#
| Schwere | GlossarbegriffBedeutung beschreibt den fachlichen Sinn eines Elements und seine Relevanz für Menschen und Organisationen.Glossareintrag vollständig lesen | Exit-Wirkung |
|---|---|---|
error |
Vertrag verletzt oder Prüfung nicht zuverlässig ausführbar | Lauf schlägt fehl |
warning |
prüfbare Abweichung ohne zwingenden Vertragsbruch | darf Erfolg nicht stillschweigend vortäuschen; maschinenlesbar ausweisen |
info |
rein erklärender Befund | keine Fehlerwirkung |
gap |
deklarierte fehlende Verifikation oder MeaningEvidenceTechnical documentation artifact.Vollständig lesen | Wirkung folgt der zugehörigen Severity |
Bestehende Validatoren, die nur ERROR: und Exit-Code unterscheiden, erfüllen den Mindestvertrag für Fehler. Eine feinere Klassifikation ist eine spätere, kompatible Erweiterung und darf nicht rückwirkend behauptet werden.
Determinismus#
Bei unveränderten Eingaben müssen Reihenfolge, Identifikation und Exit-Wirkung der Findings stabil sein. Pfade werden repositoryrelativ bevorzugt; temporäre absolute Pfade dürfen keine fachliche Identität bilden.