Antigravity Agent
32 lines
2.5 KiB
Markdown
32 lines
2.5 KiB
Markdown
---
|
|
id: [[P-Reinforce|P-Reinforce]]-AUTO-GQCG-001
|
|
category: Dev
|
|
confidence_score: 0.96
|
|
tags: [auto-reinforced, graphql, code-generator, typescript, type-safety, [[Schema|Schema]], automation, api-development]
|
|
last_reinforced: 2026-04-20
|
|
---
|
|
|
|
# [[GraphQL-Code-Generator|GraphQL-Code-Generator]]
|
|
|
|
## 📌 한 줄 통찰 (The Karpathy Summary)
|
|
> "서버와 클라이언트의 실시간 동기화: 서버의 GraphQL 스키마를 읽어 클라이언트에서 즉시 사용할 수 있는 완벽한 타입스크립트 타입과 데이터 요청 함수를 자동 생성하여, 수동 작업으로 인한 '타입 미스매치'를 0%로 만드는 자동화 도구."
|
|
|
|
## 📖 구조화된 지식 (Synthesized Content)
|
|
GraphQL 코드 제너레이터(GraphQL-Code-Generator)는 GraphQL 스키마와 작업(Query, Mutation 등)을 분석하여 다양한 언어의 타입과 코드를 생성해 주는 오픈 소스 라이브러리입니다.
|
|
|
|
1. **동작 매커니즘**:
|
|
* **Input**: `schema.graphql` 파일 + 프론트엔드에서 작성한 `.graphql` 쿼리 파일들.
|
|
* **[[Processing|Processing]]**: 플러그인 시스템을 통해 AST 분석 및 템플릿 적용.
|
|
* **Output**: `types.ts`, `hooks.ts` 등 (React Query, Apollo, SWR 대응 가능). ([[Efficiency|Efficiency]]와 연결)
|
|
2. **왜 중요한가?**:
|
|
* API 변경 시 클라이언트 코드가 즉시 컴파일 에러를 띄우므로, 런타임 장애 정책을 사전에 완벽히 차단하기 때문임. ([[Reliability|Reliability]]와 연결)
|
|
|
|
## ⚠️ 모순 및 업데이트 (Contradictions & RL Update)
|
|
- **과거 데이터와의 충돌**: 과거에는 `any` 타입을 쓰거나 수동으로 인터페이스 정책을 맞췄으나, 현대 정책은 'Schema-first' 또는 'Code-first' 방식 정책을 통해 타입 정책을 100% 자동 생성 정책하는 것이 표준임(RL Update). ([[Distributed-System-Type-Safety|Distributed-System-Type-Safety]]와 연결)
|
|
- **정책 변화(RL Update)**: 이제는 단순 타입 생성 정책을 넘어, 스키마 정보를 활용하여 목업 데이터(Mocking) 정책이나 유효성 검사 로직(Zod) 정책까지 자동으로 생성해 주는 풀스택 개발 가속기로 진화함.
|
|
|
|
## 🔗 지식 연결 (Graph)
|
|
- [[Efficiency|Efficiency]], [[Reliability|Reliability]], [[Distributed-System-Type-Safety|Distributed-System-Type-Safety]], [[Technical-Architecture|Technical-Architecture]], Standard-Operating-Procedure, Automation
|
|
- **Key Ecosystem**: The Guild (Creators).
|
|
---
|