Záznam rozhodnutí o architektuře
Záznam rozhodnutí o architektuře architektury je jedním z nejdůležitějších výsledků architekta řešení. Tento záznam dokumentuje rozhodnutí o architektuře, která v průběhu procesu návrhu provedete. Poskytuje také kontextové odůvodnění a důsledky pro každé rozhodnutí.
ADR dokumentuje všechna klíčová rozhodnutí, včetně alternativ, které jste vyloučili, pro architektonicky významné požadavky. Protokol zahrnuje požadavky a omezení do zdokumentovaných účinků rozhodnutí.
Implementace ADR
Spusťte ADR na nástupu úlohy a udržujte ji po celou dobu životnosti úlohy. Pro úlohy brownfieldu by se mělo začít sdružovat a pokud jsou data dostupná, měla by se zpětně generovat na základě známých minulých rozhodnutí. ADR slouží jako protokol jen pro připojení. Tento záznam přesahuje počáteční návrh, aby zahrnoval aspekty návrhu proti budoucím funkčním a nefunkčním požadavkům.
Navrhované charakteristiky jednotlivého záznamu
Být konzistentní s anatomií každého záznamu. Navrhujte šablonu záznamu a konzistentně ji sledujte.
Záznam by měl obsahovat konzistentní prvky, jako jsou:
- Příkaz problému s kontextem
- Možnosti považované za
- Výsledek rozhodnutí
- Zahrnout důležité kompromisy provedené s tímto rozhodnutím
- Zaznamená úroveň spolehlivosti rozhodnutí. Někdy je architektonické významné rozhodnutí učiněno s relativně nízkou důvěrou. Zdokumentování stavu nízké důvěry může být užitečné pro budoucí rozhodnutí o znovuhodnocení.
Rozdělte jedno rozhodnutí na několik, pokud rozhodnutí o architektuře povede k několika fázím, jako jsou krátkodobé, střední a dlouhodobé přístupy. Zaznamenejte jednotlivé fáze jako vlastní záznam rozhodnutí.
Vyhněte se skrytí důsledků rozhodnutí úmyslně nebo omylem.
Udržujte záznamy pithy, assertive, on-topic, a fakt.
Vyhněte se průvodcům návrhu rozhodovacích záznamů. Pokud je k dispozici více odůvodnění nebo návrhu, uveďte odkaz na dokument jako doplňkový materiál, ale rozhodnutí musí být jasné a samostatné bez daného materiálu.
Úložiště dokumentace k úlohě
Tento protokol by měl být snadno dostupný a volně uložený v dokumentaci k úloze.
Architekt může týmu úloh pomoct dosáhnout doporučení efektivity provozu tím, že pomáhá vytvořit a udržovat úložiště dokumentů a prostředků. Architekti pomáhají týmům umístit všechny své prostředky do úložiště, jako je například tento protokol rozhodnutí. Podporují také jednotné přijetí jediného zdroje pravdivých informací, které týmy používají pro referenci, audity a reakce na incidenty.
Další kroky
Další materiály
Příklady šablon najdete v organizaci GitHubu s rozhodovacími záznamy architektury.