서비스 분리로 해결 못 하는 NestJS 코드 비대화와 구조적 한계 분석

Context

단일 서비스 클래스 내 비즈니스 로직 집중으로 인한 유지보수 효율 저하 상황. 단순한 서비스 분리를 통한 리팩토링이 코드 가독성은 높이나 근본적인 의존성 복잡도와 도메인 엉킴 문제는 해결하지 못하는 한계 직면.

Technical Solution

• AuthService를 Orchestrator로 설정하고 Users, AntiFraud, Referral 등 도메인별 전담 서비스로 로직을 위임하는 구조 설계
• Result<T, E> 타입을 도입하여 내부 서비스의 에러 처리 방식을 명시적 계약 형태로 변경하고 HTTP Transport 계층에서만 HttpException으로 변환
• 비대해진 User 모듈을 Profile, Settings, Privacy 등 세부 Use-case 기반 서비스로 쪼개어 파일 단위의 물리적 분리 수행
• Controller-Service-Entity로 이어지는 계층 구조 내에서 단방향 의존성을 유지하여 구조적 복잡도 제어 시도