교재 목차
모듈·의존성 주입·데이터베이스·인증·REST API에서 마이크로서비스·테스트·배포까지 NestJS 서버 개발을 연결합니다.
API에 인증과 저장 기능이 더해지면 한 함수가 입력 검사와 업무 규칙을 함께 맡기 쉽습니다.
NestJS에서는 모듈·컨트롤러·서비스로 책임을 나눠 바뀌는 부분을 찾아 고칠 수 있게 합니다.
모듈은 사용할 컨트롤러와 서비스를 등록해 객체를 조립합니다. 요청 처리에서는 가드가 접근을 확인하고 파이프가 입력을 검증·변환합니다. 컨트롤러는 요청과 응답을 연결하고 서비스는 업무 규칙을 처리합니다. 모듈의 조립과 요청의 실행을 구분하며 읽어 보세요.
이 교재는 첫 응답을 만든 뒤 인증, 데이터베이스, 테스트와 운영으로 확장합니다. 먼저 작은 요청 하나를 따라가며 각 책임이 어디에 놓이는지 확인합니다.
먼저 시작하기
변수·함수·클래스·import를 읽을 수 있으면 첫 앱을 시작할 수 있습니다. 낯선 문법은 TypeScript 입구의 기본 타입, 함수, 클래스, ES 모듈, Promise와 async/await에서 필요한 부분을 복습하세요.
| 지금 할 일 | 읽을 경로와 확인할 결과 |
|---|---|
| 첫 서버 응답 만들기 | 환경 설정 → 첫 앱에서 Node/npm·CLI·프로젝트 폴더를 준비합니다. 생성한 앱을 바꾸지 않았다면 GET /에서 Hello World!를 예상합니다. 응답이 다르면 사용한 main.ts의 포트, 실행 폴더와 시작 예외부터 확인합니다. |
| 요청과 서비스 책임 나누기 | 모듈·컨트롤러·서비스로 이동합니다. 이 예제의 api 접두사를 설정하면 목록 경로는 /api/users입니다. 메모리 배열에 저장한 값과 응답을 비교하고, 인라인 body 타입이 필드별 런타임 검증을 제공하지 않는다는 점을 구분합니다. |
| JSON 입력 검사하기 | REST 설계와 DTO 유효성 검사를 읽습니다. 각 본문의 서비스·모듈·전역 파이프를 준비한 뒤 정상 입력과 거부 입력을 비교합니다. 5-1의 /v1/users와 5-2의 /users는 main.ts의 접두사·버전 설정이 다르므로 같은 주소로 추측하지 않습니다. |
CLI가 생성한 첫 앱의 응답에는 DB나 React가 필요하지 않습니다. 저장을 연결할 때 TypeORM, 로그인을 추가할 때 Passport, 외부 의존성을 격리해 확인할 때 단위 테스트로 이동하세요. 설치와 생성 명령은 환경 설정 절을 따르고, 사용 중인 프로젝트의 package.json·잠금 파일(lockfile)·프로젝트 안에 설치된 CLI를 함께 확인합니다.
13장 코드 편집기는 새 서버 프로젝트와 별도 Vite 화면 프로젝트를 만듭니다. 요구사항 → 모듈 실행 → 화면 구현·편집기의 기본 REST 저장·재조회를 먼저 읽으세요. 화면을 만들 때 React 입구에서 state와 effect를 복습하고, 회원가입·DTO·DB·출처 허용 설정 등 본문의 준비 범위를 맞춥니다.
기본 저장 뒤에는 WebSocket을 읽고 같은 계정의 두 세션 예제를 선택할 수 있습니다. 공유 초대와 동시 편집 병합은 이 최소 예제가 구현하지 않습니다. 마이크로서비스·서버리스·명령과 조회의 분리(CQRS)·도메인 설계는 요청과 저장 책임을 익힌 뒤 필요한 주제로 확장합니다.
각 장을 읽은 뒤에는 요청 한 건에서 입력 검사, 업무 규칙과 저장이 어느 객체를 거치는지 말로 설명해 보세요.