이 프로젝트는 Spring Modulith를 활용하여 모놀리식 환경에서 도메인 모듈 분리를 구현했습니다.
기존에는 Facade 패턴을 통해 도메인 간 경계를 나누었지만, 이는 코드로 강제할 수 없는 팀 간 약속에 불과했고 연관관계 생성을 위해 예외적으로 도메인 간의 참조를 허용하는 등 허점이 존재했습니다. 하지만 Spring Modulith를 도입해서 패키지 구조 자체가 모듈 경계를 강제하고, 자동화된 검증 테스트가 위반 사항을 검사하는 구조로 변경했습니다.
각 도메인 모듈은 명확히 정의된 Public API와 이벤트를 통해서만 통신하며, 외부 도메인 모듈은 내부 구현에 대해서 알지 못하게 추상화, 캡슐화 시켰습니다.
프로젝트의 아키텍처 변화 과정과 현재 구조에 대한 상세한 내용은 아래 문서들을 참고해주세요.
아래의 각 모듈간의 의존성 UML은 Spring Modulith의 Documenting Application Modules를 참고하여 문서화한 결과입니다.
Backend
Database
Infra & DevOps
Tools
프로젝트의 원활한 협업을 위해 Git 브랜치 전략, 커밋 메시지, 코드 스타일 등 통일된 개발 컨벤션을 따르고 있습니다. 자세한 내용은 아래 문서를 참고해주세요.
프로젝트 실행에 필요한 환경 변수(.env) 설정 및 Spring 설정 파일(application.yml) 관리 규칙은 아래 문서를 참고해주세요.