Model 기준
Entity 데코레이터와 컬럼 옵션이 테이블 구조, 관계, 제약을 코드로 드러냅니다.
TypeORM을 사용한 데이터베이스 연동 데이터 경계
TypeORM 엔티티와 Repository, 트랜잭션 범위를 분리해 NestJS 서비스가 SQL 저장 방식에 직접 묶이지 않게 만듭니다.
Repository 기준
Repository와 QueryBuilder가 반복 조회·저장 코드를 감싸 서비스에는 업무 의도만 남깁니다.
Transaction 기준
여러 Entity 변경이 하나의 업무 규칙이면 QueryRunner나 manager 범위에서 함께 커밋합니다.
eager, lazy, explicit join은 화면에 필요한 관계 수와 응답 크기를 보고 선택합니다.
DB 오류는 도메인에 맞는 예외로 변환합니다.
엔티티 변경은 생성된 migration 파일과 되돌릴 down 절차를 같이 검토합니다.