Aktualisierung der Diagramme der logischen und physischen Architektur

11

In jedem Softwareentwicklungsprojekt, an dem verteilte Systeme mit mehreren Entwicklern beteiligt sind, ist es empfehlenswert, Diagramme mit logischer und physischer Architektur zu haben. Nach meiner Erfahrung werden diese Diagramme jedoch zu Beginn eines Projekts immer gut gepflegt, aber nicht aktualisiert, wenn das Projekt veröffentlicht wird und die Wartungsphasen beginnen.

Bei komplexen Projekten mit vielen verteilten Prozessen sind die Diagramme bereits vor der ersten Veröffentlichung sehr schnell veraltet oder ungenau, da niemand über das gesamte Wissen verfügt.

Vor diesem Hintergrund möchte ich der Community folgende Fragen stellen:

  1. Wie wichtig sind genaue und aktuelle Diagramme der logischen und physischen Architektur?
  2. Gibt es Tools und Prozesse, die helfen können, sie auf dem neuesten Stand zu halten?
  3. Wer sollte dafür verantwortlich sein, sie auf dem neuesten Stand zu halten? Wie können Systemadministratoren, Entwickler und QS-Teams dazu beitragen?
ARau
quelle
Der Artikel schlägt vor, dass diese Teil der "lieferbaren Dokumentation" sein sollten, damit ihr Bedeutung beigemessen wird. Sollten dies Elemente sein, die als Teil des Rückstands erstellt und Teil des Liefergegenstandes sind?
ARau

Antworten:

5

Ich lebe in der realen Welt mit Zeitbeschränkungen und Ressourcenproblemen, daher verstehe ich, warum die meisten Softwaredokumentationen entweder ignoriert oder veraltet sind, aber selbst unter diesen Bedingungen bestehe ich unbedingt darauf, dass Datenbankdiagramme erstellt und auf dem neuesten Stand gehalten werden. Wenn es sich nicht um ein gewöhnliches relationales Modell handelt und aus Entitäten mit Dokumenten, Schlüssel-Wert-Paaren oder JSON / XML-Strukturen besteht, sollte auch ein Objektmodell dieser Elemente erstellt und verwaltet werden. Wenn alles andere bei den Dokumentationsbemühungen eines Projekts fehlschlägt, können Sie zumindest anhand eines Datenbankdiagramms und / oder eines Objektmodells rückwärts zum Front-End arbeiten, um herauszufinden, was los ist.

Es gibt zahlreiche Optionen zum Erstellen und Verwalten von Softwaredokumenten, aber einer meiner Favoriten ist Enterprise Architect. Es ist umfassend und verknüpft Anwendungsfälle, Sequenzdiagramme, Klassendiagramme und andere.

Ich halte es für eine Teamleistung, wer dafür verantwortlich ist. Nur wenige Menschen genießen es sehr, aber es muss getan werden. Der Architekt oder technische Leiter eines Projekts sollte letztendlich dafür verantwortlich sein und die Aufgaben angemessen delegieren.

David Spenard
quelle