SMEbit YAML Referenz

Feld-Level-Spezifikation fuer SMEbit YAML-Definitionen (smebits/smebit_*.yaml).

Dateikonvention

• Ort: smebits/smebit_*.yaml
• smebit_id muss mit dem Dateinamen (ohne Endung) uebereinstimmen
• Validator: python3 scripts/smebitcheck.py
• Compiler: python3 scripts/smebitcompile.py

Level

Level	Name	Hat check-Block?	Produziert dbt-Modell?	Beschreibung
0	Beobachtung	Nein	Nur Registry	Eigenstaendiges Wissen — kein SQL, kein Verdict
1	Check	Ja	Verdict-Modell	Testbare Behauptung, kompiliert zu SQL, produziert confirmed/violated/no_data

Level ist implizit: wenn der check-Block vorhanden ist, ist es Level 1. Sonst Level 0.

Top-Level-Felder

Feld	Typ	Erforderlich	Beschreibung
smebit_id	string	Ja	Muss mit Dateiname uebereinstimmen
version	string	Ja	Semver (z.B. "1.0.0")
provider	mapping	Ja	name, role, date
scope	mapping	Ja	tenant_id, source_system, time_range
category	string	Ja	data_quality | mapping | business_rule | process | system | seasonal | historical | structural
subject	i18n mapping	Ja	Einzeilige Zusammenfassung (en/de/fr erforderlich)
content	i18n mapping	Ja	Vollstaendige Erklaerung (en/de/fr erforderlich)
why	i18n mapping	Warnung	Grund hinter der Beobachtung. Validator warnt wenn fehlend
status	string	Ja	active | superseded | contested | archived
anchors	list	Nein	Querverweise (probe_id, hypothesis_id, entity_type)
check	mapping	Nein	Macht es zu Level 1. description, entity_type, query, expect
prescription	mapping	Nein	type, target_entity, target_field, description, status

Check-Block

Feld	Typ	Erforderlich	Beschreibung
description	i18n mapping	Ja	Was der Check verifiziert
entity_type	string	Ja	Gold Contract Entity-Typ
query	string	Ja	SQL-Abfrage mit {{ ref('...') }}
expect	string	Ja	confirmed oder violated

Siehe die englische Referenz fuer vollstaendige Level 0 und Level 1 Beispiele.