정정지용
프로젝트 목록
백엔드

레이싱 게임 워커 서비스 아키텍처 문서

레이싱 게임 플랫폼의 NestJS 기반 워커 서비스 구조와 엔티티 빌드 관례를 정리한 공개 기술 문서

racing-game-platform-worker-docs최근 업데이트 2026년 7월 26일

개요

레이싱 게임 플랫폼에서 API 서비스와 분리되어 독립적으로 배포되는 NestJS 워커 서비스의 구조를 설명하는 문서 프로젝트입니다. TypeORM 을 사용해 데이터베이스 스키마와 마이그레이션을 관리하며, entities 디렉터리의 엔티티 소스를 build-entity.js 로 빌드 타임에 사전 처리해 마이그레이션/스키마 sync 를 안정적으로 다루는 관례를 채택했습니다. 빌드와 배포는 Docker 이미지화 후 Jenkins CI 파이프라인을 통해 이루어집니다. 이 레포는 실제 소스 코드 없이 해당 워커 서비스의 구조와 설계 관례만을 공개적으로 정리한 문서입니다.

담당 역할

레이싱 게임 플랫폼의 워커 서비스를 설계·구현하고, 그 구조와 엔티티 빌드 관례를 정리해 공개 문서로 작성함.

아키텍처 다이어그램

레포지토리 분석 결과를 바탕으로 자동 생성된 구조도입니다.

아키텍처

워커 서비스 구조

NestJS 워커 서비스가 API 서비스와 분리되어 배포되며, 엔티티 빌드와 CI/CD를 거쳐 데이터베이스와 연결되는 구조를 보여준다.

다이어그램을 그리는 중…

기술스택

각 기술을 이 프로젝트에서 어떤 용도로 썼는지 정리했습니다.

언어

  • TypeScriptNestJS 애플리케이션 및 엔티티, ormconfig 작성 언어

백엔드

  • NestJS워커 서비스의 기반 백엔드 프레임워크

데이터베이스

  • TypeORMormconfig.ts 기반 데이터베이스 스키마 및 마이그레이션 관리

인프라

  • Docker워커 서비스 컨테이너 이미지 빌드

DevOps

  • JenkinsCI 파이프라인을 통한 빌드/배포 자동화

핵심 포인트

  • build-entity.js 로 엔티티 클래스를 빌드 타임에 사전 처리해 마이그레이션/스키마 sync 안정성 확보
  • 워커 서비스를 API 서비스와 분리된 독립 배포 단위로 구성
  • TypeORM 기반으로 엔티티와 데이터베이스 스키마를 일관되게 관리
  • Docker + Jenkins 조합으로 워커 서비스의 CI 빌드/배포 자동화

문제와 해결

문제TypeORM 마이그레이션과 스키마 sync 를 안정적으로 다루기 어려운 문제

해결엔티티 클래스를 빌드 타임에 사전 처리하는 build-entity.js 를 도입해 관례화함

레포지토리 정보

생성
2026년 7월 26일
최근 커밋
2026년 7월 26일
크기
0 KB
라이선스
없음

이 문서는 2026년 7월 26일 에 자동 분석으로 생성되었습니다.