전체 서비스를 관통하는 도메인 모듈 분리

이 게시물은 대규모 WMS 서비스에서 비대해진 도메인을 안전하게 분리하고 헥사고널 아키텍처를 적용한 경험을 소개합니다.

도메인 분리 과정

• 재고 도메인 모듈(domain-inventory) 분리 및 결합도 낮추기
• 입고/출고 도메인과 재고 도메인 간 결합 모듈(service-wms) 생성 및 점진적 제거
• 헥사고널 아키텍처와 port-adapter 패턴 도입으로 모듈 간 통신 구현
• 재고 도메인 내부 응집도 향상을 위한 리팩토링 진행
• 코어 서비스의 엔터티 외부 반환 금지 원칙 적용

안전한 배포 전략

• 피처 플래그를 사용해 점진적 배포 및 장애 최소화
• 작은 단위의 자주 배포와 테스트 코드 작성으로 품질 유지
• ADR 문서화, 주간 개발자 밋업, 스터디를 통한 지식 공유
• 아크유닛(ArchUnit) 도입으로 코드 수준 아키텍처 규칙 강제

도메인 분리의 효과

• 코드 커버리지 증가 및 시스템 복잡도 감소
• 책임과 역할이 명확해져 유지보수 및 개발 효율성 향상
• 팀 내 긍정적인 반응과 안정적인 운영 환경 구축