스키마 계약

GraphQL 스키마는 타입, 쿼리, 리졸버 계약을 맞춘다

schema.gql은 단순 선언 파일이 아니라 클라이언트가 호출할 모양과 서버 리졸버가 지켜야 할 계약입니다.

type

Object Type

클라이언트가 받을 필드 이름과 nullable 여부를 명확히 드러냅니다.

query

조회 조건과 반환 타입을 정해 API의 읽기 경로를 만듭니다.

mutation

입력 타입과 결과 타입을 분리해 쓰기 작업의 실패 가능성을 표현합니다.

resolver

스키마 필드와 클래스 메서드 이름, 반환 타입이 어긋나지 않게 맞춥니다.

GraphQL 스키마 계약 클라이언트 화면이 필요한 데이터부터 타입과 쿼리 이름을 정합니다.

구현 기준 리졸버는 스키마의 nullable, 배열, 입력 타입 조건을 그대로 따라야 합니다.

리졸버 연결 검산 Playground나 테스트 쿼리로 스키마 변경이 실제 응답에 반영되는지 확인합니다.