ENGINEERING-FINDINGS
Engineering Findings#
Zweck#
Engineering Findings verwandeln reale Erfahrungen in wiederverwendbares Architekturwissen.
Sie ergänzen Architecture Decisions, Principles, Learning Nuggets und Verification GlossarbegriffTechnical documentation artifact.Glossareintrag vollständig lesen.
Vertrag#
Führendes Modell:
../reference-model/engineering-finding-model.md
Führender Prozess:
../reference-process/knowledge-evolution-process.md
Aktuelle Findings#
| ID | Titel | Kategorie | Reifegrad |
|---|---|---|---|
| EF-001 | Runtime is not a Source Repository | Runtime | Institutionalized |
| EF-002 | Storage Class determines permitted operations | Storage | Institutionalized |
| EF-003 | GlossarbegriffEine Materialisierung ist die technisch erzeugte und persistierte Darstellung einer Projektion. Beispiele sind JSON, HTML, Markdown, PDF, Suchindex, Diagrammdatei, Runtime-Ressource oder Report. Materialisierungen sind abgeleitet und dürfen fachlich nicht zum Single Point of Truth werden.Glossareintrag vollständig lesen without Verification is incomplete | Verification | Institutionalized |
| EF-004 | Administrative and application database identities must be separated | Bootstrap | Validated |
| EF-005 | User systemd services must not depend on system services | Deployment | Institutionalized |
| EF-006 | Port ownership must be verified before restart | Deployment | Institutionalized |
| EF-007 | Import success is not Engineering success | Roundtrip | Institutionalized |
| EF-008 | Execution Evidence is an architecture 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 | Evidence | Institutionalized |
| EF-009 | Roundtrip must execute and verify the deployed system | Roundtrip | Institutionalized |
| EF-010 | Deployment is a coordinated runtime transaction | Deployment | Institutionalized |
Kategorien#
- Runtime und Storage
- Bootstrap und Configuration
- Deployment und Betrieb
- Roundtrip und Verification
- Evidence und Knowledge Evolution
Nutzung#
Bei Arbeiten an betroffenen Building Blocks müssen relevante Findings gelesen und referenziert werden. Ein behobener Fehler löscht das GlossarbegriffTechnical documentation artifact.Glossareintrag vollständig lesen nicht; er erhöht dessen Reifegrad und ergänzt Evidence.
| EF-011 | Invisible state transitions block engineering | Observability | Institutionalized |
|---|