Skip to content

YAML Frontmatter Schema Reference

Extracted from PRD.md Chapter 6 for quick reference.

Pflichtfelder (Required — all document types)

Field Type Valid Values
title string Non-empty
type enum richtlinie, arbeitsanweisung, control, vorfall, massnahme, auditbericht, auditplan, kpi, schulung, verarbeitungstaetigkeit, dsfa, prozess, lieferant, dashboard, managementbewertung
management_system enum IMS, ISMS, QMS, DSMS
classification enum vertraulich, intern, extern
status enum entwurf, aktiv, abgeschlossen, archiviert
Field Type Format
review_date date YYYY-MM-DD
approved_by string Approver name
approved_date date YYYY-MM-DD
lifecycle_stage enum entwurf, review, freigegeben, archiviert
norm_refs list [ISO 27001, VDA ISA, NIS2, DSGVO, ISO 9001, Umweltschutz]
last_ai_review date YYYY-MM-DD

Type-Specific Fields

type: control

Field Type Values
norm string ISO 27001, VDA ISA, NIS2, ISO 9001, DSGVO
chapter string e.g., A.5.01, 4.1, Art.32
reifegrad number/string 0, 1, 2, 3, 4, 5, na
bewertet_am date YYYY-MM-DD
risiko_wahrscheinlichkeit number optional
risiko_auswirkung number optional
risiko_score number optional
compliance_gap boolean optional, KI-detected

type: vorfall

Field Type Values
schweregrad enum hoch, mittel, niedrig
betroffene_systeme list System names
entdeckungsdatum date YYYY-MM-DD
datenpanne boolean true triggers DSMS entry

type: massnahme

Field Type Values
kategorie enum korrektur, vorbeugung
verantwortlicher string Person name
frist date YYYY-MM-DD
wirksamkeitspruefung date YYYY-MM-DD

type: kpi

Field Type Values
einheit string Measurement unit
zielwert string/number Target value
messfrequenz enum monatlich, quartalsweise, jaehrlich
kategorie enum qualitaet, sicherheit, datenschutz, umwelt, allgemein

type: verarbeitungstaetigkeit

Field Type Values
zweck string Purpose of processing
rechtsgrundlage string Art. 6 Abs. 1 lit. a/b/c/f DSGVO
datenkategorien list Data categories
empfaenger list Data recipients
loeschfristen string Retention periods

type: lieferant

Field Type Values
umwelt_bewertung enum nicht_bewertet, teilweise, vollstaendig

Compliance Score Formula

score = (populated_fields / expected_fields) * 100

Where:
  expected_fields = count(Pflichtfelder) + count(type_specific_fields) + count(recommended_fields)
  populated_fields = count(fields that are present AND non-null AND valid)