📦 NestJS 핵심 개념: Module, Providers, Exports 정리

📘 Module: 기능 단위의 경계자

✅ 정의

NestJS에서 @Module()은 관련된 구성 요소(Controller, Provider 등)를 하나로 묶는 단위입니다. 하나의 기능(혹은 도메인)을 독립적으로 관리할 수 있는 컨테이너입니다.

🧠 역할

• 관심사 분리
• DI 컨테이너의 경계
• 도메인 단위의 캡슐화
• 외부 모듈과의 의존 관계 명시

🧩 구조 예시

@Module({
  imports: [],
  controllers: [UserController],
  providers: [UserService, UserRepository],
  exports: [UserService], // 다른 모듈에서 사용할 수 있도록 외부에 노출
})
export class UserModule {}

⚙️ Provider: 의존성 주입 대상

✅ 정의

Provider는 NestJS에서 인스턴스를 만들어 관리하는 객체입니다. 일반적으로 서비스(@Injectable()), 리포지토리, 헬퍼 클래스 등이 이에 해당합니다.

💡 종류

타입 예시 설명
클래스 Provider UserService 일반적인 의존성
값(Value) Provider useValue 설정 객체 등
팩토리 Provider useFactory 동적 생성, 외부 조건 기반
기존 Provider 재사용 useExisting 기존 것 재활용

🧩 예시

@Injectable()
export class UserService {
  constructor(private readonly userRepository: UserRepository) {}
}

const ConfigProvider = {
  provide: 'CONFIG',
  useValue: {
    port: 3000,
    database: 'dev',
  },
};

🔄 주입 예시

constructor(@Inject('CONFIG') private readonly config) {}

🔁 Exports: 외부 모듈에 공유

✅ 정의

exports는 현재 모듈 내의 Provider를 다른 모듈에서 사용할 수 있도록 노출하는 역할을 합니다. exports에 등록되지 않으면 다른 모듈에서 사용 불가능합니다.

⚠️ 주의

controllers는 exports할 수 없습니다.
오직 providers 또는 imports된 모듈의 exports만 export 가능.

🧩 예시

user.module.ts

@Module({
  providers: [UserService],
  exports: [UserService],
})
export class UserModule {}

auth.module.ts

@Module({
  imports: [UserModule],
})

export class AuthModule {
  constructor(private readonly userService: UserService) {}
}

🧠 아키텍처적 해석 (Clean Architecture 관점)

NestJS 구성 요소 아키텍처 역할
Module: 기능 단위의 경계, Bounded Context
Provider: 도메인 서비스, 인프라 어댑터, 유스케이스
Export: 모듈 간 명시적 의존성 계약 (Interface/Port 개념)

🧪 테스트 전략 참고

테스트 대상 계층 테스트 유형
Provider (Service 등) Application, Domain 유닛 테스트 (Mock 사용)
Module 전체 Application Layer 통합 테스트
Controller Interface Layer e2e 테스트 / HTTP 테스트

✅ 마무리 요약

요소 설명 예시
Module: NestJS의 기능 단위 경계자 UserModule, AuthModule 등
Provider: NestJS DI 컨테이너에 의해 관리되는 인스턴스 UserService, LoggerService 등
Exports: 다른 모듈에서 Provider를 사용할 수 있도록 공개 exports: [UserService]