소프트웨어 아키텍처: 클린 아키텍처와 헥사고날 아키텍처를 통한 유지보수성 극대화 전략

핵심 기술

본 콘텐츠는 소프트웨어의 핵심 가치인 '구조'의 중요성을 강조하며, 복잡한 코드 베이스의 유지보수성을 극대화하기 위한 클린 아키텍처와 헥사고날 아키텍처의 개념과 장단점을 분석합니다.

기술적 세부사항

• 아키텍처의 정의: 소프트웨어가 제공하는 기능과 구조 중, 구조에 포함되는 개념입니다.
• 구조의 중요성: 클린 코드, 클린 아키텍처 저자는 기능보다 구조를 더 중요하게 판단하며, 복잡한 구조는 유지보수에 어려움을 야기합니다.
• 좋은 아키텍처의 목표: 코드 읽기, 이해, 수정, 추가 등의 유지보수 작업을 수월하게 하여 투입 인력을 최소화합니다.
• 좋은 아키텍처의 특징: 높은 응집성, 낮은 결합도, SOLID 원칙 준수, 보편적인 아키텍처 패턴(예: 3-layered 아키텍처) 준수를 포함합니다.
• Layered 아키텍처: 단순하고 빠른 개발이 가능하나, 도메인과 인프라 구분이 명확하지 않을 수 있습니다.
• 클린 아키텍처: 도메인을 중심으로 구축되며, 규칙이 단순하고 도메인이 인프라에 의존되지 않습니다. 계층형 아키텍처보다 복잡할 수 있으나, 모든 의존성이 도메인 쪽으로 향하는 것이 핵심입니다.
• 헥사고날 아키텍처: 클린 아키텍처와 매우 유사하며, 때로는 동일하게 간주되기도 합니다. 도메인 중심 설계를 통해 도메인 기반 프로그래밍을 가능하게 합니다.
• 아키텍처 평가 기준: 도메인 의존성, 레이어 중요도, 의존성 방향 등을 기준으로 판단할 수 있습니다.
• 실제 적용 시 고려사항: 소규모 프로젝트나 팀원 전체가 클린 아키텍처를 이해하지 못할 경우, 장점을 얻기 어려울 수 있습니다.
• 의존성 분리의 중요성: 의존성 분리를 위해 파일 및 패키지가 늘어날 수 있으나, 이는 유연성 확보에 필수적입니다.
• Entity 분리: Infra 관련 Entity와 Domain Entity를 분리하면 영속 기술 변화에 유연하게 대처하고 POJO 개발을 잘 할 수 있습니다.
• Jpa Repository 위치: 헥사고날 아키텍처에서 UseCase(interface)를 구현하는 쪽에 두어야 DIP를 통해 구현 기술 변경이 용이합니다.
• Service 간 의존성: Port를 통해 노출하는 것이 깔끔하며, Controller가 Service 경계를 명확히 설정하여 사고의 경계를 돕습니다.

개발 임팩트

• 코드의 가독성, 이해도, 수정 용이성을 비약적으로 향상시켜 유지보수 비용을 절감합니다.
• 기술 변화에 대한 유연성을 증대시켜 장기적인 프로젝트의 안정성을 확보합니다.
• 의존성 관리 및 분리를 통해 테스트 용이성을 높이고 코드 품질을 개선합니다.

커뮤니티 반응

톤앤매너

본 콘텐츠는 IT 개발 분야의 전문성을 바탕으로, 아키텍처 설계의 중요성과 실질적인 적용 방안에 대해 명확하고 체계적으로 설명하고 있습니다.