피드로 돌아가기
Dev.toBackend
원문 읽기
NestJS-Drizzle-tRPC 조합의 Composition 문제 해결 및 엔드투엔드 레퍼런스 설계
A NestJS reference app that proves the nest-native stack under realistic backend pressure
AI 요약
Context
개별 라이브러리의 문서화만으로는 부족한 실제 백엔드 구성 단계의 Composition Problem 해결 필요. 특히 Multi-tenant 인증 컨텍스트 전파, 서비스 간 Transaction 정합성 보장, Post-commit 사이드 이펙트 처리와 같은 통합 설계 지점의 부재가 병목으로 작용.
Technical Solution
- request-scoped DI와 TrpcModule.forRoot({ createContext }) 설계를 통한 tRPC Procedure 및 가드 단계의 인증 컨텍스트 전파 구현
- @nestjs-cls/transactional 기반의 @Transactional() 데코레이터 도입으로 서비스 간 분산 로직의 단일 트랜잭션 원자성 확보
- Better-sqlite3의 비동기 래퍼로 인한 빈 트랜잭션 커밋 문제를 해결하는 Custom Sync Adapter 구현
- Transactional Outbox 패턴 적용을 통한 데이터베이스 커밋과 외부 알림 전송 간의 원자적 처리 및 Idempotency 보장
- CI 단계에서 AppRouter 타입을 활용한 client-smoke typecheck 프로세스 구축으로 API 변경에 따른 클라이언트 런타임 오류 사전 방지
실천 포인트
- tRPC와 NestJS 통합 시 request-scoped DI를 통해 인증 컨텍스트를 전파하고 있는지 검토 - DB 트랜잭션 완료 후 실행되어야 하는 사이드 이펙트에 Transactional Outbox 패턴 적용 고려 - SQLite 환경의 트랜잭션 어댑터가 비동기 래퍼로 인해 Silent Commit을 유발하는지 확인 - API 스키마 변경이 클라이언트에 즉각 반영되도록 CI 파이프라인에 타입 체크 스모크 테스트 추가