도메인 주도 설계(DDD)는 소프트웨어 개발에서 복잡한 도메인(비즈니스 영역)의 모델링에 집중하는 접근 방식입니다. 에릭 에반스(Eric Evans)가 2003년 저서 "Domain-Driven Design: Tackling Complexity in the Heart of Software"에서 처음 제시했습니다.
DDD의 핵심 목표
비즈니스 복잡성 관리: 복잡한 비즈니스 로직과 규칙을 명확하게 이해하고 소프트웨어 모델에 정확히 반영합니다.
도메인 전문가와의 협업: 개발자와 도메인 전문가(비즈니스 관계자) 간의 효과적인 의사소통을 통해 도메인 지식을 공유하고 모델을 정교화합니다.
유연하고 확장 가능한 시스템 구축: 비즈니스 요구사항의 변화에 유연하게 대응하고, 장기적으로 유지보수 및 확장이 용이한 시스템을 만듭니다.
import { Injectable } from '@nestjs/common';import { Repository } from 'typeorm';import { InjectRepository } from '@nestjs/typeorm';import { UserEntity } from '../infrastructure/entities/user.entity'; // TypeORM 엔티티import { IUserRepository } from '../domain/repositories/user.repository.interface';import { User } from '../domain/entities/user.entity'; // 도메인 엔티티@Injectable()export class TypeOrmUserRepository implements IUserRepository { constructor( @InjectRepository(UserEntity) private typeOrmRepository: Repository<UserEntity>, ) {} async findById(id: string): Promise<User | null> { const entity = await this.typeOrmRepository.findOne({ where: { id } }); return entity ? User.fromPersistence(entity) : null; // DB 엔티티를 도메인 엔티티로 변환 } async save(user: User): Promise<User> { const entity = UserEntity.fromDomain(user); // 도메인 엔티티를 DB 엔티티로 변환 const savedEntity = await this.typeOrmRepository.save(entity); return User.fromPersistence(savedEntity); }}
NestJS 모듈에서는 providers에 인터페이스와 구현체를 연결합니다.
src/user/user.module.ts
import { Module } from '@nestjs/common';import { TypeOrmModule } from '@nestjs/typeorm';import { UserEntity } from './infrastructure/entities/user.entity';import { UserController } from './presentation/user.controller';import { UserService } from './application/user.service'; // 애플리케이션 서비스import { TypeOrmUserRepository } from './infrastructure/repositories/typeorm-user.repository';import { IUserRepository } from './domain/repositories/user.repository.interface';@Module({ imports: [TypeOrmModule.forFeature([UserEntity])], controllers: [UserController], providers: [ UserService, { provide: IUserRepository, // 인터페이스를 토큰으로 사용 useClass: TypeOrmUserRepository, // 실제 구현체 }, ], exports: [IUserRepository], // 다른 모듈에서 리포지토리 사용 시})export class UserModule {}
애플리케이션 서비스 구현: UserService와 같은 애플리케이션 서비스는 컨트롤러의 요청을 받아 도메인 계층의 객체(User 엔티티, IUserRepository 등)를 호출하고, 트랜잭션을 관리하며, 필요한 경우 DTO(Data Transfer Object)를 도메인 객체로 변환하거나 그 반대로 변환하는 역할을 합니다.
src/user/application/user.service.ts
import { Inject, Injectable } from '@nestjs/common';import { IUserRepository } from '../domain/repositories/user.repository.interface';import { User } from '../domain/entities/user.entity';import { CreateUserDto } from '../presentation/dtos/create-user.dto';@Injectable()export class UserService { constructor(@Inject(IUserRepository) private readonly userRepository: IUserRepository) {} async createUser(createUserDto: CreateUserDto): Promise<User> { // DTO를 도메인 엔티티로 변환 (또는 도메인 팩토리 사용) const newUser = User.create(createUserDto.name, createUserDto.email); return this.userRepository.save(newUser); } async findUserById(id: string): Promise<User | null> { return this.userRepository.findById(id); }}
CQRS와 DDD의 조합: CQRS는 DDD와 매우 잘 어울립니다.
명령(Command) 계층: 쓰기 모델은 DDD의 애그리게이트와 리포지토리 패턴을 사용하여 비즈니스 규칙과 일관성을 엄격하게 유지합니다.
조회(Query) 계층: 읽기 모델은 단순하고 평탄화된 데이터 구조로, 효율적인 조회를 위해 최적화됩니다. 도메인 모델의 복잡한 비즈니스 로직을 포함하지 않습니다.
