GraphQL Mutation 설계 원칙: 명시적 작명, 단일 입력 객체, 중첩 구조 활용

GraphQL Mutation을 설계할 때 세 가지 핵심 원칙을 따르는 것이 권장된다. 첫째, 명시적인 작명이다. sendPasswordResetEmail처럼 구체적인 의도를 드러내는 RPC 스타일의 Mutation이 범용적인 Mutation보다 타입 시스템의 이점을 살리고 UI 개발 및 보안에 유리하다. 둘째, 단일 입력 객체 사용이다. Mutation은 input이라는 이름의 null이 아닌 고유한 입력 객체 타입을 하나의 인자로만 받아야 하며, 이는 클라이언트에서의 변수 처리를 단순화한다. 셋째, 중첩 구조의 활용이다. 입력 객체와 반환값(Payload)을 중첩된 커스텀 객체 타입으로 설계하면, 향후 clientMutationId나 에러 정보 같은 메타데이터 필드를 추가하거나 기존 필드를 Deprecate할 때 스키마 변경 부담을 줄이고 API의 버전 호환성을 유지할 수 있다.