2nd/10_Wiki/Topics/DevOps_and_Security/Encapsulation-via-Access-Modifiers.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-via-access-modifie	Encapsulation via Access Modifiers	10_Wiki/Topics	needs_review	self	P-Reinforce-AI-ACCESS-MODIFIERS	none	A	1.0	OOP Programming AccessModifiers Security		2026-04-20	pending	Claude Opus 4.7 (auto-normalize 2026-05-08)	language framework unspecified unspecified

Encapsulation-via-Access-Modifiers (접근 제어자를 통한 캡슐화)

📌 한 줄 통찰 (The Karpathy Summary)

"공개할 것인가, 숨길 것인가에 대한 명확한 선언." public, private, protected와 같은 키워드를 통해 클래스 멤버의 가시성을 제어하고 접근 경로를 설계하는 구체적인 실천 방식이다.

📖 구조화된 지식 (Synthesized Content)

• Access Modifiers:
  • Private: 오직 해당 클래스 내부에서만 접근 가능. (철저한 보호)
  • Protected: 해당 클래스와 이를 상속받은 자식 클래스에서 접근 가능.
  • Public: 어디서든 접근 가능. (공개 API)
• Default/Package-Private: (언어마다 다름) 같은 패키지 내 공유.
• Role: 객체의 내부 상태를 외부로부터 고립시켜 '깨지기 쉬운 코드'가 되는 것을 방지함.

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

• JavaScript/TypeScript 진영에서는 #private 문법이 표준화되기 전까지 접두사 _를 관습적으로 사용해왔다. 하지만 이는 강제성이 없어 '의도된 약속'에 의존했다면, 이제는 언어 차원의 강제성을 부여하는 것이 표준이다. 테스트 코드를 위해 private을 억지로 여는 것은 부적절한 설계 신호일 수 있다.

🔗 지식 연결 (Graph)

• Related: Encapsulation-and-Information-Hiding , Interface-Segregation-Principle
• Language Specific: TypeScript-Private-Fields

🤖 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: 무엇을 하면 안 되는가 + 이유 + 대신 무엇을)