Rails 애플리케이션의 핵심 비즈니스 로직 분리를 위한 헥사고날 아키텍처 적용 전략

핵심 기술

이 콘텐츠는 Rails 프레임워크에 대한 강한 의존성으로 인해 발생하는 코드의 복잡성, 테스트 어려움, 그리고 유지보수 문제를 해결하기 위한 방안으로 헥사고날 아키텍처(Ports & Adapters)를 소개합니다. 핵심은 비즈니스 로직을 프레임워크 및 인프라스트럭처로부터 분리하여 순수한 Ruby 객체로 관리하는 것입니다.

기술적 세부사항

• 문제점: Rails의 기본 구조는 ActiveRecord 모델에 비즈니스 규칙, 유효성 검사, 영속성 로직이 혼합되어 있으며, 외부 서비스(Stripe, PostgreSQL 등) 호출이 코드 전반에 퍼져 있어 테스트 및 변경이 어렵습니다.
• 헥사고날 아키텍처 구성:
  • Core: 순수 Ruby 객체로 비즈니스 로직만 포함합니다.
  • Ports: 애플리케이션이 수행할 기능(예: 결제 처리)을 정의하는 인터페이스(추상 클래스 또는 모듈)입니다.
  • Adapters: Ports 인터페이스를 구현하여 외부 시스템과의 연동을 담당합니다 (예: Stripe 결제 게이트웨이, 데이터베이스 어댑터, Fake 객체).
• 구현 예시:
  • ActiveRecord의 Order 모델에서 결제 로직과 유효성 검사를 분리하여 순수 Core::Order 객체로 만듭니다.
  • Ports::PaymentGateway 인터페이스를 정의하고, Adapters::StripePaymentGateway와 Adapters::FakePaymentGateway로 구현합니다.
  • 컨트롤러에서는 Core::Order 객체를 생성하고, 필요한 어댑터(예: Adapters::StripePaymentGateway)를 주입하여 비즈니스 로직을 실행합니다.
• 테스트 용이성: FakePaymentGateway와 같은 목(Mock) 객체를 사용하여 데이터베이스나 실제 외부 API 호출 없이 비즈니스 로직(예: 가격 계산)을 쉽게 테스트할 수 있습니다.

개발 임팩트

• 유지보수성 향상: 결제 제공업체 변경과 같이 인프라스트럭처 변경 시 수정 범위를 최소화할 수 있습니다.
• 테스트 커버리지 증대: 핵심 비즈니스 로직을 프레임워크 및 외부 종속성 없이 독립적으로 테스트할 수 있어 높은 수준의 테스트 커버리지를 확보할 수 있습니다.
• 확장성: GraphQL, CLI 등 새로운 인터페이스(Delivery Mechanism)를 추가하기 용이하며, Rails는 여러 어댑터 중 하나로만 취급됩니다.
• 팀 협업: 코드 베이스의 특정 영역에 대한 팀 간의 충돌을 줄이고 병렬 개발을 용이하게 합니다.

커뮤니티 반응

글에서 직접적인 커뮤니티 반응은 언급되지 않았지만, 헥사고날 아키텍처와 클린 아키텍처는 복잡한 애플리케이션의 설계 및 유지보수성에 대한 오랜 논의와 실증을 거친 패턴입니다.