ORM 선택 기준

ORM 사용 전 점검표

ORM은 엔티티, repository, migration을 연결해 생산성을 높이지만 데이터 모델의 책임을 흐리면 장애 지점도 커진다.

모델

Entity

테이블 구조와 관계를 코드로 표현하되 도메인 규칙과 혼동하지 않는다.

접근 계층

Repository

조회 조건과 저장 동작을 한 경계로 모아 중복 쿼리를 줄인다.

변경 이력

Migration

스키마 변경은 코드 리뷰 가능한 기록으로 남기고 순서를 관리한다.

경계 유지

DTO 분리

API 입력과 DB 엔티티를 분리해 외부 계약 변화가 DB에 새지 않게 한다.

ORM 추적성

ORM을 잘 쓰는 기준은 쿼리를 숨기는 것이 아니라 데이터 변경을 추적 가능하게 만드는 것이다.