#Swagger (3)

NestJS Swagger 일괄 적용 — 35개 컨트롤러 + DTO 22개

Swagger UI는 멀쩡한데 모듈마다 빠진 데코레이터·interface DTO 때문에 API 문서가 실제 동작과 어긋났다. 35개 컨트롤러에 @ApiTags·@ApiBearerAuth를 일괄 적용하고, 한 모듈의 9개 메서드·22개 DTO를 interface에서 class로 한 번에 정리했다. 모듈별 점진 적용을 거절하고 일괄 적용을 택한 트레이드오프와 적용 패턴을 정리한다.

2026년 5월 20일

NestJSSwaggerOpenAPI

📚 모노레포 아키텍처 결정기

스펙 변경에 강한 API 설계 — 1인 개발 실전 패턴 5가지

스펙이 바뀔 때마다 API를 뒤엎지 않으려면? NestJS + Prisma 모노레포에서 겪은 5가지 스펙 변경 사고와 그로부터 얻은 API 설계 원칙을 정리했다.

2026년 3월 23일

API설계NestJS스펙변경

📚 NestJS 실전 트러블슈팅

NestJS DTO 클래스 필수인 이유 — interface로 만들면 터지는 두 가지

NestJS에서 DTO를 interface로 만들면 400 에러와 Swagger 스키마 누락이 동시에 발생합니다. class-validator와 @ApiProperty가 작동하는 원리부터 해결까지 정리했습니다.

2026년 3월 16일

NestJSDTOSwagger