메인 콘텐츠로 건너뛰기
Header
백엔드 디렉토리 구조는 다음과 같습니다: 
server
  └───ability
  └───constants 
  └───core
  └───database
  └───decorators
  └───filters
  └───guards
  └───health
  └───integrations
  └───metadata
  └───workspace
  └───utils

​
Ability

각 엔티티에 대한 권한을 정의하고 핸들러를 포함합니다.

​
데코레이터

추가 기능을 위한 NestJS 커스텀 데코레이터를 정의합니다. 자세한 내용은 커스텀 데코레이터를 참조하세요.

​
필터

GraphQL 엔드포인트에서 발생할 수 있는 예외를 처리하기 위한 예외 필터를 포함합니다.

​
가드

자세한 내용은 가드를 참조하세요.

​
Health

데이터베이스가 예상대로 작동하는지 확인하기 위해 JSON을 반환하는 공개 API(healthz)를 포함합니다.

​
메타데이터

커스텀 객체를 정의하고 GraphQL API (graphql/metadata)를 제공합니다.

​
워크스페이스

메타데이터 기반의 커스텀 GraphQL 스키마를 생성하고 제공합니다.

​
Workspace Directory Structure

workspace

  └───workspace-schema-builder
    └───factories 
    └───graphql-types
    └───database
    └───interfaces
    └───object-definitions
    └───services
    └───storage
    └───utils
  └───workspace-resolver-builder
    └───factories
    └───interfaces
  └───workspace-query-builder
    └───factories
    └───interfaces
  └───workspace-query-runner
    └───interfaces
    └───utils 
  └───workspace-datasource
  └───workspace-manager
  └───workspace-migration-runner
  └───utils 
  └───workspace.module.ts   
  └───workspace.factory.spec.ts    
  └───workspace.factory.ts
작업 공간 디렉토리의 루트에는 개별 작업 공간을 위한 스키마를 맞춤화하는 createGraphQLSchema 함수가 포함된 workspace.factory.ts 파일이 있습니다. 이 함수는 메타데이터를 사용하여 작업 공간별 스키마를 생성합니다. 스키마와 리졸버 구조를 분리하여, 이러한 개별 요소를 결합하는 makeExecutableSchema 함수를 사용합니다. 이 전략은 조직화뿐만 아니라 성능 및 확장성을 향상시키기 위해 생성된 타입 정의를 캐시하는 최적화에도 기여합니다.

​
작업 공간 스키마 빌더

GraphQL 스키마를 생성하며 다음을 포함합니다:

​
팩토리:

GraphQL 관련 구성 요소를 생성하는 특수 생성자입니다.
  • type.factory는 TypeMapperService를 사용하여 필드 메타데이터를 GraphQL 타입으로 변환합니다.
  • type-definition.factory는 objectMetadata에서 파생된 GraphQL 입력 또는 출력 객체를 만듭니다.

​
GraphQL 타입

열거형, 입력, 객체, 스칼라를 포함하며, 스키마 구축의 기초로 사용됩니다.

​
인터페이스 및 객체 정의

GraphQL 엔티티를 위한 청사진을 포함하며, MONEY나 URL과 같은 사전 정의와 커스텀 타입을 포함합니다.

​
서비스

FieldMetadataType과 적절한 GraphQL 스칼라 또는 쿼리 수정자를 연결하는 서비스가 포함되어 있습니다.

​
저장소

GraphQL 타입의 중복을 방지하기 위해 재사용 가능한 타입 정의를 포함하는 TypeDefinitionsStorage 클래스를 포함합니다.

​
작업 공간 리졸버 빌더

GraphQL 스키마를 쿼리하고 변경하기 위한 리졸버 함수를 만듭니다. 이 디렉토리의 각 팩토리는 다양한 테이블에 걸쳐 적응 가능한 FindManyResolverFactory와 같은 명확한 리졸버 타입을 생성할 책임이 있습니다.

​
작업 공간 쿼리 실행기

데이터베이스에서 생성된 쿼리를 실행하고 결과를 구문 분석합니다.