DreamTourManagement 백엔드 Part 1: Express.js, TypeScript 기반의 모듈식 아키텍처 구축

핵심 기술

이 글은 Express.js와 TypeScript를 활용하여 확장 가능하고 프로덕션 준비가 된 백엔드 아키텍처를 구축하는 과정을 상세히 설명합니다. Zod를 통한 타입 안전한 유효성 검사와 모듈 패턴 적용이 주요 내용입니다.

기술적 세부사항

• 기본 서버 인프라 구축:
  • Express 서버 초기화 및 express.json(), cors() 미들웨어 설정
  • Mongoose를 사용한 MongoDB 연결 및 서버 시작 전 DB 연결 성공 보장
  • PORT, DB_URL 등을 위한 타입 안전한 환경 변수 관리 시스템 구축
• 모듈화된 아키텍처 (User 모듈 예시):
  • user.interface.ts: IUser 인터페이스 정의
  • user.model.ts: Mongoose 스키마 및 필드 규칙(필수, 고유 제약 등) 정의
  • user.service.ts: 비즈니스 로직(생성, 조회 등)을 포함하는 모듈의 '두뇌' 역할
  • user.controller.ts: HTTP 요청과 서비스 계층 사이의 중간 역할, 요청 데이터 처리 및 응답 형식화
  • user.route.ts: /register, /all-users와 같은 REST 엔드포인트 설정 및 컨트롤러 연결
• 확장 가능한 패턴 도입:
  • routes/index.ts: 모든 모듈 라우트를 중앙 집중식으로 등록하는 방식
  • utils/sendResponse.ts: 일관된 응답 구조(success, statusCode, message, data, meta) 제공 유틸리티
• 효과적인 오류 처리:
  • utils/catchAsync.ts: 비동기 컨트롤러를 감싸 반복적인 try...catch 블록 제거 및 오류 자동 전달
  • errorHelpers/appError.ts: 사용자 정의 HTTP 상태 코드를 지원하는 커스텀 오류 클래스
  • middlewares/globalErrorHandler.ts: 모든 오류를 포착하여 일관된 JSON 응답으로 포맷
  • middlewares/notfound.ts: 정의되지 않은 라우트에 대한 404 Not Found 응답 처리
• 프로덕션 준비를 위한 안정성 확보:
  • server.ts에 unhandledRejection, uncaughtException, SIGTERM 리스너 추가하여 예기치 않은 오류나 종료 신호 시 안전한 종료 처리
• 요청-응답 라이프사이클 설명:
  • 클라이언트 요청 -> app.ts -> 라우팅 -> user.route.ts (Zod 유효성 검사) -> user.controller.ts (catchAsync 활용) -> user.service.ts -> user.model.ts (DB 작업)
  • 유효성 검사 실패 시 validateRequest 미들웨어에서 오류 처리
  • Mongoose 오류 발생 시 promise 거부 처리 후 catchAsync를 통해 전역 오류 핸들러로 전달

개발 임팩트

• 모듈 디자인: 유지보수 및 확장이 용이한 구조
• 일관된 응답: 표준화된 응답 형식으로 클라이언트 개발 편의성 증대
• 중앙 집중식 유효성 검사 및 오류 처리: 코드 중복 감소 및 안정성 향상
• 확장 가능한 라우트 관리: 새로운 라우트 추가 용이
• 안정적인 프로덕션 동작: 예외 처리 및 안전한 종료 메커니즘

커뮤니티 반응

원문에는 커뮤니티 반응에 대한 언급이 없습니다.

톤앤매너

전반적으로 명확하고 전문적인 톤으로, 개발자가 실제 프로젝트에 적용할 수 있는 실질적인 가이드라인을 제공합니다.