CON-018-PRESENTATION-DIMENSION
Vertrag für Präsentationsdimensionen#
Zweck#
presentation_dimension ist eine zusätzliche Metadatenangabe für die menschenorientierte Reportdarstellung. Sie ersetzt weder artifact_type noch fachliche Relationships. Sie bestimmt ein primäres Seitenbadge und spätere Einstiegs- beziehungsweise Interaktionsmöglichkeiten.
Zulässige Primärwerte#
| Wert | Verwendung |
|---|---|
meaning |
Visionen, Capabilities, Prinzipien, Requirements, Decisions, Learning und andere Seiten, die GlossarbegriffBedeutung beschreibt den fachlichen Sinn eines Elements und seine Relevanz für Menschen und Organisationen.Glossareintrag vollständig lesen, Ziel oder Begründung behandeln. |
| GlossarbegriffEin Artefakt ist jede eindeutig identifizierbare fachliche, technische, organisatorische oder reale Einheit, die in der Engineering-Landschaft modelliert wird. Alles Modellierbare wird als Artefakt geführt. Dazu gehören unter anderem Systeme, Beziehungen, Features, Dokumente, ADRs, Tests, UI-Buttons, Menüs, Farben, Icons, Konfigurationen, Diagramme, Runtime-Ressourcen, fachliche Objekte und reale Objekte wie ein Blumentopf, sofern sie modelliert werden. Knowledge ist keine Sonderklasse. UI- und Applikationsartefakte werden fachlich nach demselben Grundmodell behandelt.Glossareintrag vollständig lesen | Building Blocks, Components, Services, GlossarbegriffCode ist eine ausführbare oder interpretierbare technische Realisierung, die durch Tests und Runtime-Evidence überprüfbar bleibt.Glossareintrag vollständig lesen, konkrete Dokumentations- oder Lösungsartefakte. |
| GlossarbegriffEine Beziehung beschreibt eine nachvollziehbare Verbindung zwischen Bedeutungen, Artefakten und ihrem Kontext.Glossareintrag vollständig lesen | Seiten, deren Gegenstand die Verbindung, Zuordnung, Traceability oder Abhängigkeit zwischen Elementen ist. |
context-time |
Seiten zu Kontext, Zeit, GlossarbegriffTechnical documentation artifact.Glossareintrag vollständig lesen, Feedback, Ausführung, historischer Gültigkeit oder Rückführung. |
structure |
Gruppierungs- und Orientierungsdokumentation für Verzeichnisse, Pakete, Kataloge oder Navigationsbereiche. |
control |
Steuernde Dokumente wie AI_STARTS_HERE, Development Guides, Arbeitsanweisungen oder später katalogisierte Manifeste/JSON-Konfigurationen. |
report |
Konkrete Reports, Summaries, Validierungs- und Änderungsnachweise. |
Regeln#
- Ein Dokument erhält höchstens eine Primärdimension.
artifact_typebleibt unverändert führend für den technischen und fachlichen Typ.- Beziehungen zu weiteren Dimensionen werden als Relationships modelliert, nicht als Mehrfachbadge.
- Ohne eindeutige Zuordnung bleibt
presentation_dimensionzunächst leer und der Inventurbefund sichtbar. - Das spätere Badge ist zugänglich: Icon, Textlabel und Tooltip müssen dieselbe Information vermitteln.
- Jede
README.mdist primärstructure, weil sie den zugehörigen Bereich erklärt und gruppiert. - Architekturentscheidungen sind primär
meaning: Sie erklären, warum eine Entscheidung gilt, nicht das konkret materialisierte Element. reporttrennt einen konkreten Nachweis oder eine Zusammenfassung voncontext-time, das den fachlichen Zusammenhang von Zeit, Evidence und Feedback erklärt.- SE-0086 inventarisiert nur Markdown-Dokumente. JSON- und andere Steuerungsdateien werden erst nach einem eigenen Katalogvertrag als
controlaufgenommen; sie erhalten in diesem Schritt kein implizites Badge.
Historische Grundlagen#
Die Quellen ARCH-FOUNDATION-WISSENSARCHITEKTUR-GRUNDLAGEN.md und Platform_Vision.md sind als historische Grundlagen registriert. Ihre inhaltliche Übernahme erfolgt erst im getrennten SE-0090 mit Herkunftsnachweis.