프레임워크 종속성 제거로 유지보수 비용을 낮추는 NestJS Clean Architecture 전략

Context

비즈니스 로직이 HTTP 핸들러나 데이터베이스 쿼리에 결합된 구조적 한계 발생. 인프라 변경 시 애플리케이션 전반을 수정해야 하는 높은 변경 비용 문제. 프레임워크 의존성으로 인한 단위 테스트 복잡도 증가 및 실행 속도 저하.

Technical Solution

• 의존성 방향을 내부로 향하게 하는 Domain, Application, Infrastructure 3계층 분리 설계
• 프레임워크 데코레이터와 외부 라이브러리를 완전히 배제한 순수 TypeScript 클래스 기반의 Domain Entity 정의
• 인프라 구현체에 의존하지 않고 인터페이스만 정의하는 Repository Port 방식의 추상화 계층 도입
• CQRS 패턴을 적용하여 명령(Command)과 조회(Query) 핸들러를 분리하고 단일 책임 원칙 준수
• NestJS 컨트롤러와 TypeORM 리포지토리를 최외곽 Infrastructure 계층으로 배치하여 기술 스택 교체 유연성 확보
• NestJS 테스트 하네스 없이 실행 가능한 순수 Application 레이어 단위 테스트 환경 구축

Key Takeaway

비즈니스 핵심 로직을 프레임워크로부터 격리하여 기술적 세부 사항의 변경이 도메인 모델에 영향을 주지 않는 유연한 아키텍처 설계 원칙.