Separation of Concerns 기반 Node.js API 확장성 확보 설계

Context

초기 단계의 단일 파일 구조가 서비스 성장함에 따라 Route Handler 내 비즈니스 로직 침투 및 에러 핸들링 중복 문제를 야기함. 이는 코드 가독성 저하와 유지보수 비용 증가로 이어지는 전형적인 기술 부채 상황임.

Technical Solution

• Route, Controller, Service, Schema 레이어 분리를 통한 관심사 분리(Separation of Concerns) 달성
• Zod를 활용한 Boundary 단계의 Request Validation으로 비즈니스 로직 진입 전 데이터 무결성 보장
• 중앙 집중식 Error Handling Middleware 도입으로 중복 try-catch 제거 및 일관된 응답 구조 정의
• API Versioning(/api/v1/) 폴더 구조 채택을 통한 하위 호환성 유지 및 리팩토링 리스크 최소화
• App 정의(app.ts)와 서버 실행(server.ts) 로직 분리로 테스트 환경의 서버 기동 없는 유닛 테스트 가능 구조 설계
• Global Rate Limiting 및 Helmet 적용으로 인프라 진입 단계의 보안성 강화