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