GraphQL + 클린 아키텍처 상용구

4879 단어 boilerplate typescript graphql cleanarchitecture

영감

Clean Architecture은 깨끗하고 구조적이며 유지 관리 가능한 프로젝트를 구축하고자 하는 개발자를 위한 유용한 안내서입니다. SOLID 원칙의 문자 L을 사용하면 비즈니스 및 시스템의 핵심을 건드리지 않고도 종속 구성 요소를 쉽게 교체할 수 있습니다. 예를 들어 많은 프레임워크(Expressjs, GraphQL 등)가 있고 선택한 결정은 비즈니스의 목적과 컨텍스트에 따라 달라지는 웹 서버의 경우입니다.

이 상용구 가이드 범위에서는 세부 기술의 변경으로 핵심 비즈니스를 면역으로 만드는 방법을 살펴보겠습니다. 갑시다!

여기에서 구현 세부 정보를 찾을 수 있습니다repository.

상용구

코드 구조

.
├── package.json
├── package-lock.json
├── README.md
├── src
│   ├── application
│   │   ├── auth
│   │   │   └── index.ts
│   │   ├── graphql
│   │   │   ├── index.ts
│   │   │   ├── schemaShards
│   │   │   │   ├── index.ts
│   │   │   │   └── users.ts
│   │   │   ├── subscriptionManager.ts
│   │   │   └── utils
│   │   │       └── mergeRawSchemas.ts
│   │   └── index.ts
│   ├── dto
│   │   └── user.dto.ts
│   ├── entities
│   │   └── user.entity.ts
│   ├── index.ts
│   ├── IoC
│   │   ├── container.ts
│   │   ├── icradle.interface.ts
│   │   └── providers
│   │       ├── auth.provider.ts
│   │       └── user.provider.ts
│   ├── persistence
│   │   ├── auth.repository.ts
│   │   ├── constants.ts
│   │   ├── password.ts
│   │   └── user.repository.ts
│   ├── services
│   │   ├── auth.repository.interface.ts
│   │   ├── auth.service.ts
│   │   ├── user.repository.interface.ts
│   │   └── user.service.ts
│   └── __typedefs
│       ├── graphqlTypes.d.ts
│       └── schema.graphql
└── tsconfig.json

기본 폴더는 src이며 구현이 포함되어 있습니다.

애플리케이션: 백엔드 웹 애플리케이션 프레임워크를 사용할 수 있는 애플리케이션 계층입니다. 이 상용구에는 GraphQL가 있습니다.

서비스: 애플리케이션 사용 사례를 처리하기 위해 논리를 정의한 비즈니스 서비스 계층입니다. 이 계층에는 데이터베이스에 대한 액세스와 같은 세부 작업을 추상화하는 어댑터도 포함되어 있습니다.

엔터티: 애플리케이션 엔터티를 정의하는 애플리케이션의 핵심 구성 요소입니다.

지속성: 이것은 데이터베이스, 메시지 대기열 등과 통신하기 위한 작업을 지정하는 또 다른 세부 계층입니다.

dto: (Data Transfer Object의 약자)는 계층 간의 통신 계약을 정의합니다. 예를 들어 레이어의 메서드에서 사용되는 입력 매개변수 또는 반환 값의 유형

IoC: (Inversion of Control의 약자)는 SOLID 주체의 문자 D인 종속성 주입의 구현입니다. 새 서비스 클래스, 새 리포지토리 클래스 또는 새 컨트롤러를 만들 때마다 이 컨테이너에 등록해야 합니다. 이 상용구는 Awilix 라이브러리를 사용하여 요소를 달성합니다.