백엔드 리팩토링 — 단일 모놀리식에서 멀티모듈 클린 아키텍처로

src/main/java/com/example/app/
├── controller/     # 컨트롤러 11개
├── service/        # 서비스 11개
├── data/           # 데이터 클래스 19개
├── config/
├── util/
└── (기타 설정 파일들)

// 리팩토링 전 Post.java
@Data  // Lombok - getter/setter 전부 열려있음
public class Post {
    private Integer srl;
    private String title;
    private String content;
    private String regDt;
    private Integer hit;
    private String status;
    private String boardType;
    private Integer postCodeSrl;
    // ...
}

rootProject.name = 'service-backend'
 
include(
        ':application:web-api',   // REST API 진입점
        ':core:common',             // 공통 유틸, 에러 타입
        ':core:domain',             // 순수 도메인 모델
        ':core:service',            // 유스케이스, 비즈니스 로직
        ':core:web',                // HTTP 응답 DTO
        ':core:infra:database:mongodb',         // MongoDB 구현체
        ':core:infra:client:synthy-feign-client', // 외부 API 클라이언트
        // ... 기타 infra 모듈들
        ':support:logging',
        ':support:jackson'
)

// core/domain/build.gradle
dependencies {
    implementation project(':core:common')
    implementation 'com.github.f4b6a3:uuid-creator:6.0.0'
    implementation 'com.fasterxml.jackson.core:jackson-annotations'
}

domain/post/
├── entity/
│   └── Post.java          # Aggregate Root
├── vo/
│   ├── PostId.java
│   ├── PostTitle.java
│   ├── PostContent.java
│   ├── PostTag.java
│   ├── RevisionNumber.java
│   └── ...
├── type/
│   ├── BoardType.java     # enum
│   └── SourceType.java    # enum
├── repository/
│   └── PostRepository.java  # Port (interface)
└── event/
    └── PostUpdatedEvent.java

public record PostTitle(String value) {
    public PostTitle {
        value = value == null ? "" : value;
    }
}

@Getter
@AllArgsConstructor(access = AccessLevel.PRIVATE)
@Builder(access = AccessLevel.PRIVATE, toBuilder = true)
public class Post {
    private final PostId id;
    private final PostCodeId postCodeId;
    private final PostTitle title;
    private final PostContent content;
    private final List<PostTag> tags;
    private final RevisionNumber revision;
    private final Audit audit;
    private final boolean deleted;
 
    public static Post create(PostCodeId postCodeId, PostTitle title, ...) {
        return new Post(PostId.generate(), postCodeId, title, ...);
    }
 
    public Post update(PostTitle title, PostContent content, List<PostTag> tags) {
        return this.toBuilder()
                .title(title)
                .content(content)
                .tags(tags)
                .revision(revision.next())
                .audit(audit.modified())
                .build();
    }
}

// core/domain/post/repository/PostRepository.java (Port)
public interface PostRepository {
    Optional<Post> findByPostId(PostId postId);
 
    Post getBy(PostId postId);
 
    Optional<Post> findBy(PostTitle title);
 
    PageResult<Post> findBy(BoardType boardType, List<PostCodeId> postCodeIds, PageQuery page);
 
    Post save(Post post);
}

core/infra/database/mongodb/
└── post/
    └── repository/
        └── PostRepositoryImpl.java  # Adapter

// 이런 식으로 쌓이기 시작한다
public RegistrationRequest submit(SubmitCommand command) {
    RegistrationRequest saved = repository.save(...);
    googleChatNotifier.notify(saved);  // 서비스가 알림 책임도 짐
    logger.logSubmission(saved);
    return saved;
}

// domain 모듈
public record RegistrationRequestSubmittedEvent(RegistrationRequest request) {}
 
// service 모듈
public RegistrationRequest submit(SubmitCommand command) {
    RegistrationRequest saved = repository.save(...);
    eventPublisher.publishEvent(new RegistrationRequestSubmittedEvent(saved));
    return saved;  // 서비스는 저장만 책임진다
}
 
// application 모듈 - 이벤트 리스너
@Async
@TransactionalEventListener(phase = AFTER_COMMIT)
public void onSubmitted(RegistrationRequestSubmittedEvent event) {
    notificationSender.send(event.request(), postCodeName);
}

CreatePostV1Dto       # 요청 DTO
GetPostDetailV1Dto    # 응답 DTO
GetPostListV1Dto      # 목록 응답 DTO