이 프로젝트는 Gradle Multi-Project Builds 과 Java 21을 사용하며, 아래와 같은 subprojects 및 디렉토리로 구성되어있습니다.
Hexagonal Architecture 를 적용하여 아래와 같은 subprojects 및 디렉토리로 구성되어있습니다.
.
├── domain #(1)
├── application #(2)
└── port #(3)
모든 비즈니스 로직과 도메인 모델들이 들어있는 모듈입니다.
비즈니스 코드의 결합을 방지하기 위해 다른 어떠한 모듈도 참조하지 않습니다.
어플리케이션의 진입점이 되는 모듈입니다.
domain의 코드를 참조하여 비즈니스 로직을 조합하는 역할을 담당하고 있습니다.
Hexagonal Architecture 에서의 Port 역할을 하는 모듈입니다.
domain과application모듈을 참조하며, 외부와의 통신을 위한 인터페이스를 제공합니다.외부에서 들어오는 요청을 처리하기 위한
input포트와 외부로 나가는 응답을 처리하기 위한output포트를 제공합니다.현재 가벼운 구현을 위해 mysql이 아닌 H2 데이터베이스를 사용하고 있습니다.
./gradlew port:bootRun 명령어를 통해 어플리케이션을 실행할 수 있습니다.
또한 IntelliJ 를 이용한 실행도 가능합니다.
기본 포트는 8080으로 설정되어 있습니다.
현재 테스트는 port 모듈의 Integration Test만 작성되어 있습니다.
유닛 테스트를 작성하지 않은 이유는 유닛 테스트를 작성할 정도로 비즈니스가 복잡하지 않기 때문입니다.
./gradlew port:test 명령어를 통해 테스트를 실행할 수 있습니다.
어플리케이션을 실행한 후 localhost:8080/docs 에서 API 문서를 확인할 수 있습니다.