TypeORM 학습 가이드

이 문서는 더 이상 전체 내용을 중복해서 담는 전체판이 아니다.
이제는 TypeORM 분할 문서들을 엮어 소개하는 허브 문서로 사용한다.

문서 구성

• Core Guide DataSource, Entity, relation, Repository, CRUD 같은 핵심 흐름을 다룬다.
• Advanced Guide QueryBuilder, QueryRunner, driver 차이, FAQ, v1 변경점 같은 심화 내용을 다룬다.
• Operations Guide migration, CLI, Git 충돌, DBA 체크리스트, 운영 배포 관점을 다룬다.
• TypeORM + NestJS Guide TypeOrmModule, transaction scope, 테스트, subscriber, 운영 함정을 NestJS 기준으로 묶었다.

추천 읽기 순서

1. Core Guide
2. TypeORM + NestJS Guide
3. Operations Guide
4. Advanced Guide

이런 식으로 읽으면 된다

• 처음 배우면: Core -> TypeORM + NestJS
• 이미 CRUD는 해봤다면: Operations -> Advanced
• NestJS 프로젝트에 바로 붙인다면: TypeORM + NestJS -> Operations
• migration, 배포, Git conflict가 궁금하면: Operations부터 봐도 된다

NestJS와 함께 읽기

• NestJS Core Guide: module, provider, DI 구조를 먼저 다시 잡을 때
• NestJS Techniques Guide: TypeOrmModule, validation, serialization과 함께 실제 앱 흐름으로 볼 때
• NestJS Advanced Guide: 테스트, e2e, 운영 장애 대응까지 이어서 볼 때

범위 메모

• TypeORM 공식 문서 전 범위를 분할본 기준으로 재정리했다.
• 개념 요약만이 아니라 code example, trade-off, 자주 드는 의문, NestJS 조합 포인트를 포함한다.
• migration, REQUIRES_NEW 유사 패턴, Git conflict, 운영 주의점은 Operations와 TypeORM + NestJS에 모아두었다.

공식 문서

• TypeORM Docs