Verdict YAML Referenz

Feld-Level-Spezifikation fuer Verdict-YAML-Definitionen.

Uebersicht

Eigenschaft	Wert
Dateiort	verdicts/verdict_*.yaml
ID-Regel	verdict_id muss mit Dateiname (ohne .yaml) uebereinstimmen
Validator	python3 scripts/verdictcheck.py
Compiler	python3 scripts/verdictcompile.py
Compiler Trockenlauf	python3 scripts/verdictcompile.py --check

Felder

Feld	Typ	Erforderlich	Gueltige Werte
verdict_id	string	ja	Muss mit Dateiname uebereinstimmen
version	string	ja	Semantische Version (z.B. "1.0")
thesis_id	string	ja	Muss auf existierende theses/*.yaml referenzieren
root_cause_category	string	ja	Siehe Root Cause Kategorien
root_cause_id	string	ja	Freiformbezeichner fuer die spezifische Root Cause
conditions	list	ja	Min 1 Eintrag
confidence	dict	ja	Siehe Confidence-Block
explanation	dict	ja	{en, de, fr} dreisprachiger Text
recommendation	dict	ja	{en, de, fr} dreisprachiger Text

Root Cause Kategorien

Kategorie	Beschreibung
process_failure	Defekter oder unvollstaendiger Geschaeftsprozess
system_failure	IT-Systemfehlfunktion oder Integrationsluecke
data_quality	Veraltete, fehlende oder inkonsistente Stammdaten
behavioral	Menschliche Verhaltensmuster (Workarounds, uebersprungene Schritte)
structural	Organisatorisches oder vertragliches Misalignment
external	Externe Faktoren (Lieferant, regulatorisch)

Conditions-Block

Feld	Typ	Erforderlich	Beschreibung
signal_id	string	ja	Muss auf existierende signals/*.yaml referenzieren
field	string	ja	Aggregatfeld aus Signal Findings (z.B. finding_count, money_at_risk)
above	number	ja	Numerischer Schwellenwert

Alle Bedingungen muessen erfuellt sein (UND-Logik). Das Verdict wird nur bewertet wenn seine uebergeordnete Thesis den Status confirmed hat.

Confidence-Block

Feld	Typ	Erforderlich	Gueltige Werte
base	float	ja	0.0-1.0
boost_if	list	nein	Siehe unten

Jeder boost_if-Eintrag:

Feld	Typ	Erforderlich	Gueltige Werte
signal_id	string	ja	Muss auf existierende signals/*.yaml referenzieren
field	string	ja	Aggregatfeld aus Signal Findings
above	number	ja	Numerischer Schwellenwert
boost	float	ja	0.0-0.3

Regeln: base + sum(alle Boosts) sollte 1.0 nicht ueberschreiten.

Verdict-Ausgabe

Jedes Verdict produziert eine Zeile pro Tenant in verdict_findings (nur fuer bestaetigte Theses bei denen alle Bedingungen erfuellt sind):

Spalte	Typ	Beschreibung
verdict_id	string	Verdict-Bezeichner
tenant_id	string	Tenant-Bezeichner
thesis_id	string	Uebergeordneter Thesis-Bezeichner
root_cause_category	string	Kategorie aus dem YAML
root_cause_id	string	Spezifischer Root Cause Bezeichner
confidence	float	base + anwendbare Boosts
finding_count	integer	Gesamt-Findings ueber Bedingung-Signals
money_at_risk	numeric	Summe von money_at_risk aus Bedingung-Signals
thesis_evidence_score	float	Evidence Score der uebergeordneten Thesis

Siehe die englische Referenz fuer das vollstaendige Minimalbeispiel.