dependency-cruiser를 통한 Circular Dependency 제거 및 SDP 기반 아키텍처 가드레일 구축

Context

JavaScript의 유연한 모듈 해소 방식이 Circular Dependency 발생 시 런타임 에러 없이 undefined를 반환하며 잠재적 버그를 유발하는 구조적 한계 존재. 단순한 순환 참조 탐지를 넘어 모듈 간 의존성 방향이 설계 원칙을 위반하는 근본적인 아키텍처 설계 오류 해결 필요.

Technical Solution

• dependency-cruiser를 활용한 정적 분석 기반의 모듈 의존성 그래프 맵핑 및 검증 체계 구축
• no-circular 룰 설정을 통한 직접 및 간접 순환 참조의 즉각적인 탐지와 빌드 단계에서의 차단
• Stable Dependencies Principle(SDP)을 적용하여 의존성 방향을 안정적인 모듈(Stable)에서 불안정한 모듈(Unstable)로 흐르도록 강제
• forbidden 규칙 설정을 통해 utils $\rightarrow$ features $\rightarrow$ pages로 이어지는 계층 구조 위반 시 CI 단계에서 즉시 실패 처리
• 사후 대응 방식의 Cycle 탐지에서 사전 예방 방식의 Direction Rule 적용으로 아키텍처 정합성 유지