Architektur-Änderungsanträge

Architektur-Änderungsanträge ermöglichen es Ihnen, Modifikationen an Ihrem C4-Modell über einen strukturierten Review-Workflow vorzuschlagen. Anstatt die Architektur direkt zu bearbeiten, erstellen Teammitglieder Antrage, die geprüft, diskutiert und gemergt werden können.

Funktionsweise

Ein Änderungsantrag gruppiert eine oder mehrere vorgeschlagene Änderungen an Ihrem Architekturmodell. Er folgt einem Lebenszyklus ähnlich wie ein Pull Request in Code-Repositories:

  1. Erstellen Sie einen Antrag mit Titel und Beschreibung
  2. Änderungen hinzufügen — C4-Elemente erstellen, aktualisieren oder löschen (Systeme, Container, Komponenten, Code-Elemente, Beziehungen, Overlays)
  3. Zur Prüfung öffnen wenn der Vorschlag bereit ist
  4. Prüfen — Teammitglieder genehmigen, fordern Änderungen an oder hinterlassen Kommentare
  5. Mergen um alle Änderungen auf die Architektur anzuwenden

Lebenszyklus eines Antrags

Jeder Antrag durchläuft diese Status:

Status Beschreibung
Entwurf In Bearbeitung. Nur der Autor kann Änderungen sehen und bearbeiten.
Offen Zur Prüfung eingereicht. Teammitglieder können prüfen und kommentieren.
Genehmigt Hat Genehmigungen erhalten und ist bereit zum Mergen.
Gemergt Änderungen wurden auf das Architekturmodell angewendet.
Geschlossen Abgelehnt oder aufgegeben. Kann vom Autor erneut geöffnet werden.

Einen Antrag erstellen

Über den Antrage-Tab

  1. Navigieren Sie zu Ihrem Projekt
  2. Öffnen Sie den Tab Antrage
  3. Klicken Sie auf Neuer Antrag
  4. Geben Sie einen Titel (max. 200 Zeichen) und eine optionale Beschreibung ein
  5. Der Antrag beginnt im Status Entwurf

Änderungen hinzufügen

Innerhalb eines Entwurfs oder offenen Antrags fügen Sie Änderungen hinzu, indem Sie auswählen:

  • Operation: Erstellen, Aktualisieren oder Löschen
  • Elementtyp: System, Container, Komponente, Code, Beziehung oder Overlay
  • Elementdaten: Die Eigenschaften des neuen oder geänderten Elements

Änderungen werden nach Operationstyp gruppiert (Erstellungen, Aktualisierungen, Löschungen) zur einfacheren Prüfung.

Einen Antrag bearbeiten

Der Autor kann den Titel und die Beschreibung eines Antrags jederzeit bearbeiten, solange er nicht gemergt wurde. Klicken Sie auf das Stift-Symbol neben dem Titel, um in den Bearbeitungsmodus zu wechseln.

Einen Antrag prüfen

Eine Prüfung einreichen

Teammitglieder mit Bearbeitungszugriff können offene Antrage prüfen:

  • Genehmigen — der Vorschlag ist zufriedenstellend
  • Änderungen anfordern — Anpassungen sind vor dem Mergen erforderlich
  • Kommentieren — Feedback ohne formelle Entscheidung hinterlassen

Aktivitats-Feed

Der Aktivitats-Tab zeigt alle Prüfungen und Kommentare in chronologischer Reihenfolge. Nutzen Sie den Kommentar-Composer unten, um schnelle Kommentare ohne formelle Prüfung zu hinterlassen.

Einen Antrag mergen

Wenn ein Antrag geprüft und genehmigt wurde:

  1. Öffnen Sie die Detailseite des Antrags
  2. Klicken Sie auf Mergen
  3. Alle Änderungen werden atomar auf das C4-Modell angewendet

Nur Teammitglieder mit Bearbeitungsrechten können Antrage mergen.

Änderungen vorab anzeigen

Der Tab Vorschau zeigt eine visuelle Darstellung der Architektur nach Anwendung der Änderungen, damit Prüfer die Auswirkungen vor dem Mergen verstehen können.

Best Practices

Schreiben Sie klare Titel

Verwenden Sie beschreibende Titel, die die Absicht erklären:

  • "Payment-Service und Stripe-Integration hinzufügen"
  • "Monolithische API in Benutzer- und Bestell-Services aufteilen"
  • "Veraltete Benachrichtigungs-Komponente entfernen"

Halten Sie Antrage fokussiert

  • Eine logische Änderung pro Antrag
  • Vermeiden Sie das Vermischen unzusammenhängender Modifikationen
  • Kleinere Antrage sind einfacher zu prüfen

Verwenden Sie Beschreibungen

Erklären Sie die Begründung hinter den vorgeschlagenen Änderungen:

  • Warum diese Architekturanderung notwendig ist
  • Welche Alternativen in Betracht gezogen wurden
  • Links zu zugehörigen ADRs oder Dokumentation

Prüfen Sie vor dem Mergen

  • Mindestens eine Genehmigung wird empfohlen
  • Nutzen Sie Kommentare, um Kompromisse zu diskutieren
  • Überprüfen Sie den Vorschau-Tab, um das Ergebnis zu validieren

Nächste Schritte