Beslutspost för arkitektur
En beslutspost för arkitektur (ADR) är en av de viktigaste slutprodukterna för en lösningsarkitekt. Den här posten dokumenterar arkitektoniska beslut som du fattar under hela designprocessen. Det ger också sammanhangsspecifika motiveringar och konsekvenser för varje beslut.
ADR dokumenterar alla viktiga beslut, inklusive alternativ som du uteslöt, för arkitektoniskt viktiga krav. Loggen innehåller krav och begränsningar i de dokumenterade effekterna av ett beslut.
Implementera en ADR
Starta adr vid början av en arbetsbelastning och underhålla den under hela arbetsbelastningens livslängd. En adr ska startas för brownfield-arbetsbelastningar, och om data är tillgängliga bör de genereras retroaktivt baserat på kända tidigare beslut. ADR fungerar som en tilläggslogg. Den här posten sträcker sig bortom den ursprungliga designen och omfattar designaspekter mot framtida funktionella och icke-funktionella krav.
Föreslagna egenskaper för en enskild post
Var konsekvent med varje posts anatomi. Utforma en postmall och följ den konsekvent.
En post bör innehålla konsekventa element som:
- Problemuttryck med kontext
- Alternativ som övervägs
- Beslutsresultat
- Inkludera viktiga kompromisser som gjorts med det här beslutet
- Registrera konfidensnivån för beslutet. Ibland fattas ett arkitektoniskt betydelsefullt beslut med relativt låg konfidens. Att dokumentera den låga konfidensstatusen kan vara användbart för framtida beslut om omprövning.
Dela upp ett beslut i flera om ett arkitekturbeslut kommer att resultera i flera faser, till exempel kortsiktiga, långsiktiga metoder på medellång sikt. Logga varje fas som en egen beslutspost.
Undvik att dölja konsekvenserna av beslut avsiktligt eller av misstag.
Spara ynkliga, självsäkra, ämnesspecifika och faktiska uppgifter.
Undvik att skapa designguider för beslutsposter. Om det finns mer motivering eller designidé kan du tillhandahålla en länk till ett dokument som kompletterande material, men beslutet måste vara tydligt och fristående utan det materialet.
Lagringsplats för arbetsbelastningsdokumentation
Den här loggen ska vara lättillgänglig och lagras öppet med arbetsbelastningens dokumentation.
En arkitekt kan hjälpa ett arbetsbelastningsteam att få rekommendationer om operational excellence genom att hjälpa till att upprätta och underhålla ett dokument- och tillgångslager. Arkitekter hjälper team att placera alla sina tillgångar i lagringsplatsen, till exempel den här beslutsloggen. De uppmuntrar också teamens enhetliga införande av en enda sanningskälla som ska användas för referens, granskningar och incidenthantering.
Nästa steg
Fler resurser
Exempel på mallar finns i GitHub-organisationen Architectural Decision Records.