Zum Inhalt springen

Einen Architecture Decision Record (ADR) erstellen

Das ADR-Modul speichert Ihre Architekturentscheidungen in nummerierter, nachvollziehbarer Form.

  1. Gehen Sie zu ADR → Neue Entscheidung.
  2. Schreiben Sie einen Titel; AppArch vergibt eine automatische, fortlaufende Nummer (z. B. ADR-0007).
  3. Schreiben Sie den Inhalt in Markdown - mit den Abschnitten Kontext, Entscheidung und Konsequenz:
## Kontext
Wir brauchen asynchrone Kommunikation zwischen den Services.
## Entscheidung
RabbitMQ wird als Event-Queue eingesetzt.
## Konsequenzen
Der Betriebsaufwand steigt; ersetzt ADR-0003.
  1. Speichern - der Datensatz wird im Status „Vorgeschlagen” erstellt.

Der MADR-Lebenszyklus: Vorgeschlagen → Akzeptiert → Abgelehnt → Abgelöst. Verwenden Sie in der Entscheidungsdetailansicht Status ändern, um zu wechseln; jeder Übergang wird protokolliert.

Wenn eine Entscheidung eine andere ablöst, wählen Sie im Feld „Löst ab” des Datensatzes den betreffenden ADR aus. Die Verknüpfung bleibt erhalten; die alte Entscheidung wird als „Abgelöst” markiert, und die Antwort auf „Warum hat sich das geändert?” ist stets griffbereit.

Verwenden Sie ADR → Export, um alle Datensätze als JSON, CSV oder Markdown-ZIP herunterzuladen - bereit für Audit und Sicherung.