문서로만 지키던 아키텍처 규칙, 테스트 코드로 강제하기
아키텍처
문서로만 지키던 아키텍처 규칙, 테스트 코드로 강제하기
두줄요약
문서와 리뷰에만 의존하던 팀 규칙을 ArchUnit 테스트로 강제한 사례를 소개했습니다. 기존 위반은 동결하고 신규 위반만 막아 점진적으로 도입하는 방법과 주의점도 정리했습니다.
핵심 내용
- 문서와 코드 리뷰에만 의존하던 팀 규칙을 ArchUnit 테스트로 코드 레벨에서 강제한 사례
- 헥사고날 아키텍처의 아웃포트 의존성, 코딩 스타일, 네이밍, Lombok 규칙 등을 별도 테스트 모듈과 CI로 검증
- FreezingArchRule로 기존 레거시는 동결하고 신규 위반만 차단해 점진적으로 도입
- SOURCE Retention Lombok 규칙은 바이트코드 분석 한계를 보완하기 위해 소스 스캔으로 처리
