2nd/10_Wiki/Topics/AI_and_ML/Encapsulation-and-Information-Hiding.md

id, title, category, status, canonical_id, aliases, duplicate_of, source_trust_level, confidence_score, tags, raw_sources, last_reinforced, github_commit, inferred_by, tech_stack

id	title	category	status	canonical_id	aliases	duplicate_of	source_trust_level	confidence_score	tags	raw_sources	last_reinforced	github_commit	inferred_by	tech_stack
wiki-2026-0508-encapsulation-and-information-hi	Encapsulation and Information Hiding	10_Wiki/Topics	needs_review	self	P-Reinforce-AI-ENCAPSULATION	none	A	1.0	OOP SoftwareDesign Encapsulation InformationHiding		2026-04-20	pending	Claude Opus 4.7 (auto-normalize 2026-05-08)	language framework unspecified unspecified

Encapsulation-and-Information-Hiding (캡슐화와 정보 은닉)

📌 한 줄 통찰 (The Karpathy Summary)

"내부 부품은 숨기고 조작 핸들만 노출하라." 데이터와 그 데이터를 조작하는 메서드를 하나로 묶고, 외부에서 직접적인 접근을 제한하여 객체의 무결성을 보호하고 결합도를 낮추는 객체지향의 핵심 원칙이다.

📖 구조화된 지식 (Synthesized Content)

• Encapsulation (캡슐화): 데이터와 행위의 번들링. "함께 쓰이는 것은 함께 두라."
• Information Hiding (정보 은닉): 구현 세부 사항(어떻게 돌아가는지)을 감추어 인터페이스(무엇을 하는지)만 알면 사용 가능하게 함.
• Benefits:
  • Maintainability: 내부 로직을 바꿔도 외부 인터페이스만 같으면 다른 코드에 영향을 주지 않음.
  • Security: 의도치 않은 데이터 변조 방지.

⚠️ 모순 및 업데이트 (Contradictions & Updates)

• 캡슐화가 너무 과하면 지나친 추상화로 인해 코드가 복잡해지는 '추상 공해'가 발생한다. 무늬만 캡슐화인 단순 Getter/Setter 남발은 지양해야 한다. 최근 함수형 프로그래밍의 부상으로 데이터(Record)와 로직(Function)을 다시 분리하는 경향도 있으나, 대규모 시스템의 복잡도 제어에는 여전히 필수적인 개념이다.

🔗 지식 연결 (Graph)

• Related: Object-Oriented-Programming (OOP) , SoC ([[뇌와 팔다리의 분리 - 관심사의 분리 (Separation of Concerns)|Separation of Concerns]])
• Practice: Getter-Setter-Abuse

🤖 LLM 활용 힌트 (How to Use This Knowledge)

언제 이 지식을 쓰는가:

• (TODO)

언제 쓰면 안 되는가:

• (TODO)

🧪 검증 상태 (Validation)

• 정보 상태: needs_review
• 출처 신뢰도: A
• 검토 이유: (P-Reinforce Phase 1 자동 정규화. 본문 검증 필요.)

🧬 중복 검사 (Duplicate Check)

• 기존 유사 문서: (TODO: 인덱서 클러스터 리포트 참조)
• 처리 방식: UPDATE (자동 정규화)
• 처리 이유: Phase 1 정규화 — 옛 템플릿/누락 필드 보강.

🕓 변경 이력 (Changelog)

날짜	변경 내용	처리 방식	신뢰도
2026-05-08	P-Reinforce Phase 1 정규화 (frontmatter + 헤더 표준화)	UPDATE	A

💻 코드 패턴 (Code Patterns)

패턴 1: (TODO: 이 프로젝트 컨벤션 반영한 구조 스켈레톤)

# TODO

🤔 의사결정 기준 (Decision Criteria)

선택 A를 써야 할 때:

• (TODO)

선택 B를 써야 할 때:

• (TODO)

기본값:

(TODO)

❌ 안티패턴 (Anti-Patterns)

• [안티패턴]: (TODO: 무엇을 하면 안 되는가 + 이유 + 대신 무엇을)