가끔 ADR(architectural decision record) 작성이 필요한데, 관련 양식 및 내용을 정리해둘 목적으로 글을 작성합니다.(다시 소프트웨어 엔지니어 책의 내용 발췌)
- 제목
- 세 자리 일련번호를 접두어로 붙인 결정 내용의 설명
- 일렵번호 덕분에 ADR을 순서대로 정렬할 수 있어서 현재까지의 경로를 빠르게 파악 가능
- 상태
- 의견 요청 : 팀과 관련 이해 관계자가 적극적으로 검토 중인 ADR
- 제안: 승인을 기다리는 작업 중인 ADR
- 승인: 검토를 마치고 채택된 ADR
- 대체: ADR은 수정할 수 없지만, 나중의 ADR이 이전 ADR을 대체 가능
- 맥락
- 모든 결정에는 제약 조건과 고유한 상황이 수반된다. 예를 들어 CIO가 선호하는 업자 목록이 있어서 선택지가 인위적으로 제한될 수 있음
- 선택지
- 어떤 선택지를 고려했는가? 고려 대상에서 제외한 것이 있다면 왜 그랬는지?
- 결정
- 무엇을 하기로 결정했는가? 왜 그렇게 결정했는가?(정보가 많은 쪽이 낫다)
- 결과
- 거버넌스
- 결정이 실제로 지ㅕ지도록 어떻게 보장할 것인가?
- 이 ADR을 강제하기 위해 어떤 적합도 함수를 만들 것 인가?
- 비고