docs(10_Wiki): Dev 폴더 누락분 반영 — Topic_Programming으로 통합

이전 재구성 작업에서 Dev/ 폴더가 누락되었던 것을 반영.

- Dev/Topic_Programming(중첩 폴더, 78개)은 Dev 자체 최상위 폴더들
  (Architecture/Conventions/Engineering_Intelligence 등)과 완전 중복이라 제거.
- Dev 최상위 엔지니어링 지식 폴더(Architecture/Conventions/Engineering_Intelligence/
  Failure_Library/Generalized_Principles/Language/Pattern_Catalog/Platform_Guides/
  Subsystems, 77개)는 이미 Topic_Programming/Topic_Programming에 더 최신 버전이
  존재해 중복 제거(고유 콘텐츠 1개는 예외 처리하여 이동 보존).
- Dev의 W3Schools 언어 튜토리얼 폴더(Topic_C/CPP/CSS/CSharp/HOWTO/HTML/Java/
  JavaScript/PHP/Python/SQL/W3CSS, 1201개)는 전부 Topic_Programming 하위로 이동.
- 에이전트 운영 상태(.astra/docs)는 그대로 유지, 콘텐츠 폴더만 정리.
- Topic_Programming 최종 문서 수: 2784 → 3985.

10_Wiki/Topic_Programming/Topic_CPP/CPP_Friend_Function.md

@@ -0,0 +1,72 @@
+---
+id: cpp-friend-function
+title: "C++ The Friend Keyword"
+category: "Programming_Language"
+status: "draft"
+verification_status: "conceptual"
+canonical_id: ""
+aliases: ["friend function", "bypass encapsulation", "C++ friend 키워드"]
+duplicate_of: ""
+source_trust_level: "B"
+confidence_score: 0.86
+created_at: 2026-07-04
+updated_at: 2026-07-04
+review_reason: ""
+merge_history: []
+tags: ["cpp", "programming-language", "w3schools", "oop", "friend", "encapsulation"]
+raw_sources: ["https://www.w3schools.com/cpp/cpp_friend_function.asp"]
+applied_in: []
+github_commit: ""
+---
+
+# [[CPP The Friend Keyword]]
+
+## 🎯 한 줄 통찰 (One-line insight)
+A `friend` function is deliberately EXEMPT from the entire Encapsulation chapter's rule — it's NOT a member of the class at all, yet it can read `private` data directly with no getter method required, meaning `friend` is a language-level ESCAPE HATCH from encapsulation, granted explicitly and individually per-function rather than a general loophole, since each `friend` declaration must name exactly which external function gets the privilege. [S1]
+
+## 🧠 핵심 개념 (Core concepts)
+- **Friend function** — a function that is NOT a member of the class, but is explicitly GRANTED access to the class's `private` members. [S1]
+- **Declared inside, defined outside** — the friend function's declaration lives INSIDE the class (marked with `friend`), but its actual body is written OUTSIDE the class like a normal function. [S1]
+- **Bypasses the getter/setter requirement** — unlike ordinary external code (which must use public getters/setters per the Encapsulation chapter), a friend function reads `private` members directly. [S1]
+
+## 📖 세부 내용 (Details)
+- A friend function accessing a private attribute directly: `class Employee { private: int salary; public: Employee(int s) { salary = s; } friend void displaySalary(Employee emp); }; void displaySalary(Employee emp) { cout << "Salary: " << emp.salary; } Employee myEmp(50000); displaySalary(myEmp);` — `displaySalary` isn't a class member but reads `emp.salary` directly. [S1]
+
+## ⚖️ 모순 및 업데이트 (Contradictions & updates)
+- **friend는 캡슐화 규칙의 예외**: 일반적으로 private 멤버는 public 게터/세터로만 접근해야 하지만, friend로 선언된 함수는 클래스의 멤버가 아님에도 private 데이터를 직접 읽을 수 있다는 점에서 캡슐화 원칙의 명시적 예외임이 확인됨. [S1]
+
+## 🛠️ 적용 사례 (Applied in summary)
+Employee의 private 급여(salary)를 friend 함수 displaySalary()가 게터 없이 직접 출력하는 예제가 friend 키워드의 대표 실전 활용 사례로 원문에 직접 제시됨. [S1]
+
+## 💻 코드 패턴 (Code patterns)
+A friend function reading a private member directly, with no getter needed (C++):
+```cpp
+class Employee {
+private:
+  int salary;
+public:
+  Employee(int s) { salary = s; }
+  friend void displaySalary(Employee emp); // friend declaration
+};
+void displaySalary(Employee emp) { // defined outside, not a member
+  cout << "Salary: " << emp.salary; // direct access to private data
+}
+```
+
+## ✅ 검증 상태 및 신뢰도
+- **상태:** draft
+- **검증 단계:** conceptual
+- **출처 신뢰도:** B (W3Schools — widely used educational reference, not a primary standards body)
+- **신뢰 점수:** 0.86
+- **중복 검사 결과:** 신규 생성 (New discovery)
+
+## 🔗 지식 그래프 (Knowledge Graph)
+- **상위/루트:** [[C++ Tutorial]]
+- **관련 개념:** [[CPP Virtual Functions]], [[CPP Encapsulation]], [[CPP Templates]]
+- **참조 맥락:** friend 함수 — 템플릿(Templates) 챕터로 이어짐.
+
+## 📚 출처 (Sources)
+- [S1] W3Schools — C++ The Friend Keyword — https://www.w3schools.com/cpp/cpp_friend_function.asp
+
+## 📝 변경 이력 (Change history)
+- 2026-07-04: Initial draft synthesized from the W3Schools "C++ The Friend Keyword" page (Astra wiki-curation, P-Reinforce v3.1 format).