Kostenloses Tool
ADR Generator
Architecture Decision Records mit strukturiertem Formular erstellen. Markdown-Vorschau, PDF-Export. Das Standard-ADR-Template für Engineering-Teams.
Beispiel-ADR
Ein Backend-Team entscheidet, wie die API-Authentifizierung für einen neuen Microservice gehandhabt wird.
ADR-003: JWT für Service-zu-Service-Authentifizierung verwenden
Kontext
Unser neuer Bestell-Service muss Anfragen von vier internen Services authentifizieren. Der aktuelle Ansatz verwendet geteilte API-Keys in Umgebungsvariablen. Mit steigender Anzahl an Services wird das Verwalten und Rotieren geteilter Keys fehleranfällig und schwer zu auditieren.
Entscheidung
Wir verwenden kurzlebige JWTs, signiert mit RS256, für die Service-zu-Service-Authentifizierung. Jeder Service bekommt ein eigenes Key-Paar. Tokens laufen nach 5 Minuten ab.
Konsequenzen
Positiv
- Keine geteilten Secrets, die über Services rotiert werden müssen
- Token-Ablauf begrenzt den Schadenszeitraum bei Token-Leak
- Standard-JWT-Libraries in allen unseren Sprachen verfügbar
Negativ
- Erhöhte Komplexität: Jeder Service braucht Key-Management
- Clock-Skew zwischen Services kann zu falschen Ablehnungen führen
- Team muss JWT-Validierung und Key-Rotation lernen
Entscheidung im Team treffen?
DecTrack gibt Teams einen Ort, um gemeinsam zu entscheiden: Optionen definieren, Perspektiven sammeln, Konsens festhalten.
Häufig gestellte Fragen
- Ein ADR ist ein kurzes Dokument, das eine einzelne Architekturentscheidung festhält. Es dokumentiert den Kontext, die Entscheidung selbst und ihre Konsequenzen, damit zukünftige Teammitglieder verstehen, warum die Codebasis so aufgebaut ist.
- Dieses Tool folgt dem weit verbreiteten Template von Michael Nygard: Titel, Status, Kontext, Entscheidung und Konsequenzen. Es ist das gleiche Format, das die meisten Open-Source-Projekte und Engineering-Organisationen verwenden.
- Schreibe ein ADR, wenn du eine technische Entscheidung triffst, die schwer rückgängig zu machen ist oder andere Teammitglieder betrifft. Beispiele: Datenbankwahl, Framework-Adoption, API-Design-Änderung oder Deployment-Strategie.
- Best Practice ist die Ablage im Code-Repository, typischerweise in einem docs/adr/ oder doc/architecture/decisions/ Ordner. So bleiben Entscheidungen nah am Code und werden Teil des Code-Reviews.
- Ein ADR konzentriert sich auf technische und architektonische Entscheidungen und folgt einem spezifischen Template (Kontext, Entscheidung, Konsequenzen). Ein Entscheidungs-Protokoll ist breiter und deckt jede Art von Teamentscheidung ab (Personal, Prozesse, Anbieter). Beide dienen dem gleichen Ziel: Entscheidungskontext für die Zukunft bewahren.
- Ja. Du kannst den Markdown-Output direkt kopieren oder ein gebrandetes PDF exportieren. Das Markdown ist bereit zum Einfügen in dein Repository.
Passend aus dem Blog
Weitere kostenlose Tools
Entscheidungs-Protokoll
Kontext, Optionen, Begründung und nächste Schritte für jede Teamentscheidung festhalten. Als PDF exportieren und mit Stakeholdern teilen.
Entscheidungsmatrix
Kriterien definieren, Gewichte vergeben und Optionen bewerten, um einen klaren, datengetriebenen Gewinner zu erhalten. Auch bekannt als Nutzwertanalyse.
Pro/Contra-Liste
Vor- und Nachteile auflisten, gewichten und die Punkte zeigen dir die beste Wahl. Der schnellste Weg, jede Entscheidung zu durchdenken.