Selbstpflegende Architekturaufzeichnung
Eine Architekturaufzeichnung, die Ihnen sagt, wenn sie gealtert ist
Jedes Architekturdiagramm ist an dem Tag genau, an dem es gezeichnet wird, und verfällt bis zum Ende der Woche. Das Problem war nie das Zeichnen. Das Problem ist, dass nichts Ihnen sagt, wann es nicht mehr zum Code passt.
Vom Diagramm zum aktuellen Eintrag
Das Diagramm im Wiki
- Das Diagramm wurde für ein Review vor zwei Umstrukturierungen gezeichnet
- Drei der darauf aufgeführten Services existieren nicht mehr
- Der Service, der letzten Monat den Checkout lahmgelegt hat, steht nicht darauf
- Niemand vertraut ihm, also aktualisiert es niemand, also vertraut ihm niemand
Der Eintrag in SourceAnt
- Jede Kante nennt das Manifest, aus dem sie gelesen wurde
- Ein veralteter Teil wird als stale markiert, nicht stillschweigend falsch
- Die Konfidenz ist eine Zahl, nach der Sie die Ansicht filtern können
- Das Genehmigen ist die Entscheidung eines Menschen, nach Ihrem Zeitplan
Die Teile und wie sicher sich das System bei jedem einzelnen ist
Services, Datenspeicher, Queues und die Kanten zwischen ihnen, wobei ausstehende Vorschläge getrennt von den von Ihrem Team unterzeichneten gehalten werden.
Vier Fragen, die früher ein Meeting erforderten
- Was berührt das noch?
- Durchlaufen Sie inbound von dem Teil aus, den Sie gerade ändern wollen, und erhalten Sie die Nachbarn zurück, begrenzt, sodass die Antwort vor einen Menschen oder ein Modell passt.
- Können wir das löschen?
- Nichts inbound und ein Status „retired" ist eine Antwort. Eine veraltete Kante, die Sie sich nicht angesehen haben, ist eine andere Antwort, und der Eintrag sagt Ihnen, welche Sie haben.
- Was ist das und wer ruft es auf?
- Dieselbe Traversierung liefert Antworten für eine neue Mitarbeiterin in der ersten Woche und für einen Agenten in seiner ersten Sitzung. Eine Abfrage, zwei Leser.
- Woher wissen wir das?
- Jede Entität und jede Beziehung trägt ihren Beleg: die Datei, das Manifest, die Revision. Ein Auditor erhält Zitate statt einer Tabellenkalkulation.
Was das nicht ist
Dieser Graph wird aus dem gelesen, was Ihre Repositories deklarieren, nicht aus Live-Traffic. Er sagt Ihnen, was von was abhängt, bevor Sie deployen. Er zeigt Ihnen keinen Aufruf, der nur zur Laufzeit über Konfiguration oder Service Discovery geschieht. Wenn Sie ein Tracing-Tool betreiben, beantworten die beiden unterschiedliche Fragen, und beide sind es wert, vorhanden zu sein.
Setzen Sie Ihr System auf den Eintrag
Betreiben Sie den Open Core auf Ihrer eigenen Infrastruktur oder starten Sie im gehosteten Workspace. Der Graph ist in beiden Fällen portabel.