📌 NestJS 백엔드 개발: 기초부터 실전까지 - NestJS 실시간 SaaS 백엔드 설계 (GraphQL + WebSocket)

📌 NestJS 백엔드 개발: 기초부터 실전까지

19. NestJS 실시간 SaaS 백엔드 설계 (GraphQL + WebSocket)

SaaS 백엔드에서는 실시간 데이터 처리가 중요한 요소입니다.
특히 실시간 알림, 대시보드 업데이트, 채팅, 실시간 협업 기능 등에서 WebSocket과 GraphQL을 활용한 효율적인 구현이 필요합니다.
이번 글에서는 NestJS에서 GraphQL + WebSocket을 활용하여 실시간 SaaS 백엔드를 설계하는 방법을 소개합니다. 🚀

---

19.1 SaaS에서 실시간 기능이 중요한 이유

✅ 실시간 기능이 필요한 SaaS 사례

✔ 실시간 대시보드 → 데이터가 변경될 때 즉시 반영
✔ 실시간 알림(Notification) → 유저의 행동에 따른 즉각적인 피드백
✔ 채팅 및 협업 → 다중 사용자 간 실시간 커뮤니케이션

💡 GraphQL Subscriptions + WebSocket을 조합하면 효율적인 실시간 기능 구현 가능

---

19.2 NestJS에서 GraphQL + WebSocket 설정

✅ 1) GraphQL Subscriptions 패키지 설치

npm install @nestjs/graphql apollo-server-express graphql-ws

---

✅ 2) GraphQL Subscriptions 활성화

반응형

📂 app.module.ts

import { Module } from '@nestjs/common';
import { GraphQLModule } from '@nestjs/graphql';
import { PubSub } from 'graphql-subscriptions';

@Module({
  imports: [
    GraphQLModule.forRoot({
      autoSchemaFile: true,
      subscriptions: {
        'graphql-ws': true, // WebSocket 사용 설정
      },
    }),
  ],
  providers: [{ provide: 'PUB_SUB', useValue: new PubSub() }],
})
export class AppModule {}

✅ subscriptions 옵션을 graphql-ws로 설정하면 WebSocket 기반의 GraphQL Subscriptions 활성화

---

19.3 실시간 알림 기능 구현 (GraphQL Subscriptions 사용)

✅ 1) 이벤트 발행 (PubSub 사용)

📂 notifications.resolver.ts

import { Resolver, Mutation, Subscription } from '@nestjs/graphql';
import { PubSub } from 'graphql-subscriptions';

@Resolver()
export class NotificationsResolver {
  constructor(private readonly pubSub: PubSub) {}

  @Mutation(() => String)
  async sendNotification() {
    const message = '새로운 알림이 도착했습니다!';
    await this.pubSub.publish('NOTIFICATION_ADDED', { notificationAdded: message });
    return '알림 전송 완료';
  }

  @Subscription(() => String, {
    resolve: (payload) => payload.notificationAdded,
  })
  notificationAdded() {
    return this.pubSub.asyncIterator('NOTIFICATION_ADDED');
  }
}

✅ 2) GraphQL Subscription 요청 예제

subscription {
  notificationAdded
}

✅ 클라이언트가 Subscription을 구독하고 있으면, Mutation 발생 시 실시간으로 데이터 전달

---

19.4 NestJS WebSocket으로 실시간 채팅 구현

✅ 1) WebSocket 모듈 설치

npm install @nestjs/websockets @nestjs/platform-socket.io

---

✅ 2) WebSocket Gateway 생성

📂 chat.gateway.ts

import { WebSocketGateway, WebSocketServer, SubscribeMessage, MessageBody } from '@nestjs/websockets';
import { Server } from 'socket.io';

@WebSocketGateway({ cors: true })
export class ChatGateway {
  @WebSocketServer()
  server: Server;

  @SubscribeMessage('chatMessage')
  handleMessage(@MessageBody() message: string): void {
    this.server.emit('chatMessage', message);
  }
}

---

✅ 3) 프론트엔드 WebSocket 클라이언트 예제

  const socket = io('http://localhost:3000');
  
  socket.emit('chatMessage', '안녕하세요!');
  
  socket.on('chatMessage', (msg) => {
    console.log('받은 메시지:', msg);
  });

💡 NestJS WebSocket Gateway를 사용하면 채팅, 실시간 협업 기능을 쉽게 구현할 수 있습니다.

---

19.5 실시간 SaaS 시스템 설계 시 고려할 점

✔ Connection 관리 → WebSocket의 상태 유지 및 세션 처리 필요
✔ 보안 및 인증 → JWT 토큰 기반 인증으로 보안 강화
✔ 로드 밸런싱 → WebSocket 사용 시 Redis PubSub 또는 Kafka 활용
✔ 고객별 실시간 데이터 분리 → 멀티 테넌시 환경에서 tenantId 기반의 필터링 필요

---

19.6 결론: NestJS로 강력한 실시간 SaaS 백엔드 구축하기

✅ GraphQL Subscriptions를 사용하면 실시간 대시보드, 알림 기능 구현 가능
✅ WebSocket Gateway를 활용하면 실시간 채팅 및 협업 서비스 가능
✅ 멀티 테넌시 환경에서 각 테넌트별 데이터 스트리밍 전략 필요

다음 글에서는 NestJS에서 AI/ML 모델을 활용하여 SaaS 서비스에 인공지능 기능을 추가하는 방법을 다룹니다! 🚀

---

🔍 다음 글 예고: NestJS AI/ML 연동하여 SaaS 기능 확장

📌 다음 편: 20. NestJS에서 AI/ML 연동 실전 가이드