HUMAN-READABLE-CODE-CONTRACTS
Human-Readable Code Contracts#
Die Engineering Platform dokumentiert größere Implementierungsblöcke und fachlich relevante Use Cases direkt neben dem GlossarbegriffCode ist eine ausführbare oder interpretierbare technische Realisierung, die durch Tests und Runtime-Evidence überprüfbar bleibt.Glossareintrag vollständig lesen.
Aktuelle Anwendung#
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 Management besitzt:
- Code-ArtifactCodeansicht öffnen
application/create-artifact.mdapplication/save-revision.md- Go-Doc-Kommentare für öffentliche Domain-, Port-, Service- und Adapterverträge
- Verknüpfungen im
artifact-manifest.json
Die Dokumentation erklärt das Warum, Verantwortungen, Invarianten und Fehlerfälle. Sie ersetzt weder Tests noch den ausführbaren Code.