ORM 작업 기준표

ORM 코드는 엔티티, 마이그레이션, 트랜잭션 검토

TypeORM을 쓰면 CRUD 구현은 빨라지지만, 운영에서는 스키마 변경과 실패 시 일관성을 더 엄격하게 확인해야 한다.

entity

모델은 DB 계약

엔티티 필드, null 허용, 인덱스, 관계 설정이 실제 쿼리 패턴과 일치하는지 검토한다.

스키마 계약
repository

서비스는 의도만 노출

컨트롤러가 쿼리 세부사항을 알지 않게 하고, 서비스 메서드 이름에 도메인 의도를 남긴다.

domain method
migration

스키마 변경은 기록

자동 동기화보다 마이그레이션 파일로 변경을 남기고, 롤백 가능성과 데이터 보정을 함께 검토한다.

change history
transaction

여러 쓰기는 원자화

사용자 생성과 권한 부여처럼 함께 성공해야 하는 작업은 트랜잭션 경계 안에서 처리한다.

all or nothing