MVP-001-KNOWLEDGE-TERMINOLOGY-EXPLAINABILITY-SERVICE-CONTRACT

MVP-001 – Wissens-, Terminologie- und Erklärbarkeitsdienstvertrag#

Servicegrenzen#

Die Solution stellt logisch getrennte, gemeinsam komponierbare Verträge bereit:

• KnowledgeProviderRegistry: registriert Provider und deren Scope.
• KnowledgeAggregationService: vereinigt zulässige Artefakte unter Erhalt von Identität, ⌘HerkunftProvenienz beschreibt die nachvollziehbare Herkunft eines Wissenselements, einer Aussage oder einer abgeleiteten Darstellung., Owner und Revision.
• KnowledgePublicationService: erzeugt freigegebene Sichten nach Sprache, Rolle und Kontext.
• TerminologyResolutionService: löst stabile Begriffsreferenzen auf bevorzugte Bezeichnung, Kurzdefinition und Definition auf.
• HelpContextService: liefert kontextbezogene Hilfe für Commands, Views, Dialoge, Felder, Status und Workflow-Schritte.
• KnowledgeSearchService: sucht in veröffentlichten Wissensartefakten und liefert nachvollziehbare Treffergründe.
• ExplanationService: löst Reason Codes in lokalisierte Erklärungen, Referenzen und ⌘EvidenceTechnical documentation artifact. auf.

Verbindliche Regeln#

1. Jeder ⌘ServiceEin Service ist eine abgegrenzte bereitgestellte technische oder fachliche Leistung mit klarer Verantwortung. arbeitet auf stabilen Artefakt- und Revisionsidentitäten.
2. Berechtigungs-, Rollen-, Lifecycle- und Sprachfilter werden vor Veröffentlichung oder Auslieferung angewandt.
3. Suchranking darf Trefferrelevanz bestimmen, aber keine fachliche Wahrheit erzeugen.
4. Ein Suchtreffer enthält mindestens Identität, Revision, Typ, Sprache, Provider, Owner und begründende Match-Information.
5. Nicht auflösbare Terminologie-, Hilfe- oder Knowledge-Referenzen werden als explizite Fehler beziehungsweise Coverage Findings ausgegeben.
6. Provider liefern Inhalt und Metadaten; Rendering, globale Berechtigungsdurchsetzung und Ranking bleiben Service- beziehungsweise Workbench-Verantwortung.
7. Externe Quellen oder Connectoren sind nur über registrierte Provider und nachvollziehbare Provenance zulässig.
8. Glossarreferenzen werden vor dem Rendering aufgelöst; doppelte IDs, GUIDs oder Aliase sowie nicht auflösbare Referenzen führen zu sichtbaren Fehlern.
9. Der Terminology Service stellt Definitionen bereit, übersetzt und wendet sie an, übernimmt dadurch aber nicht deren fachliche Ownership.

Abgrenzung#

Konkrete API-Routen, Suchindizes, Datenbanktabellen und UI-Widgets sind Solution Design. Dieser Vertrag definiert ausschließlich die solutionweiten Ports und Verhaltensgrenzen.

Datenvertrag#

Siehe ◆Knowledge, Terminology and Explainability ModelKanonisches Solution-Modell für Wissen, Terminologie, Hilfe, Erklärungen und Nachweise..