Teil I · Fragen 73 bis 80
Softwarearchitektur und Implementierung
Inhalt
Antworten auf die Fragen 73 bis 80
Die Architektur im Einzelnen steht in Dokument 4. Die Antworten beschreiben, was im Prototyp umgesetzt ist, und begründen Abweichungen vom vorgeschlagenen Technikstapel.
Frage 73: Welche Architektur eignet sich für eine zunächst selbst gehostete Webanwendung?
Antwort. Eine einzige Anwendung mit klar getrennten Schichten und eine Datenbank, beide als Container auf einem eigenen Server, hinter einem vorhandenen Webserver. Keine verteilten Dienste.
Grundlage. Für einen Betreiber, einen Server und eine Anwendung im Prototypstadium ist ein gegliederter Einzelbau am einfachsten zu betreiben, zu sichern und zu verstehen. Mehrere Dienste brächten Aufwand ohne Nutzen. Derselbe Aufbau trägt bereits zwei andere Anwendungen auf demselben Server.
Empfehlung.
Internet
|
Caddy (vorhandener Webserver, Verschlüsselung, zwei Namen der Domain)
|
Internal Talent (ein Container, Next.js, kein öffentlicher Anschluss)
|
PostgreSQL 16 (eigener Container, nur intern erreichbar, eigener Datenträger)
Die Anwendung ist in Schichten gegliedert, die nur in eine Richtung voneinander abhängen:
| Schicht | Verzeichnis | Aufgabe | Darf zugreifen auf |
|---|---|---|---|
| Rechenkern | src/analytics | alle Formeln, rein und deterministisch | nichts |
| Fachkataloge | src/domain | Instrumente, Fragen, Situationen, Rollen, Zwecke | nichts |
| Geschäftslogik | src/server | Datenzugriff, Berechtigungen, Protokoll | Rechenkern, Kataloge, Datenbank |
| Oberfläche | src/app, src/components | Seiten, Eingaben, Diagramme | Geschäftslogik |
Auslieferung: Ein Stand auf dem Hauptzweig löst Tests und den Bau eines Abbilds aus. Das Abbild wird in einer Registratur abgelegt und per gesicherter Verbindung auf dem Server eingespielt. Schlägt die Prüfung der Erreichbarkeit fehl, kehrt das Skript zur vorigen Fassung zurück.
Alternativen. Betrieb bei einem Plattformanbieter: bequemer, aber die Daten lägen außerhalb der eigenen Kontrolle und oft außerhalb der Europäischen Union. Ein eigener Rechendienst in R oder Python neben der Webanwendung: nützlich für aufwendige Statistik, für die Formeln dieses Modells nicht nötig. Betrieb im Rechenzentrum jeder Kundenorganisation: maximale Kontrolle für die Organisation, hoher Betreuungsaufwand.
Risiken und Grenzen. Ein einzelner Server ist ein einzelner Ausfallpunkt. Für den Prototyp ist das vertretbar. Für den Betrieb mit echten Daten braucht es getestete Sicherungen an einem zweiten Ort.
Stand. Technische Entscheidung, im Prototyp umgesetzt.
Frage 74: Wie sollten React, Next.js, PostgreSQL und eine statistische Berechnungsengine zusammenspielen?
Antwort. Der Server rendert die Seiten und rechnet. Der Browser zeigt an und nimmt Eingaben entgegen. Die Berechnungsengine ist eine Bibliothek reiner Funktionen ohne Zugriff auf Datenbank, Uhr oder Netz.
Grundlage. Zwei Anforderungen des Konzepts: Die Rechnung muss nachvollziehbar und wiederholbar sein, und Schutzregeln dürfen nicht im Browser umgehbar sein.
Empfehlung.
- Seiten werden auf dem Server zusammengesetzt. Sie rufen Funktionen der Geschäftslogik auf und erhalten nur, was die Rolle sehen darf.
- Die Geschäftslogik fragt zuerst die zentrale Regelstelle (
policy.ts), lädt dann Daten und übergibt Zahlen an den Rechenkern. - Der Rechenkern erhält Zahlen und gibt Zahlen zurück. Er kennt keine Personen, nur Werte und, wo nötig, anonyme Kennungen.
- Interaktive Teile (Befragung, Simulator, Zielprofil) laufen im Browser und senden jede Änderung als Serveraktion. Der Simulator rechnet nie im Browser.
- Die Datenbank speichert Originalantworten. Dimensionswerte werden bei jedem Abruf neu berechnet.
Der Rechenkern ist in TypeScript geschrieben, in derselben Sprache wie die Anwendung. Gründe: ein Prozess, keine Schnittstelle zwischen zwei Sprachen, dieselben Tests, und die Formeln dieses Modells sind einfach genug.
Abweichungen vom vorgeschlagenen Technikstapel, mit Begründung:
| Vorschlag | Entscheidung | Grund |
|---|---|---|
| Next.js, React, TypeScript, Tailwind CSS | übernommen | passt |
| PostgreSQL, Prisma | übernommen | passt |
| shadcn/ui | nicht übernommen | Die wenigen Grundbausteine (Schaltfläche, Karte, Hinweis, Kennzeichen) sind selbst geschrieben. Das spart eine Abhängigkeit und hält die Gestaltung in einer Hand. |
| Apache ECharts | nicht übernommen | Die Diagramme sind eigene Bausteine aus HTML und SVG. Sie brauchen kein Skript, sind mit Tastatur und Vorleseprogramm bedienbar und laden nichts nach. Die Bibliothek hätte das Paket deutlich vergrößert. |
| OpenID Connect | vorbereitet, nicht umgesetzt | Die Demonstration hat keine Konten. Jede besuchende Person erhält eine eigene, befristete Umgebung. Für echte Organisationen ist die Anmeldung über deren Verzeichnis vorgesehen. |
| Deterministische Analytics Engine | übernommen | Kern des Modells |
| Claude API als optionale Assistenz | vorbereitet, nicht umgesetzt | Freigabe und Einstellung sind vorhanden. Eine Verbindung zu einem Sprachmodell besteht nicht, weil dafür eine Entscheidung zum Verarbeitungsort nötig ist (siehe Frage 78). |
Alternativen. Ein Rechendienst in R mit dem Paket OpenRepGrid für die Auswertung einzelner Grids. Sinnvoll, sobald aufwendigere Grid Auswertungen gewünscht sind, etwa Hauptkomponenten.
Risiken und Grenzen. Statistische Verfahren jenseits der Grundrechenarten sind in TypeScript weniger erprobt als in R. Der Vergleich einzelner Ergebnisse mit einem Referenzpaket steht noch aus.
Stand. Technische Entscheidung, im Prototyp umgesetzt.
Frage 75: Wie modellieren wir Organisationen, Teams, Personen, Konstrukte, Antworten und Simulationen?
Antwort. Mit dreizehn Tabellen, in denen persönliche Angaben, Freigaben, Festlegungen des Teams und gespeicherte Berechnungen getrennt liegen.
Grundlage. Die Trennung der drei Messebenen und die Zweckbindung müssen sich im Datenmodell wiederfinden.
Empfehlung.
| Tabelle | Inhalt | Besonderheit |
|---|---|---|
| Organization | Name, Mindestgruppengröße, Aufbewahrung, Zulassung der KI Assistenz, Ablaufdatum | Jede Demonstration ist eine eigene Organisation. |
| Team | Name, Auftrag, künftige Aufgaben, Sichtbarkeit der Verteilung | |
| Person | Anzeigename, Kennung ohne Namen, fachlicher Hintergrund, Rollen | |
| Membership | Zugehörigkeit zu einem Team, Leitung ja oder nein | |
| Consent | Freigabe je Person und Zweck, mit Fassung des Freigabetexts und Zeitpunkt | Eine Zeile je Zweck. |
| Assessment | eine Erhebung je Person und Instrument, mit Version, Stand und allen Antworten | Antworten als strukturierter Datensatz. |
| Construct | eine Unterscheidung: Dreiergruppe, gewähltes Paar, beide Pole im ursprünglichen und im aktuellen Wortlaut, bevorzugte Seite, Begründung, bestätigt, für das Team freigegeben | |
| Rating | Einordnung einer Situation auf einem Konstrukt | Ein eigener Wert steht für „passt nicht“. |
| ValueMapping | Zuordnung eines Konstrukts zu einer Dimension, mit Herkunft | Nur von der Person selbst bestätigt gültig. |
| TargetProfile | Zielprofil eines Teams je Instrument: Fassung, Stand, Festlegungen, drei Antworten, Zeitpunkt der Festlegung | Festgelegte Fassungen sind unveränderlich. |
| Simulation | gespeichertes Szenario: Team, hinzugefügte und herausgenommene Personen, angenommener Messfehler, Modellversion, Prüfwert, Ergebnis | Wird bei Widerruf gelöscht. |
| TeamProfile | festgehaltener Stand eines Teamprofils | angelegt, im Prototyp noch ungenutzt |
| AuditEvent | wer, wann, was, zu welchem Zweck | nie Inhalte |
Wird eine Organisation gelöscht, verschwinden alle abhängigen Datensätze mit ihr.
Alternativen. Antworten als einzelne Zeilen statt als Datensatz je Erhebung. Das erleichtert Auswertungen über viele Personen und erschwert das Löschen und Exportieren.
Risiken und Grenzen. Für echte Daten sollten persönliche Angaben und Verwaltungsdaten in getrennten Schemata mit getrennten Datenbankrollen liegen. Der Prototyp trennt sie nur in der Anwendung.
Stand. Technische Entscheidung, im Prototyp umgesetzt.
Frage 76: Wie implementieren wir eine nachvollziehbare Versionierung von Befragungen, Skalen und Berechnungen?
Antwort. Mit fünf Kennungen, die mit jedem Datensatz gespeichert werden, und dem Grundsatz, dass Originalantworten nie überschrieben werden.
Grundlage. Ein Ergebnis ist nur nachvollziehbar, wenn feststeht, mit welchen Fragen, welcher Skala und welcher Rechenregel es entstand.
Empfehlung.
| Was | Kennung | Gespeichert an |
|---|---|---|
| Instrument und Fragen | Schlüssel und Version, etwa arbeitsorientierung 0.1 | jeder Erhebung |
| Situationen des Grids | Schlüssel und Version des Elementsets | Katalog, über die Version des Instruments an jeder Erhebung |
| Rechenmodell | Modellversion, etwa itvem-0.1.0 | jedem gespeicherten Szenario |
| Eingaben einer Rechnung | Prüfwert über die geordneten Eingaben | jedem gespeicherten Szenario |
| Freigabetext | Fassung, etwa 0.2 | jeder Freigabe |
| Zielprofil | fortlaufende Fassung, unveränderlich nach Festlegung | jedem gespeicherten Szenario als Bezug |
| Datenbankaufbau | fortlaufende Migrationen mit Prüfsumme | eigener Tabelle der Datenbank |
Regeln:
- Ändert sich eine Formel, Schwelle oder Rundung, wird die Modellversion erhöht.
- Ändert sich der Wortlaut einer Frage, entsteht eine neue Version des Instruments. Alte Antworten bleiben ihrer Version zugeordnet.
- Dimensionswerte werden nicht gespeichert, sondern aus den Antworten berechnet. Eine verbesserte Regel wirkt so auf alle vorhandenen Antworten und ist an der Modellversion erkennbar.
- Kataloge liegen im Quelltext und damit in der Versionsverwaltung. Jede Änderung ist dort mit Datum und Begründung nachzulesen.
Alternativen. Kataloge in der Datenbank mit einer Bearbeitungsoberfläche. Bequemer für Fachleute, aber ohne die strenge Nachvollziehbarkeit der Versionsverwaltung.
Risiken und Grenzen. Weil Werte neu berechnet werden, kann sich ein angezeigter Wert nach einer Änderung der Regel ändern. Für Studien ist deshalb der Stand zu einem Stichtag festzuhalten. Die Tabelle dafür ist angelegt.
Stand. Technische Entscheidung, im Prototyp umgesetzt.
Frage 77: Wie trennen wir personenbezogene Rohdaten, aggregierte Ergebnisse und freigegebene Berichte?
Antwort. Durch drei Zugriffswege, die sich nicht kreuzen, und dadurch, dass zusammengefasste Ergebnisse gar nicht gespeichert, sondern bei jedem Abruf neu und unter den geltenden Schutzregeln berechnet werden.
Grundlage. Was nicht gespeichert ist, kann nicht zweckwidrig gelesen werden. Und ein Widerruf wirkt sofort, wenn bei jedem Abruf neu gerechnet wird.
Empfehlung.
| Art | Wo | Wer kommt heran |
|---|---|---|
| Rohdaten: Antworten, Konstrukte, Einordnungen | Tabellen der Erhebung | ausschließlich Funktionen, die mit der Kennung der handelnden Person arbeiten. Es gibt keine Funktion „Rohdaten von Person X laden“. |
| Zusammengefasste Ergebnisse | nirgends gespeichert | werden bei jedem Abruf berechnet, nach Prüfung der Rolle, der Freigaben und der Mindestgruppengröße |
| Freigegebene Einzelwerte für die Simulation | werden zur Laufzeit geladen | nur mit Freigabe der Person für diesen Zweck, mit Protokolleintrag |
| Gespeicherte Szenarien | Tabelle der Simulationen | Leitung des Teams und Organisationsentwicklung. Zeigt ein Team keine Verteilung, enthält auch das gespeicherte Ergebnis keine Einzelwerte des Teams. |
| Namenlos freigegebene Konstrukte | Kennzeichen am Konstrukt | Mitglieder und Leitung des Teams, ab drei Personen, ohne Bezug zur Verfasserin |
Für den Betrieb mit echten Daten zusätzlich: getrennte Schemata und Datenbankrollen für Rohdaten und Verwaltung, Verschlüsselung besonders schutzwürdiger Felder und Regeln auf Ebene der Datenbankzeilen als zweite Sicherung.
Alternativen. Eine eigene, vollständig getrennte Datenbank für Rohdaten. Sauberer, aber aufwendiger im Betrieb.
Risiken und Grenzen. Die Trennung liegt im Prototyp in der Anwendung. Wer direkten Zugriff auf die Datenbank hat, kann sie umgehen.
Stand. Technische Entscheidung, im Prototyp umgesetzt und mit Tests gegen eine echte Datenbank geprüft.
Frage 78: Wie integrieren wir Claude als optionalen Assistenten, ohne unkontrolliert personenbezogene Daten zu übermitteln?
Antwort. Mit drei Schaltern, die alle geschlossen sein müssen, mit strenger Begrenzung dessen, was gesendet wird, und nie in einer Rolle, in der die Antwort des Modells in eine Rechnung eingeht. Im Prototyp ist die Assistenz vorbereitet, aber nicht aktiv.
Grundlage. Die direkte Schnittstelle des Anbieters bedeutet nach dem Stand der Recherche eine Verarbeitung außerhalb der Europäischen Union auf Grundlage von Standardvertragsklauseln. Eine Verarbeitung in der Union wäre über die Angebote großer Cloud Anbieter in europäischen Regionen möglich. F Freitexte über Arbeitssituationen sind oft über den Zusammenhang einer Person zuordenbar.
Empfehlung.
Drei Schalter:
- Der Server hat einen Zugangsschlüssel. Ohne ihn gibt es keine Funktion.
- Die Organisation hat die Assistenz zugelassen.
- Die Person hat den Zweck „KI Assistenz“ freigegeben.
Was gesendet werden darf:
- nur der Text, den die Person in diesem Moment ausdrücklich abschickt, etwa die beiden Pole eines Konstrukts,
- nie Namen, Kennungen, Team, Organisation, Werte oder Antworten anderer,
- vor dem Senden eine Prüfung auf Namen und Kontaktdaten.
Was die Assistenz tun darf:
- Verständnisfragen stellen, kürzere Formulierungen vorschlagen, berechnete Ergebnisse in Alltagssprache erklären.
Was sie nie tut:
- rechnen, zuordnen, vergleichen, bewerten, empfehlen.
Dazu:
- sichtbarer Hinweis, dass ein KI System antwortet,
- Protokolleintrag ohne Inhalt,
- keine Speicherung der Eingaben über die Anfrage hinaus, soweit der Anbieter das zusagt,
- Vertrag zur Auftragsverarbeitung und Prüfung des Verarbeitungsorts,
- technischer Ausschluss der Assistenz in Simulator und Zielprofil.
Alternativen. Ein Sprachmodell auf eigenem Server in der Europäischen Union: volle Kontrolle, geringere Güte, hoher Aufwand. Verzicht auf KI: der Stand des Prototyps.
Risiken und Grenzen. Auch mit allen Schaltern bleibt ein Rest: Menschen schreiben in freie Felder, was sie wollen. Und die rechtliche Bewertung des Datenflusses in ein Drittland kann sich ändern.
Stand. Gestaltung: fachliche Empfehlung. Rechtliche Bewertung: nach Fachbeiträgen, nicht anwaltlich geprüft.
Rückfrage. Soll die Assistenz gebaut werden? Wenn ja: über die direkte Schnittstelle mit Verarbeitung außerhalb der Union oder über einen europäischen Cloud Standort?
Frage 79: Welche automatisierten Tests benötigen wir für statistische Korrektheit, Datenschutz und Berechtigungen?
Antwort. Vier Arten, die bei jeder Auslieferung laufen. Schlägt eine fehl, wird nicht ausgeliefert.
Grundlage. Eine Schutzregel, die nicht getestet ist, gilt nur so lange, bis jemand den Quelltext ändert.
Empfehlung. Stand des Prototyps: 175 Tests in zwölf Dateien.
| Art | Was geprüft wird | Beispiele |
|---|---|---|
| Rechenkern | jede Formel gegen von Hand nachgerechnete Werte | Mittel und Streuung, r(wg), ICC, Blau, größte Lücke, Kennwerte nach Honey, Bewertung gegen das Zielprofil |
| Beispiele der Dokumentation | jede Zahl aus Dokument 3 | ändert sich eine Formel, schlägt der Test fehl, und das Dokument muss angepasst werden |
| Regeln der Berechtigung | jede Regel für jede Rolle, als reine Funktionen | Administration ohne Fachzugriff, fremde Organisation, Schutz vor Rückrechnung, Übersicht „Wer sieht was“ |
| Zusammenspiel mit echter Datenbank | ganze Abläufe mit einer erzeugten Beispielorganisation | Mitglied anderer Teams sieht nichts. Widerruf wirkt sofort. Unter der Mindestgröße wird nichts gezeigt. Niemand ändert Konstrukte anderer, auch nicht mit bekannter Kennung. Profile ohne Freigabe lassen sich nicht simulieren. Das Protokoll enthält keine Inhalte. |
Zwei Tests sichern Grundsätze des Produkts:
- Das Ergebnis der Simulation enthält keine Felder für Gesamtwert, Rang oder Prozent.
- Die Engine liefert für dieselben Eingaben dasselbe Ergebnis.
Zusätzlich wurden alle Seiten im Prototyp mit einem automatisierten Browser am großen und am kleinen Bildschirm durchlaufen und auf Fehler in der Konsole und auf waagerechtes Überlaufen geprüft. Diese Abläufe sind noch nicht Teil der festen Testsammlung.
Alternativen. Tests mit zufällig erzeugten Eingaben, die allgemeine Eigenschaften prüfen, etwa „das Mittel liegt immer zwischen kleinstem und größtem Wert“. Sinnvolle Ergänzung für die nächste Stufe.
Risiken und Grenzen. Tests zeigen die Anwesenheit von Fehlern, nicht ihre Abwesenheit. Eine unabhängige Sicherheitsprüfung ersetzt das nicht.
Stand. Umgesetzt.
Frage 80: Welche Funktionen müssen bereits im MVP vorhanden sein, welche sollten erst nach einer wissenschaftlichen Validierung entwickelt werden?
Antwort. Im MVP gehört alles, was beschreibt und sich nachrechnen lässt. Nach der Validierung kommt, was Vergleichbarkeit über Organisationen oder Aussagen über Wirkung verlangt. Gar nicht kommen sollte, was über Menschen entscheidet.
Grundlage. Die Befunde aus Teil A bis F und die rechtlichen Grenzen aus Teil H.
Empfehlung.
| Im MVP (im Prototyp vorhanden) | Nach Klärung der Rechte und erster Pilotierung | Erst nach wissenschaftlicher Validierung | Nicht vorgesehen |
|---|---|---|---|
| Repertory Grid mit neun Situationen | geprüfte Fragen an Stelle der Demonstrationsfragen | Normen und Vergleichswerte über Organisationen | Fit Wert, Prozentzahl der Eignung |
| eigenes Profil mit Konstrukten und Zusammenhängen | lizenziertes Werteinstrument oder eigene validierte Fragen | Verlaufsansichten über die Zeit | Rangfolge von Personen |
| Arbeitsorientierungen und Teamnormen als Demonstration | Anmeldung über das Verzeichnis der Organisation | Aussagen über Wirkung von Zusammensetzung | Vorhersage von Leistung oder Kultur |
| Team DNA mit Verteilung, Übereinstimmung, Lagern | Mehrsprachigkeit mit geprüfter Übersetzung | Gewichtung nach Rolle oder Einfluss | Unterstützung von Auswahl, Beförderung, Versetzung, Kündigung |
| Zielprofil mit unveränderlichen Fassungen | begleitete Auswertung von Konstrukten über Personen | ein empirisches Prognosemodell, falls überhaupt | Ableiten von Eigenschaften aus Texten durch KI |
| Simulator mit drei getrennten Perspektiven | KI Formulierungshilfe mit geklärtem Verarbeitungsort | Auswertung von Arbeitskommunikation | |
| Gesprächsanlässe und Formate für das Team | Unterlagenpaket für Datenschutz und Betriebsrat | ||
| Freigaben je Zweck, Export, Löschung, Protokoll | Löschkonzept und Verschlüsselung für echte Daten | ||
| vollständige Methodik mit Rechenwegen | Messung von Bearbeitungszeit und Abbrüchen | ||
| ausschließlich synthetische Daten | erste Nutzung mit echten Teams nur für Reflexion |
Alternativen. Ein schmalerer Einstieg nur mit Repertory Grid und eigenem Profil, ohne Teamfunktionen. Rechtlich am einfachsten, aber ohne den Kern der Idee.
Risiken und Grenzen. Der Schritt von der Demonstration zur ersten echten Nutzung ist größer, als die Software vermuten lässt: Er verlangt geprüfte Fragen, eine rechtliche Prüfung, eine Folgenabschätzung und eine Vereinbarung mit der Beschäftigtenvertretung.
Stand. Empfehlung auf Grundlage der Recherche.
Rückfrage. Welche der Schritte in der zweiten Spalte haben für Sie Vorrang? Davon hängt die Reihenfolge in Dokument 6 ab.