클린 아키텍처 (Robert C. Martin) 핵심 정리·유지보수 가능한 설계 원칙

안녕하세요, DeepCode 입니다. 이번 글에서는 클린 아키텍처(Robert C. Martin)를 정리해보려고 합니다. 평소 유지보수가 어려운 스파게티 코드로 고민하던 중, 시스템의 근본적인 구조를 설계하는 법을 배우고 싶어 이 책을 펼치게 되었습니다.

출처: 알라딘

 

▶ 1. 클린 아키텍처, 어떤 책인가요

이 책은 소프트웨어 공학의 거장 로버트 C. 마틴이 집필하였으며, 복잡한 소프트웨어 시스템을 어떻게 하면 유연하고 견고하게 설계할 수 있는지에 대한 철학을 담고 있습니다. 저자는 시스템의 핵심 로직이 외부 환경의 변화에 휘둘리지 않도록 만드는 경계와 계층의 중요성을 강조합니다. 단순한 코딩 기법을 넘어, 소프트웨어의 생명주기를 연장하는 설계 원칙을 다루는 전문 서적입니다.

▶ 2. 의존성 규칙을 통한 소프트웨어 경계 구축

클린 아키텍처가 관통하는 핵심 명제는 소프트웨어의 비즈니스 로직이 데이터베이스나 UI 같은 세부 사항으로부터 완전히 독립되어야 한다는 점입니다. 시스템의 중심에는 정책이 있어야 하며, 그 주변을 기술적인 세부 사항들이 감싸는 형태를 가져야 합니다. 이를 위해 의존성의 방향은 반드시 고수준 정책에서 저수준 세부 사항으로 향해야 한다는 원칙을 제시합니다.

▶ 3. 인상 깊었던 챕터 3가지

3.1 SOLID 원칙과 객체 지향 설계의 정수

저자는 좋은 설계의 기초로 SOLID 원칙을 상세히 설명합니다. 특히 단일 책임 원칙과 의존성 역전 원칙이 어떻게 코드의 결합도를 낮추는지 보여줍니다.

"모든 모듈은 하나의 책임만을 가져야 한다." (p.45)

이 문장을 통해 코드의 변경이 다른 곳으로 전이되는 현상을 막는 법을 배웠습니다.

3.2 컴포넌트와 경계를 나누는 기술

단순히 클래스를 나누는 것을 넘어, 시스템을 구성하는 컴포넌트 간의 경계를 어떻게 설정할 것인가에 대한 통찰을 줍니다. 경계가 모호하면 시스템은 금세 거대한 덩어리가 되어버립니다.

"경계는 소프트웨어의 복잡성을 관리하는 핵심 도구이다." (p.128)

제 기준으로 정리하면, 경계를 명확히 하는 것이 곧 유지보수 비용을 결정하는 척도라고 생각합니다.

3.3 의존성 역전 원칙의 실전 적용

가장 강력한 도구인 의존성 역전(DIP)에 대해 심도 있게 다룹니다. 고수준 모듈이 저수준 모듈에 의존하지 않고 추상화에 의존하게 만듦으로써, 데이터베이스 교체나 프레임워크 변경이 비즈니스 로직에 영향을 주지 않게 합니다.

"추상화는 변화를 견디는 힘이다." (p.210)

이 부분은 설계의 패러다임을 바꾸기에 충분했습니다.

▶ 4. 실무·일상에 적용하는 방법

1. 비즈니스 로직을 담은 엔티티와 유즈케이스를 프레임워크 코드와 분리하여 작성합니다.
2. 데이터베이스 접근 로직을 인터페이스로 추상화하여 핵심 로직이 DB 기술을 알지 못하게 합니다.
3. 새로운 기능을 추가할 때 기존 코드를 수정하기보다 새로운 클래스를 확장하는 방향을 우선 고려합니다.
4. 외부 라이브러리 사용 시 해당 라이브러리의 인터페이스를 직접 쓰지 않고, 우리 시스템에 맞는 어댑터를 거쳐 사용합니다.

▶ 5. 추천 대상 / 비추천 대상

소프트웨어 아키텍처의 근본적인 원리를 깨닫고 싶은 주니어 개발자나, 시스템 설계의 방향성을 고민하는 시니어 개발자에게 매우 유익합니다. 코드의 품질을 구조적으로 개선하고 싶은 분들에게는 필독서와 같습니다. 반면, 당장 돌아가는 코드를 빠르게 짜는 문법 위주의 학습을 원하는 분들에게는 내용이 다소 추상적이고 어렵게 느껴질 수 있어 추천하지 않습니다.

▶ 6. 함께 읽으면 좋은 책

객체 지향의 기본기를 더 탄탄히 다지고 싶다면 에릭 에반스의 디자인 패턴 관련 서적을 함께 읽어보시길 권합니다. 또한 테스트 코드의 중요성을 깨닫고 싶다면 테스트 주도 개발 관련 도서를 병행하는 것도 좋은 선택입니다.

관련 글 추천

정리해보면, 클린 아키텍처는 의존성 관리와 경계 설정을 통해 변화에 강한 시스템을 만드는 법을 알려줍니다. SOLID 원칙을 실무에 녹여내어 비즈니스 로직을 보호하는 설계가 핵심입니다. 구조적인 설계 능력을 기르고 싶은 분들에게 이 책은 훌륭한 길잡이가 될 것입니다. 다음 글에서는 객체 지향 설계의 구체적인 패턴에 대해 다뤄보겠습니다.