ADRy czyli z angielskiego Architectural Decision Record to po prostu opis decyzji architektonicznej. Składa się on w podstawowej wersji z następujących sekcji:
– tytułu
– statusu
– kontekstu
– decyzji
– konsekwencji
Tytuł
Jak to tytuł – powinien w zwięzły sposób opisywać decyzję. Ale powinien także zawierać trzy-liczbowy numer. Przykładowo:
014: Użycie grafowej bazy danych
Status
ADR może posiadać wiele statusów. Najczęściej spotykane to:
– Request for Comment (RFC) – Prośba o komentarz – tutaj jest czas na komentarze
– Proposed – Zaproponowany – tutaj dostajemy zgody
– Accepted – Zaakceptowany – no i mamy zgodę
– Superseded by … – Zastąpiony przez … – gdy jeden ADR jest zastąpiony przez inny (także dodajemy Supersedes … – Zastępuje … w ADR zastępującym)
Kontekst
Opisuje sytuację i dostępne opcje. Przykładowo:
Musimy wspierać złożone relacje pomiędzy obiektami.
Mamy dostępne bazy relacyjne i grafowe.
Decyzja
Tutaj opisujemy jaką decyzję podejmujemy i dlaczego. Przykładowo:
Użyjemy bazy grafowej.
Bazy grafowe pozwalają na łatwe tworzenie skomplikowanych relacji pomiędzy obiektami.
Konsekwencje
Jak to zwykle w życiu bywa, każda decyzja ponosi za sobą jakieś konsekwencje. Przykładowo:
Grafowe bazy danych gorzej radzą sobie ze złożonymi transakcjami, dodatkowo w drużynie nikt jeszcze nie używał baz grafowych.