ADR (Architecture Decision Records) 아키텍쳐 결정 레코드

 

업무를 하다보니, 아키텍쳐 결정 레코드에 대한 니즈를 절실히 느껴 이를 만들고 관리하기로 했습니다. 

 

템플릿을 공유합니다. 

 

# 해결된 문제 및 솔루션의 짧은 제목 <!— 필수 —>

## Context and Problem Statement 상황 및 문제 설명 <!— 필수 —>
<!— 컨텍스트와 문제를 설명합니다.
ex) 2~3개의 문장을 사용하는 자유형식 또는 이야기 형식
문제를 명확히 설명하고 협업 게시판이나 issue management system링크를 추가할 수 있습니다. —>

## Decision Drivers 의사결정 동인 <!— 옵셔널 —>
* …

## Considered Options 고려된 옵션 <!— 필수 —>
1. 
2. 
…

## Decision Outcome 결정 결과 <!— 필수 —>
선택한 옵션과 그 이유

### Consequences 결과 <!— 필수 —>
* Good, 이유 
* Bad, 이유
* Neutral, 이유 (Neutral : 좋지도 나쁘지도 않은 경우)
… 

### Confirmation 확인 <!— 옵션 —>
<!— ADR을 구현하고 준수하는 것을 어떻게 확인하는지 설명합니다.
ex) 리뷰 또는 ArchUnit 테스트 
옵셔널이지만 대부분의 ADR에 포함됩니다. —>

## Pros and Cons of the Other Options 다른 옵션의 장단점 <!— 옵션 —>

### 옵션1
* Good, 이유 
* Bad, 이유
* Neutral, 이유 (Neutral : 좋지도 나쁘지도 않은 경우)
… 

### 옵션2
* Good, 이유 
* Bad, 이유
* Neutral, 이유 (Neutral : 좋지도 나쁘지도 않은 경우)
… 

## More Information 추가 정보 <!— 옵션 —>

<!— 결과에 대한 추가적인 증거, 근거를 제공할 수 있습니다.
결정이 실현되어야 하는 시기와 방법, 재검토해야하는 경우 시기를 정의할 수 있습니다.
결정들 리소스에 대한 링크도 여기에 표시될 수 있습니다. —>

 

 

해보니까, 디테일하게 관리하는 건 좋은데 옵셔널한 부분까지 적기에는 좀 귀찮을 수도 있겠더라구요..? 

간소화 버전으로 관리해도 좋을 것 같습니다. 

다만, 결정과 그 컨텍스트, 장단과 결과는 꼭 들어가야할 부분입니다.

 

## 주제

### 컨텍스트

### 결정

### 결과