Systeme
Ein System führt die Repositories und Ressourcen zusammen, die eine Anwendung funktionsfähig machen. Es zeigt, was zusammengehört und wie die Teile voneinander abhängen. Ein Produkt kann zum Beispiel eine Web-App, eine API, eine Mobile-App und eine Datenbank umfassen.
Teile und Verbindungen
Ein System kann andere Systeme enthalten. Das Einlesen eines Repositorys erzeugt ein System dafür; Sie können es dann in ein größeres System zusammen mit verwandten Repositorys aufnehmen. Ressourcen stehen für Teile wie Datenbanken, Queues und externe APIs.
Teile beschreiben, was in einem System enthalten ist. Verbindungen beschreiben, wie diese Teile zusammenarbeiten: Eines nutzt eine API, stellt einen Dienst bereit oder hängt von einem anderen Teil ab. Das Gruppieren von Repositorys beschreibt diese Beziehungen nicht von selbst.
System erstellen
- Offen Systeme und wählen Sie System erstellen, oder dem + Schaltfläche, wenn Sie bereits Systeme haben.
- In System zeichnen, verwenden Sie Jetzt lesen für alle verbundenen Repositorys, die unter Noch nicht gelesen aufgeführt sind und die Sie aufnehmen möchten.
- Geben Sie dem System einen Namen und beschreiben Sie Was es ist. Wählen Sie seine Teile unter Systeme darinein und wählen Sie dann System erstellen.
Die Repositories lesen schlägt Gruppierungen vor, wenn Sie einen Ausgangspunkt benötigen. Sie entscheiden, welche Teile zusammengehören. Verwenden Sie Innerhalb eines anderen Systems wenn dieses System innerhalb eines größeren gehört.
Verbindungen finden
Öffnen Sie ein System, das Repository-Systeme enthält. Klicken Sie auf die teilungsförmige Symbol direkt links neben dem + Button in der Kopfzeile. Sein Tooltip lautet Verbindungen finden. SourceAnt liest deklarierte Abhängigkeiten und relevanten Code, um Beziehungen zwischen den Teilen vorzuschlagen. Die Arbeit läuft im Hintergrund, sodass Sie die Seite verlassen können, während sie fortgesetzt wird.
Die Fortschrittsmeldung zeigt an, wie viele Repositorys eingelesen wurden, und benennt alle, die nicht eingelesen werden konnten. Unveränderte Repositorys können ein früheres Einlesen wiederverwenden. Ein fehlgeschlagenes Einlesen bedeutet nicht, dass das Repository keine Verbindungen hat.
Die Belege prüfen
Entdeckte Verbindungen beginnen als ausstehend. In Verbindungen zum Ansehen, lesen Sie die Beziehung von links nach rechts: die Quelle, wie sie verbunden ist, und das Ziel. Prüfen Sie die zitierte Datei und den Codeauszug, bevor Sie Genehmigen oder Ablehnen.
Ein Vorschlag ist etwas zum Prüfen, keine bestätigte Beschreibung Ihres Systems. Zwei Teile können mehr als eine Beziehung haben, bewerten Sie daher jeden Vorschlag anhand seiner eigenen Belege.
Verwenden Sie Parts um das System als Liste zu durchsuchen, oder Architektur um seine Struktur visuell zu erkunden. Sie können auch Verbindungen manuell hinzufügen , wenn Sie von einer Beziehung wissen, die die Entdeckung nicht sehen kann.
Den Code hinter einem System untersuchen
Für ein repository-gestütztes System bietet Architektur auch Code-Komponenten, Klassen und Aufrufablauf. Verwenden Sie Daten und Externe Abhängigkeiten für andere Lesarten. Siehe Architektur-Prüfung für gezielte Abläufe, Abhängigkeitsmatrizen und lokale Snapshot-Vergleiche.
Systeme in Reviews verwenden
Das System-Review, auch repositoryübergreifendes Review genannt, nutzt diese Beziehungen, um einer Änderung in verwandte Repositorys zu folgen. Die Genehmigung unterscheidet bestätigte Verbindungen von Vorschlägen; sie entscheidet nicht darüber, ob ein Review ein anderes Repository erreichen kann.
Siehe System-Review für die Review-Einrichtung, den Umgang mit ausstehenden Verbindungen und das Vorgehen, wenn verwandter Code nicht eingelesen werden kann.