기술적 성찰: Impextech 데이터베이스 아키텍처 구축 🏗️

Source: Dev.to

Implementing Strict Type Safety (TypeScript)

이 단계의 주요 목표는 TypeScript 로 전환하여 런타임 데이터 오류를 없애는 것이었습니다.

• Schema Inference: 별도로 인터페이스와 스키마를 관리하는 대신 Mongoose의 InferSchemaType을 활용했습니다. 이를 통해 TypeScript 컴파일러와 MongoDB 검증 규칙이 항상 동기화되어 제품 및 사용자 데이터에 대해 100 % 타입 커버리지를 제공합니다.
• IDE Support: 이 전환으로 개발 경험이 크게 향상되어 실시간 자동 완성 및 속성 불일치 버그를 실행 단계에 도달하기 전에 잡아낼 수 있게 되었습니다.

Migration to ES Modules (ESM)

레거시 CommonJS(require) 시스템에서 최신 ES Modules(import/export) 로 프로젝트를 성공적으로 마이그레이션했습니다.

• Named Imports: Mongoose 컴포넌트를 명명된 import 로 사용함으로써 코드베이스가 더 깔끔해졌고 트리‑쉐이킹에 최적화되어 애플리케이션 전체 메모리 사용량이 감소했습니다.
• Modern Standards: ESM을 채택함으로써 Impextech이 최신 Node.js 성능 업데이트와 업계 표준 모듈 해석 패턴에 호환되도록 했습니다.

Collaboration and Configuration Optimization

TypeScript 마이그레이션에서 가장 어려운 부분은 종종 설정입니다. 복잡한 모듈‑해석 오류가 발생했을 때 백엔드 엔지니어 동료에게 코드 리뷰를 요청했습니다.

• tsconfig.json Evaluation: 이 협업을 통해 tsconfig.json 파일—특히 moduleResolution과 target 설정—을 최적화하여 TypeScript 컴파일러와 Node.js 런타임 간의 원활한 통합을 보장했습니다.
• Key Takeaway: 이번 경험은 인프라 병목을 해결하는 데 있어 동료 리뷰와 기술 협업의 가치를 다시 한 번 확인시켜 주었습니다.

Version Control & Git Strategy

안정적인 프로덕션 환경을 유지하기 위해 전용 브랜치 전략을 구현했습니다.

• Feature Branching: 모든 모델 개발은 design-models 브랜치에서 진행되었습니다.
• Integration: 스키마가 검증되고 빌드 스크립트가 통과하면 해당 브랜치를 main에 병합하여 프로젝트 진화의 깔끔하고 문서화된 히스토리를 유지했습니다.

Current Project Status

• Database: MongoDB Atlas 연결 확인 ✅
• Architecture: TypeScript/ESM 파이프라인 안정화 ✅
• Models: 제품 및 사용자 청사진 최종 확정 ✅

Next Steps: 컨트롤러 레이어와 RESTful API 라우트를 개발하여 비즈니스 로직 및 데이터 흐름을 처리합니다.