--- id: wiki-2026-0508-런타임-유효성-검사-runtime-validation title: 런타임 유효성 검사 (Runtime Validation) category: Redirect status: merged canonical_id: self aliases: [P-Reinforce-REDIRECT-RV-001] duplicate_of: Runtime_Validation source_trust_level: A confidence_score: 0.92 tags: [uncategorized] raw_sources: [] last_reinforced: 2026-05-08 github_commit: pending inferred_by: Claude Opus 4.7 (auto-normalize 2026-05-08) tech_stack: language: unspecified framework: unspecified --- # [[런타임 유효성 검사 (Runtime Validation)]] > [!NOTE] > 본 문서는 **[[Runtime_Validation]]**으로 통합되었습니다. 🫡🐟 ## 📌 한 줄 통찰 (The Karpathy Summary) > 런타임 유효성 검사는 외부 데이터(API 응답, 폼 입력, 환경변수)가 기대 형태인지 실행 시점에 확인하는 보호 계층으로, TypeScript 타입만으로는 부족한 경계 검증을 보완한다. ## 📖 구조화된 지식 (Synthesized Content) **추출된 패턴:** 타입은 빌드 타임 약속, 검증은 런타임 약속 — 둘이 같은 출처(스키마)에서 나와야 drift 방지. **세부 내용:** - 검증 위치: API 경계, DB 입출력, 폼, env. - 라이브러리: Zod, Yup, Valibot, io-ts. - 패턴: parse 후 정상값만 도메인으로 진입. - 에러 처리: 사용자 메시지 + 로깅 분리. - 비용: 런타임 오버헤드 vs 디버깅 비용 절감. ## 🤖 LLM 활용 힌트 (How to Use This Knowledge) **언제 이 지식을 쓰는가:** - *(TODO)* **언제 쓰면 안 되는가:** - *(TODO)* ## 🧪 검증 상태 (Validation) - **정보 상태:** merged - **출처 신뢰도:** A - **검토 이유:** *(P-Reinforce Phase 1 자동 정규화. 본문 검증 필요.)* ## 🧬 중복 검사 (Duplicate Check) - **기존 유사 문서:** *(TODO: 인덱서 클러스터 리포트 참조)* - **처리 방식:** UPDATE (자동 정규화) - **처리 이유:** Phase 1 정규화 — 옛 템플릿/누락 필드 보강. ## ⚠️ 모순 및 업데이트 (Contradictions & Updates) - **과거 데이터와의 충돌:** 없음 - **정책 변화:** 없음 ## 🔗 지식 연결 (Graph) - **Parent:** [[10_Wiki/Topics]] - **Related:** *(TODO: 최소 2개)* - **Opposite / Trade-off:** *(TODO)* - **Raw Source:** 직접 입력 ## 🕓 변경 이력 (Changelog) | 날짜 | 변경 내용 | 처리 방식 | 신뢰도 | |------|-----------|-----------|--------| | 2026-05-08 | P-Reinforce Phase 1 정규화 (frontmatter + 헤더 표준화) | UPDATE | A | ## 💻 코드 패턴 (Code Patterns) **패턴 1:** *(TODO: 이 프로젝트 컨벤션 반영한 구조 스켈레톤)* ```text # TODO ``` ## 🤔 의사결정 기준 (Decision Criteria) **선택 A를 써야 할 때:** - *(TODO)* **선택 B를 써야 할 때:** - *(TODO)* **기본값:** > *(TODO)* ## ❌ 안티패턴 (Anti-Patterns) - **[안티패턴]:** *(TODO: 무엇을 하면 안 되는가 + 이유 + 대신 무엇을)*