TL;DR

이 레포는 NestJS와 TypeScript로 구현된 클라우드 네이티브 마이크로서비스 지갑 플랫폼으로 각 서비스가 Clean Architecture를 따르고 Apache Kafka로 비동기 이벤트를 스트리밍하며 gRPC로 실시간 검증을 수행한다. 복식부기 원장을 사용하여 트랜잭션 무결성을 확보하고 MFA·KYC 통합으로 규제 요건을 충족하도록 구성되어 있다. Terraform과 서비스별 GitHub Actions가 함께 제공되어 인프라 코드 기반의 재현 가능한 배포 파이프라인을 구성할 수 있다. 로컬 Docker Compose로 Kafka·PostgreSQL·Redis를 기동한 뒤 서비스별 .env를 설정하고 npm run start:dev로 각 서비스를 실행하면 엔드투엔드 흐름을 빠르게 검증할 수 있다.

핵심 포인트

• 클린 아키텍처를 서비스 단위로 일관되게 적용하여 각 서비스의 도메인 경계를 명확히 한다. 이로 인해 기능별 테스트 및 독립 배포가 수월하고 서비스별 기술 부채를 국지화할 수 있다. 결과적으로 팀별 소유와 운영 효율성이 향상된다.
• 이벤트 중심 설계와 gRPC 병용으로 비동기 확장성과 동기적 무결성 검증을 동시에 확보한다. Kafka는 비용이 큰 재시도·재생(consumer replay)을 지원하여 이벤트 기반 회복성을 제공하고 gRPC는 실시간 리스크 체크와 같은 결정적 경로에서 일관된 응답을 보장한다. 두 패턴의 조합으로 지연-정합성 트레이드오프를 상황에 맞게 조율할 수 있다.
• Terraform을 통한 인프라 코드와 서비스별 GitHub Actions 워크플로가 통합되어 배포 파이프라인을 표준화한다. 인프라 변경은 코드 리뷰와 계획 단계로 관리되며 이미지 빌드·ECR 푸시·ECS 배포가 자동화되어 운영 반복 작업을 줄인다. 이로 인해 로컬 개발 환경과 프로덕션 간의 불일치를 줄이고 재현 가능한 배포를 달성한다.
• 지갑 관리를 수행하는 독립 서비스 구성을 제공한다. 각 서비스는 도메인·애플리케이션·인프라 계층으로 분리되어 유지보수와 테스트가 용이하다. 서비스별로 독립 배포가 가능하여 확장성과 장애 격리를 확보한다.