패키지 구조

com.example.user ┣ domain ┃ ┣ model ┃ ┃ ┣ User.java ┃ ┃ ┣ UserRole.java ┃ ┃ ┗ ... ┃ ┣ service ┃ ┃ ┗ UserDomainService.java ┃ ┗ repository (Domain에서의 인터페이스, Port에 가깝지만 Domain 레이어 내부에서 정의되는 경우도 있음) ┃ ┗ UserRepository.java ┣ application ┃ ┣ port ┃ ┃ ┣ in ┃ ┃ ┃ ┗ UserUseCase.java ┃ ┃ ┗ out ┃ ┃ ┗ UserPersistencePort.java ┃ ┣ service ┃ ┃ ┗ UserApplicationService.java ┃ ┗ dto ┃ ┗ UserDto.java ┣ adapter ┃ ┣ in ┃ ┃ ┗ web (Controller, HTTP/API 등 사용자/외부가 들어오는 '입력' 어댑터) ┃ ┃ ┗ UserController.java ┃ ┗ out ┃ ┣ persistence (DB, JPA, MyBatis, etc. 구체적인 구현체) ┃ ┃ ┗ UserJpaRepository.java ┃ ┗ external (다른 시스템/API 연동용 어댑터) ┃ ┗ FeignClient.java ┗ config (스프링 설정, 빈 등록, 환경 설정 등) ┗ JpaConfig.java

각 패키지의 역할?

1. domain 패키지

• 핵심 비즈니스 로직과 도메인 모델이 위치함
• model
  • 엔티티나 VO 등..
• service
  • 도메인 서비스가 위치함
  • 엔티티 하나로 해결하기 힘든 복잡한 도메인 로직 담당
    • 여러 엔티티 간의 복잡한 비즈니스 규칙 등
• repository
  • Repository 인터페이스

2. application 패키지

• 도메인을 활용해 실제 애플리케이션 유스케이스를 구현하고, 입출력(UseCase)을 정의하는 레이어
• port (in / out)
  • in
    • 바깥 세상 (컨트롤러, 메시지 리스너 등)에서 들어오는 요청을 추상화 하는 인터페이스 정의
    • 예시 : UserUseCae라는 인터페이스로 createUser, getUser 등 애플리케이션에서 제공하는 기능 정의
  • out
    • 도메인 논리에서 필요한 외부 시스템(Repository, 외부 API 호출 등) 연동을 추상화하는 인터페이스
    • 예시 : UserPersistencePort를 통해 유저 데이터 영속화 관련 기능에 대한 추상 메서드들을 선언
• service
  • port의 in 인터페이스(UseCase)를 구현하여 도메인 레이어와 협업하며 유스 케이스를 실제로 수행
• dto
  • 애플리케이션 계층에서 사용되는 DTO 정의

3. adapter 패키지

• in / out 으로 구분하여, 각각 애플리케이션 외부와의 실제 입출력 구현체들을 모아둠