백엔드 시스템

백엔드 시스템은 Akan.js 애플리케이션의 기반입니다. Nest.js 위에 구축되어 데이터 저장, 비즈니스 로직, API 엔드포인트를 처리하기 위한 견고하고 확장 가능한 아키텍처를 제공합니다.

🏗️ 아키텍처 하이라이트

각 기능별로 1개의 Nest 모듈이 만들어지며, 모듈들이 모여 1개의 서버를 구성합니다. 여러 서버가 모여 서비스의 고가용성과 확장성을 제공하는 클러스터를 형성합니다.

백엔드 모듈 구조

Akan.js의 각 데이터 모델은 전용 모듈을 가집니다. 이러한 모듈식 접근 방식은 관심사의 깔끔한 분리를 보장하고 코드베이스를 유지보수하고 확장하기 쉽게 만듭니다.

각 모듈은 함께 작동하는 네 가지 핵심 구성 요소를 포함합니다:

1Constant

데이터 모델 스키마, 타입, 열거형, 검증 규칙을 정의합니다. 백엔드와 프론트엔드 간에 공유되는 단일 진실의 원천입니다.

2Document

CRUD, 쿼리, 필터, 문서 메서드를 포함한 MongoDB 작업을 처리합니다. 작업 전/후 미들웨어 훅을 포함합니다.

3Service

비즈니스 로직을 포함하고 작업을 조율합니다. 다른 서비스와 외부 API에 접근하기 위한 의존성 주입을 지원합니다.

4Signal

자동 타입 생성, 인증 가드, 속도 제한과 함께 GraphQL 엔드포인트(슬라이스와 엔드포인트)를 노출합니다.

Akan.js 서버는 서로 다른 워크로드에 최적화된 두 가지 모드로 클러스터 구성에서 운영됩니다:

⚡페더레이션 모드

수평 확장 기능으로 프론트엔드로부터 들어오는 요청을 처리합니다. 여러 컨테이너를 배포하여 부하를 분산할 수 있어 고가용성과 응답성을 보장합니다.

🔄배치 모드

예약된 작업, 큐 처리, 보안 작업을 위해 클러스터에서 단일 컨테이너로 실행됩니다. 경쟁 조건 없이 일관된 실행을 보장합니다.

두 서버 모드는 공유 인프라에 연결됩니다:

🗄️ MongoDB

영구 데이터 저장을 위한 주 데이터베이스. 샤딩과 복제를 위해 1-3개의 데이터베이스 연결을 지원합니다.

⚡ Redis

세션 관리, 실시간 구독, 서버 인스턴스 간 공유 상태를 위한 인메모리 캐시.

백엔드를 통해 요청이 어떻게 흐르는지 이해하면 효율적인 애플리케이션을 구축하는 데 도움이 됩니다:

쿼리/뮤테이션 작업: 표준 CRUD 및 커스텀 작업은 최적의 부하 분산을 위해 페더레이션 모드 서버에서 처리됩니다.

큐/배치 작업: 예약된 작업, 백그라운드 처리, 큐 작업은 일관된 실행을 위해 배치 모드에서 처리됩니다.

실시간 구독: GraphQL 구독은 Redis pub/sub을 사용하여 모든 페더레이션 인스턴스 간에 데이터를 실시간으로 동기화합니다.