SE-0102-TARGET-STRUCTURE-REVIEW
Zielstruktur-Review für Baselines und Reference Artifacts#
Anlass#
Im Enterprise-Repository existieren zwei gleich nummerierte Bereiche: 95-baselines und 85-reference-artifacts. Ihre fachlichen Aufgaben sind verschieden und ihre gleichartige Nummerierung erschwert Orientierung, Navigation und spätere Referenzen.
Die Zielstruktur wurde freigegeben und umgesetzt. Dateien des historischen Doppelpfads wurden in 85-reference-artifacts konsolidiert; ihre Inhalte und fachlichen Identitäten wurden nicht umgedeutet.
Inventar#
| Heutiger Bereich | Bestand | Fachliche Aufgabe |
|---|---|---|
95-baselines |
README und SE-0022-semantic-inventory-knowledge-baseline.md |
zeitlich freigegebener, reproduzierbarer Referenzstand |
85-reference-artifacts/reference-artifact |
ein Referenzartefakt | allgemeine, wiederverwendbare Artefaktdefinition |
85-reference-artifacts/reference-model |
Modelle für Verträge, GlossarbegriffTechnical documentation artifact.Glossareintrag vollständig lesen, Qualität, Realisierung und Speicherung | lösungsneutrale Erklärungs- und Referenzmodelle |
85-reference-artifacts/reference-process |
Knowledge-Evolution-Process | wiederverwendbarer Ablauf |
85-reference-artifacts/reference-pattern |
Referenzpattern | wiederverwendbarer Lösungsansatz |
85-reference-artifacts/reference-building-block |
Bootstrap- und Knowledge-Management-Bausteine | lösungsneutrale Architekturbausteine |
85-reference-artifacts/engineering-findings |
EF-001 bis EF-011 | validierte, wiederverwendbare Erkenntnisse aus Engineering und Betrieb |
Abgenommene Zielstruktur#
enterprise-architecture/
├── 85-reference-artifacts/
│ ├── README.md
│ ├── engineering-findings/
│ ├── reference-artifact/
│ ├── reference-building-block/
│ ├── reference-model/
│ ├── reference-pattern/
│ └── reference-process/
├── 95-baselines/
│ ├── README.md
│ └── SE-0022-semantic-inventory-knowledge-baseline.md
├── 96-architecture-decisions/
├── 97-standards/
├── 98-glossary/
└── 99-reports/
Begründung#
95-baselines bleibt unverändert, weil die Nummer die späte, zeitpunktbezogene Referenz- und Freigabefunktion angemessen ausdrückt.
85-reference-artifacts erhält einen eigenen, vor Governance und zeitpunktbezogenen Baselines liegenden Bereich. Reference Artifacts sind keine Snapshots und keine Reports: Sie stellen wiederverwendbare GlossarbegriffBedeutung beschreibt den fachlichen Sinn eines Elements und seine Relevanz für Menschen und Organisationen.Glossareintrag vollständig lesen, Modelle, Muster, Prozesse und Bausteine bereit, die andere Ebenen nutzen.
Die Engineering Findings verbleiben in diesem Bereich. Ihre einzelnen Auslöser liegen in konkreter Runtime- oder Engineering-Evidence, ihre verallgemeinerte Aussage ist jedoch wiederverwendbares Architekturwissen. Ein reiner Report wäre dagegen an einen einzelnen Lauf, Zeitpunkt oder Befund gebunden.
Bestätigte Entscheidungen#
85-reference-artifactsist der führende Zielpfad.- Engineering Findings bleiben als wiederverwendbares Wissen unter
85-reference-artifacts/engineering-findings.
95-baselinesbleibt ausschließlich für freigegebene Referenzstände,
ohne allgemeine Modelle oder Prozesse.
- Es werden keine Weiterleitungen und keine zentrale Migrationskarte für
historische Pfade bereitgestellt.
Ausführungsnachweis#
- Der Verzeichnisbaum wurde atomar nach
85-reference-artifactsverschoben. - Interne Markdown-, JSON- und Manifestpfade innerhalb der Enterprise
Architecture verwenden den neuen Pfad.
- Der historische Doppelpfad ist nicht mehr vorhanden;
95-baselinesbleibt
unverändert erhalten.
- Eine lokale Renderprobe publiziert den Bereich unter
85-reference-artifacts/ und erzeugt 253 Seiten.