Schema · Kompass Standard
Kompass-Schema Datenstruktur des Standards
Die formale Datenstruktur hinter dem Kompass Standard — JSON-Schema, Feldnamen, Wertebereiche, Validierungsregeln. Für HR-IT, Integrationen und Partner, die auf Kompass-Daten aufbauen wollen.
- JSON-Schema
- Maschinenlesbar & validierbar
- Versioniert (v1.0)
PDF · Technische Spezifikation
Kompass-Schema — vollständige Spezifikation
Die vollständige Datenstruktur als PDF: alle Felder, alle Wertebereiche, alle Validierungsregeln. Inklusive Beispiel-JSON, Versionierungshinweisen und Migrationspfaden. Kostenlos, ohne Registration.
Warum strukturierte Daten neben dem Text wichtig sind.
01 — Wozu ein formales Schema?
- Maschinenlesbarkeit — Drittsysteme können Kompass-Zeugnisse direkt parsen, statt Fliesstext zu interpretieren
- Vergleichbarkeit — gleiche Felder für alle Zeugnisse, vergleichbare Skalen über Firmen und Branchen hinweg
- Validierung — automatische Prüfung auf Vollständigkeit und Konsistenz vor der Ausstellung
- Manipulationsschutz — Schema + SHA-256-Fingerabdruck erlauben unverfälschte Wiederherstellung
Top-Level-Felder eines Kompass-Zeugnisses.
02 — Wurzelobjekt
- schemaVersion (string) — z. B. „kompass/1.0"
- issuedAt (date) — Ausstellungsdatum, ISO 8601
- subject (object) — Personendaten der bewerteten Person
- company (object) — Stammdaten der ausstellenden Firma
- assessment (object) — die fünf Leistungsfelder, narrative Texte, Schluss
Wer wird beurteilt, wer stellt aus.
03 — subject und company
- subject.firstName, lastName (string, required)
- subject.birthDate (date, optional)
- subject.position (string) — Funktion bzw. Berufsbezeichnung
- subject.employmentStart, employmentEnd (date) — Anstellungsperiode
- company.name, address, uid, city (string)
Die fünf Leistungsfelder, jeweils mit Status und Beleg-Satz.
04 — assessment-Block
- fields (array) — fünf Einträge: aufgabenbewaeltigung, selbststeuerung, zusammenarbeit, entwicklung, wirkung
- fields[i].status (enum) — „anforderungen-erfuellt", „anforderungen-oft-uebertroffen", „anforderungen-deutlich-uebertroffen", „nicht-anwendbar"
- fields[i].evidenz (string, max 240 chars) — beobachtbarer Beleg-Satz
- narrative (object) — Aufgaben, Beiträge, Kompetenzbelege, Arbeitsstil als ausformulierter Fliesstext
- schluss (object) — Austrittsgrund, Dank, Zukunftswunsch
Was die Schema-Engine vor Ausstellung prüft.
05 — Validierungsregeln
- Pflichtfelder vorhanden (subject.firstName/lastName/position, company.name, assessment.fields)
- Genau fünf fields-Einträge mit den definierten Schlüsseln
- Status aus dem fixen Enum, keine Freitext-Werte
- Datumsfelder im ISO-8601-Format, employmentEnd ≥ employmentStart
Wie neue Schema-Versionen eingeführt werden.
06 — Versionierung & Kompatibilität
- Semantic Versioning (Major.Minor) — schemaVersion stets im Wurzelobjekt
- Minor-Updates sind abwärtskompatibel (zusätzliche optionale Felder)
- Major-Updates erhalten Migrationspfad und Übergangszeit von 12 Monaten
- Validatoren erkennen die Version selbst und nutzen die passende Regelmenge
Weiterlesen
Vertiefende Seiten
FAQ
Häufige Fragen
Ist das Schema offen?
Ja. Das Schema ist offen dokumentiert und kann von jedem Anbieter, HR-System oder Integrator verwendet werden. Die PDF-Spezifikation oben enthält alle Felder, Wertebereiche und Validierungsregeln. Eine maschinenlesbare JSON-Schema-Datei stellen wir auf Anfrage bereit.
Welche Beziehung hat das Schema zum PDF-Output?
Das Schema ist die Datenquelle, das PDF die Darstellung. Aus einem schema-konformen JSON kann ZeugnisPilot (oder ein Drittsystem) das druckfertige PDF deterministisch rendern. Der Inhalts-Fingerabdruck (SHA-256) wird über das normalisierte JSON gebildet — so ist Manipulation auch nach dem PDF-Druck nachweisbar.
Kann ich das Schema in meinem eigenen HR-System verwenden?
Ja. Wenn Ihr System Kompass-Zeugnisse erstellen oder importieren soll, muss es lediglich das Schema einhalten. Validatoren und Beispiel-JSONs erleichtern den Einstieg. Wir empfehlen, mit Schema-Version 1.0 zu beginnen und bei Major-Updates die Übergangszeit zu nutzen.
Was passiert bei einem Validierungsfehler?
Der Validator gibt eine strukturierte Fehlerliste zurück (Feldpfad, Regel, gefundener Wert, erwartete Werte). Das Zeugnis kann nicht ausgestellt werden, bis alle Fehler behoben sind — das schützt vor unvollständigen oder inkonsistenten Daten.
Wo finde ich das vollständige Schema als PDF?
Direkt hier: die Schema-Spezifikation steht oben auf dieser Seite als PDF-Download bereit (kostenlos, ohne Registration). Sie enthält Wurzelobjekt, alle Sub-Objekte, Wertebereiche, Beispiel-JSON und Validierungsregeln.
Kompass im Generator direkt anwenden
Der Generator schreibt Kompass-Zeugnisse automatisch schema-konform — Sie können sich auf die Inhalte konzentrieren statt auf JSON-Felder.