MVP-001-KNOWLEDGE-AND-EXPLAINABILITY-COMPONENT-CONTRACT

MVP-001 – Wissens- und Erklärbarkeits-Komponentenvertrag#

Komponentenbeiträge#

Workbench Shell#

• trägt CommandId, HelpContextId und sprachneutrale ReasonCode-Referenzen;
• fordert Hilfe und Erklärungen kontextbezogen an;
• stellt fehlende oder gesperrte Funktionen mit nachvollziehbarem Grund dar;
• übernimmt keine fachliche Inhaltshoheit.

Knowledge Panel#

• zeigt freigegebene Hilfe, Glossar, Learning Nuggets, Beispiele und Referenzen;
• erhält den aktuellen Command-, View-, Selection-, Rollen- und Sprachkontext;
• macht Quelle, Revision und Status zugänglich;
• kennzeichnet Fallback, veraltete und reviewpflichtige Inhalte.

Contribution Framework#

• erlaubt Building Blocks, Commands, Views, Help Contexts und Knowledge Provider deklarativ zu registrieren;
• validiert stabile IDs und Referenzen vor Aktivierung;
• filtert Contributions anhand von Policy, Rolle, Lifecycle und Kontext.

Administration and Review#

• unterstützt Pflege, Vergleich, Übersetzung, Review, ⌘FreigabeEin Release ist ein bewusst freigegebener und nachvollziehbarer Stand von Artefakten und ihrer Realisierung. und Deprecation;
• bleibt als Solution-Komponente vom fachlichen Owner der Inhalte getrennt.

Verbotene Kopplungen#

• UI-Komponenten dürfen keine zweite lokale Terminologiequelle aufbauen.
• Help-Texte dürfen nicht ausschließlich im Frontend hart verdrahtet sein.
• Building Blocks dürfen globale Suche, Reason Codes oder Provider-Registry nicht jeweils inkompatibel neu implementieren.

Verweise#

• ◆Workbench Interaction ContextTechnical documentation artifact.
• ◆Service ContractServicevertrag für Provider, Auflösung, Suche, Hilfe und Erklärungen.
• ◆Contribution FrameworkArchitektur des rollenbasierten und personalisierbaren Contribution Frameworks der Engineering Workbench.