Zurück zum Blog
Applications Jan 6, 2026 7 Min. Lesezeit

Das JSON-Deskriptor-Pattern: Wie wir Enterprise-UI-Generierung deterministisch gemacht haben

Zuletzt aktualisiert Apr 9, 2026

ZUSAMMENFASSUNG

Ein 40-zeiliger JSON-Deskriptor ersetzt 400 Zeilen handcodierten Angular, weil das Framework das Rendering deterministisch übernimmt. Diese 10-fache Reduktion der Angriffsfläche macht die KI-Generierung reproduzierbar, auditierbar und für Nicht-Ingenieure überprüfbar.

Ein Auftragnehmer-Listenbildschirm in einer unserer Kundeninstallationen umfasst 38 Zeilen JSON. Das handgeschriebene Angular-Äquivalent, das er ersetzt hat, hatte 412 Zeilen TypeScript, HTML und SCSS. Dasselbe Verhalten, dasselbe Daten-Grid, dieselbe Master-Detail-Beziehung zur Adressen-Untertabelle. Ein Zehntel der Oberfläche.

Dieses Verhältnis ist der Grund, warum unsere KI-Generierungspipeline in Produktion funktioniert. Es ist auch der Grund, warum die meisten KI-generierten Enterprise-UIs das nicht tun.

Das Problem mit der direkten Codegenerierung

Wenn ein Modell eine React-Komponente generiert, trifft es Hunderte von Mikroentscheidungen. Variablennamen, State-Management, CSS-Ansatz, Fehlerbehandlung, Datenabruf. Führen Sie denselben Prompt zweimal aus, und Sie erhalten zwei funktionierende Implementierungen, die fast keine Struktur teilen. Für eine Demo ist das in Ordnung. Für ein Produktions-Enterprise-System ist es ein Ausschlusskriterium.

Unternehmen brauchen Reproduzierbarkeit. Sie brauchen Auditierbarkeit. Sie müssen auf einen Bildschirm zeigen und genau nachweisen können, was er tut, wer was sehen kann und wie eine Zahl berechnet wurde. Freie Codegenerierung kann nichts davon auf architektureller Ebene liefern.

Die Erkenntnis, die unseren Ansatz veränderte

Wir haben ungefähr sechs Monate lang verschiedene Generierungsstrategien ausprobiert, bevor wir auf die Regel stießen, die alles neu ordnete. Generiere nicht die Anwendung. Generiere die Beschreibung der Anwendung.

Ein JSON-Deskriptor spezifiziert, was ein Bildschirm tut. Seine Felder, sein Layout, seine Validierungsregeln, Datenquellen, Berechtigungen und Aktionen. Er sagt nichts darüber, wie dieser Bildschirm gerendert wird. Das Framework übernimmt das Rendering, deterministisch, jedes Mal auf dieselbe Weise.

Wie ein Deskriptor in der Praxis aussieht

Ein typischer Listenbildschirm-Deskriptor deklariert den Datenquellen-Endpunkt und Abfrageparameter, die Spalten mit Typen und Sortierverhalten, Filter- und Suchkonfiguration, die verfügbaren Aktionen und deren Berechtigungsanforderungen sowie etwaige Master-Detail-Beziehungen zu anderen Entitäten.

Das ist alles. Kein JSX, keine Event-Handler, kein Styling. Das Framework übernimmt das Rendering, der API-Client das Netzwerk und die Berechtigungsschicht die Zugriffskontrolle. Der Deskriptor ist einfacher zu schreiben, einfacher zu prüfen und deutlich einfacher zu ändern.

Warum das für die KI-Generierung wichtig ist

Das Modell auf Deskriptoren statt auf Code zu richten, verändert vier Dinge gleichzeitig.

Token-Effizienz. Ein Deskriptor ist ungefähr 10-mal kleiner als die äquivalente Komponente. Die Generierung ist schneller und günstiger, und das Kontextfenster fasst mehr des umgebenden Systems.

Konsistenz. Das Framework rendert jeden Deskriptor identisch. Es gibt keinen architekturellen Drift zwischen Bildschirmen, die am Montag geschrieben wurden, und solchen vom Dienstag.

Überprüfbarkeit. Ein Produktmanager kann einen JSON-Deskriptor lesen und den Bildschirm verstehen. 400 Zeilen TypeScript kann er nicht lesen, und das sollte er auch nicht müssen.

Diff-Fähigkeit. Wenn sich ein Deskriptor ändert, zeigt der Diff die tatsächliche semantische Änderung. „Spalte Priorität hinzugefügt, Typ Select, Optionen Hoch/Mittel/Niedrig.” Das ist ein aussagekräftiges Artefakt für einen menschlichen Prüfer oder einen SOX-Auditor.

Der Notausgang

Deskriptoren sind nicht universell. Manche Bildschirme benötigen benutzerdefinierte Komponenten, ungewöhnliche Layouts oder Verhaltensweisen, die das Framework nicht vorhersieht. Wir lösen das mit einer einzigen Regel: Jeder Deskriptor kann eine benutzerdefinierte Komponente referenzieren, die in standardmäßigem TypeScript geschrieben ist.

In unseren Installationen deckt das Framework ungefähr 90 % der Enterprise-Bildschirme ab. Die verbleibenden 10 % verwenden benutzerdefinierten Code dort, wo er seine Komplexität rechtfertigt. Auch diese benutzerdefinierten Komponenten erben die Framework-Muster für Datenzugriff, Berechtigungen und Fehlerbehandlung.

Der kumulative Vorteil

Jeder neue Deskriptor macht das System klüger. Die KI lernt aus bestehenden Deskriptoren, um bessere zu entwerfen. Die Komponentenbibliothek absorbiert Randfälle, sobald sie auftreten. Einmal gelöste Muster stehen jedem zukünftigen Bildschirm zur Verfügung.

Im Laufe der Zeit konvergiert das System auf einen Zustand, in dem die Generierung eines neuen Enterprise-Bildschirms Sekunden dauert und die Ausgabe sofort produktionsreif ist. Nicht weil das Modell klüger geworden ist. Sondern weil wir das Problem kleiner gemacht haben.