Engineering
Nachvollziehbare Änderungen, gemeinsame Verträge und überprüfbare Qualität.
Eine Quelle pro Entscheidung
Brand-JSON definiert Identität, Foundation-JSON die gemeinsamen Skalen, Präsentationsgeometrie das Folienraster. Website, CSS und maschinenlesbare Exporte werden daraus abgeleitet.
Änderungen und Releases
Kleine fachlich zusammenhängende Commits. Review beschreibt Problem, Änderung und resultierendes Verhalten. Breaking Changes erhalten eine neue Hauptversion des jeweiligen Vertrags.
Verbindliche Prüfungen
npm run check prüft Brand-Schema, Kontraste, Token-Vollständigkeit, Core-Isolation, Präsentationsrezepte, TypeScript und Produktionsbuild. Browserprüfungen ergänzen den Build für Navigation, Portale, Mobilansicht und Darstellung.
Release und Produktionsnachweis
Version aus package.json, Quellcommit und Build-Zeit gehören in build-info.json. Der Abruf auf der Zieldomain muss mit dem ausgelieferten Commit übereinstimmen. GitHub-Push, Build und Produktionsauslieferung sind drei getrennte Schritte.
Integration und Rollback
Authentifizierung, Mandantentrennung und Datenzugriff werden serverseitig geprüft. Mailvorschau und Versand bleiben getrennt. Das letzte funktionsfähige Deployment bleibt als Rückfallpunkt bekannt; Datenmigrationen benötigen einen eigenen Rückweg.
Abweichungen dokumentieren
Übernommenen Fremdcode auf einen Commit fixieren. Bewusste Abweichungen vom Vertrag mit Grund dokumentieren. Source-Module zählen separat von geprüftem Verhalten; eine Inventarliste ist keine Abnahme.