ADR (Architecture Decision Record)

ADR?

• ADR은 Architecture Decision Record의 약자

• 아키텍처 관련 결정에 대해 과정 및 결과를 기록한 문서

왜 사용?

• 보다 합리적인 선택을 위해

  • 만약 ADR을 적용하지 않고 의사 결정을 내린다면, 일관되지 않은 의사 결정을 할 수 있음

  • ADR을 작성하며 선택 이유, 결과, 이에 대한 영향 등 여러 요소를 작성하기 때문에 더욱 합리적인 선택 가능

• 미래의 팀 (또는 팀원) 을 위해

  • 미래의 팀원에게 의사 결정에 대한 히스토리를 제공할 수 있음

  • 이를 통해 더욱 빠르게 적응할 수 있음

  • 또한 기존 팀의 의사 결정 방식에 대해도 파악할 수 있어 추후 비슷한 결로 의사 결정을 내릴 수 있음

구성 요소

1. 상태 (Status)

2. 맥락 (Context)

3. 결정 (Decision)

4. 결과 (Consequences)

ADR 작성 예시

주제: iOS 애플리케이션 프레임 워크 선택(UIKit vs. SwiftUI)

상태

• 제안

배경

• 새로운 프로젝트 진행 시 선택할 필요가 있음

• 유지 보수, 확장 가능성 등 추후 프로젝트 진행에 대해 많은 부분을 고려하여 선택해야 함

결정

UIKit 선택

• 모듈화

  • SwiftUI는 View에서 라우팅 기능을 하고 있음

  • UIKit은 뷰컨트롤러(또는 내비게이션 컨트롤러) 에 대한 레퍼런스만 있다면 라우팅이 가능

  • 이를 통해 인터페이스/구현체 구조의 모듈 구성이 가능

  • SwiftUI도 이론상 가능하나, 현재 이에 대한 best practice가 없음

• 변경이 적음

  • UIKit의 API는 SwiftUI에 비해 오랜 기간 개발되었음

  • 따라서 UIKit은 버전에 따른 변화가 많지 않지만 SwiftUI는 변화가 있음

결과

• (긍정) UIKit을 선택하여 안전(변경이 적음)하고 확정성 있는 애플리케이션 개발이 가능

• (부정) SwiftUI에 비해 UI 작업 시 많은 시간이 걸림