Was ist ein ADR (Architecture Decision Record) und warum braucht jedes SAP-Projekt einen?

Verfasst von

in

Kategorie: Architecture & Strategy | Lesezeit: ca. 4 Min.

In komplexen SAP-Transformations- und S/4HANA-Projekten stehen Architekten und Entwickler täglich vor wegweisenden Fragen: Nutzen wir RAP Managed oder Unmanaged? Implementieren wir die Geschäftslogik On-Stack oder Side-by-Side in CAP? Wie gestalten wir das Eventing über die SAP Integration Suite?

Oft werden diese Entscheidungen in langen Meetings getroffen, in E-Mails oder Teams-Chats besprochen – und sind sechs Monate später für das Team kaum mehr nachvollziehbar.

Hier kommen Architecture Decision Records (ADRs) ins Spiel: ein leichtgewichtiges, aber extrem wirkungsvolles Werkzeug für die Architekturdokumentation.

Was ist ein Architecture Decision Record (ADR)?

Ein Architecture Decision Record (ADR) ist ein kurzes, prägnantes Dokument, das eine einzelne, bedeutende Architekturentscheidung festhält. Es beschreibt nicht nur, was entschieden wurde, sondern vor allem warum und in welchem Kontext.

Gute ADRs sind:

  • Kurz und fokussiert: Meist nicht länger als 1–2 Seiten (Markdown/Text).
  • Historisch unveränderlich: Ein bestehendes ADR wird nicht überschrieben. Ändert sich die Architektur, ersetzt ein neues ADR das alte („ADR-005 supersedes ADR-002“).
  • Nah am Team: Idealerweise werden sie im Git-Repository oder zentralen Dev-Wiki als Plain-Text gespeichert.

Der klassische Aufbau eines ADRs

Ein bewährtes und simples Format ist das MADR-Schema (Markdown Architectural Decision Records):

  1. Titel & Status: Eindeutige Nummerierung, prägnanter Name und aktueller Status (Proposed, Accepted, Rejected, Superseded).
  2. Kontext (Context): Welches Problem muss gelöst werden? Welche Rahmenbedingungen (z. B. Clean Core Vorgaben, Budget, Performance) schränken uns ein?
  3. Betrachtete Optionen (Options): Welche Alternativen stehen zur Auswahl?
  4. Entscheidung (Decision): Welche Option wählen wir und warum?
  5. Konsequenzen (Consequences): Welche positiven Auswirkungen hat die Entscheidung und welche Kompromisse (Trade-offs) gehen wir bewusst ein?

Praxisbeispiel: ADR im SAP S/4HANA Context

Hier ist ein einfaches Beispiel für ein ADR aus der SAP-Praxis:

# ADR-003: Wahl der Extensibility-Strategie für Custom Partner-Logik

* Status: Accepted
* Datum: 2026-10-24
* Entscheider: SAP Architecture Team

## Kontext
Für ein neues Modul zur Partner-Validierung benötigen wir erweiterte Geschäftslogik. 
Gemäß unseren Clean Core Richtlinien sollen Modifikationen am SAP-Standard vermieden werden.
Die Logik erfordert Lese- und Schreibzugriff auf Business Partner Stammdaten.

## Betrachtete Optionen
1. Option 1: Classic ABAP Enhancement (User-Exit / BAdI direkt im Core)
2. Option 2: Developer Extensibility (RAP On-Stack Extension auf S/4HANA)
3. Option 3: Side-by-Side Extensibility (CAP App auf der SAP BTP)

## Entscheidung
Wir entscheiden uns für Option 2: Developer Extensibility (RAP On-Stack).

Begründung:
* Hohe Performance durch direkten DB-Zugriff ohne zusätzliche Netzwerk-Latenz.
* Vollständig Clean-Core-konform durch Nutzung freigegebener C1-Schnittstellen (Released APIs).
* Die Komplexität einer separaten BTP-Laufzeitumgebung ist für diesen Use Case nicht gerechtfertigt.

## Konsequenzen
* Positiv: Schnelle Umsetzung, volle Abdeckung durch RAP Framework.
* Negativ: Entwickler müssen im ABAP RESTful Application Programming Model geschult sein.

Warum ADRs die Zusammenarbeit im Entwicklerteam verändern

  • Kein „Warum haben die das damals so gebaut?“ mehr: Neue Entwickler oder Berater im Projekt verstehen sofort die Historie des Systems.
  • Weniger Grundsatzdiskussionen: Wenn eine Entscheidung einmal fundiert dokumentiert ist, muss sie nicht bei jedem Personalwechsel neu diskutiert werden.
  • Fokus auf Clean Core: ADRs zwingen dazu, Abweichungen vom SAP-Standard oder der Referenzarchitektur explizit zu begründen.

Fazit für sapdev.de

Auf diesem Blog werden Sie in Zukunft immer wieder ADR-Formate finden. Wenn wir konkrete Architekturdilemmata behandeln (z. B. OData v2 vs. v4, CAP vs. RAP oder Event Mesh vs. Direct Webhook), nutzen wir genau dieses Schema – kurz, transparent und nachvollziehbar.

Kommentare

Schreiben Sie einen Kommentar

Ihre E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert