한빛미디어

요즘 개발을 하면서 가장 많이 고민하는 게 ‘이 코드가 지금만 돌아가면 되는 코드인지, 아니면 나중에도 유지보수가 가능한 코드인지’에 대한 부분이다. 처음에는 기능만 잘 되면 된다고 생각했는데, 프로젝트를 몇 번 겪다 보니까 결국 오래 살아남는 코드는 구조가 좋은 코드라는 걸 체감하게 됐다. 특히 여러 시스템을 동시에 운영하거나, 고객사 요구사항이 계속 바뀌는 환경에서는 더더욱 그렇다.

최근에 읽은 『클린 아키텍쳐 with 파이썬』은 그런 고민을 하던 시점에 꽤 인상적으로 다가온 책이었다. 단순히 “이렇게 코드를 작성하세요” 수준이 아니라, 왜 구조를 분리해야 하는지, 왜 의존성을 신경 써야 하는지, 그리고 실무에서 어떤 식으로 아키텍처를 설계해야 하는지를 파이썬 기반으로 설명해준다.

사실 처음 책 제목만 봤을 때는 조금 어렵지 않을까 싶었다. ‘클린 아키텍처’라는 단어 자체가 뭔가 엄청 거창하게 느껴졌기 때문이다. 그런데 막상 읽어보니까 생각보다 설명 흐름이 자연스럽고, 예제를 기반으로 단계적으로 설명해줘서 이해하기 편했다. 특히 단순 이론 위주가 아니라 실제 서비스 구조를 어떻게 나누고 관리할 수 있는지를 보여주는 방식이라 더 와닿았다.

내가 가장 인상 깊게 봤던 부분은 “비즈니스 로직은 외부 기술에 종속되지 않아야 한다”는 내용이었다. 개발하다 보면 DB나 API, 프레임워크에 로직이 너무 강하게 엮이는 경우가 많다. 처음에는 개발 속도가 빠른 것 같지만, 나중에 구조 변경이 필요해지면 수정 범위가 엄청 커진다. 이 책에서는 그런 문제를 줄이기 위해 계층을 어떻게 분리해야 하는지, 어떤 방향으로 의존성이 흘러가야 하는지를 계속 강조한다.

실제로 책을 읽으면서 예전에 진행했던 프로젝트들도 많이 떠올랐다. 당시에는 급하게 기능 구현을 하느라 서비스 로직이 컨트롤러에 몰려 있었고, 나중에는 수정 한 번 하려면 영향 범위를 계속 확인해야 했다. 테스트 코드 작성도 쉽지 않았고, 작은 기능 변경에도 예상치 못한 오류가 자주 발생했다. 그런데 이 책에서 설명하는 구조를 보니까 왜 그런 문제가 생겼는지 조금 더 명확하게 이해됐다.

책에서 특히 좋았던 점은 단순히 “좋은 코드”를 추상적으로 말하는 게 아니라, 실제 코드 예시를 통해 비교해준다는 점이었다. 잘못 설계된 구조와 개선된 구조를 나란히 보여주니까 차이가 확실하게 보였다. 그리고 파이썬 문법 자체를 설명하는 책이 아니라, 설계와 구조에 초점을 맞추고 있어서 어느 정도 개발 경험이 있는 사람이라면 언어 관계없이 도움이 될 것 같다는 생각도 들었다.

물론 초급자 입장에서는 조금 어려울 수도 있다. 특히 객체지향 설계나 의존성 역전 같은 개념이 익숙하지 않다면 처음에는 용어가 낯설 수 있다. 나도 처음 읽을 때는 한 번에 다 이해되지는 않았고, 중간중간 다시 읽으면서 정리했다. 그런데 오히려 그래서 더 오래 기억에 남는 느낌이었다. 단순히 읽고 끝나는 책이 아니라, 실제 프로젝트 경험이 쌓일수록 다시 펼쳐보게 되는 유형의 책이라고 해야 할까.

또 좋았던 건 테스트 코드 관련 내용이었다. 보통 테스트 코드는 귀찮고 시간 많이 드는 작업이라고 생각하기 쉬운데, 책에서는 왜 테스트 가능한 구조를 만들어야 하는지를 설계 관점에서 설명한다. 단순히 테스트 코드를 작성하는 방법만 알려주는 게 아니라, 테스트하기 쉬운 구조 자체를 만드는 방향으로 접근하는 점이 인상적이었다.

실무에서 개발 일정이 촉박할 때는 구조를 신경 쓰기 쉽지 않다. 나도 일정 맞추느라 일단 돌아가는 방향으로 구현했던 적이 많다. 그런데 시간이 지나면 결국 유지보수 비용으로 다시 돌아온다. 기능 하나 추가할 때마다 기존 코드 영향 범위를 확인해야 하고, 수정 후 QA 과정도 길어진다. 결국 개발 속도를 진짜로 올리는 건 빠른 구현이 아니라, 수정 가능한 구조라는 걸 점점 느끼게 된다.

이 책은 그런 부분을 계속 상기시켜준다. 특히 단순히 “클린 코드” 수준이 아니라 시스템 전체를 어떤 기준으로 나눌지에 대한 관점을 다뤄서 좋았다. API, 데이터베이스, 프레임워크 같은 외부 요소와 핵심 비즈니스 로직을 분리하는 사고방식은 앞으로 프로젝트를 진행할 때도 꽤 큰 기준이 될 것 같다.

개인적으로는 중간중간 나오는 예제 구성도 좋았다. 설명만 길게 이어지는 스타일이 아니라 실제 코드와 함께 보여주다 보니까 이해가 더 쉬웠다. 그리고 책 전체가 “이론 암기” 느낌보다는 “왜 이렇게 설계해야 하는가”를 계속 설득하는 방식이라 읽는 동안 지루하지 않았다.

개발 관련 책을 읽다 보면 너무 이상적인 이야기만 하는 경우도 있는데, 이 책은 그래도 현실적인 고민들을 꽤 잘 담고 있다는 느낌이었다. 특히 유지보수, 테스트, 의존성 관리 같은 부분은 실제 프로젝트를 해본 사람일수록 공감할 만한 내용이 많다. 그래서 단순 입문서보다는 어느 정도 개발 경험이 있는 사람이 읽었을 때 더 와닿는 책이라는 생각이 들었다.

그리고 제목에 ‘with 파이썬’이 들어가 있어서 파이썬 개발자만 보는 책 같지만, 구조 설계 자체에 대한 이야기라 다른 언어를 사용하는 사람에게도 충분히 도움이 될 것 같다. 나 역시 Java 기반 프로젝트 경험이 더 많은 편인데도 읽는 동안 공감되는 부분이 많았다.

특히 최근에는 서비스 규모가 커질수록 유지보수성과 확장성이 더 중요해지고 있는데, 그런 관점에서 이 책은 단순한 기술 서적이라기보다는 개발에 대한 사고방식을 정리해주는 느낌에 가까웠다. 코드 몇 줄 잘 작성하는 것보다 시스템을 어떻게 바라봐야 하는지를 생각하게 만드는 책이었다.

전체적으로 정리하자면 『클린 아키텍쳐 with 파이썬』은 단순히 파이썬 문법이나 패턴을 설명하는 책이라기보다, 실무에서 유지보수 가능한 구조를 어떻게 고민해야 하는지를 알려주는 책에 가까웠다. 당장 모든 내용을 완벽하게 적용하기는 어렵겠지만, 프로젝트를 바라보는 기준 자체를 바꿔준 점에서 꽤 의미 있게 읽었다.

개발을 하면서 “왜 유지보수가 점점 어려워지는지”, “왜 작은 수정에도 영향 범위가 커지는지” 같은 고민을 해본 사람이라면 한 번쯤 읽어볼 만한 책이라고 생각한다. 특히 서비스 구조나 설계 방향에 관심 있는 개발자라면 얻어가는 부분이 꽤 많을 것 같다.

나도 이번에 읽으면서 단순히 기능 구현에만 집중하기보다, 앞으로는 구조 자체를 조금 더 의식하면서 개발해야겠다는 생각이 많이 들었다. 아마 실무 경험이 더 쌓이면 다시 읽었을 때 또 다른 부분이 보일 것 같은 책이다.