COADF Engineering Companion
Von Architekturprinzipien zu konkreten Engineering-Mustern.
Nicht normativ
- Companion-Version
- 1.0
- Bezug zu COADF Core
- 2.2
- Status
- Aktuell
- Zuletzt geprüft
COADF benennt die Eigenschaften, die ein KI-System unter Governance einhalten muss. Dieser Companion zeigt, wie verschiedene Technologie-Stacks sie einhalten können, wo jede Umsetzung typischerweise bricht und wie sich belegen lässt, dass eine Eigenschaft gilt.
Der Technologie-Stack wechselt. Die Architektureigenschaft bleibt.
Bereiche
- Engineering-MusterFünf Muster, jedes um eine Architektureigenschaft herum aufgebaut.
- ImplementierungsprofileVier Technologie-Stacks, jeder auf dieselben Eigenschaften abgebildet.
- TechnologiematrixEine Eigenschaft pro Zeile, in jeder Spalte mit einer anderen Technologie umgesetzt.
- Technologie-NotizenKurze Korrekturen verbreiteter Kategorienfehler.
- VerifikationWas jede Testart belegen kann und was kein Test begründet.
Wie er sich zu COADF Core verhält
- COADF Core ist das Framework: technologieneutrale Prinzipien, Governance-Vorlagen, Kontrollen und eine Regulierungskarte. Es ist maßgeblich.
- Der Engineering Companion ist nicht normative Engineering-Orientierung. Wo er und COADF Core voneinander abzuweichen scheinen, gilt COADF Core.
- Engineering-Muster benennen jeweils eine Architektureigenschaft, mit den zugehörigen Strategien, Fehlermustern und Verifikationen, unabhängig von jeder Technologie.
- Implementierungsprofile setzen diese Eigenschaften in jeweils einem Technologie-Stack um.
- Technologie-Notizen korrigieren verbreitete Kategorienfehler.
- Referenzbeispiele sind klein, neu geschrieben und synthetisch. Sie veranschaulichen eine Eigenschaft und sind keine Produktionsimplementierungen.
Was jede Seite enthält
Jedes Muster nennt seine Architektureigenschaft, warum sie wichtig ist, zulässige Umsetzungsstrategien, Fehlermuster, Verifikation, alternative Umsetzungen und Grenzen.
Jedes Profil ergänzt die Technologiezuordnung, ein Referenzmuster, Abwägungen und das, was das Profil nicht begründet.
Welche Prinzipien er abdeckt
Die Muster decken P-1, P-4, P-6, P-7 und P-8 ab, und P-5 dort, wo die probabilistische Grenze die Extraktionsmethode mitführt. P-2 und P-3 erscheinen nur in der Tiefe, in der COADF selbst sie veröffentlicht: Darstellung auf Attributebene, eine Prüfung dort, wo sie erforderlich ist, die Quelle neben dem geprüften Wert und ein abgelehnter Wert, der leer bleibt. Wo COADF die operative Einzelheit eines Prinzips zurückhält, fügt der Companion nichts davon hinzu.
Sprachen
Der gesamte Companion erscheint in fünf Sprachen: die Navigation, der Überblick, die Muster, die Profile, die Matrix, die Notizen und die Seite zur Verifikation. Der Referenzcode wird in jeder Sprache so gezeigt, wie er getestet wurde.
Versionen
Der Companion wird unabhängig von COADF Core versioniert. Companion 1.0 bezieht sich auf COADF Core 2.2. Jedes Profil trägt eine eigene Version, und eine Änderung an einem Profil ändert COADF Core nicht. Der Status einer Seite lautet Aktuell, Überprüfung ausstehend oder Archiviert.
Grenzen
- Nichts im Companion wird von COADF vorausgesetzt.
- Die Referenzbeispiele dienen der Veranschaulichung. Sie wurden nur in der Referenzumgebung getestet, die ein Profil nennt, und an dem Tag, den es nennt.
- Das Profil für Java und Spring und das Profil für TypeScript und Node enthalten in Companion 1.0 keinen Code. Ihre Beispiele folgen in einer späteren Revision, nach einer Prüfung durch Fachleute aus diesen Ökosystemen.
- Nichts hier begründet die Einhaltung regulatorischer Anforderungen, eine Zertifizierung oder ein Verfahren zur Bewertung der Übereinstimmung mit Rechtsvorschriften.
Rechte
Veröffentlichungsrechte vorbehalten. Für den COADF Engineering Companion 1.0 und seine Referenzbeispiele wird derzeit keine öffentliche Lizenz erteilt.