[투표] 엔티티 간 결합도 및 응집도 향상을 위한 연관관계 처리 방식

[mainlib990]

안녕하세요, 팀원 여러분.

현재 저희 프로젝트는 Package by Feature 구조를 채택하고 있으며, 각 모듈의 독립성과 유지보수성을 높이는 것을 중요하게 생각합니다. 엔티티 간 연관관계를 어떻게 처리할지에 대한 결정은 시스템의 결합도(Coupling)와 응집도(Cohesion)에 큰 영향을 미치며, 이는 장기적인 아키텍처의 유연성과 확장성에 직결됩니다. 팀원들의 의견을 모아 최적의 방안을 결정하고자 합니다.

아래 두 가지 안을 읽어보시고, 우리 프로젝트의 현재 상황과 미래 확장성을 고려했을 때 더 적합하다고 생각하는 방식에 투표해 주세요.

---

📝 안건 1: 엔티티를 직접 참조한다.

• 설명:

  • Order 엔티티가 User 엔티티를 필드로 직접 가지는 방식 (private User user;).
  • JPA의 @manytoone, @OnetoOne 등의 어노테이션을 사용하여 객체 간 연관관계를 매핑합니다.

• 장점:

  • 객체 지향적: 도메인 모델에서 객체 그래프 탐색이 자연스럽고 직관적입니다 (order.getUser().getName()).
  • 개발 편의성: JPA의 강력한 연관관계 매핑 기능을 활용하여 초기 개발이 편리합니다.

• 단점:

  • 강한 결합: 엔티티 간 직접적인 의존성이 발생하여, 특정 모듈(Feature)의 변경이 다른 모듈에 영향을 미칠 가능성이 높습니다. 이는 모듈의 독립적인 진화를 어렵게 하고, 시스템 전체의 결합도를 높입니다.
  • 유지보수성 저하: 복잡한 객체 그래프 탐색은 코드 이해도를 낮추고, 불필요한 데이터 로딩으로 인한 성능 저하 및 N+1 문제 발생 가능성이 있습니다.

---

📝 안건 2: ID만 참조한다.

• 설명:

  • Order 엔티티가 User 엔티티의 ID만 필드로 가지는 방식 (private Long userId;).
  • DB의 외래 키(Foreign Key) 개념과 유사하게, 다른 엔티티의 식별자(ID)만을 저장합니다.

• 장점:

  • 느슨한 결합 및 높은 응집도: 엔티티 간 직접적인 의존성이 사라지고, ID를 통한 간접적인 참조만 이루어져 각 모듈(Feature)의 독립성이 강화됩니다. 이는 모듈의 독립적인 개발 및 진화를 용이하게 하여 시스템 전체의 응집도를 높입니다.
  • 유연한 아키텍처: 시스템의 특정 부분이 변경되거나 확장될 때 다른 부분에 미치는 영향을 최소화하여, 장기적인 유지보수성과 확장성을 높입니다.
  • 성능 관리 용이: 필요한 경우에만 연관 데이터를 조회하므로, 불필요한 로딩을 방지할 수 있습니다.

• 단점:

  • 객체 지향적이지 않음: 객체 그래프 탐색이 불가능하며, 연관된 엔티티의 정보를 얻기 위해 별도의 조회 로직(Service 호출 등)이 필요합니다.
  • 개발 공수 증가: 연관된 데이터를 조회하고 조합하는 로직을 직접 구현해야 하므로 초기 개발 공수가 늘어날 수 있습니다.
  • 데이터 무결성 관리: 애플리케이션 레벨에서 참조 무결성을 관리해야 할 수도 있습니다.

---

🗣️ 중점 논의사항

이 결정은 단순히 엔티티 매핑 방식을 넘어, 시스템 전체의 결합도를 낮추고 응집도를 높여 각 모듈이 독립적으로 진화할 수 있는 아키텍처를 구축하는 데 핵심적인
역할을 합니다. 현재의 개발 편의성과 장기적인 시스템의 유연성 및 유지보수성 사이의 균형점을 찾는 것이 중요합니다.

[kimdotcom2]

참조 무결성을 애플리케이션에서 체크한다는 게 생소하신 분이 있으실텐데, 코드로 보면 save 하기 전에 boolean으로 다른 테이블의 값을 한번 체크하는 로직을 넣는 방식입니다.

// 1. 주문 생성 시 무결성 검사
    public void createOrder(Long customerId, String item) {

        if (!customerRepository.existsById(customerId)) {
            throw new IllegalArgumentException("존재하지 않는 고객 ID입니다.");
        }

        Order order = new Order();
        order.setCustomerId(customerId);
        order.setItem(item);
        orderRepository.save(order);
    }