클린 아키텍처란 무엇인가요? 어떻게 구성되고 작동하나요?

Question

IT Interview Practice · Accepted Answer

## 클린 아키텍처란 무엇인가요?

**클린 아키텍처(Clean Architecture)**는 비즈니스 동작을 중심으로 소프트웨어를 구성하고, 사용자 인터페이스, 데이터베이스, 프레임워크로부터 이를 분리합니다. 중요한 애플리케이션 규칙에 기술 변화가 미치는 영향을 줄이는 것이 목표입니다.

예를 들어 “배송이 완료된 주문은 취소할 수 없다”는 비즈니스 규칙입니다. 이 규칙은 고객이 웹사이트를 사용하든 모바일 애플리케이션을 사용하든 같으며, 저장 기술과도 무관합니다.

## 주요 구성 요소

클린 아키텍처는 보통 안쪽에서 바깥쪽으로 배치된 동심원으로 표현합니다.

- **엔티티:** 주문과 그 취소 조건처럼 핵심 비즈니스 데이터와 규칙을 담습니다.
- **유스 케이스:** 주문 조회, 취소 요청, 결과 저장과 같은 특정 애플리케이션 작업을 조율합니다.
- **인터페이스 어댑터:** 비즈니스 로직과 외부 시스템 사이에서 데이터를 변환합니다. 컨트롤러는 HTTP 요청을 취소 작업의 입력으로 변환하고, 저장소 어댑터는 주문 데이터를 데이터베이스 쿼리로 변환합니다.
- **프레임워크와 도구:** 웹 프레임워크나 데이터베이스 시스템처럼 가장 바깥쪽에 위치하는 기술입니다.

**핵심 규칙은 안쪽 코드가 바깥쪽 코드에 의존해서는 안 된다는 것입니다.** 유스 케이스는 비즈니스 측에 정의된 주문 저장 인터페이스를 사용할 수 있으며, 외부 어댑터가 특정 기술로 그 인터페이스를 구현합니다.

## 예시: 주문 취소하기

고객이 취소를 요청하면 컨트롤러가 취소 유스 케이스를 호출합니다. 유스 케이스는 데이터 접근 인터페이스를 통해 주문을 조회한 뒤 주문 객체에 취소 가능 여부를 확인하도록 요청합니다.

주문이 아직 배송 완료되지 않았고 조건을 충족하면 상태가 취소됨으로 변경됩니다. 유스 케이스가 변경 사항의 저장을 요청하고, 데이터베이스 어댑터가 쓰기를 수행하며, 컨트롤러는 고객에게 결과를 반환합니다.

실행 중에는 비즈니스 로직도 시작 시점에 연결된 인터페이스를 통해 어댑터를 호출할 수 있습니다. 의존성이 안쪽을 향해야 한다는 규칙은 코드 구성 요소 사이의 관계에 관한 것이며, 데이터나 호출이 한 방향으로만 이동할 수 있다는 뜻은 아닙니다.

## 장점

- **쉬운 규칙 테스트:** 웹 서버나 데이터베이스를 실행하지 않고 메모리의 데이터로 허용되는 취소와 거부되는 취소를 테스트할 수 있습니다.
- **비즈니스 동작의 명확한 위치:** 규칙이 컨트롤러와 쿼리 곳곳에 흩어지지 않아 읽기 쉽고 일관되게 변경하기 쉽습니다.
- **기술 변경의 영향 감소:** 비즈니스 계약이 그대로라면 저장소 라이브러리나 요청 처리기를 교체할 때 주로 바깥쪽 구성 요소만 영향을 받습니다.

## 한계

- **구성 요소 증가:** 인터페이스, 유스 케이스, 데이터 변환 코드를 작성하고 유지보수하는 데 시간이 듭니다.
- **경계 준수 필요:** 유스 케이스가 특정 프레임워크나 데이터베이스 라이브러리의 타입을 직접 사용하면 비즈니스 로직이 다시 외부 기술에 의존하게 됩니다.

## 언제 사용하면 좋을까요?

클린 아키텍처는 복잡한 비즈니스 동작이 있고, 개발 기간이 길며, 자주 테스트해야 하는 시스템에 유용합니다. 몇 개의 테이블만 읽고 쓰는 작은 애플리케이션이라면 더 단순한 구조가 다루기 쉬울 수 있습니다. 실제 책임을 분리하는 데 도움이 되지 않는다면 모든 동심원이나 폴더를 만들 필요는 없습니다.

클린 아키텍처란 무엇인가요?

주요 구성 요소

예시: 주문 취소하기

장점

한계

언제 사용하면 좋을까요?

관련 질문