diff --git a/10_Wiki/Decisions/Index.md b/10_Wiki/Decisions/Index.md
deleted file mode 100644
index aafb18a1..00000000
--- a/10_Wiki/Decisions/Index.md
+++ /dev/null
@@ -1,5 +0,0 @@
-# Index: Decisions
-
-## ๐ Subcategories
-- Skybound
-
diff --git a/10_Wiki/Decisions/Skybound/Index.md b/10_Wiki/Decisions/Skybound/Index.md
deleted file mode 100644
index 5a3b1def..00000000
--- a/10_Wiki/Decisions/Skybound/Index.md
+++ /dev/null
@@ -1,6 +0,0 @@
-# Index: Decisions > Skybound
-
-## ๐ Documents
-- [[Combat_Balance_Buff|Combat_Balance_Buff]]
-- [[Frame_Type_Restoration|Frame_Type_Restoration]]
-- [[IDE_Stability_Fix|IDE_Stability_Fix]]
diff --git a/10_Wiki/Development/Index.md b/10_Wiki/Development/Index.md
deleted file mode 100644
index b03aa5f6..00000000
--- a/10_Wiki/Development/Index.md
+++ /dev/null
@@ -1,7 +0,0 @@
-# Index: Development
-
-## ๐ Subcategories
-- UI_Components
-
-## ๐ Documents
-- [[Homepage_React_Best_Practices|Homepage_React_Best_Practices]]
diff --git a/10_Wiki/Development/UI_Components/Index.md b/10_Wiki/Development/UI_Components/Index.md
deleted file mode 100644
index 93fe9891..00000000
--- a/10_Wiki/Development/UI_Components/Index.md
+++ /dev/null
@@ -1,4 +0,0 @@
-# Index: Development > UI_Components
-
-## ๐ Documents
-- [[Accordion|Accordion]]
diff --git a/10_Wiki/Management/Code Review.md b/10_Wiki/Management/Code Review.md
deleted file mode 100644
index e8ba29f5..00000000
--- a/10_Wiki/Management/Code Review.md
+++ /dev/null
@@ -1,56 +0,0 @@
-# [[Code Review|Code Review]]
-
-## ๐ Brief Summary
-์ฝ๋ ๋ฆฌ๋ทฐ(Code Review)๋ ๊ฐ๋ฐ์๊ฐ ์์ฑํ ์ฝ๋๋ฅผ ๋ฉ์ธ ๋ธ๋์น์ ๋ณํฉํ๊ธฐ ์ ์ ํ์(๋๋ฃ)์ด ๊ฒํ ํ์ฌ ์น์ธํ๋ ํ์ง ๊ด๋ฆฌ ๋ฐ ํ์
ํ๋ก์ธ์ค์
๋๋ค [1, 2]. ์ฃผ๋ก Pull Request(PR) ๋จ๊ณ๋ฅผ ํตํด ์ด๋ฃจ์ด์ง๋ฉฐ, ๋จ๋
์ผ๋ก ์๋ชป๋ ์ฝ๋๊ฐ ๋ณํฉ๋๋ ๊ฒ์ ๋ฐฉ์งํ๊ณ ํ ๋ด ๋น ๋ฅธ ํผ๋๋ฐฑ ๋ฃจํ๋ฅผ ํ์ฑํฉ๋๋ค [1]. ์ต๊ทผ ํ๋ก ํธ์๋ ํ๊ฒฝ์์๋ ๋จ์ํ ์ฝ๋ ๊ฒํ ๋ฅผ ๋์ด Storybook๊ณผ ๊ฐ์ ๋๊ตฌ๋ฅผ CI ํ์ดํ๋ผ์ธ๊ณผ ๊ฒฐํฉํ '์๊ฐ์ ๋ฆฌ๋ทฐ(Visual Review)'๋ก ํ์ฅ๋์ด ์๋์น ์์ UI ๋ณ๊ฒฝ์ ๋ฐฉ์งํ๋ ์ญํ ๋ ์ํํฉ๋๋ค [3].
-
-## ๐ Core ์์ค์ ๊ธฐ๋ฐํ Core Content
-- **๋๋ฃ ๊ฒํ (Peer Review)์ ์ญํ ๋ฐ ์ด์ **: ๊ฐ๋ฐ์๋ ๊ธฐ๋ฅ ๋ธ๋์น(feature branch)์์ ์์
์ ๋ง์น ํ ๋ณํฉ์ ์ํ Pull Request(PR)๋ฅผ ์์ฑํ๋ฉฐ, ์ด๋ ์ต์ 1๋ช
์ด์์ ํ์์๊ฒ ๊ฒํ ์ ์น์ธ์ ๋ฐ์์ผ ํฉ๋๋ค [1, 4]. ๋ฆฌ๋ทฐ์ด๋ ๋ณ๊ฒฝ๋ ์ฝ๋์ ๋ํด ์ฝ๋ฉํธ๋ฅผ ๋จ๊ธฐ๋ฉฐ, ์์ฑ์๊ฐ ์ด๋ฅผ ์์ ํ๊ณ ์ฌํธ์(push)ํ์ฌ ์ต์ข
์น์ธ์ ๋ฐ์ผ๋ฉด ๋ณํฉ์ด ์ด๋ฃจ์ด์ง๋๋ค [5]. ์ด๋ ๋จ์ผ ๊ฐ๋ฐ์์ ์ค์๋ก ์ธํ ์๋ชป๋ ๋ณํฉ์ ๋ง๊ณ , ํ์ ๊ฐ์ ๊ฑด์ ํ ๋ฆฌ๋ทฐ ์ต๊ด๊ณผ ํ์
์ ์ด์งํฉ๋๋ค [1, 6].
-- **ํจ์จ์ ์ธ PR ์ํฐ์ผ**: ์ํํ ์ฝ๋ ๋ฆฌ๋ทฐ๋ฅผ ์ํด์๋ PR์ ์๊ฒ ์ ์งํ๊ณ ๋จ์ผ ์์
(Single task)์ ์ง์คํ๋ ๊ฒ์ด ๋ชจ๋ฒ ์ฌ๋ก์
๋๋ค [2]. ๋ฆฌ๋ทฐ์ด๊ฐ ํ ๋ฒ์ 2,000์ค ์ด์์ ๋ฐฉ๋ํ ์ฝ๋๋ฅผ ๊ฒ์ฌํ๋๋ก ์๊ตฌํด์๋ ์ ๋๋ฉฐ, PR ๊ท๋ชจ๊ฐ ์์์๋ก ๋ ๋น ๋ฅด๊ณ ์ฒ ์ ํ๊ฒ ๊ฒํ ๋ ์ ์์ต๋๋ค [2, 7].
-- **์๊ฐ์ ๋ฆฌ๋ทฐ(Visual Review)์ ๋์
**: ํ๋ก ํธ์๋ ๊ฐ๋ฐ์ PR ํ๋ก์ธ์ค์์๋ ์ฝ๋์ ๋
ผ๋ฆฌ ๊ฒํ ๋ฟ๋ง ์๋๋ผ ์๊ฐ์ ํ๊ท(Visual Regression) ๊ฒํ ๊ฐ ํ์๊ฐ ๋์์ต๋๋ค [3]. ๊ฐ๋ฐ์๋ Storybook์ ํ์ฉํด ์ปดํฌ๋ํธ๋ฅผ ๋ถ๋ฆฌํ์ฌ ๊ตฌ์ถํ๊ณ , Chromatic์ด๋ Happo ๋ฑ์ ๋๊ตฌ๋ฅผ CI ํ์ดํ๋ผ์ธ์ ํตํฉํฉ๋๋ค [3, 8].
-- **์๋ํ๋ ์๊ฐ์ ํ๊ท ๊ฐ์ง**: PR์ด ์ด๋ฆฌ๋ฉด ์ด ๋๊ตฌ๋ค์ด ์ฌ๋ฌ ๋ธ๋ผ์ฐ์ ๋ฐ ๋ทฐํฌํธ ํ๊ฒฝ์์ ์๋์ผ๋ก ๋ชจ๋ UI ์ํ์ ์คํฌ๋ฆฐ์ท์ ์บก์ฒํ๊ณ ์ด์ ๊ธฐ์ค์ (baseline)๊ณผ ๋น๊ตํฉ๋๋ค [9, 10]. ๋ ์ด์์์ด๋ ์์ ๋ฑ์ ์๋์น ์์ ๋ณ๊ฒฝ ์ฌํญ์ด ๋ฐ๊ฒฌ๋๋ฉด PR์ ํด๋น ์ฌํญ์ด ์๋ ๊ฒํ ๋์์ผ๋ก ํ์(flagged)๋์ด ๋ฒ๊ทธ๊ฐ ํ๋ก๋์
ํ๊ฒฝ์ผ๋ก ๋ฐฐํฌ๋๋ ๊ฒ์ ์ฐจ๋จํฉ๋๋ค [3]. ๋๋ถ์ด, ์๊ฐ์ ๊ฒํ ๋๊ตฌ๋ ์๊ฐ์ ๋ณ๊ฒฝ ์ฌํญ๊ณผ ํจ๊ป ์๋ก์ด ์ ๊ทผ์ฑ ์๋ฐ(accessibility violations)๊น์ง ํฌ์ฐฉํ ์ ์์ต๋๋ค [9, 11].
-
-## โ๏ธ Trade-offs & Caveats
-- **๋ฆฌ๋ทฐ ๋ณ๋ชฉ ํ์ ๋ฐ ๋ณต์ก๋ ์ฆ๊ฐ**: ํ ๋ฒ์ ์์ฒ ์ค์ ๋ฌํ๋ ํฐ ๊ท๋ชจ์ ์ฝ๋(PR)๋ฅผ ๋ฆฌ๋ทฐํ๋๋ก ์์ฒญํ ๊ฒฝ์ฐ, ๋ฆฌ๋ทฐ์ด๊ฐ ์ฝ๋๋ฅผ ์ฒ ์ ํ ๊ฐ์ฌ(audit)ํ๊ธฐ ์ด๋ ค์ ๋ฆฌ๋ทฐ ์๋์ ํ์ง์ด ๋ชจ๋ ์ ํ๋๋ ๋ฌธ์ ๊ฐ ๋ฐ์ํฉ๋๋ค [2]. ์ด๋ฅผ ํผํ๊ธฐ ์ํด์๋ PR์ ๋งค์ฐ ์๊ฒ ๋๋์ด ์ง์์ ์ผ๋ก ๋ฆฌ๋ทฐํด์ผ ํ๋ฏ๋ก, ๊ฐ๋ฐ์๋ ์์
๋จ์๋ฅผ ์ธ๋ฐํ๊ฒ ์ชผ๊ฐ์ผ ํ๋ ์ถ๊ฐ์ ์ธ ๋
ธ๋ ฅ์ด ํ์ํฉ๋๋ค [2, 7].
-- **์๊ฐ์ ํ
์คํธ์ ๋ถ์์ ์ฑ(Flake) ์ด์**: ์๊ฐ์ ๋ฆฌ๋ทฐ๋ฅผ ์ํด ์คํฌ๋ฆฐ์ท ๊ธฐ๋ฐ ํ
์คํธ๋ฅผ ๋์
ํ ๋, ์ปดํฌ๋ํธ์ ๊ธฐ๋ฅ์ ๋ณ๊ฒฝ์ด ์๋๋ผ๋ ์์ถ ๋
ธ์ด์ฆ, ์ํฐ์จ๋ฆฌ์ด์ฑ, ๋น๋๊ธฐ ์์
(ํฐํธ ๋ฑ), ์ ๋๋ฉ์ด์
๋ฑ์ผ๋ก ์ธํด ๋ฏธ์ธํ ํฝ์
์ฐจ์ด๊ฐ ๋ฐ์ํ์ฌ ์ค๋ฅ๋ก ์ฒ๋ฆฌ๋๋ ๊ฑฐ์ง ์์ฑ(False positive) ๋ฌธ์ ๊ฐ ์๊ธธ ์ ์์ต๋๋ค [8, 12]. ์ด๋ฅผ ํด๊ฒฐํ๊ธฐ ์ํด ์์ ์ค์ฐจ ํ์ฉ ๋ฒ์(color-delta tolerance)๋ฅผ ์ค์ ํ๊ฑฐ๋ ์ ๋๋ฉ์ด์
์ ์์๊ฑฐํ๋ ๋ฑ์ ์ถ๊ฐ์ ์ธ ๊ตฌ์ฑ(Configuration)๊ณผ ๊ด๋ฆฌ๊ฐ ์๊ตฌ๋ฉ๋๋ค [8, 12, 13].
-
-## ๐ Knowledge Connections
-
-### Related Concepts
-
-#### [ํ์
๋ฐ ํ์ ๊ด๋ฆฌ ์ํฌํ๋ก์ฐ]
-- [[Pull Request (PR)|Pull Request (PR)]]
- - ์ฐ๊ฒฐ ์ด์ : ์ฝ๋ ๋ฆฌ๋ทฐ๊ฐ ์ค์ง์ ์ผ๋ก ์์ฒญ๋๊ณ , ๊ฒํ ํผ๋๋ฐฑ์ด ์ค๊ฐ๋ ํต์ฌ ํ๋ซํผ์ด์ ๋จ์์
๋๋ค [1, 2].
- - ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ๋ธ๋์น ๋ณํฉ ์ ํ์ง ๊ด๋ฆฌ ๊ฒ์ดํธ๋ก์์ ๊ธฐ๋ฅ๊ณผ ์งง๊ณ ๋ช
ํํ ์์
๋จ์ ๋ถํ ์ ์ค์์ฑ์ ํ์
ํ ์ ์์ต๋๋ค.
-
-- Feature Branch Workflow
- - ์ฐ๊ฒฐ ์ด์ : ์ฝ๋ ๋ฆฌ๋ทฐ ์์คํ
์ ์ฝ๊ฒ ๋์
ํ๊ธฐ ์ํ ๊ฐ์ฅ ๊ธฐ๋ณธ์ ์ด๊ณ ์ถฉ๋์ด ์ ์ ๋ธ๋์น ์ ๋ต์
๋๋ค [14, 15].
- - ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ๋ฉ์ธ ๋ธ๋์น๋ฅผ ํญ์ ์์ ์ ์ผ๋ก ์ ์งํ๋ฉด์, ๊ฐ๊ฐ์ ํ์คํฌ๋ฅผ ๋
๋ฆฝ๋ ๋ธ๋์น์์ ์์
ํ๊ณ ๋ฆฌ๋ทฐ๋ฅผ ํตํด ๊ฒ์ฆํ๋ ์ ์ฒด ํ๋ฆ์ ์ดํดํ ์ ์์ต๋๋ค.
-
-#### [์๋ํ ๋ฐ ํ์ง ๊ฒ์ฆ ๋๊ตฌ]
-- [[Visual Regression Testing|Visual Regression Testing]]
- - ์ฐ๊ฒฐ ์ด์ : ํ๋ก ํธ์๋ ์ฝ๋ ๋ฆฌ๋ทฐ ์ ์ก์์ผ๋ก ํ์ธํ๊ธฐ ํ๋ ์๋์น ์์ ๋ ์ด์์/์์ ๋ณ๊ฒฝ์ ์๋ํ ๋๊ตฌ๊ฐ ์๊ฐ์ ์ผ๋ก ์ฐพ์๋ด์ด ๋ฆฌ๋ทฐ์ด์๊ฒ ์ ์ํฉ๋๋ค [3, 9].
- - ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: Chromatic์ด๋ Happo๋ฅผ CI ํ์ดํ๋ผ์ธ๊ณผ ๊ฒฐํฉํ์ฌ PR ๋ฆฌ๋ทฐ์ ์ ํ๋๋ฅผ ๋์ด๊ณ ์์ ์ ์ธ UI๋ฅผ ๋ฐฐํฌํ๋ ํ๋ก์ธ์ค๋ฅผ ๋ฐฐ์ธ ์ ์์ต๋๋ค.
-
-### Deeper Research Questions
-
-- PR์ ํฌ๊ธฐ๋ฅผ ์๊ฒ ์ ์งํ๊ณ ๋จ์ผ ์์
(Single task)์ ์ง์คํ๋๋ก ๋
ผ๋ฆฌ์ ์ผ๋ก ์์
์ ๋ถํ ํ๋ ๊ฐ์ฅ ํจ๊ณผ์ ์ธ ๋ฐฉ๋ฒ๋ก ๊ณผ ๊ธฐ์ค์ ๋ฌด์์ธ๊ฐ?
-- ๋๊ท๋ชจ ํ์์ ์์์ง๋ ์๋ง์ PR๊ณผ ์ฝ๋ ๋ฆฌ๋ทฐ ์์ฒญ์ ๋ณ๋ชฉ ํ์ ์์ด ํจ์จ์ ์ผ๋ก ์ฒ๋ฆฌํ๊ณ ๋ฐฐํฌ ์๋๋ฅผ ์ ์งํ๊ธฐ ์ํ ์ ๋ต์ ๋ฌด์์ธ๊ฐ?
-- ์๊ฐ์ ํ๊ท ํ
์คํธ(Visual Regression Testing) ์ ๋ฐ์ํ๋ ๋ฏธ์ธํ ๋ ๋๋ง ์ฐจ์ด(Flake)๋ฅผ ๋ฐฉ์งํ๊ณ ์ ๋ขฐํ ์ ์๋ ๊ธฐ์ค์ (Baseline)์ ์ ์งํ๊ธฐ ์ํ ๊ตฌ์ฒด์ ์ธ ๊ตฌ์ฑ ์ต์ ํ ๋ฐฉ๋ฒ์ ๋ฌด์์ธ๊ฐ?
-- ์ฝ๋ ๋ฆฌ๋ทฐ ์ ์๊ฐ์ ํ๊ท(Visual changes) ๊ฐ์ง๋ฟ๋ง ์๋๋ผ, ์ ๊ทผ์ฑ ํ
์คํธ(Accessibility tests)๋ฅผ ํจ๊ป ์๋ํํ์ ๋ ์ป๊ฒ ๋๋ ์ด์ ๊ณผ ์ด๋ฅผ ์ฒ๋ฆฌํ๋ ๋ด๋ถ ๋์ ์๋ฆฌ๋ ๋ฌด์์ธ๊ฐ?
-- ๊ธฐ๋ฅ ๋ถ๊ธฐ(Feature branch)์ ์๋ช
์ด ๊ธธ์ด์ก์ ๋ ๋ฐ์ํ๋ ๋ฆฌ๋ทฐ ๋ฐ ๋ณํฉ ์ถฉ๋ ๋ฌธ์ ๋ฅผ ํด๊ฒฐํ๊ณ , ์ง์์ ์ผ๋ก ์งง์ ์ฃผ๊ธฐ์ ๋ฆฌ๋ทฐ๋ฅผ ์ ๋ํ๋ ๋ฌธํ๋ ์ด๋ป๊ฒ ์ ์ฐฉ์ํฌ ์ ์๋๊ฐ?
-
-### Practical Application Contexts
-
-- **Implementation:** ์ฝ๋๋ฅผ ์ปค๋ฐํ๊ณ PR์ ์์ฑํ ๋, ๋ฆฌ๋ทฐ์ด๊ฐ ์ฝ๊ฒ ์ฝ๋๋ฅผ ํ์
ํ ์ ์๋๋ก 200์ค ๋ฏธ๋ง์ ์์ ๋จ์๋ก ๋ณ๊ฒฝ ์ฌํญ์ ์ชผ๊ฐ์ด ์ฌ๋ฆฌ๊ณ ๋ฌด์์ด ์ ๋ณ๊ฒฝ๋์๋์ง ๋ช
ํํ ๋ช
์ํด์ผ ํฉ๋๋ค [2, 7].
-- **System Design:** ํ๋ก ํธ์๋ ์ค๊ณ ์ Storybook์ ํ์ฉํ์ฌ ๋ชจ๋ UI ์ปดํฌ๋ํธ์ ๋ค์ํ ์ํ(loading, error ๋ฑ)๋ฅผ ์บก์ํํด ๋๋ฉด, ์ฝ๋ ๋ฆฌ๋ทฐ ์์ ์ด ์ํ๋ค์ ์๋์ผ๋ก ์คํฌ๋ฆฐ์ท์ผ๋ก ์ฐ์ด ๊ฒ์ฆํ ์ ์๋ ๊ธฐ๋ฐ ์์คํ
์ด ๋ง๋ค์ด์ง๋๋ค [16].
-- **Operation / Maintenance:** CI/CD ํ์ดํ๋ผ์ธ ๋จ๊ณ์ Chromatic์ด๋ Happo ๊ฐ์ ๋๊ตฌ๋ฅผ ์ฐ๋์์ผ, ํ์์ด PR์ ์์ฑํ ๋๋ง๋ค ์๊ฐ์ ๋ณ๋ ์ฌํญ(diff)์ด๋ ์ ๊ทผ์ฑ ์๋ฐ ๋ด์ญ์ด PR ์ฒดํฌ ๋ฆฌ์คํธ์ ๋ฐฐ์ง๋ก ์๋ ๋ณด๊ณ ๋๋๋ก ์ด์ ํ๊ฒฝ์ ๊ตฌ์ถํฉ๋๋ค [17].
-- **Learning Path:** Git์ ๊ธฐ์ด์ ์ธ ๋ธ๋์น ์ฌ์ฉ๋ฒ์ ๋ฐฐ์ด ํ, ํ ํ์
์ ํต์ฌ์ธ PR ์์ฑ ๋ฐ ๋ฆฌ๋ทฐ ์์ฒญ ๊ณผ์ (GitHub Flow ๋ฑ)์ ์ตํ๊ณ , ๋์๊ฐ ์๊ฐ์ ํ
์คํ
๋๊ตฌ๊ฐ PR์ ์ด๋ป๊ฒ ํผ๋๋ฐฑ์ ์ฃผ๋์ง๋ฅผ ์ค์ตํด๋ณด๋ ํ๋ฆ์ผ๋ก ํ์ตํ ์ ์์ต๋๋ค [8, 18].
-- **My Project Relevance:** ์๊ท๋ชจ 3์ธ ํ ํ๋ก์ ํธ๋ฅผ ์งํํ ๋ ๋ณต์กํ Git-Flow ๋์ ๊ธฐ๋ฅ ๋ธ๋์น ์ํฌํ๋ก์ฐ๋ฅผ ์ฑํํ๊ณ , ์ฝ๋ ๋ณํฉ ์ ๋ฐ๋์ 1๋ช
์ด์์ ํผ์ด ๋ฆฌ๋ทฐ(Peer review)๋ฅผ ๋ฐ๋๋ก ๊ท์น์ ์ ํด ๋ฒ๊ทธ ์๋ ์์ ์ ๋ฉ์ธ ๋ธ๋์น๋ฅผ ์ ์งํ ์ ์์ต๋๋ค [1, 14].
-
-### Adjacent Topics
-
-- [[Continuous Integration (CI)|Continuous Integration (CI)]]
- - ํ์ฅ ๋ฐฉํฅ: PR์ด ์ฌ๋ผ์์ ๋ ์ฝ๋ ๋ฆฌ๋ทฐ๋ฅผ ๋๊ธฐ ์ํด ์ฌ์ ์ ํ
์คํธ ํต๊ณผ ์ฌ๋ถ, ๋น๋ ์ฑ๊ณต ์ฌ๋ถ ๋ฑ์ ์๋์ผ๋ก ๊ฒ์ฌํด์ฃผ๋ ์๋ํ ํ์ดํ๋ผ์ธ์ ๊ตฌ์ถ์ ๋ํด ํ์ตํ ์ ์์ต๋๋ค [7, 19].
-
----
-*Last updated: 2026-04-30*
\ No newline at end of file
diff --git a/10_Wiki/Management/Index.md b/10_Wiki/Management/Index.md
deleted file mode 100644
index f06399ff..00000000
--- a/10_Wiki/Management/Index.md
+++ /dev/null
@@ -1,5 +0,0 @@
-# Index: Management
-
-## ๐ Subcategories
-- System
-
diff --git a/10_Wiki/Management/System/Index.md b/10_Wiki/Management/System/Index.md
deleted file mode 100644
index f25d45e4..00000000
--- a/10_Wiki/Management/System/Index.md
+++ /dev/null
@@ -1,4 +0,0 @@
-# Index: Management > System
-
-## ๐ Documents
-- [[Antigravity_Agent_System_v1|Antigravity_Agent_System_v1]]
diff --git a/10_Wiki/Projects/Index.md b/10_Wiki/Projects/Index.md
deleted file mode 100644
index 152a0fa0..00000000
--- a/10_Wiki/Projects/Index.md
+++ /dev/null
@@ -1,5 +0,0 @@
-# Index: Projects
-
-## ๐ Subcategories
-- Skybound
-
diff --git a/10_Wiki/Projects/Skybound/Index.md b/10_Wiki/Projects/Skybound/Index.md
deleted file mode 100644
index bc42e401..00000000
--- a/10_Wiki/Projects/Skybound/Index.md
+++ /dev/null
@@ -1,5 +0,0 @@
-# Index: Projects > Skybound
-
-## ๐ Documents
-- [[Architecture_Refactor|Architecture_Refactor]]
-- [[HUD_UI_Refinement|HUD_UI_Refinement]]
diff --git a/10_Wiki/Skills/BuildSystem/Index.md b/10_Wiki/Skills/BuildSystem/Index.md
deleted file mode 100644
index 4b19bf60..00000000
--- a/10_Wiki/Skills/BuildSystem/Index.md
+++ /dev/null
@@ -1,4 +0,0 @@
-# Index: Skills > BuildSystem
-
-## ๐ Documents
-- [[Incremental_Build|Incremental_Build]]
diff --git a/10_Wiki/Skills/Index.md b/10_Wiki/Skills/Index.md
deleted file mode 100644
index 4f6254a3..00000000
--- a/10_Wiki/Skills/Index.md
+++ /dev/null
@@ -1,7 +0,0 @@
-# Index: Skills
-
-## ๐ Subcategories
-- BuildSystem
-
-## ๐ Documents
-- [[P-Reinforce_Skill|P-Reinforce_Skill]]
diff --git a/10_Wiki/Technical_Reports/Index.md b/10_Wiki/Technical_Reports/Index.md
deleted file mode 100644
index 91ea53a4..00000000
--- a/10_Wiki/Technical_Reports/Index.md
+++ /dev/null
@@ -1,5 +0,0 @@
-# Index: Technical_Reports
-
-## ๐ Documents
-- [[2026-04-22_Boss_Battle_System_Implementation|2026-04-22_Boss_Battle_System_Implementation]]
-- [[2026-04-22_Boss_Spawn_Logic_Fix|2026-04-22_Boss_Spawn_Logic_Fix]]
diff --git a/10_Wiki/Topics/.gitignore b/10_Wiki/Topics/.gitignore
deleted file mode 100644
index 5d136e73..00000000
--- a/10_Wiki/Topics/.gitignore
+++ /dev/null
@@ -1,10 +0,0 @@
-# ์๋ ์์ฑ โ Connect AI 1์ธ ๊ธฐ์
๋ชจ๋
-# ์ํฌ๋ฆฟยทAPI ํค ๋ณดํธ
-_agents/*/config.md
-
-# ์ธ๋ถ API ์๋ต ์บ์ (์ฌํ ๊ฐ๋ฅ)
-_cache/
-
-# ๋์ฉ๋ ์์ ์ฐ์ถ๋ฌผ
-_tmp/
-*.log
diff --git a/10_Wiki/Topics/.obsidian/app.json b/10_Wiki/Topics/.obsidian/app.json
deleted file mode 100644
index 9e26dfee..00000000
--- a/10_Wiki/Topics/.obsidian/app.json
+++ /dev/null
@@ -1 +0,0 @@
-{}
\ No newline at end of file
diff --git a/10_Wiki/Topics/.obsidian/appearance.json b/10_Wiki/Topics/.obsidian/appearance.json
deleted file mode 100644
index 9e26dfee..00000000
--- a/10_Wiki/Topics/.obsidian/appearance.json
+++ /dev/null
@@ -1 +0,0 @@
-{}
\ No newline at end of file
diff --git a/10_Wiki/Topics/.obsidian/core-plugins.json b/10_Wiki/Topics/.obsidian/core-plugins.json
deleted file mode 100644
index 639b90da..00000000
--- a/10_Wiki/Topics/.obsidian/core-plugins.json
+++ /dev/null
@@ -1,33 +0,0 @@
-{
- "file-explorer": true,
- "global-search": true,
- "switcher": true,
- "graph": true,
- "backlink": true,
- "canvas": true,
- "outgoing-link": true,
- "tag-pane": true,
- "footnotes": false,
- "properties": true,
- "page-preview": true,
- "daily-notes": true,
- "templates": true,
- "note-composer": true,
- "command-palette": true,
- "slash-command": false,
- "editor-status": true,
- "bookmarks": true,
- "markdown-importer": false,
- "zk-prefixer": false,
- "random-note": false,
- "outline": true,
- "word-count": true,
- "slides": false,
- "audio-recorder": false,
- "workspaces": false,
- "file-recovery": true,
- "publish": false,
- "sync": true,
- "bases": true,
- "webviewer": false
-}
\ No newline at end of file
diff --git a/10_Wiki/Topics/.obsidian/graph.json b/10_Wiki/Topics/.obsidian/graph.json
deleted file mode 100644
index 51769675..00000000
--- a/10_Wiki/Topics/.obsidian/graph.json
+++ /dev/null
@@ -1,22 +0,0 @@
-{
- "collapse-filter": true,
- "search": "",
- "showTags": false,
- "showAttachments": false,
- "hideUnresolved": false,
- "showOrphans": true,
- "collapse-color-groups": true,
- "colorGroups": [],
- "collapse-display": true,
- "showArrow": false,
- "textFadeMultiplier": 0,
- "nodeSizeMultiplier": 1,
- "lineSizeMultiplier": 1,
- "collapse-forces": false,
- "centerStrength": 0.518713248970312,
- "repelStrength": 10,
- "linkStrength": 1,
- "linkDistance": 250,
- "scale": 0.07596443649899076,
- "close": true
-}
\ No newline at end of file
diff --git a/10_Wiki/Topics/.obsidian/workspace.json b/10_Wiki/Topics/.obsidian/workspace.json
deleted file mode 100644
index d6bee4c7..00000000
--- a/10_Wiki/Topics/.obsidian/workspace.json
+++ /dev/null
@@ -1,223 +0,0 @@
-{
- "main": {
- "id": "3fc76d379d004b0c",
- "type": "split",
- "children": [
- {
- "id": "ed6b7013899a2c11",
- "type": "tabs",
- "children": [
- {
- "id": "e84fb23982481828",
- "type": "leaf",
- "state": {
- "type": "graph",
- "state": {},
- "icon": "lucide-git-fork",
- "title": "๊ทธ๋ํ ๋ทฐ"
- }
- }
- ]
- }
- ],
- "direction": "vertical"
- },
- "left": {
- "id": "14420f71c8e463c7",
- "type": "split",
- "children": [
- {
- "id": "026126c5779ef0d1",
- "type": "tabs",
- "children": [
- {
- "id": "3c4f676663de108b",
- "type": "leaf",
- "state": {
- "type": "file-explorer",
- "state": {
- "sortOrder": "alphabetical",
- "autoReveal": false
- },
- "icon": "lucide-folder-closed",
- "title": "ํ์ผ ํ์๊ธฐ"
- }
- },
- {
- "id": "c85f7eceb7d2fd98",
- "type": "leaf",
- "state": {
- "type": "search",
- "state": {
- "query": "",
- "matchingCase": false,
- "explainSearch": false,
- "collapseAll": false,
- "extraContext": false,
- "sortOrder": "alphabetical"
- },
- "icon": "lucide-search",
- "title": "๊ฒ์"
- }
- },
- {
- "id": "0aab514d3887d1f0",
- "type": "leaf",
- "state": {
- "type": "bookmarks",
- "state": {},
- "icon": "lucide-bookmark",
- "title": "๋ถ๋งํฌ"
- }
- }
- ]
- }
- ],
- "direction": "horizontal",
- "width": 300
- },
- "right": {
- "id": "8e81aaf0af24f2a0",
- "type": "split",
- "children": [
- {
- "id": "3283f5452e0c7734",
- "type": "tabs",
- "children": [
- {
- "id": "2768a7df58e67cf4",
- "type": "leaf",
- "state": {
- "type": "backlink",
- "state": {
- "file": "Focal Loss (ํฌ์ปฌ ์์ค).md",
- "collapseAll": false,
- "extraContext": false,
- "sortOrder": "alphabetical",
- "showSearch": false,
- "searchQuery": "",
- "backlinkCollapsed": false,
- "unlinkedCollapsed": true
- },
- "icon": "links-coming-in",
- "title": "Focal Loss (ํฌ์ปฌ ์์ค) ์ ๋ฐฑ๋งํฌ"
- }
- },
- {
- "id": "e32c536fe9411952",
- "type": "leaf",
- "state": {
- "type": "outgoing-link",
- "state": {
- "file": "Focal Loss (ํฌ์ปฌ ์์ค).md",
- "linksCollapsed": false,
- "unlinkedCollapsed": true
- },
- "icon": "links-going-out",
- "title": "Focal Loss (ํฌ์ปฌ ์์ค) ์ ๋๊ฐ๋ ๋งํฌ"
- }
- },
- {
- "id": "e4e179d925740b8d",
- "type": "leaf",
- "state": {
- "type": "tag",
- "state": {
- "sortOrder": "frequency",
- "useHierarchy": true,
- "showSearch": false,
- "searchQuery": ""
- },
- "icon": "lucide-tags",
- "title": "ํ๊ทธ"
- }
- },
- {
- "id": "259c52e79205779b",
- "type": "leaf",
- "state": {
- "type": "all-properties",
- "state": {
- "sortOrder": "frequency",
- "showSearch": false,
- "searchQuery": ""
- },
- "icon": "lucide-archive",
- "title": "๋ชจ๋ ์์ฑ"
- }
- },
- {
- "id": "75330b282fdbce70",
- "type": "leaf",
- "state": {
- "type": "outline",
- "state": {
- "file": "Focal Loss (ํฌ์ปฌ ์์ค).md",
- "followCursor": false,
- "showSearch": false,
- "searchQuery": ""
- },
- "icon": "lucide-list",
- "title": "Focal Loss (ํฌ์ปฌ ์์ค) ์ ๊ฐ์"
- }
- }
- ]
- }
- ],
- "direction": "horizontal",
- "width": 300,
- "collapsed": true
- },
- "left-ribbon": {
- "hiddenItems": {
- "switcher:๋น ๋ฅธ ์ ํ๊ธฐ ์ด๊ธฐ": false,
- "graph:๊ทธ๋ํ ๋ทฐ ์ด๊ธฐ": false,
- "canvas:์ ์บ๋ฒ์ค ๋ง๋ค๊ธฐ": false,
- "daily-notes:์ค๋์ ์ผ์ผ ๋
ธํธ ์ด๊ธฐ": false,
- "templates:ํ
ํ๋ฆฟ ์ฝ์
": false,
- "command-palette:๋ช
๋ น์ด ํ๋ ํธ ์ด๊ธฐ": false,
- "bases:์ ๋ฒ ์ด์ค ์์ฑํ๊ธฐ": false
- }
- },
- "active": "e84fb23982481828",
- "lastOpenFiles": [
- "02_Software_Engineering/ํ๋ ๊ธฐ๋ฐ ์ฝ๋ ๋ถ์ (Behavioral Code Analysis).md",
- "01_Process_Methodology/ํํฅ์ ๋ฐ ์ํฅ์ ์ ๊ทผ๋ฒ (Top-Down and Bottom-Up Approaches).md",
- "02_Software_Engineering/ํ์ด๋ธ๋ฆฌ๋ ์ ๋ต (Hybrid Strategy).md",
- "02_Software_Engineering/์ฝ๋๋ฒ ์ด์ค ์ฝ๊ธฐ ์ง์.md",
- "02_Software_Engineering/์ฝ๋๋ฒ ์ด์ค ๋งต (Codebase Map).md",
- "02_Software_Engineering/์ฝ๋ ์
์ทจ (Code Smells).md",
- "01_Process_Methodology/์ฝ๋ ๋ฆฌํฉํ ๋ง (Code Refactoring).md",
- "01_Process_Methodology/์ฝ๋ ๋ฆฌ๋ทฐ ํ๋ก์ธ์ค (Code Review Process).md",
- "02_Software_Engineering/์ปจํ
์คํธ ์์ง (Context Engine).md",
- "02_Software_Engineering/์ถ์ ๊ตฌ๋ฌธ ํธ๋ฆฌ (AST, Abstract Syntax Tree).md",
- "02_Software_Engineering/์ง์
์ (Entry Points).md",
- "03_DevOps_Environment/์ง์์ ๋ณด์(DevSecOps)๊ณผ CI-CD ํตํฉ.md",
- "02_Software_Engineering/์ค๋จ์ (Breakpoints).md",
- "02_Software_Engineering/์ ์ ์ฝ๋ ๋ถ์ ๋๊ตฌ (Static Code Analysis Tools).md",
- "02_Software_Engineering/์ ์ ์ฝ๋ ๋ถ์ (Static Code Analysis).md",
- "02_Software_Engineering/์ ์ ์ ํ๋ฆฌ์ผ์ด์
๋ณด์ ํ
์คํธ (SAST).md",
- "02_Software_Engineering/์์ฐ์ด ์ํฐํฉํธ (Natural Language Artifacts).md",
- "Agent & AI/์ธ๊ณต์ง๋ฅ ์ฝ๋ ๋ถ์ (AI-Powered Codebase Analysis).md",
- "02_Architecture_Principles/์ํคํ
์ฒ ์คํ์ผ ๋ฐ ๋์์ธ ํจํด (Architectural Styles & Design Patterns).md",
- "02_Architecture_Principles/์ํคํ
์ฒ ๋ค์ด์ด๊ทธ๋จ (Architecture Diagrams).md",
- "02_Architecture_Principles/์์คํ
์ํคํ
์ฒ ์๊ฐํ (System Architecture Visualization).md",
- "02_Software_Engineering/์คํ ํธ๋ ์ด์ค (Stack Trace).md",
- "02_Software_Engineering/์ํํธ์จ์ด ๋ฌธ์ํ (Software Documentation).md",
- "02_Software_Engineering/๋ฒ์ ๊ด๋ฆฌ ์ปจํ
์คํธ (Version Control Context).md",
- "02_Software_Engineering/๋ฒ์ ๊ด๋ฆฌ ์ถ์ ๋ถ์ (Version Control Tracking).md",
- "02_Software_Engineering/๋ฒ์ ๊ด๋ฆฌ ์ด๋ ฅ ๋ถ์ (Version Control History Analysis).md",
- "๋ฌด์ 1.canvas",
- "๋ฌด์ .canvas",
- "sessions/2026-05-01T12-09",
- "sessions/2026-04-30T07-07",
- "sessions",
- "company_state.json",
- "_shared",
- "_agents/youtube/tools/youtube_account.py",
- "_agents/youtube/tools/youtube_account.json",
- "_agents/youtube/tools/trend_sniper.py",
- "_agents/youtube/tools/trend_sniper.json",
- "_agents/youtube/tools/telegram_notify.py"
- ]
-}
\ No newline at end of file
diff --git a/10_Wiki/Topics/01_Frontend_Mastery/Index.md b/10_Wiki/Topics/01_Frontend_Mastery/Index.md
deleted file mode 100644
index afc0758c..00000000
--- a/10_Wiki/Topics/01_Frontend_Mastery/Index.md
+++ /dev/null
@@ -1,11 +0,0 @@
-# Index: Topics > 01_Frontend_Mastery
-
-## ๐ Documents
-- [[React_Clean_Code_Best_Practices|React_Clean_Code_Best_Practices]]
-- [[React_Hooks_Deep_Dive|React_Hooks_Deep_Dive]]
-- [[React_Mental_Model|React_Mental_Model]]
-- [[React_Performance_Optimization|React_Performance_Optimization]]
-- [[React_State_Management_Strategy|React_State_Management_Strategy]]
-- [[React_Testing_Strategy|React_Testing_Strategy]]
-- [[TypeScript_Type_Safety|TypeScript_Type_Safety]]
-- [[WebWorker_Performance|WebWorker_Performance]]
diff --git a/10_Wiki/Topics/01_Frontend_Mastery/React_Clean_Code_Best_Practices.md b/10_Wiki/Topics/01_Frontend_Mastery/React_Clean_Code_Best_Practices.md
deleted file mode 100644
index c26ad0e3..00000000
--- a/10_Wiki/Topics/01_Frontend_Mastery/React_Clean_Code_Best_Practices.md
+++ /dev/null
@@ -1,28 +0,0 @@
----
-title: ๋ฆฌ์กํธ ํด๋ฆฐ ์ฝ๋ ๋ฐ ๊ฐ๋ฐ ์ํฐ์ผ
-category: Software [[Architecture|Architecture]]
-tags: [Clean Code, Etiquette, Best Practice, Readable Code]
-created: 2026-04-20
----
-
-# [[React_Clean_Code_Best_Practices|React_Clean_Code_Best_Practices]] (๋ฆฌ์กํธ ํด๋ฆฐ ์ฝ๋)
-
-## ๐ ํ ์ค ํต์ฐฐ (The Karpathy Summary)
-> ๊ฐ๋
์ฑ ์ข์ ์ฝ๋๋ '์ปดํจํฐ'๊ฐ ์ดํดํ๋ ์ฝ๋๊ฐ ์๋๋ผ, '๋์ค์ ์ด ์ฝ๋๋ฅผ ๊ณ ์น ๋๋ฃ(ํน์ ๋ฏธ๋์ ๋)'๊ฐ ์จ ์ฌ๋ฏ ์ฝ์ด๋ด๋ ค๊ฐ ์ ์๋ ์ฝ๋๋ค.
-
-## ๐ ๊ตฌ์กฐํ๋ ์ง์ (Synthesized Content)
-- **Early Return ํจํด**:
- - ์ค์ฒฉ๋ `if-else`๋ ์ง์ฅ์ด๋ค. ์์ธ ์ํฉ(Loading, Error)์ ๋จผ์ `return`์ผ๋ก ์ณ๋ด๋ฉด, ํจ์์ ๋ณธ์ฒด๋ ํญ์ ๊ฐ์ฅ ์ค์ํ ๋ก์ง๋ง ๋จ๊ฒ ๋๋ค.
-- **Props Destructuring (๊ตฌ์กฐ ๋ถํด ํ ๋น)**:
- - `props.user.name` ์ฒ๋ผ ๊ฒฝ๋ก๋ฅผ ๊ธธ๊ฒ ์ฐ๋ ๋์ , ํจ์์ ์ธ์ ๋จ๊ณ์์ `{ user: { name } }` ์ฒ๋ผ ๋ถํดํ๋ผ. ์ฝ๋๊ฐ ์จ์ ์ฌ๊ธฐ ์์ํ๋ค.
-- **Explicit Naming (๋ช
์์ ๋ค์ด๋ฐ)**:
- - ํธ๋ค๋ฌ ํจ์๋ `handle[Action]` (์: `handle[[Search|Search]]`), ๋น์ฆ๋์ค ํจ์๋ `on[Action]` (์: `onSearchSubmit`)์ผ๋ก ๊ตฌ๋ถํ์ฌ ์ฑ
์ ์์ฌ๋ฅผ ๋ช
ํํ ํ๋ค.
-- **์กฐ๊ฑด๋ถ ๋ ๋๋ง ์ํฐ์ผ**:
- - `&&` ์ฐ์ฐ์ ๋์ ์ผํญ ์ฐ์ฐ์(`? :`)๋ฅผ ๊ถ์ฅํ๋ค. ํนํ `0 && ` ์ ํ๋ฉด์ ์ซ์ 0์ด ์ถ๋ ฅ๋๋ ๋์ฐธ์ฌ๋ฅผ ๋ฐฉ์งํ๊ธฐ ์ํจ์ด๋ค.
-
-## โ ๏ธ ๋ชจ์ ๋ฐ ์
๋ฐ์ดํธ (RL Update)
-- ๊ณผ๋ํ ์ถ์ํ๋ ์คํ๋ ค ๋
์ด๋ค. ์ฝ๋๊ฐ 3์ค์ธ๋ฐ ํจ์ 5๊ฐ๋ก ์ชผ๊ฐ๋ ๊ฒ์ ๊ฐ๋
์ฑ์ ํด์น๋ค. '์ง๊ด์ฑ'์ด '๋ถ๋ฆฌ'๋ณด๋ค ์ฐ์ ํ ๋๊ฐ ์์์ ๋ช
์ฌํ๋ผ.
-
-## ๐ ์ง์ ์ฐ๊ฒฐ (Graph)
-- Related: [[Collaboration_Governance|Collaboration_Governance]] , [[System_Debugging_Protocol|System_Debugging_Protocol]]
-- Foundation: [[React_Mental_Model|React_Mental_Model]]
diff --git a/10_Wiki/Topics/01_Frontend_Mastery/React_Hooks_Deep_Dive.md b/10_Wiki/Topics/01_Frontend_Mastery/React_Hooks_Deep_Dive.md
deleted file mode 100644
index 75d92ce0..00000000
--- a/10_Wiki/Topics/01_Frontend_Mastery/React_Hooks_Deep_Dive.md
+++ /dev/null
@@ -1,26 +0,0 @@
----
-title: ๋ฆฌ์กํธ ํ
(Hooks) ์ฌ์ธต ๋ถ์ ๋ฐ ํ์ฉ
-category: Software [[Architecture|Architecture]]
-tags: [React, Hooks, useEffect, Custom Hooks]
-created: 2026-04-20
----
-
-# [[React_Hooks_Deep_Dive|React_Hooks_Deep_Dive]] (๋ฆฌ์กํธ ํ
์ฌํ)
-
-## ๐ ํ ์ค ํต์ฐฐ (The Karpathy Summary)
-> ํ
์ ๋จ์ํ ํจ์๋ฅผ ์ฌ์ฌ์ฉํ๋ ๊ฒ์ด ์๋๋ผ, ์ปดํฌ๋ํธ์ ์์ ์ฃผ๊ธฐ์ ๋
ผ๋ฆฌ๋ฅผ '์ ์ธ์ '์ผ๋ก ๊ฒฐํฉํ๋ ๊ณ ๋์ ๋๊ธฐํ ๊ธฐ์ ๋ค.
-
-## ๐ ๊ตฌ์กฐํ๋ ์ง์ (Synthesized Content)
-- **useEffect์ ์ฌ๋ฐ๋ฅธ ๊ด์ **:
- - "๋ง์ดํธ๋ ๋ ์คํ"์ด๋ผ๋ ๋ผ์ดํ์ฌ์ดํด ์ฌ๊ณ ๋ฐฉ์์์ ๋ฒ์ด๋๋ผ. `useEffect`๋ **์์กด์ฑ ๋ฐฐ์ด์ ๊ฐ๊ณผ ์ปดํฌ๋ํธ ์ธ๋ถ ์์คํ
(API, DOM ๋ฑ)์ ๋๊ธฐํ**ํ๋ ์์
์ด๋ค.
-- **Custom Hooks (์ถ์ํ์ ๊ฝ)**:
- - ๋ณต์กํ ๋น์ฆ๋์ค ๋ก์ง(์: ๋ฐ์ดํฐ ํ์นญ, ํ์ด๋จธ ๊ด๋ฆฌ)์ `useMy[[Logic|Logic]]` ์ฒ๋ผ ๋ฐ๋ก ๋นผ๋ด์ด ์ปดํฌ๋ํธ๋ ์ค์ง UI ์ ์ธ์๋ง ์ง์คํ๊ฒ ๋ง๋ ๋ค. ์ด๊ฒ์ด ์ปดํฌ๋ํธ์ ๊ฐ๋
์ฑ์ ํญ๋ฐ์ํค๋ ๋น๊ฒฐ์ด๋ค.
-- **Rules of Hooks**:
- - ๋ฐ๋์ ํจ์์ ์ต์์์์๋ง ํธ์ถ๋์ด์ผ ํ๋ค. ๊ทธ๋์ผ ๋ฆฌ์กํธ๊ฐ ํ
์ ์ํ๋ฅผ ์ ํ ์ํ ๋จธ์ ์ฒ๋ผ ์ ํํ ์์๋ก ๊ด๋ฆฌํ ์ ์๋ค.
-
-## โ ๏ธ ๋ชจ์ ๋ฐ ์
๋ฐ์ดํธ (RL Update)
-- `useEffect` ๋ด์์ ๋ฌด๋ถ๋ณํ๊ฒ ์ํ๋ฅผ ์
๋ฐ์ดํธํ๋ฉด ๋ฌดํ ๋ฃจํ๋ ์ฑ๋ฅ ์ ํ๊ฐ ๋ฐ์ํ๋ค. ๊ฐ๋ฅํ๋ฉด `useMemo`๋ `useCallback`์ผ๋ก ๊ณ์ฐ ๊ฒฐ๊ณผ๋ฅผ ์บ์ฑํ๊ฑฐ๋, ์ํ ์
๋ฐ์ดํธ ๋ก์ง์ `useReducer`๋ก ์์ํ๋ผ.
-
-## ๐ ์ง์ ์ฐ๊ฒฐ (Graph)
-- Related: [[React_Performance_Optimization|React_Performance_Optimization]] , React_State_Management_Strategy
-- Context: [[WebWorker_Performance|WebWorker_Performance]]
diff --git a/10_Wiki/Topics/01_Frontend_Mastery/React_Mental_Model.md b/10_Wiki/Topics/01_Frontend_Mastery/React_Mental_Model.md
deleted file mode 100644
index 250093cf..00000000
--- a/10_Wiki/Topics/01_Frontend_Mastery/React_Mental_Model.md
+++ /dev/null
@@ -1,26 +0,0 @@
----
-title: ๋ฆฌ์กํธ ํต์ฌ ๋ฉํ ๋ชจ๋ธ (UI as a Function of [[State|State]])
-category: Software [[Architecture|Architecture]]
-tags: [React, State, Mental Model, Immutability]
-created: 2026-04-20
----
-
-# [[React_Mental_Model|React_Mental_Model]] (๋ฆฌ์กํธ ๋ฉํ ๋ชจ๋ธ)
-
-## ๐ ํ ์ค ํต์ฐฐ (The Karpathy Summary)
-> ๋ฆฌ์กํธ ๊ฐ๋ฐ์ DOM์ '์กฐ์(Manipulate)'ํ๋ ๊ฒ์ด ์๋๋ผ, ๋ฐ์ดํฐ์ ํ๋ฆ์ธ '์ํ(State)'๋ฅผ ์ ์ํ๊ณ ๊ทธ ๊ฒฐ๊ณผ๋ฌผ์ ํ๋ฉด์ '์ ์ธ(Declare)'ํ๋ ๊ณผ์ ์ด๋ค.
-
-## ๐ ๊ตฌ์กฐํ๋ ์ง์ (Synthesized Content)
-- **UI = f(State)**:
- - ํ๋ฉด์ ์ํ์ ๊ฒฐ๊ณผ๊ฐ์ด์ด์ผ ํ๋ค. ๋ช
๋ นํ(Imperative)์ผ๋ก "์ด ๋ฒํผ์ ๊ธ์๋ฅผ ๋ฐ๊ฟ๋ผ"๋ผ๊ณ ํ๋ ์๊ฐ ๋ฆฌ์กํธ์ ์ง์๋ ๋ฌด๋์ง๋ค. ์ค์ง ์ํ๋ฅผ ๋ฐ๊พธ๊ณ ๋ฆฌ์กํธ๊ฐ ์์์ ๊ทธ๋ฆฌ๊ฒ ํ๋ผ.
-- **Immutability (๋ถ๋ณ์ฑ)**:
- - ๋ฆฌ์กํธ๋ ๊ฐ์ฒด์ ์ฃผ์๊ฐ์ด ๋ณํ ๋๋ง ๋ ๋๋ง์ ์๋ํ๋ค. `arr.push(1)`์ด ์๋๋ผ `setArr([...arr, 1])`์ฒ๋ผ **์๋ก์ด ์๋ณธ**์ ๋ณต์ ํ์ฌ ๊ฐ์ DOM([[Virtual DOM|Virtual DOM]])์ด ํจ์จ์ ์ผ๋ก ๋์ํ๊ฒ ๋๋๋ค.
-- **Virtual DOM Diffing**:
- - ๋ฆฌ์กํธ๋ ์ค์ DOM์ ์ง์ ๊ฑด๋๋ฆฌ๊ธฐ ์ ์ ๋ฉ๋ชจ๋ฆฌ์์ ๊ฐ์ DOM์์ ์ด์ ์ํ์ ๋น๊ต(Diffing)ํ์ฌ, ๊ผญ ํ์ํ ๋ถ๋ถ๋ง ์ค์ ํ๋ฉด์ ๋ฐ์(Commit)ํ๋ค. ์ด๊ฒ์ด ๊ณ ์ฑ๋ฅ ์น์ ๋น๊ฒฐ์ด๋ค.
-
-## โ ๏ธ ๋ชจ์ ๋ฐ ์
๋ฐ์ดํธ (RL Update)
-- ๋ถ๋ณ์ฑ ์ ์ง๋ฅผ ์ํด ๋งค๋ฒ ๊ฑฐ๋ํ ๊ฐ์ฒด๋ฅผ ๋ณต์ฌํ๋ ๊ฒ์ ๋๋ก ์ํด๋ค. `Immer` ๊ฐ์ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ ์ฐ๊ฑฐ๋, ์ํ์ ํฌ๊ธฐ๋ฅผ ์๊ฒ ์ชผ๊ฐ์ด([[Normalization|Normalization]]) ์
๋ฐ์ดํธ ๋น์ฉ์ ์ต์ํํ๋ ์ ๋ต์ด ์ค๊ธ ๊ฐ๋ฐ์์ ์ญ๋์ด๋ค.
-
-## ๐ ์ง์ ์ฐ๊ฒฐ (Graph)
-- Related: [[React_Hooks_Deep_Dive|React_Hooks_Deep_Dive]] , [[Component_Design_Patterns|Component_Design_Patterns]]
-- Foundation: [[System_Protocol_Standard|System_Protocol_Standard]]
diff --git a/10_Wiki/Topics/01_Frontend_Mastery/React_Performance_Optimization.md b/10_Wiki/Topics/01_Frontend_Mastery/React_Performance_Optimization.md
deleted file mode 100644
index 79372506..00000000
--- a/10_Wiki/Topics/01_Frontend_Mastery/React_Performance_Optimization.md
+++ /dev/null
@@ -1,28 +0,0 @@
----
-title: ๋ฆฌ์กํธ ๋ ๋๋ง ์ต์ ํ ์ ๋ต
-category: Software [[Architecture|Architecture]]
-tags: [Performance, Memoization, React.memo, [[Optimization|Optimization]]]
-created: 2026-04-20
----
-
-# [[React_Performance_Optimization|React_Performance_Optimization]] (๋ฆฌ์กํธ ์ฑ๋ฅ ์ต์ ํ)
-
-## ๐ ํ ์ค ํต์ฐฐ (The Karpathy Summary)
-> ๊ฐ์ฅ ๋น ๋ฅธ ๋ ๋๋ง์ 'ํ์ง ์๋ ๋ ๋๋ง'์ด๋ค. ํ์ ์๋ ์
๋ฐ์ดํธ๋ฅผ ์ฐจ๋จํ๊ณ ๋ฐ์ดํฐ๊ฐ ํ๋ฅผ ๋๋ง ํ๋ฉด์ด ์ถ๋ ์ด๊ฒ ํ๋ผ.
-
-## ๐ ๊ตฌ์กฐํ๋ ์ง์ (Synthesized Content)
-- **Memoization (๋ฉ๋ชจ์ด์ ์ด์
)**:
- - **React.memo**: ์์ ์ปดํฌ๋ํธ๊ฐ ๋ณํด๋ ๋ด Props๊ฐ ๊ฐ๋ค๋ฉด ๊ทธ๋ฆฌ๊ธฐ๋ฅผ ๊ฑฐ๋ถํ๋ค.
- - **useMemo**: ๋น์ฉ์ด ํฐ ์ฐ์ฐ ๊ฒฐ๊ณผ(์: ๋ณต์กํ ํํฐ๋ง)๋ฅผ ์ ์ฅํด๋๊ณ ์ฌ์ฌ์ฉํ๋ค.
- - **useCallback**: ํจ์ ๊ฐ์ฒด์ ๋ณ๋์ ๋ง์ ์์ ์ปดํฌ๋ํธ์ ๋ถํ์ํ ๋ฆฌ๋ ๋๋ง์ ๋ฐฉ์งํ๋ค.
-- **Windowing (๊ฐ์ ๋ฆฌ์คํธ)**:
- - ์์ฒ ๊ฐ์ ๋ฆฌ์คํธ ์์ดํ
์ด ์์ด๋ ์ฌ์ฉ์์ ๋์ ๋ณด์ด๋ ์์ญ ๊ฐ๋ง ์ค์ DOM์ ๋ ๋๋งํ๋ค. (์: `react-window`, `react-virtualized`).
-- **์ํ์ ์์น ์ ์ ([[State|State]] Colocation)**:
- - ์ ์ญ ์ํ๊ฐ ๋ฐ๋ ๋๋ง๋ค ์ฑ ์ ์ฒด๊ฐ ๋ค์ฉ์ด์ง ์๊ฒ ํ๋ผ. ์ํ๋ ๊ทธ๊ฒ์ ์ฌ์ฉํ๋ ๊ฐ์ฅ ํ์ ์ปดํฌ๋ํธ ๊ทผ์ฒ๋ก ๋ด๋ ค๋ผ.
-
-## โ ๏ธ ๋ชจ์ ๋ฐ ์
๋ฐ์ดํธ (RL Update)
-- ๋ชจ๋ ๊ณณ์ `memo`๋ฅผ ์ฐ๋ ๊ฒ์ ๋ฉ๋ชจ๋ฆฌ ๋ญ๋น๋ค. ๋ฆฌ์กํธ์ ๊ธฐ๋ณธ ๋ ๋๋ง ์ฑ๋ฅ์ ์ด๋ฏธ ๋งค์ฐ ๋ฐ์ด๋๋ค. ๋ณ๋ชฉ ํ์์ด '์ค์ ๋ก ๊ด์ธก'๋ ๋๋ง ์ต์ ํ๋ฅผ ์ ์ฉํ๋ ๊ฒ์ด ์์น์ด๋ค.
-
-## ๐ ์ง์ ์ฐ๊ฒฐ (Graph)
-- Related: [[WebWorker_Performance|WebWorker_Performance]] , [[System_Debugging_Protocol|System_Debugging_Protocol]]
-- Foundation: [[React_Mental_Model|React_Mental_Model]]
diff --git a/10_Wiki/Topics/01_Frontend_Mastery/React_State_Management_Strategy.md b/10_Wiki/Topics/01_Frontend_Mastery/React_State_Management_Strategy.md
deleted file mode 100644
index 31b687f9..00000000
--- a/10_Wiki/Topics/01_Frontend_Mastery/React_State_Management_Strategy.md
+++ /dev/null
@@ -1,28 +0,0 @@
----
-title: ์ ๋ต์ ์ํ ๊ด๋ฆฌ ๊ฐ์ด๋ (Global & Server [[State|State]])
-category: Software [[Architecture|Architecture]]
-tags: [State [[Management|Management]], React Query, SSOT, Architecture]
-created: 2026-04-20
----
-
-# [[React_State_Management_Strategy|React_State_Management_Strategy]] (์ํ ๊ด๋ฆฌ ์ ๋ต)
-
-## ๐ ํ ์ค ํต์ฐฐ (The Karpathy Summary)
-> ์ํ๋ '์ด๋๋ ' ์์ ์ ์์ง๋ง, '์๋ฌด๋ฐ๋' ์์ด์๋ ์ ๋๋ค. ์ํ์ ์๋ช
์ฃผ๊ธฐ์ ์ ํ ๋ฒ์์ ๋ฐ๋ผ ๋ช
ํํ ๊ฑฐ์ฃผ์ง๋ฅผ ๊ฒฐ์ ํ๋ผ.
-
-## ๐ ๊ตฌ์กฐํ๋ ์ง์ (Synthesized Content)
-- **์ํ์ 3๋ ๊ฑฐ์ฃผ์ง**:
- 1. **Local State (๊ฑฐ์ฃผํ)**: `useState`. ํน์ ์ปดํฌ๋ํธ ๋ด๋ถ์์๋ง ์๊ณ ์๋ '์ฌ์ํ' (์: ๋๋กญ๋ค์ด ์ด๋ฆผ ์ฌ๋ถ).
- 2. **Global State (๊ณต์ฉ)**: `Zustand`, `Redux`. ์จ ๋๋ค๊ฐ ์์์ผ ํ๋ '๊ณต๊ณต ์ ๋ณด' (์: ๋ก๊ทธ์ธ ์ ์ , ๋คํฌ๋ชจ๋).
- 3. **Server State (๋น๋ ค์จ ๊ฒ)**: `React Query`. ์๋ฒ์์ ์ ์ ๋น๋ ค์์ ํ๋ฉด์ ๋ณด์ฌ์ฃผ๋ '์ธ๋ถ ๋ฐ์ดํฐ'.
-- **Server State์ ๋
๋ฆฝ**:
- - ๊ณผ๊ฑฐ์ Redux์ ์๋ฒ ๋ฐ์ดํฐ๋ฅผ ๋ด์ผ๋ ค ํ์ผ๋, ์ด์ ๋ ์บ์ฑ, ์ฌ์๋, ๋ก๋ฉ ๊ด๋ฆฌ๋ฅผ ์ ๋ดํ๋ **React Query/SWR**๋ก ๋ถ๋ฆฌํ๋ ๊ฒ์ด ์ธ๊ณ์ ์ธ ์ถ์ธ๋ค.
-- **์ํ์ ์ต์ํ ์์น**:
- - ๋ค๋ฅธ ์ํ๋ก๋ถํฐ ๊ณ์ฐ๋ ์ ์๋ ๊ฐ(์: `firstName`+`lastName` = `fullName`)์ ์ ๋ '์ํ'๋ก ๋ง๋ค์ง ๋ง๋ผ. ๋ ๋๋ง ์์ ์ ๊ณ์ฐํ๋ ๊ฒ์ด ์ ํฉ์ฑ ์ ์ง์ ํต์ฌ์ด๋ค.
-
-## โ ๏ธ ๋ชจ์ ๋ฐ ์
๋ฐ์ดํธ (RL Update)
-- ๋ฌด์กฐ๊ฑด์ ์ธ ์ ์ญ ์ํ ์ง์์ฃผ์๋ '[[Prop Drilling|Prop Drilling]]'๋ณด๋ค ์ํํ ์ ์๋ค. ์ปดํฌ๋ํธ ๊ฐ์ ์์กด์ฑ์ด ์์์ ์ผ๋ก ์ฝํ๊ธฐ ๋๋ฌธ์ด๋ค. ์ํ๋ ๋๋๋ก ์ฌ์ฉํ๋ ๊ณณ์์ ๊ฐ์ฅ ๊ฐ๊น๊ฒ ์์น์์ผ๋ผ.
-
-## ๐ ์ง์ ์ฐ๊ฒฐ (Graph)
-- Related: [[Single_Source_of_Truth|Single_Source_of_Truth]] , [[API_Communication_Patterns|API_Communication_Patterns]]
-- Foundation: [[React_Hooks_Deep_Dive|React_Hooks_Deep_Dive]]
diff --git a/10_Wiki/Topics/01_Frontend_Mastery/React_Testing_Strategy.md b/10_Wiki/Topics/01_Frontend_Mastery/React_Testing_Strategy.md
deleted file mode 100644
index cf1950eb..00000000
--- a/10_Wiki/Topics/01_Frontend_Mastery/React_Testing_Strategy.md
+++ /dev/null
@@ -1,26 +0,0 @@
----
-title: ๋ฆฌ์กํธ ์ ํ๋ฆฌ์ผ์ด์
ํ
์คํธ ์ ๋ต
-category: Software [[Architecture|Architecture]]
-tags: [[Testing|[Testing]], Vitest, RTL, Unit Test, QA]
-created: 2026-04-20
----
-
-# [[React_Testing_Strategy|React_Testing_Strategy]] (๋ฆฌ์กํธ ํ
์คํธ ์ ๋ต)
-
-## ๐ ํ ์ค ํต์ฐฐ (The Karpathy Summary)
-> ํ
์คํธ๋ '๋ด๊ฐ ์ง ์ฝ๋'๋ฅผ ๊ฒ์ฌํ๋ ๊ฒ์ด ์๋๋ผ, '์ฌ์ฉ์๊ฐ ๊ฒฝํํ ๊ฐ์น'๊ฐ ์ ์ง๋๊ณ ์๋์ง ์ํ์ ์ผ๋ก ์ฆ๋ช
ํ๋ ๋ณดํ์ด๋ค.
-
-## ๐ ๊ตฌ์กฐํ๋ ์ง์ (Synthesized Content)
-- **Unit Testing (๋จ์ ํ
์คํธ)**:
- - `Vitest` ์ฌ์ฉ. ์์ ํจ์, ๋น์ฆ๋์ค ๋ก์ง, ์ ํธ๋ฆฌํฐ ํจ์๊ฐ ์ฃผ์ด์ง ์
๋ ฅ์ ์ ํํ ์ถ๋ ฅ์ ๋ด๋์ง ๊ฒ์ฆํ๋ค.
-- **Integration Testing (ํตํฉ ํ
์คํธ)**:
- - `React Testing Library (RTL)`์ ์ฒ ํ: "์ฌ์ฉ์๊ฐ ๋ณด๋ฏ ํ
์คํธํ๋ผ." ๋ฒํผ์ ํด๋ฆญํ์ ๋ ํ๋ฉด์ด ๋ณํ๋์ง, ์ ์ ์ ์ธํฐ๋์
์ ์๋ฎฌ๋ ์ด์
ํ๋ค.
-- **Mocking (๋ชจํน)**:
- - ์๋ฒ API ํธ์ถ(`msw`)์ด๋ ๋ฌด๊ฑฐ์ด ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ ๊ฐ์ง(Mock)๋ก ๋์ฒดํ์ฌ ํ๊ฒฝ์ ๊ตฌ์ ๋ฐ์ง ์๋ ์์ ์ ์ธ ํ
์คํธ ํ๊ฒฝ์ ๊ตฌ์ถํ๋ค.
-
-## โ ๏ธ ๋ชจ์ ๋ฐ ์
๋ฐ์ดํธ (RL Update)
-- ํ
์คํธ ์ปค๋ฒ๋ฆฌ์ง 100% ์ง์ฐฉ์ ์์ฐ์ฑ์ ๊ฐ์๋จน๋๋ค. ๋น์ฆ๋์ค ํต์ฌ ๋ก์ง๊ณผ ์ฌ์ฉ์๊ฐ ๊ฐ์ฅ ๋ง์ด ์ฐ๋ '๋ฉ์ธ ์๋๋ฆฌ์ค'๋ถํฐ ๊ฒฌ๊ณ ํ๊ฒ ๋ณดํธํ๋ ์งํ๊ฐ ํ์ํ๋ค.
-
-## ๐ ์ง์ ์ฐ๊ฒฐ (Graph)
-- Related: [[System_Debugging_Protocol|System_Debugging_Protocol]] , [[Reliability_Safety_First|Reliability_Safety_First]]
-- Tool: [[Modern_Environment_Ecosystem|Modern_Environment_Ecosystem]]
diff --git a/10_Wiki/Topics/01_Frontend_Mastery/TypeScript_Type_Safety.md b/10_Wiki/Topics/01_Frontend_Mastery/TypeScript_Type_Safety.md
deleted file mode 100644
index 7ff64b3e..00000000
--- a/10_Wiki/Topics/01_Frontend_Mastery/TypeScript_Type_Safety.md
+++ /dev/null
@@ -1,26 +0,0 @@
----
-title: ํ์
์คํฌ๋ฆฝํธ ๊ธฐ๋ฐ์ ์์ ์ ๊ฐ๋ฐ (Type Safety)
-category: Software [[Architecture|Architecture]]
-tags: [TypeScript, Interface, Type Safety, Generic]
-created: 2026-04-20
----
-
-# [[TypeScript_Type_Safety|TypeScript_Type_Safety]] (ํ์
์คํฌ๋ฆฝํธ ์ ์)
-
-## ๐ ํ ์ค ํต์ฐฐ (The Karpathy Summary)
-> ํ์
์คํฌ๋ฆฝํธ๋ ๋น์ ์ ๊ท์ฐฎ๊ฒ ํ๋ '์์๋ฆฌ๊พผ'์ด ์๋๋ผ, ๋ฐํ์ ์๋ฌ๋ผ๋ '๋ญ๋ ๋ฌ์ง' ์์์ ๋น์ ์ ๋ถ์ก์์ฃผ๋ '์๋ช
์ค'์ด๋ค.
-
-## ๐ ๊ตฌ์กฐํ๋ ์ง์ (Synthesized Content)
-- **Non-Nullable & Narrowing**:
- - ๋ฐ์ดํฐ๊ฐ `null`์ด๊ฑฐ๋ `undefined`์ผ ์ ์์์ ์ฝ๋ ์์ค์์ ๊ฐ์ ๋ก ์ธ์ง์์ผ, ๋ฐํ์์์ ๋ฐ์ํ๋ 'TypeError'๋ฅผ 90% ์ด์ ์ฌ์ ์ฐจ๋จํ๋ค.
-- **Generics (์ถ์ํ์ ๋ํ์)**:
- - ๋ฐ์ดํฐ์ ๊ตฌ์ฒด์ ์ธ ํ์
์ ๋์ค์ ์ ํ์ง๋ง, ๊ทธ ๊ตฌ์กฐ์ ์ผ๊ด์ฑ์ ์ ์งํ๊ณ ์ถ์ ๋ ์ฌ์ฉํ๋ค. ์ฌ์ฌ์ฉ ๊ฐ๋ฅํ ๊ณ ๊ธฐ๋ฅ ์ปดํฌ๋ํธ ์ ์์ ํ์ ์๊ฑด์ด๋ค.
-- **Interface & Alias**:
- - ์์คํ
์ ์ฒด์ ํ๋ฅด๋ ๋ฐ์ดํฐ์ 'ํํ(Shape)'๋ฅผ ์ ์ํ๋ผ. ํ์
์ ์๋ง ์ ๋์ด ์์ด๋ ์ฝ๋๋ ์ค์ค๋ก๋ฅผ ์ค๋ช
ํ๋ ํ๋ฅญํ ๋ฌธ์๊ฐ ๋๋ค.
-
-## โ ๏ธ ๋ชจ์ ๋ฐ ์
๋ฐ์ดํธ (RL Update)
-- `any`๋ฅผ ๋จ๋ฐํ๋ ์๊ฐ ํ์
์คํฌ๋ฆฝํธ์ ๋ชจ๋ ์ด์ ์ ์ฌ๋ผ์ง๋ค. ์ฐจ๋ผ๋ฆฌ `unknown`์ ์ฐ๊ณ ํ์
์ ์ขํ๋(Narrowing) ๋ฐฉ์์ ํํ๋ผ. ํ์
์ ์์ ๋๋ฌด ๋ง์ ์๊ฐ์ ๋บ๊ธฐ๋ 'ํ์
ํฌ(Type Hell)'์ ๊ฒฝ๊ณํ๊ณ ์ ์ ํ ํํ์ ์ ์ฐพ์๋ผ.
-
-## ๐ ์ง์ ์ฐ๊ฒฐ (Graph)
-- Related: [[React_Clean_Code_Best_Practices|React_Clean_Code_Best_Practices]] , [[React_Hooks_Deep_Dive|React_Hooks_Deep_Dive]]
-- Foundation: [[System_Protocol_Standard|System_Protocol_Standard]]
diff --git a/10_Wiki/Topics/01_Process_Methodology/Refactoring.md b/10_Wiki/Topics/01_Process_Methodology/Refactoring.md
deleted file mode 100644
index 30baa419..00000000
--- a/10_Wiki/Topics/01_Process_Methodology/Refactoring.md
+++ /dev/null
@@ -1,69 +0,0 @@
----
-id: P-REINFORCE-WIKI-3576D819
-category: "10_Wiki/๐ก Topics/01_Process_Methodology"
-confidence_score: 0.95
-tags: ['refactoring', 'strangler-fig-pattern', 'ports-and-adapters-(hexagonal-architecture)', 'software-architecture-erosion', 'technical-debt', 'process-methodology']
-last_reinforced: 2026-05-02
----
-
-# [[Refactoring]]
-
-## ๐ Brief ์ Summary
-๋ฆฌํฉํ ๋ง(Refactoring)์ ๋ณํํ๋ ์๊ตฌ์ฌํญ๊ณผ ์์คํ
ํ์ฅ์ ๋์ํ๊ณ ๊ธฐ์ ๋ถ์ฑ๋ฅผ ํด๊ฒฐํ๊ธฐ ์ํด, ์ํํธ์จ์ด์ ๊ธฐ์กด ์ฝ๋๋ ์ํคํ
์ฒ๋ฅผ ์ ์ง์ ์ผ๋ก ์ฌ๊ตฌ์กฐํํ๋ ๊ณผ์ ์ ์๋ฏธํฉ๋๋ค [1, 2]. ์ด๊ธฐ MVP ๊ฐ๋ฐ์ ์ํด ์ ํํ ๋จ์ํ ์ํคํ
์ฒ(์: ๊ณ์ธตํ ์ํคํ
์ฒ)๊ฐ ์์คํ
๊ท๋ชจ๊ฐ ์ปค์ง์ ๋ฐ๋ผ ํ๊ณ์ ๋ถ๋ชํ ๋, ๋ณด๋ค ๋ชจ๋ํ๋๊ณ ํ์ฅ ๊ฐ๋ฅํ ์ํคํ
์ฒ(์: ํฅ์ฌ๊ณ ๋ , ๋ง์ดํฌ๋ก์๋น์ค)๋ก ์ ํํ๊ธฐ ์ํ ํ์์ ์ธ ์งํ ๋จ๊ณ๋ก ํ์ฉ๋ฉ๋๋ค [2-4].
-
-## ๐ Core Content
-- **์ํคํ
์ฒ ์งํ์ ๊ธฐ์ ๋ถ์ฑ ํด์:** ์คํํธ์
์ด๋ ์๊ท๋ชจ ํ๋ก์ ํธ๋ ๋น ๋ฅธ ์ถ์๋ฅผ ์ํด ๋จ์ํ ๊ณ์ธตํ ์ํคํ
์ฒ(Layered Architecture)๋ ๋ชจ๋๋ฆฌ์(Monolithic) ๊ตฌ์กฐ๋ก ์์ํ๋ ๊ฒฝ์ฐ๊ฐ ๋ง์ต๋๋ค [4, 5]. ํ์ง๋ง ์์คํ
์ด ์ฑ์ฅํ๊ณ ํ๋ ์์ํฌ๋ ๋ฐ์ดํฐ๋ฒ ์ด์ค๋ฅผ ์
๊ทธ๋ ์ด๋ํด์ผ ํ ๋, ์ด๋ฌํ ๊ตฌ์กฐ๋ ์ฌ๊ฐํ ๊ธฐ์ ๋ถ์ฑ์ ๋ณด์ ๋ถ์ฑ๋ฅผ ์ ๋ฐํ ์ ์์ผ๋ฏ๋ก ํฅ์ฌ๊ณ ๋ (Hexagonal)์ด๋ ๋ง์ดํฌ๋ก์๋น์ค ์ํคํ
์ฒ๋ก์ ๋ฆฌํฉํ ๋ง์ด ๋ถ๊ฐํผํฉ๋๋ค [1, 3].
-- **์ ์ง์ ๋ง์ด๊ทธ๋ ์ด์
(Incremental Refactoring):** ์ํคํ
์ฒ ๋ฆฌํฉํ ๋ง์ ์ํ์ฑ์ด ํฐ "๋น
๋ฑ
(Big bang)" ๋ฐฉ์์ ์ ๋ฉด ์ฌ๊ตฌ์ถ์ ํผํ๊ณ ์ ์ง์ ์ผ๋ก ์ด๋ฃจ์ด์ ธ์ผ ํฉ๋๋ค [6]. ์๋ฅผ ๋ค์ด, ์๋ก์ด ๊ธฐ๋ฅ์ ์ํด ํฌํธ์ ์ด๋ํฐ(Ports/Adapters)๋ฅผ ๋์
ํ์ฌ ๊ธฐ์กด ๋ ๊ฑฐ์ ์ปดํฌ๋ํธ์ ๊ฒฐํฉ๋๋ฅผ ์์ํ ๋ฎ์ถ๊ฑฐ๋ [6, 7], ์คํธ๋ญ๊ธ๋ฌ ํผ๊ทธ ํจํด(Strangler Fig Pattern)์ ํ์ฉํด ๋ชจ๋๋ฆฌ์ ์ปดํฌ๋ํธ๋ฅผ ์ ์ง์ ์ผ๋ก ์๋ฒ๋ฆฌ์ค ์๋น์ค๋ก ๋์ฒดํ๋ ๋ฐฉ์์ด ๊ถ์ฅ๋ฉ๋๋ค [8].
-- **์์ ํ ๋ฆฌํฉํ ๋ง์ ์ํ ์ํคํ
์ฒ ์ค๊ณ:** ํด๋ฆฐ ์ํคํ
์ฒ(Clean Architecture)๋ ํฅ์ฌ๊ณ ๋ ์ํคํ
์ฒ์ ๊ฐ์ด ๋๋ฉ์ธ ํต์ฌ ๋น์ฆ๋์ค ๋ก์ง์ ๊ฒฉ๋ฆฌํ๋ ๊ตฌ์กฐ๋, ๊ธฐ์ ์ด๋ ํ๋กํ ์ฝ์ ๊ด๊ณ์์ด ๋ด๋ถ ๋ก์ง์ ๋ณดํธํ๋ฏ๋ก ์ต์ํ์ ์ํ์ผ๋ก ์์ ํ๊ฒ ํ
์คํธํ๊ณ ๋ฆฌํฉํ ๋งํ ์ ์๋ ํ๊ฒฝ์ ์ ๊ณตํฉ๋๋ค [9].
-- **์ํคํ
์ฒ ์นจ์(Architecture Erosion)์ ๋ํ ์น๋ฃ์ ์กฐ์น:** ์ํํธ์จ์ด ์ํคํ
์ฒ๋ ์๊ฐ์ด ์ง๋จ์ ๋ฐ๋ผ ์๋๋ ์ค๊ณ์ ์ค์ ๊ตฌํ ์ฌ์ด์ ๊ฒฉ์ฐจ๊ฐ ๋ฐ์ํ๋ '์ํคํ
์ฒ ์นจ์'์ ๊ฒช๊ฒ ๋ฉ๋๋ค [10]. ๊ธฐ์ ๋ถ์ฑ ๋์ ๋ฑ์ผ๋ก ์ธํด ๋ฐ์ํ๋ ์ด๋ฌํ ์นจ์์ ํด๊ฒฐํ๊ณ ์์คํ
์ ์ ์ง๋ณด์ํ๊ธฐ ์ํ ์ฃผ์ ์น๋ฃ์ ์กฐ์น(Remedial measures)๋ก ๋ฆฌํฉํ ๋ง๊ณผ ์ฌ์ค๊ณ(Redesign)๊ฐ ์ํ๋ฉ๋๋ค [11].
-
-## โ๏ธ Trade-offs & Caveats
-- **๊ฐ๋ฐ ์คยทํ๋ฐ๋ถ์ ๋์ ๋ณต์ก์ฑ:** ์ํคํ
์ฒ ํจํด์ ๋ณ๊ฒฝํ๊ฑฐ๋ ํฐ ๊ท๋ชจ์ ๋ฆฌํฉํ ๋ง์ ๊ฐ๋ฐ ์คยทํ๋ฐ๋ถ์ ์๋ํ ๊ฒฝ์ฐ, ์ด๋ฏธ ๊ตฌ์ถ๋ ์์กด์ฑ๊ณผ ์ฝ๋๋ฒ ์ด์ค์ ๋ณต์ก์ฑ์ผ๋ก ์ธํด ์๋นํ ๊ณ ํต๊ณผ ๋ง๋ํ ๋
ธ๋ ฅ์ด ์๋ฐ๋ ์ ์์ต๋๋ค [2, 12].
-- **๊ฐํ ๊ฒฐํฉ(Tight Coupling) ํ๊ฒฝ์์์ ๋ฆฌํฉํ ๋ง ์ทจ์ฝ์ฑ:** ๊ฒฝ๊ณ๊ฐ ๋ถ๋ถ๋ช
ํด์ง ๊ณ์ธตํ ์ํคํ
์ฒ๋ ๊ตฌ์กฐ๊ฐ ์ํจ ๋ชจ๋๋ฆฌ์ ์์คํ
์์๋, ์ปดํฌ๋ํธ ๊ฐ์ ๊ฐํ ๊ฒฐํฉ์ผ๋ก ์ธํด ๋ฆฌํฉํ ๋ง ์ ํตํฉ ํ
์คํธ๊ฐ ๊นจ์ง๊ธฐ ์ฝ๊ณ (brittle), ์์ธก ๋ถ๊ฐ๋ฅํ ์ฐ์ ์ค๋ฅ๊ฐ ๋ฐ์ํ ์ํ์ด ํฝ๋๋ค [13, 14].
-- **๋น์ฉ๊ณผ ์๊ฐ์ ์ ์ฝ:** ๊ธฐ์ ๋ถ์ฑ๋ฅผ ์ํํ๊ณ ์์คํ
์ฑ๋ฅ์ ์ต์ ํํ๊ธฐ ์ํด ๋ฆฌํฉํ ๋ง์ด ํ์ํ์ง๋ง, ์ด๊ธฐ๋ถํฐ ์๋น์ค ๋ถ๋ฆฌ(์: ๋ง์ดํฌ๋ก์๋น์ค)๋ฅผ ์ผ๋์ ๋์ง ์๊ณ ๋ง๋ค์ด์ง ๋ชจ๋๋ฆฌ์ ์์คํ
์ ๋ถํดํ๋ ๊ฒ์ ์๋นํ ๊ฐ๋ฐ ๊ธฐ๊ฐ๊ณผ ์ด์ ์ธํ๋ผ ๋ณ๊ฒฝ ๋น์ฉ์ ์๊ตฌํฉ๋๋ค [2, 15].
-
-## ๐ Knowledge Connections
-
-### Related Concepts
-
-#### [๋ง์ด๊ทธ๋ ์ด์
/์ ํ ์ ๋ต]
-- [[Strangler Fig Pattern]]
- - ์ฐ๊ฒฐ ์ด์ : ๊ธฐ์กด ๋ชจ๋๋ฆฌ์ ์ํคํ
์ฒ์์ ์๋ฒ๋ฆฌ์ค๋ ๋ง์ดํฌ๋ก์๋น์ค๋ก ๋ฆฌํฉํ ๋งํ ๋ ์ฌ์ฉ๋๋ ๋ํ์ ์ธ ์ ์ง์ ๋ง์ด๊ทธ๋ ์ด์
ํจํด์ด๊ธฐ ๋๋ฌธ์
๋๋ค [8].
- - ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ๋ ๊ฑฐ์ ์์คํ
์ ๊ฐ์ฉ์ฑ์ ์ ์งํ๋ฉด์ ์ํคํ
์ฒ ๋ถ์ฑ๋ฅผ ์์ ํ๊ฒ ๋ถํ ๋ฐ ์ํํ๋ ์ค๋ฌด์ ์ธ ๋ฆฌํฉํ ๋ง ๋ฐฉ๋ฒ๋ก ์ ์ดํดํ ์ ์์ต๋๋ค.
-- [[Ports and Adapters (Hexagonal Architecture)]]
- - ์ฐ๊ฒฐ ์ด์ : ๋ ๊ฑฐ์ ์ฝ๋๋ฅผ ๋ฆฌํฉํ ๋งํ ๋, ์๋ก์ด ๊ธฐ๋ฅ์ ๋ํด ํฌํธ์ ์ด๋ํฐ๋ฅผ ๋์
ํ์ฌ ์ ์ง์ ์ผ๋ก ์์คํ
์ ๋์ปคํ๋งํ๋ ๋ฐ ํ์ฉ๋ฉ๋๋ค [6].
- - ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ๋น์ฆ๋์ค ๋ก์ง๊ณผ ์ธ๋ถ ์ธํ๋ผ์ ์์กด์ฑ์ ์ญ์ ์์ผ ๋ฆฌํฉํ ๋ง์ ๋ฐ๋ฅธ ๋ถ์์ฉ์ ์ต์ํํ๋ ๊ตฌ์กฐ์ ์๋ฆฌ๋ฅผ ๋ฐฐ์ธ ์ ์์ต๋๋ค.
-
-#### [์ํคํ
์ฒ ํ์ง ๋ฐ ๋ถ์ฑ]
-- [[Software Architecture Erosion]]
- - ์ฐ๊ฒฐ ์ด์ : ์ํคํ
์ฒ ์นจ์์ ๋ฆฌํฉํ ๋ง์ด ํ์ํ๊ฒ ๋๋ ๊ทผ๋ณธ์ ์ธ ์์ธ ์ค ํ๋์ด๋ฉฐ, ๋ฆฌํฉํ ๋ง์ ์ด๋ฅผ ๋ณต๊ตฌํ๊ธฐ ์ํ ์น๋ฃ์ ์กฐ์น๋ก ์์ฉํฉ๋๋ค [10, 11].
- - ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ์ ์ด๊ธฐ์ ์ ์ค๊ณ๋ ์์คํ
์ด๋ผ๋ ์ง์์ ์ธ ๋ฆฌํฉํ ๋ง ์์ด๋ ๊ตฌ์กฐ๊ฐ ๋ฌด๋์ง๊ณ ์ ์ง๋ณด์ ๋น์ฉ์ด ๊ธ์ฆํ๋์ง ์ดํดํ ์ ์์ต๋๋ค.
-- [[Technical Debt]]
- - ์ฐ๊ฒฐ ์ด์ : ๋ชจ๋๋ฆฌ์ค๋ ๋จ์ ๊ณ์ธตํ ์ํคํ
์ฒ๊ฐ ํ์ฅ์ ๋ง์ดํ ๋ ์ถ์ ๋๋ ๋ถ์ฑ์ด๋ฉฐ, ์ด๋ฅผ ํด์ํ๊ธฐ ์ํด ๋ฆฌํฉํ ๋ง์ด ์ํ๋ฉ๋๋ค [1, 15].
- - ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ์ํคํ
์ฒ๋ฅผ ์ ์์ ๋ฆฌํฉํ ๋งํ์ง ์์ ๊ฒฝ์ฐ ์์คํ
์ฑ๋ฅ๊ณผ ๊ฐ๋ฐ ์๋์ ๋ฏธ์น๋ ์
์ํฅ์ ํ์
ํ ์ ์์ต๋๋ค.
-
-### Deeper Research Questions
-
-- ๊ณ์ธตํ ์ํคํ
์ฒ(Layered Architecture)๊ฐ ๊ฐํ ๊ฒฐํฉ(Tight Coupling) ์ํ๋ก ๋ณ์ง๋์์ ๋, ์ด๋ฅผ ํฅ์ฌ๊ณ ๋ ์ํคํ
์ฒ๋ก ์์ ํ๊ฒ ๋ฆฌํฉํ ๋งํ๊ธฐ ์ํ ํฌํธ์ ์ด๋ํฐ ๋์
์ ๊ตฌ์ฒด์ ์ธ ๋จ๊ณ๋ ๋ฌด์์ธ๊ฐ?
-- ๋๊ท๋ชจ ๋ชจ๋๋ฆฌ์ ์ํคํ
์ฒ๋ฅผ ๋ง์ดํฌ๋ก์๋น์ค๋ก ๋ฆฌํฉํ ๋งํ ๋, ์คํธ๋ญ๊ธ๋ฌ ํผ๊ทธ ํจํด(Strangler Fig Pattern)์ ์ ์ฉํ์ฌ ๋ฐ์ดํฐ ์ผ๊ด์ฑ์ ์ ์งํ๋ ๋ฐฉ์์ ๋ฌด์์ธ๊ฐ?
-- ์ํคํ
์ฒ ์นจ์(Architecture Erosion)์ ์กฐ๊ธฐ์ ์๋ณํ์ฌ ๋๊ท๋ชจ ๋ฆฌํฉํ ๋ง์ผ๋ก ์ด์ด์ง๊ธฐ ์ ์ ์๋ฐฉํ ์ ์๋ ์๋ํ๋ ์ํคํ
์ฒ ์ ํฉ์ฑ ๊ฒ์ฌ(Architecture Conformance Check) ๊ธฐ๋ฒ์ ๋ฌด์์ด ์๋๊ฐ?
-- ๋น์ฆ๋์ค ๋ก์ง์ด UI๋ ๋ฐ์ดํฐ๋ฒ ์ด์ค ๊ณ์ธต์ ๋ถ์ฐ๋์ด ๋์(Leak)๋ ๊ธฐ์กด ๋ ๊ฑฐ์ ์ฝ๋๋ฅผ, ๋๋ฉ์ธ ์ค์ฌ ์ค๊ณ(DDD) ๊ธฐ๋ฐ์ผ๋ก ๋ฆฌํฉํ ๋งํ ๋ ๊ฒช๋ ํธ๋ ์ด๋์คํ๋ ๋ฌด์์ธ๊ฐ?
-- ๋ฆฌํฉํ ๋ง ๊ณผ์ ์ค ๋ถ๊ฐํผํ ๋ง์ด๊ทธ๋ ์ด์
์ด ์งํ๋๋ ๋์, ์์คํ
์ ๋ฌด์ค๋จ ๋ฐฐํฌ ๋ฐ ์ด์ ๊ธฐ๋ฅ๊ณผ์ ํ์ ํธํ์ฑ์ ๋ณด์ฅํ๊ธฐ ์ํ API ๋ฒ์ ๋ ๋ฐ ๋ผ์ฐํ
์ ๋ต์ ์ด๋ป๊ฒ ๊ตฌ์ฑํด์ผ ํ๋๊ฐ?
-
-### Practical Application Contexts
-
-- **Implementation:** ๋ชจ๋๋ฆฌ์ ์์คํ
์ ํน์ ๋ชจ๋์ ์๋ฒ๋ฆฌ์ค ํจ์๋ก ์ ํํ๊ฑฐ๋, ๋ ๊ฑฐ์ ์ฝ๋ ๋ด๋ถ์ ์ธํฐํ์ด์ค(ํฌํธ)๋ฅผ ์ ์ํ์ฌ ์ธ๋ถ ์์กด์ฑ(์ด๋ํฐ)์ ๋ถ๋ฆฌํ๋ ๋ฐฉ์์ผ๋ก ์ฝ๋๋ฅผ ์ ์ง์ ์ผ๋ก ๊ฐ์ ํ ๋ ์ ์ฉ๋ฉ๋๋ค.
-- **System Design:** ์ด๊ธฐ ์์คํ
์ ๋น ๋ฅธ ์๋๋ฅผ ์ํด ๋จ์ํ ๋ชจ๋๋ฌ ๋ชจ๋๋ฆฌ์ค(Modular Monolith)๋ก ์ค๊ณํ๋, ํฅํ ์ฌ์ฉ์๊ฐ ํญ์ฆํ ๋ ๋ง์ดํฌ๋ก์๋น์ค๋ก ์ฝ๊ฒ ๋ฆฌํฉํ ๋งํ ์ ์๋๋ก ๋๋ฉ์ธ ๊ฐ ๊ฒฐํฉ๋๋ฅผ ๋ฏธ๋ฆฌ ๋ฎ์ถ๋ ์ ๋ต์ ์ทจํ ๋ ํ์ฉ๋ฉ๋๋ค.
-- **Operation / Maintenance:** ์ฝ๋ ์ ์ ๋ถ์์ด๋ ์ํคํ
์ฒ ์ ํฉ์ฑ ๊ฒ์ฌ๋ฅผ ํตํด ์ํคํ
์ฒ ์นจ์ ๋ฐ ๊ธฐ์ ๋ถ์ฑ๋ฅผ ์๋ณํ๊ณ , ์ ์ง๋ณด์ ์ฃผ๊ธฐ๋ง๋ค ์ด๋ฅผ ํด๊ฒฐํ๊ธฐ ์ํ ๋ฆฌํฉํ ๋ง ์คํ๋ฆฐํธ๋ฅผ ์ด์ํฉ๋๋ค.
-- **Learning Path:** ๊ธฐ๋ณธ ๊ณ์ธตํ ํจํด ๊ตฌ์ถ -> ๊ธฐ์ ๋ถ์ฑ ๋ฐ ๊ตฌ์กฐ์ ํ๊ณ ์ฒด๊ฐ -> ์์กด์ฑ ์ญ์ ์์น(SOLID, Clean Architecture) ํ์ต -> ๊ธฐ์กด ํ๋ก์ ํธ๋ฅผ ๋๋ฉ์ธ ์ค์ฌ์ผ๋ก ๋ฆฌํฉํ ๋ง ํด๋ณด๋ ๊ณผ์ ์ผ๋ก ํ์ต์ด ์ฐ๊ฒฐ๋ฉ๋๋ค.
-- **My Project Relevance:** ํ์ฌ ๊ตฌ์ถ ์ค์ธ MVP ํ๋ก์ ํธ๊ฐ ํฅํ ํด๋ผ์ฐ๋ ๋ค์ดํฐ๋ธ(Cloud-Native) ํ๊ฒฝ์ผ๋ก ์ค์ผ์ผ์
๋ ๊ฒ์ ๋๋นํ์ฌ, ๋ฌด๋ฆฌํ ๋น
๋ฑ
๋ฐฉ์์ ์ ํ์ ํผํ๊ณ ์ ์ง์ ์ธ ๋ฆฌํฉํ ๋ง์ด ๊ฐ๋ฅํ ์์คํ
๊ฒฝ๊ณ๋ฅผ ์ฌ์ ์ ์ค๊ณํ๋ ๋ฐ ๊ธฐ์ค์ด ๋ฉ๋๋ค.
-
-### Adjacent Topics
-
-- [[Domain-Driven Design (DDD)]]
- - ํ์ฅ ๋ฐฉํฅ: ์ํคํ
์ฒ ๋ฆฌํฉํ ๋ง ์, ๋ชจ๋๋ฆฌ์ ์์คํ
์ ๋ถํดํ๊ธฐ ์ํ ๊ฒฝ๊ณ(Bounded Context)๋ฅผ ์๋ณํ๊ณ ์ ์ํ๋ ๊ธฐ์ค์ ์ผ๋ก ํ์ต์ ํ์ฅํ ์ ์์ต๋๋ค.
-- [[Microservices Decomposition]]
- - ํ์ฅ ๋ฐฉํฅ: ๋ฆฌํฉํ ๋ง์ ํตํด ๋จ์ผ ๋ฐ์ดํฐ๋ฒ ์ด์ค๋ฅผ ์๋น์ค๋ณ ๋ฐ์ดํฐ๋ฒ ์ด์ค(Database per Service)๋ก ๋ถ๋ฆฌํ๊ณ , ์ฌ๊ฐ(Saga) ํจํด์ด๋ CQRS๋ฅผ ๋์
ํ๋ ์ค๋ฌด์ ์ธ ๋ง์ด๊ทธ๋ ์ด์
๊ธฐ๋ฒ์ผ๋ก ํ๊ตฌํ ์ ์์ต๋๋ค.
-
----
-*Last updated: 2026-05-02*
\ No newline at end of file
diff --git a/10_Wiki/Topics/02_Architecture_Principles/API_Communication_Patterns.md b/10_Wiki/Topics/02_Architecture_Principles/API_Communication_Patterns.md
deleted file mode 100644
index 55668e02..00000000
--- a/10_Wiki/Topics/02_Architecture_Principles/API_Communication_Patterns.md
+++ /dev/null
@@ -1,26 +0,0 @@
----
-title: ํจ์จ์ ์ธ API ํต์ ํจํด (Axios & Interceptors)
-category: Software [[Architecture|Architecture]]
-tags: [API, Axios, Interceptor, Error Handling, Network]
-created: 2026-04-20
----
-
-# [[API_Communication_Patterns|API_Communication_Patterns]] (API ํต์ ํจํด)
-
-## ๐ ํ ์ค ํต์ฐฐ (The Karpathy Summary)
-> ์๋ฒ์์ ๋ํ๋ ํญ์ '์ ์คํ๋ ์์ฌํ๋ฉฐ' ์ฒ๋ฆฌํ๋ผ. ๋ชจ๋ ์์ฒญ์ ์ค์ ํต์ ์(Interceptor)๋ฅผ ๊ฑฐ์น๊ณ ๋ชจ๋ ์๋ฌ๋ ์๋๋ฆฌ์ค๊ฐ ์ค๋น๋์ด ์์ด์ผ ํ๋ค.
-
-## ๐ ๊ตฌ์กฐํ๋ ์ง์ (Synthesized Content)
-- **Service Layer (์๋น์ค ๋ ์ด์ด) ์ถ์ํ**:
- - ์ปดํฌ๋ํธ ๋ด์ `axios` ์ฝ๋๋ฅผ ๊ธฐ์์ํค์ง ๋ง๋ผ. `userService.js`, `productApi.js` ์ฒ๋ผ API๋ณ๋ก ๋ชจ๋ํํ์ฌ ์ปดํฌ๋ํธ๋ ์ค์ง 'ํจ์ ํธ์ถ'๋ง ์๊ฒ ํ๋ผ.
-- **Axios Interceptors (์ฌ์ฌ ํต๋ก)**:
- - ๋ชจ๋ ์์ฒญ์ ์ธ์ฆ ํ ํฐ์ ์๋์ผ๋ก ๋ถ์ด๊ฑฐ๋, ๋ฐฑ์๋์์ ๋ด๋ ค์ค๋ 401 ์๋ฌ๋ฅผ ๊ฐ๋ก์ฑ์ ์๋์ผ๋ก ํ ํฐ์ ๊ฐฑ์ (Silent Refresh)ํ๋ ๋ก์ง์ ์ค์ ์ง๊ถํํ๋ค.
-- **Error Scenario Planning**:
- - 400(์๋ชป๋ ์์ฒญ), 403(๊ถํ ์์), 500(์๋ฒ ์ฃฝ์) ๋ฑ ๊ฐ ์๋ฌ ์ฝ๋๋ณ๋ก ์ฌ์ฉ์๊ฐ ๊ฒฝํํ UI ์ฒ๋ฆฌ ๋ฐฉ์นจ์ ๋ฏธ๋ฆฌ ์ฝ์ํ๋ผ.
-
-## โ ๏ธ ๋ชจ์ ๋ฐ ์
๋ฐ์ดํธ (RL Update)
-- ๋ชจ๋ ํต์ ์ Axios๊ฐ ์ ๋ต์ ์๋๋ค. ๋ธ๋ผ์ฐ์ ๋ค์ดํฐ๋ธ์ธ `fetch`๋ก๋ ์ถฉ๋ถํ ๊ฒฝ์ฐ๊ฐ ๋ง์ผ๋ฉฐ, ๋ผ์ด๋ธ๋ฌ๋ฆฌ ์์กด์ฑ์ ๋ฎ์ถ๋ ๊ฒ์ด ๊ฐ๋ฒผ์ด ์ฑ์ ๋ง๋๋ ์ฒซ๊ฑธ์์ผ ์ ์๋ค.
-
-## ๐ ์ง์ ์ฐ๊ฒฐ (Graph)
-- Related: [[System_Protocol_Standard|System_Protocol_Standard]] , React_State_Management_Strategy
-- Foundation: [[Reliability_Safety_First|Reliability_Safety_First]]
diff --git a/10_Wiki/Topics/02_Architecture_Principles/CQRS.md b/10_Wiki/Topics/02_Architecture_Principles/CQRS.md
deleted file mode 100644
index 809bd012..00000000
--- a/10_Wiki/Topics/02_Architecture_Principles/CQRS.md
+++ /dev/null
@@ -1,79 +0,0 @@
----
-id: P-REINFORCE-WIKI-73312AB3
-category: "10_Wiki/๐ก Topics/02_Architecture_Principles"
-confidence_score: 0.95
-tags: ['cqrs', 'event-sourcing-pattern', 'microservices-architecture', 'event-driven-architecture', 'message-brokers-(e.g.,-kafka)', 'architecture-principles']
-last_reinforced: 2026-05-02
----
-
-# [[CQRS]]
-
-## ๐ Brief Summary
-CQRS(Command Query Responsibility Segregation)๋ ์ ํ๋ฆฌ์ผ์ด์
์์ ์ฝ๊ธฐ(Query) ์์
๊ณผ ์ฐ๊ธฐ(Command) ์์
์ ๊ฐ๊ฐ ๋
๋ฆฝ๋ ๋ณ๋์ ๋ชจ๋ธ๋ก ๋ถ๋ฆฌํ์ฌ ์ฒ๋ฆฌํ๋ ์ํคํ
์ฒ ํจํด์ด๋ค [1]. ์ด๋ฅผ ํตํด ๋ฐ์ดํฐ ์ง์ฝ์ ์ธ ์ ํ๋ฆฌ์ผ์ด์
์ ์ฑ๋ฅ๊ณผ ํ์ฅ์ฑ์ ๊ทน๋ํํ ์ ์์ผ๋ฉฐ, ํนํ ์ฝ๊ธฐ ์์
์ด ์ฐ๊ธฐ ์์
๋ณด๋ค ์๋์ ์ผ๋ก ๋ง์ ํ๊ฒฝ(์: 10๋ฐฐ ์ด์)์์ ๋งค์ฐ ์ ์ฉํ๊ฒ ์ฐ์ธ๋ค [1, 2]. ์ต๊ทผ์๋ ๊ฐ์ธํ๋ ๋์งํธ ํ๊ฒฝ์์ AI ํตํฉ ์๋น์ค๋ ๋ฐ์ดํฐ ๋ฐ ๋ถ์ ์๋น์ค ์์๊ฐ ์ฆ๊ฐํจ์ ๋ฐ๋ผ ์ด ํจํด์ ๋์
ํ์์ฑ์ด ๋์ฑ ์ปค์ง๊ณ ์๋ค [1].
-
-## ๐ Core ์์ค์ ์ ๋ณด๊ฐ ๋ถ์กฑํ๋ฉด "์์ค์ ๊ด๋ จ ์ ๋ณด๊ฐ ๋ถ์กฑํฉ๋๋ค."๋ผ๊ณ ๋ช
์ํ์์ค. Content
-- **์ฝ๊ธฐ์ ์ฐ๊ธฐ ๋ชจ๋ธ์ ์๊ฒฉํ ๋ถ๋ฆฌ:**
- CQRS์ ํต์ฌ์ ์์คํ
์ ์ํ๋ฅผ ๋ณ๊ฒฝํ๋ '๋ช
๋ น(Command)'๊ณผ ์ํ๋ฅผ ๋ฐํํ๋ '์กฐํ(Query)'์ ์ฑ
์์ ๋ถ๋ฆฌํ๋ ๊ฒ์ด๋ค [1]. ๋ณต์กํ ๋๋ฉ์ธ์ผ์๋ก ์กฐํ์ ์ํ ๋ณ๊ฒฝ ๊ณผ์ ์์ ์๋ก ๋ค๋ฅธ ์ต์ ํ๊ฐ ํ์ํ๋ฉฐ, CQRS๋ ์ด๋ฅผ ๊ตฌ์กฐ์ ์ผ๋ก ๋ถ๋ฆฌํ์ฌ ๊ฐ๊ฐ์ ๋ง๋ ๋ชจ๋ธ์ ์์ฑํ๋ค [2].
-- **๋ฐ์ดํฐ๋ฒ ์ด์ค ๋ฐ ๊ธฐ์ ์คํ์ ๋
๋ฆฝ์ ์ต์ ํ:**
- ์ฝ๊ธฐ ์์
์ ๋ณต์กํ ์กฐ์ธ ์ฐ์ฐ์ ํผํ๊ธฐ ์ํด **์ญ์ ๊ทํ(denormalized)๋ ๋ฐ์ดํฐ**๋ฅผ ์ฌ์ฉํ์ฌ ๋งค์ฐ ๋น ๋ฅธ ์ฟผ๋ฆฌ ์๋๋ฅผ ๋ฌ์ฑํ๋ค [3]. ๊ตฌ์กฐ๊ฐ ๋ถ๋ฆฌ๋์ด ์์ผ๋ฏ๋ก **์ฐ๊ธฐ ์์
์๋ ์์ ํ SQL ๋ฐ์ดํฐ๋ฒ ์ด์ค๋ฅผ, ์ฝ๊ธฐ ์์
์๋ ๊ณ ์ ๊ฒ์์ด ๊ฐ๋ฅํ NoSQL ๋ฐ์ดํฐ๋ฒ ์ด์ค๋ฅผ ์ ์ฉํ๋ ๋ฑ ์ ์ฐํ ์คํ ๋ฆฌ์ง ๊ธฐ์ ์ ํ์ด ๊ฐ๋ฅ**ํ๋ค [3].
-- **ํ์ ๋
๋ฆฝ์ฑ๊ณผ ๋ณ๋ ฌ ๊ฐ๋ฐ:**
- ๋ฐ์ดํฐ ๋ชจ๋ธ๋ฟ๋ง ์๋๋ผ ํ๋ก ํธ์๋์ ๋ฐฑ์๋ ๊ฐ๋ฐ ํ์ด ์ฝ๊ธฐ ๋ชจ๋ธ๊ณผ ์ฐ๊ธฐ ๋ชจ๋ธ์ ๊ฐ๊ฐ ๋
๋ฆฝ์ ์ผ๋ก ๊ฐ๋ฐํ๊ณ ๋ณ๋ ฌ๋ก ์์
ํ ์ ์๋ ํ๊ฒฝ์ ์ ๊ณตํ์ฌ ์ ์ฒด์ ์ธ ํ ์์ฐ์ฑ์ ๋์ธ๋ค [3].
-- **๋ถ์ฐ ์ฟผ๋ฆฌ์ ๋ง์ดํฌ๋ก์๋น์ค ํ๊ฒฝ ์ ์ฉ:**
- ๋ง์ดํฌ๋ก์๋น์ค ์ํคํ
์ฒ(MSA)์์๋ ๊ฐ ์๋น์ค๊ฐ ๋
๋ฆฝ์ ์ธ ๋ฐ์ดํฐ๋ฒ ์ด์ค๋ฅผ ๊ฐ๊ธฐ ๋๋ฌธ์ ์ฌ๋ฌ ์๋น์ค์ ๊ฑธ์น ๋ฐ์ดํฐ ์กฐํ๊ฐ ์ด๋ ต๋ค. ์ด๋ ๋น๋๊ธฐ ๋ฉ์์ง์ ํ์ฉํด ๋ค๋ฅธ ์๋น์ค๋ค์ ๋ฐ์ดํฐ ์ํ ์ด๋ฒคํธ๋ฅผ ๊ตฌ๋
ํ์ฌ ๋ฐ์ดํฐ๋ฅผ ์กฐํ ์ ์ฉ ๋ณต์ ๋ณธ(Replica)์ผ๋ก ๋ชจ์๋๋ CQRS ํจํด์ด ๊ฐ๋ ฅํ ํด๊ฒฐ์ฑ
์ด ๋๋ค [4, 5].
-- **์ฃผ์ ํ์ฉ ์ฌ๋ก:**
- e-์ปค๋จธ์ค(์ํ ๋ชฉ๋ก ์กฐํ vs ์ฃผ๋ฌธ ์ฒ๋ฆฌ), ๋์๋ณด๋ ๋ฐ ๋ฆฌํฌํ
๋๊ตฌ, X(๊ตฌ ํธ์ํฐ)์ ๊ฐ์ ์์
๋ฏธ๋์ด ์ค์ผ์ผ๋ง, ๊ทธ๋ฆฌ๊ณ ์ฑ๋ฅ๊ณผ ๋ณด์์ด ๋์์ ํ์ํ ๊ธ์ต ์์คํ
๋ฑ์์ ๋๋ฆฌ ํ์ฉ๋๋ค [2, 6, 7].
-
-## โ๏ธ Trade-offs & Caveats
-์ด ์ํคํ
์ฒ๋ ๋ง๊ฐํ ํ์ฅ์ฑ์ ์ ๊ณตํ์ง๋ง, ๋ค์๊ณผ ๊ฐ์ ๋๋ ทํ ํ๊ณ์ ๋ฐ๋ ๊ธ๋ถ(Trade-off)๋ฅผ ๊ฐ์ง๋ค.
-- **๋์ ์์คํ
๋ฐ ์ฝ๋ ๋ณต์ก์ฑ:**
- ์ฝ๊ธฐ์ ์ฐ๊ธฐ๋ฅผ ์ํ ๋ชจ๋ธ์ ๋ถ๋ฆฌํจ์ ๋ฐ๋ผ **์ด์ค ์ฝ๋๋ฒ ์ด์ค์ ์ด์ค ๋ฐ์ดํฐ ๋ชจ๋ธ์ ๊ด๋ฆฌํด์ผ ํ๋ฏ๋ก ๊ฐ๋ฐ, ํ
์คํธ, ๋๋ฒ๊น
์ ๋ค์ด๊ฐ๋ ๋
ธ๋ ฅ๊ณผ ๋น์ฉ์ด ํฌ๊ฒ ์ฆ๊ฐ**ํ๋ค [6].
-- **์ต์ข
์ ์ผ๊ด์ฑ(Eventual Consistency) ๊ฐ์:**
- ์ฐ๊ธฐ ๋ฐ์ดํฐ๋ฒ ์ด์ค์ ์ ์ฉ๋ ๋ณ๊ฒฝ ์ฌํญ์ด ์ฝ๊ธฐ ๋ชจ๋ธ์ ๋๊ธฐํ๋๊ธฐ๊น์ง ์ฝ๊ฐ์ ์๊ฐ ์ง์ฐ(Lag)์ด ๋ฐ์ํ๋ค [6]. ๋ฐ๋ผ์ ์ํ ์๊ณ ํ์ธ๊ณผ ๊ฐ์ด **์์คํ
์ด ์ฆ๊ฐ์ ์ด๊ณ ๊ฐ๋ ฅํ ๋ฐ์ดํฐ ์ผ๊ด์ฑ(Strong Consistency)์ ์๊ตฌํ๋ ๊ฒฝ์ฐ์๋ ์ ํฉํ์ง ์๋ค** [3].
-- **์ธํ๋ผ ๋์
์ ๊ฐ์ ์ฑ:**
- ์ฝ๊ธฐ ๋ชจ๋ธ๊ณผ ์ฐ๊ธฐ ๋ชจ๋ธ ๊ฐ์ ์ํ๋ฅผ ๋๊ธฐํํ๊ณ ์ค๋ฒํค๋๋ฅผ ์ค์ด๋ ค๋ฉด Apache Kafka์ ๊ฐ์ ๋ฉ์์ง ๋ธ๋ก์ปค ์ธํ๋ผ์ ๋์
์ด ํ์์ ์ด๋ค [6].
-- **์ค๋ฒ ์์ง๋์ด๋ง์ ์ํ:**
- ์ฝ๊ธฐ์ ์ฐ๊ธฐ์ ๋น๋๊ฐ ๋น์ทํ๊ฑฐ๋ ๋ก์ง์ด ๋จ์ํ CRUD(์์ฑยท์กฐํยท์์ ยท์ญ์ ) ๊ธฐ๋ฐ์ ์ ํ๋ฆฌ์ผ์ด์
(์: ๊ธฐ๋ณธ์ ์ธ CMS ์๋ฃจ์
)์ CQRS๋ฅผ ์ ์ฉํ๋ ๊ฒ์ ๋ถํ์ํ ๊ณผ์ ์์ง๋์ด๋ง์ด ๋๋ฏ๋ก ์ง์ํด์ผ ํ๋ค [3].
-
-## ๐ Knowledge Connections
-
-### Related Concepts
-
-#### [์ํคํ
์ฒ/๊ธฐ๋ฐ ๊ธฐ์ ]
-- [[Event Sourcing Pattern]]
- - ์ฐ๊ฒฐ ์ด์ : CQRS๋ ์ด๋ฒคํธ ์์ฑ ํจํด๊ณผ ๊ฒฐํฉ๋ ๋ ๊ฐ์ฅ ๊ฐ๋ ฅํ ์๋์ง๋ฅผ ๋ฐํํ๋ค [2, 8]. ์ด๋ฒคํธ ์์ฑ์ ํตํด ์์คํ
์ํ๋ฅผ ๋ถ๋ณ์ ์ด๋ฒคํธ ์คํธ๋ฆผ์ผ๋ก ์ ์ฅํ๊ณ , CQRS๋ ์ด๋ฅผ ์ฝ๊ธฐ์ ์ฐ๊ธฐ๋ก ๋ถ๋ฆฌํ์ฌ ์ต์ ํํ๋ค [9, 10].
- - ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ์ํ ๋ณ๊ฒฝ ๊ณผ์ ์ ๊ฐ์ฌ(Audit) ๋ชฉ์ ์ผ๋ก ์๋ฒฝํ ์ถ์ ํ๊ณ , ์ ์ฅ๋ ์ด๋ฒคํธ๋ฅผ ํ์ฉํด CQRS์ ๋ค์ํ ์ฝ๊ธฐ ๋ชจ๋ธ(Projection)์ ์์ ํ๊ฒ ๊ตฌ์ถํ๋ ๋ฉ์ปค๋์ฆ์ ๋ฐฐ์ธ ์ ์๋ค [8, 9].
-- [[Microservices Architecture]]
- - ์ฐ๊ฒฐ ์ด์ : CQRS๋ ๋ฐ์ดํฐ๋ฒ ์ด์ค๊ฐ ์๋น์ค ๋จ์๋ก ์ชผ๊ฐ์ ธ ์๋ ๋ง์ดํฌ๋ก์๋น์ค ํ๊ฒฝ์์ ์ฌ๋ฌ ์๋น์ค์ ๋ถ์ฐ๋ ๋ฐ์ดํฐ๋ฅผ ์ง๊ณํ์ฌ ์กฐํํ๋ ํต์ฌ ํจํด์ด๋ค [4, 5].
- - ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ๋
๋ฆฝ์ ์ธ ๋ฐ์ดํฐ ์คํ ๋ฆฌ์ง๋ฅผ ์ ์งํ๋ฉด์๋ ์ฌ์ฉ์์๊ฒ ํ์ํ ๋ณตํฉ์ ์ธ ์กฐํ API๋ฅผ ์๋น์ค ๊ฐ ๊ฐํ ๊ฒฐํฉ ์์ด ์ด๋ป๊ฒ ์ ๊ณตํ ์ ์๋์ง ์ดํดํ ์ ์๋ค [4].
-- [[Event-Driven Architecture]]
- - ์ฐ๊ฒฐ ์ด์ : CQRS์ ๋ ๋ชจ๋ธ(๋ช
๋ น๊ณผ ์กฐํ)์ ๋๊ธฐํํ๊ธฐ ์ํด์๋ ๋น๋๊ธฐ ์ด๋ฒคํธ ์ ๋ฌ ๋ฉ์ปค๋์ฆ์ด ํ์์ ์ด๋ค [2, 6].
- - ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ๋น๋๊ธฐ ๋ฉ์์ง ๋ฐํ๊ณผ ๊ตฌ๋
์ ํตํ ์๋น์ค ๊ฐ ๋์จํ ๊ฒฐํฉ(Loose Coupling)๊ณผ ์ด๋ฒคํธ ์ค์ฌ์ ์์คํ
ํ๋ฆ ์ ์ด๋ฅผ ์ดํดํ ์ ์๋ค [6, 11].
-
-#### [๊ตฌํ/ํ์ฉ ๋๊ตฌ]
-- [[Message Brokers (e.g., Kafka)]]
- - ์ฐ๊ฒฐ ์ด์ : ์ฐ๊ธฐ ๋ก์ง์ ๋ณ๊ฒฝ ์ด๋ฒคํธ๋ฅผ ์ฝ๊ธฐ ๋ฐ์ดํฐ๋ฒ ์ด์ค๋ก ์์ ํ๊ฒ ๋๊ธฐํํ๊ธฐ ์ํด CQRS ํจํด์์ ํ์์ ์ผ๋ก ์๊ตฌ๋๋ ๋ฏธ๋ค์จ์ด์ด๋ค [6].
- - ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ๋์ฉ๋ ๋ถ์ฐ ์์คํ
์์ ๋ฉ์์ง ๋๊ธฐ์ด(Queue)๊ณผ ์คํธ๋ฆผ์ ํตํด ์ด๋ป๊ฒ ์ต์ข
์ ์ผ๊ด์ฑ์ ๋ณด์ฅํ๊ณ ๋คํธ์ํฌ ์ค๋ฒํค๋๋ฅผ ์ ์ดํ๋์ง ํ์
ํ ์ ์๋ค [6].
-
-### Deeper Research Questions
-
-- CQRS ์์คํ
์ ํต์ฌ ํ๊ณ์ธ '์ต์ข
์ ์ผ๊ด์ฑ(Eventual Consistency)' ๋ฌธ์ ๋ก ์ธํ ์ฐ๊ธฐ์ ์ฝ๊ธฐ ๋ชจ๋ธ ๊ฐ์ ๋๊ธฐํ ์ง์ฐ ์๊ฐ(Lag)์ ์ต์ํํ๊ธฐ ์ํ ๊ตฌ์ฒด์ ์ธ ์ธํ๋ผ ํ๋ ๋ฐ ์ํคํ
์ฒ ์ ๋ต์ ๋ฌด์์ธ๊ฐ?
-- ์ด๋ฒคํธ ์์ฑ(Event Sourcing)๊ณผ CQRS๋ฅผ ๊ฒฐํฉํ์ ๋, ์ฝ๊ธฐ ๋ทฐ(Projection)๋ฅผ ์ฌ๊ตฌ์ถ(Rebuild)ํ๋ ๊ณผ์ ์์ ์๋ฐฑ๋ง ๊ฐ์ ์ด๋ฒคํธ ๋ก๊ทธ๋ฅผ ํจ์จ์ ์ผ๋ก ์ฒ๋ฆฌํ๊ธฐ ์ํ ์ค๋
์ท(Snapshot) ๊ธฐ๋ฒ์ ์๋ฆฌ์ ํ๊ณ๋ ๋ฌด์์ธ๊ฐ?
-- ์ฆ๊ฐ์ ์ธ ํธ๋์ญ์
์ผ๊ด์ฑ(Strong Consistency)์ด ์๊ตฌ๋๋ ์ํ ์์คํ
๋ฑ์์ CQRS ํจํด์ ์ผ๋ถ ์ ์ฉํ๊ณ ์ ํ ๋, ์ฑ๋ฅ ์ต์ ํ์ ๋ฐ์ดํฐ ๋ฌด๊ฒฐ์ฑ์ ๋์์ ๋ณด์ฅํ ์ ์๋ ํ์ด๋ธ๋ฆฌ๋ ์ํคํ
์ฒ ์ค๊ณ ๋ฐฉ๋ฒ์ ๋ฌด์์ธ๊ฐ?
-- ๋ชจ๋๋ฆฌ์(Monolithic) ์์คํ
์ ๋จ์ํ CRUD ๊ตฌ์กฐ์์ ์์ํ ํ๋ก์ ํธ๊ฐ CQRS ๊ธฐ๋ฐ์ ๋ง์ดํฌ๋ก์๋น์ค ์ํคํ
์ฒ๋ก ๋์ด๊ฐ์ผ ํ๋ '์ฝ๊ธฐ/์ฐ๊ธฐ ๋น๋์นญ์ฑ์ ์๊ณ์ (Threshold)'์ ์ด๋ป๊ฒ ๊ฐ๊ด์ ์ผ๋ก ํ๊ฐํ ์ ์๋๊ฐ?
-- ๋ง์ดํฌ๋ก์๋น์ค ๊ฐ ๋ถ์ฐ ์ฟผ๋ฆฌ(Distributed Query)๋ฅผ ๊ตฌํํ๊ธฐ ์ํด CQRS ๋ ํ๋ฆฌ์นด ๋ฐ์ดํฐ๋ฒ ์ด์ค๋ฅผ ํ์ฉํ ๋, ์๋ณธ ์๋น์ค์ ๋ฐ์ดํฐ ๋ณ๊ฒฝ๊ณผ ๋ณต์ ๋ฐ์ดํฐ๋ฒ ์ด์ค ๊ฐ์ ์คํค๋ง ๋ฒ์ ์ถฉ๋ ๋ฐ ๋ฐ์ดํฐ ์ ํฉ์ฑ์ ์ด๋ป๊ฒ ๊ด๋ฆฌํด์ผ ํ๋๊ฐ?
-
-### Practical Application Contexts
-
-- **Implementation:** ์ฝ๊ธฐ ๋ชจ๋ธ์ ์ํ ๋ฐ์ดํฐ๋ฒ ์ด์ค(์: NoSQL)์ ์ฐ๊ธฐ๋ฅผ ์ํ ๋ฐ์ดํฐ๋ฒ ์ด์ค(์: ๊ด๊ณํ DB)๋ฅผ ๋ฌผ๋ฆฌ์ ์ผ๋ก ๋ถ๋ฆฌํ์ฌ ์ฝ๋ฉํ๊ณ , Message Broker๋ฅผ ๋์
ํ์ฌ ๋ ์ ์ฅ์ ๊ฐ์ ์ํ ๋๊ธฐํ ํ์ดํ๋ผ์ธ์ ๊ตฌ์ถํด์ผ ํ๋ค [3, 6].
-- **System Design:** ์ฌ์ฉ์์ ์ฝ๊ธฐ ์์ฒญ ๋น๋๊ฐ ์ฐ๊ธฐ ์์ฒญ์ ๋นํด 10๋ฐฐ ์ด์ ์๋์ ์ผ๋ก ๋์ ์์คํ
(์: ๋ฐ์ดํฐ ๋ถ์ ๋์๋ณด๋, ๋ณต์กํ ์ ํ ์นดํ๋ก๊ทธ ๋ฑ)์ ์ค๊ณํ ๋ ์ฑ๋ฅ ๋ณ๋ชฉ์ ์ ๊ฑฐํ ๋ชฉ์ ์ผ๋ก ์ฑํํ๋ค [2]. ๋จ์ํ ๊ฒ์ํ ๊ฐ์ ์์คํ
์ค๊ณ ์์๋ ๋ฐฐ์ ํด์ผ ํ๋ค [3].
-- **Operation / Maintenance:** ๋ ๊ฐ์ง ์์ ํ ๋ค๋ฅธ ๋ฐ์ดํฐ ๋ชจ๋ธ ๋ฐ ๋๊ธฐํ ์ธํ๋ผ๋ฅผ ์ด์ํด์ผ ํ๋ฏ๋ก, ์ฝ๊ธฐ ๋ชจ๋ธ๊ณผ ์ฐ๊ธฐ ๋ชจ๋ธ ์ฌ์ด์ ๋๊ธฐํ ์ง์ฐ์ด๋ ๋ฉ์์ง ์ ์ค์ ๋ชจ๋ํฐ๋งํ๊ณ ์ถ์ ํ ์ ์๋ ์ ๊ตํ ๋ถ์ฐ ์ถ์ (Distributed Tracing) ๋ฐ ๋ก๊น
์ฒด๊ณ๋ฅผ ์ ์ง๋ณด์ ํ๋ก์ธ์ค์ ํ์์ ์ผ๋ก ํฌํจ์์ผ์ผ ํ๋ค [6, 11].
-- **Learning Path:** ๋จ์ํ CRUD ๊ธฐ๋ฐ์ ๋จ์ผ ๋ฐ์ดํฐ๋ฒ ์ด์ค(N-Tier Layered Architecture) ์ค๊ณ๋ฅผ ๋จผ์ ๋ง์คํฐํ ํ, ๋ง์ดํฌ๋ก์๋น์ค๋ก ์์คํ
์ด ๋ถํ ๋๋ฉด์ ๋ฐ์ํ๋ ๋ถ์ฐ ๋ฐ์ดํฐ ์กฐํ(Distributed Query)์ ํ๊ณ๋ฅผ ์ฒด๊ฐํ ๋ ํ์ตํ๋ ๊ฒ์ด ์ด์์ ์ธ ์ง์ ํ์ฅ ๊ฒฝ๋ก์ด๋ค [3, 4].
-- **My Project Relevance:** ๊ธฐํ ์ค์ธ ์๋น์ค๊ฐ ๋๊ท๋ชจ ๋ฐ์ดํฐ๋ฅผ ์ฒ๋ฆฌํ๊ฑฐ๋, ๋ณต์กํ ๋ทฐ(View) ๋ ๋๋ง์ ๋ณ๋ชฉ์ด ์์ธก๋๋ ์ํฉ์ด๋ผ๋ฉด ๋ณธ ํจํด์ ์ ๊ทน์ ์ผ๋ก ๊ฒํ ํ๋, ์ด์ ์ธ๋ ฅ๊ณผ ์ธํ๋ผ ์์ฐ(๋ฉ์์ง ๋ธ๋ก์ปค ์ ์ง ๋ฑ)์ด ๋ท๋ฐ์นจ๋๋์ง๋ฅผ ์ต์ฐ์ ์ผ๋ก ์ ๊ฒํ๋ ๊ธฐ์ค์ผ๋ก ํ์ฉํ๋ค [3, 6].
-
-### Adjacent Topics
-
-- [[Saga Pattern]]
- - ํ์ฅ ๋ฐฉํฅ: ๋ง์ดํฌ๋ก์๋น์ค ํ๊ฒฝ์์ CQRS๊ฐ ๋ฐ์ดํฐ ์กฐํ์ ๋ฌธ์ ๋ฅผ ํด๊ฒฐํ๋ค๋ฉด, Saga ํจํด์ ์ฌ๋ฌ ์๋น์ค์ ๊ฑธ์น ๋ถ์ฐ ์ฐ๊ธฐ(Command) ํธ๋์ญ์
์ ์ ํฉ์ฑ์ ๋ณด์ฅ(๋ณด์ ํธ๋์ญ์
๋ฑ)ํ๋ ์ญํ ์ ๋ด๋นํ๋ฏ๋ก, ๋ ํจํด์ ๊ฒฐํฉํ์ฌ ์๋ฒฝํ ๋ถ์ฐ ๋ฐ์ดํฐ ์ฒ๋ฆฌ ์ํคํ
์ฒ๋ฅผ ๊ทธ๋ฆฌ๋ ๋ฐฉํฅ์ผ๋ก ํ์ฅํ ์ ์๋ค [4, 12].
-
----
-*Last updated: 2026-05-02*
\ No newline at end of file
diff --git a/10_Wiki/Topics/02_Architecture_Principles/Component_Design_Patterns.md b/10_Wiki/Topics/02_Architecture_Principles/Component_Design_Patterns.md
deleted file mode 100644
index cf1244a7..00000000
--- a/10_Wiki/Topics/02_Architecture_Principles/Component_Design_Patterns.md
+++ /dev/null
@@ -1,28 +0,0 @@
----
-title: ์ปดํฌ๋ํธ ์ค๊ณ ํจํด (Atomic & Composition)
-category: Software [[Architecture|Architecture]]
-tags: [Design Pattern, [[Atomic Design|Atomic Design]], Composition, Architecture]
-created: 2026-04-20
----
-
-# [[Component_Design_Patterns|Component_Design_Patterns]] (์ปดํฌ๋ํธ ์ค๊ณ ํจํด)
-
-## ๐ ํ ์ค ํต์ฐฐ (The Karpathy Summary)
-> ์ปดํฌ๋ํธ๋ ์์์๋ก ๊ฐํ๊ณ , ๋จ์ํ ์๋ก ์ฌ์ฌ์ฉ์ฑ์ด ๊ทน๋ํ๋๋ค. ๋ณต์กํ ์ปดํฌ๋ํธ๋ ์ฌ๋ฌ ๊ฐ์ ์๊ณ ์์ํ(Pure) ์ปดํฌ๋ํธ๋ก ํด์ฒดํ๋ผ.
-
-## ๐ ๊ตฌ์กฐํ๋ ์ง์ (Synthesized Content)
-- **Container-Presenter ํจํด**:
- - **Container**: ๋ฐ์ดํฐ([[State|State]], API)๋ฅผ ๊ฐ์ ธ์ค๊ณ ๊ด๋ฆฌํ๋ '๋จธ๋ฆฌ'.
- - **Presenter**: ์ค์ง Props๋ง ๋ฐ์ ํ๋ฉด์ ๊ทธ๋ฆฌ๋ '๋ชธํต'. ์คํ์ผ๊ณผ UI ๊ตฌ์กฐ์๋ง ์ง์คํ์ฌ ํ
์คํธ ๊ฐ๋ฅ์ฑ์ ๋์ธ๋ค.
-- **[[Compound Components|Compound Components]] (๋ณตํฉ ์ปดํฌ๋ํธ)**:
- - `` ์ฒ๋ผ ๋ถ๋ชจ์ ์์์ด ์ํ๋ฅผ ๊ณต์ ํ๋ฉฐ ํ๋์ ๊ธด๋ฐํ ๊ธฐ๋ฅ์ ์ํํ๋ ํจํด. ์ฌ์ฉ์๊ฐ UI ๊ตฌ์กฐ๋ฅผ ์์ ๋กญ๊ฒ ๋ฐฐ์นํ ์ ์๊ฒ ์ ์ฐ์ฑ์ ์ ๊ณตํ๋ค.
-- **Atomic Design (์์ ์ค์ฌ ์ค๊ณ)**:
- - Atom(๋ฒํผ, ์
๋ ฅ์ฐฝ) $\rightarrow$ Molecule(๊ฒ์๋ฐ) $\rightarrow$ Organism(ํค๋) $\rightarrow$ Template $\rightarrow$ Page.
- - ๊ฐ์ฅ ํ์์ Atom์ด ํ๋ก์ ํธ ์ ๋ฐ์์ ๋์ผํ ๋์์ธ ์ธ์ด์ธ '๋์์ธ ํ ํฐ'์ ๋ฐ์ํ๊ฒ ํ๋ค.
-
-## โ ๏ธ ๋ชจ์ ๋ฐ ์
๋ฐ์ดํธ (RL Update)
-- ๋๋ฌด ๊ณผ๋ํ ์ปดํฌ๋ํธ ๋ถํ ์ ํ๋กํ ํ์ดํ ์๋๋ฅผ ๋ฆ์ถ๋ค. ์ฒ์์๋ ํฌ๊ฒ ์ง๊ณ , ์ค๋ณต์ด ๋ฐ์ํ๊ฑฐ๋ ๋ณต์ก๋๊ฐ ๋์์ง ๋ '์ฌํ์ ๋ฆฌํฉํ ๋ง'์ ํตํด ๋ถ๋ฆฌํ๋ ๊ฒ์ด ์ค๋ฌด์ ์ผ๋ก ํ๋ช
ํ๋ค.
-
-## ๐ ์ง์ ์ฐ๊ฒฐ (Graph)
-- Related: Project_Architecture_Guidelines , [[Styling_Governance|Styling_Governance]]
-- Design: [[Accessibility_Inclusivity|Accessibility_Inclusivity]]
diff --git a/10_Wiki/Topics/02_Architecture_Principles/Domain-Driven Design (DDD).md b/10_Wiki/Topics/02_Architecture_Principles/Domain-Driven Design (DDD).md
deleted file mode 100644
index 8c57b818..00000000
--- a/10_Wiki/Topics/02_Architecture_Principles/Domain-Driven Design (DDD).md
+++ /dev/null
@@ -1,67 +0,0 @@
----
-id: P-REINFORCE-WIKI-E5D26B38
-category: "10_Wiki/๐ก Topics/02_Architecture_Principles"
-confidence_score: 0.95
-tags: ['domain-driven-design-(ddd)', 'microservices-architecture', 'hexagonal-architecture', 'modular-monolith', 'event-sourcing-pattern', 'architecture-principles']
-last_reinforced: 2026-05-02
----
-
-# [[Domain-Driven Design (DDD)]]
-
-## ๐ Brief Summary
-**๋๋ฉ์ธ ์ฃผ๋ ์ค๊ณ(DDD)**๋ ๋น์ฆ๋์ค ์ญ๋๊ณผ ๋๋ฉ์ธ ๊ฒฝ๊ณ๋ฅผ ์ค์ฌ์ผ๋ก ์ํํธ์จ์ด์ ๊ตฌ์ฑ๊ณผ ์ฑ
์์ ์๋ณํ๋๋ก ๋๋ ์ค๊ณ ์์น ๋ฐ ๊ดํ์ด๋ค [1, 2]. ์ฃผ๋ก ๋ง์ดํฌ๋ก์๋น์ค ์ํคํ
์ฒ(MSA), ํฅ์ฌ๊ณ ๋ ์ํคํ
์ฒ, ๋ชจ๋ํ ๋ชจ๋๋ฆฌ์ค ๋ฑ๊ณผ ๊ฒฐํฉํ์ฌ ๋น์ฆ๋์ค ๋ก์ง์ ๊ฒฝ๊ณ๋ฅผ ๋ช
ํํ ํ๊ณ ์์คํ
์ ๋ชจ๋์ฑ์ ๋์ด๋ ๋ฐ ํ์ฉ๋๋ค [3, 4]. ์ ์ฒด์ ์ธ ์๋ฆฌ์ ๋ํด ์์ค์ ๊ด๋ จ ์ ๋ณด๊ฐ ๋ถ์กฑํ์ง๋ง, ์ฃผ๋ก ๋ณต์กํ ์์คํ
์ ์ฑ
์ ๋ถ๋ฆฌ ๊ธฐ์ค์ผ๋ก ์์ฉํ๋ค [1].
-
-## ๐ Core Content
-๋๋ฉ์ธ ์ฃผ๋ ์ค๊ณ(DDD)์ ๋ํ ๊ตฌ์ฒด์ ์ธ ๋ฐฉ๋ฒ๋ก ์ด๋ ์ ์ฒด ๊ตฌ์ฑ ์์์ ๋ํ ์์ธ ์ค๋ช
์ **์์ค์ ๊ด๋ จ ์ ๋ณด๊ฐ ๋ถ์กฑํฉ๋๋ค.** ์ ๊ณต๋ ์์ค์์ ํ์ธ ๊ฐ๋ฅํ DDD์ ํต์ฌ ์ญํ ๊ณผ ํน์ง์ ๋ค์๊ณผ ๊ฐ์ต๋๋ค:
-
-* **๋๋ฉ์ธ ๊ฒฝ๊ณ ์๋ณ๊ณผ ๋จ์ผ ์ฑ
์:** DDD๋ ์์คํ
๋ด์์ ๊ฐ ์๋น์ค๊ฐ ๋จ์ผ ์ฑ
์์ ๊ฐ๋๋ก **๋๋ฉ์ธ ๊ฒฝ๊ณ(Domain boundaries)๋ฅผ ์๋ณ**ํ๋ ๊ฐ์ด๋๋ผ์ธ ์ญํ ์ ํฉ๋๋ค [1].
-* **๋น์ฆ๋์ค ์ํฐํฐ ์ ์:** DDD๋ ๋น์ฆ๋์ค ๋ก์ง์ ๊ตฌํํ ๋, ๋น์ฆ๋์ค ๊ท์น์ ์คํํ๋ **๋น์ฆ๋์ค ์ํฐํฐ(DDD ์ ๊ทธ๋ฆฌ๊ฑฐํธ, aggregates)**๋ฅผ ๊ธฐ๋ฐ์ผ๋ก ๊ตฌ์ฑํฉ๋๋ค [5].
-* **์ํคํ
์ฒ ํจํด๊ณผ์ ๋์ ํธํ์ฑ:**
- * **๋ง์ดํฌ๋ก์๋น์ค ์ํคํ
์ฒ(MSA):** ๋ง์ดํฌ๋ก์๋น์ค๋ ๋น์ฆ๋์ค ์ญ๋์ ์ค์ฌ์ผ๋ก ์กฐ์ง๋์ด์ผ ํ๋ฉฐ, ์ด๋ DDD ์์น๊ณผ ๋งฅ์ ๊ฐ์ด ํฉ๋๋ค [2].
- * **ํฅ์ฌ๊ณ ๋ ์ํคํ
์ฒ(Hexagonal Architecture):** ๋ช
ํํ ์์คํ
๊ฒฝ๊ณ๋ฅผ ์ด์งํ๋ฉฐ DDD ์์น๊ณผ ๋งค์ฐ ์ ๋ถํฉํฉ๋๋ค [3].
- * **๋ชจ๋ํ ๋ชจ๋๋ฆฌ์ค(Modular Monolith):** ๋คํธ์ํฌ๋ฅผ ํตํด ๋ถ์ฐ๋ ์๋น์ค๋ฅผ ๊ตฌ์ถํ์ง ์๋๋ผ๋, ๋จ์ผ ์ ํ๋ฆฌ์ผ์ด์
๋ด์์ DDD ์์น์ ๊น๋ํ๊ฒ ์ ์ฉํ์ฌ ๋น์ฆ๋์ค ๋ก์ง์ ๊ฒฝ๊ณ๋ฅผ ๊ฐ์ ํ ์ ์์ต๋๋ค [4].
-
-## โ๏ธ Trade-offs & Caveats
-* **๋์ ์ ๋ฌธ์ฑ ์๊ตฌ:** DDD๋ ์์คํ
์ค๊ณ์ ์์ด ๋์ ์์ค์ ์ ๋ฌธ์ฑ์ ์๊ตฌํฉ๋๋ค. **DDD ์ ๋ฌธ์ฑ์ด ๋ถ์กฑํ ํ์ ๊ฒฝ์ฐ, ์ด๋ฒคํธ ์์ฑ(Event Sourcing)๊ณผ ๊ฐ์ ๋ณต์กํ ์ํคํ
์ฒ ํจํด์ ๋์
์ ํผํด์ผ ํฉ๋๋ค** [6].
-* **๊ฐํ๋ฅธ ํ์ต ๊ณก์ (Learning Curve):** DDD๋ ํด๋ฆฐ ์ํคํ
์ฒ(Clean Architecture) ๋ฑ์ ๊ตฌํํ ๋ **์๊ท๋ชจ ํ์ด๋ ์ด๋ณด ํ์ด ๋ค๋ฃจ๊ธฐ์๋ ํ์ต ๊ณก์ ์ด ๊ฐํ๋ผ ์ด๋ ค์์ ๊ฒช์ ์ ์๋ ์ ์ฝ**์ด ์์ต๋๋ค [7].
-* *(๊ทธ ์ธ ๊ตฌ์ฒด์ ์ธ ์ต์ ํ ๋ถ์์ฉ์ด๋ ์ถ๊ฐ์ ์ธ ๊ธฐ์ ์ ์ ์ฝ ์ฌํญ์ ์์ค์ ๊ด๋ จ ์ ๋ณด๊ฐ ๋ถ์กฑํฉ๋๋ค.)*
-
-## ๐ Knowledge Connections
-
-### Related Concepts
-
-#### [๊ด๊ณ ์ ํ A: ์ํคํ
์ฒ/๊ธฐ๋ฐ ๊ธฐ์ ]
-* [[Microservices Architecture]]
- * ์ฐ๊ฒฐ ์ด์ : ๋ง์ดํฌ๋ก์๋น์ค ์ํคํ
์ฒ์์ ์๋น์ค๋ฅผ ๋ถํ ํ ๋ ๋น์ฆ๋์ค ์ญ๋์ ์ค์ฌ์ผ๋ก ์กฐ์งํ๊ฒ ๋๋ฉฐ, ์ด ๊ณผ์ ์์ ๋จ์ผ ์ฑ
์์ ๋ช
ํํ ํ๊ธฐ ์ํด DDD์ ๋๋ฉ์ธ ๊ฒฝ๊ณ ์๋ณ ๊ฐ๋
์ด ํ์๋ก ์ฌ์ฉ๋จ [1, 2].
- * ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ์ด๋ก ์ ์ธ ๋๋ฉ์ธ ๊ฒฝ๊ณ๊ฐ ์ค์ ๋
๋ฆฝ์ ์ผ๋ก ๋ฐฐํฌ ๊ฐ๋ฅํ ๋ถ์ฐ ์๋น์ค ๋จ์๋ก ์ด๋ป๊ฒ ๋งคํ๋๋์ง ํ์
ํ ์ ์์.
-* [[Hexagonal Architecture]]
- * ์ฐ๊ฒฐ ์ด์ : ๋น์ฆ๋์ค ๋ก์ง์ ์ธ๋ถ ๊ธฐ์ ๊ณผ ๊ฒฉ๋ฆฌํ๊ณ ๋์จํ ๊ฒฐํฉ์ ๋ง๋๋ ํฅ์ฌ๊ณ ๋ ์ํคํ
์ฒ์ ์ฒ ํ์ด ๋ช
ํํ ๊ฒฝ๊ณ๋ฅผ ์งํฅํ๋ DDD ์์น๊ณผ ๊ตฌ์กฐ์ ์ผ๋ก ์ ๋ถํฉํจ [3].
- * ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: DDD๋ก ์ค๊ณ๋ ๋น์ฆ๋์ค ํต์ฌ ๋ก์ง์ ์ธ๋ถ ํฌํธ์ ์ด๋ํฐ๋ก๋ถํฐ ์ด๋ป๊ฒ ์์ ํ๊ฒ ๋ณดํธํ ์ ์๋์ง ์ดํดํ ์ ์์.
-* [[Modular Monolith]]
- * ์ฐ๊ฒฐ ์ด์ : ์๋น์ค๋ฅผ ๋คํธ์ํฌ ๋จ์๋ก ๋ถํ ํ์ง ์๊ณ ๋, ๋ชจ๋ํ ๋ชจ๋๋ฆฌ์ค ๋ด์์ DDD ์์น์ ํ์ฉํ์ฌ ๋ชจ๋ ๊ฐ์ ๋น์ฆ๋์ค ๋ก์ง ๊ฒฝ๊ณ๋ฅผ ์๊ฒฉํ๊ฒ ์ ์งํ ์ ์์ [4].
- * ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ๋ถ์ฐ ์์คํ
์ ๋ณต์ก์ฑ ์์ด ๋จ์ผ ์ฝ๋๋ฒ ์ด์ค์์ ๋๋ฉ์ธ ์ฃผ๋ ์ค๊ณ์ ์ด์ ์ ๋๋ฆฌ๋ ๋ฐฉ๋ฒ์ ๋ฐฐ์ธ ์ ์์.
-
-### Deeper Research Questions
-* DDD์ ํต์ฌ ๊ตฌ์ฑ ์์์ธ 'DDD ์ ๊ทธ๋ฆฌ๊ฑฐํธ(Aggregates)'๋ ์์คํ
์ ๋น์ฆ๋์ค ๊ท์น๊ณผ ๋ฐ์ดํฐ์ ์ผ๊ด์ฑ์ ์ด๋ป๊ฒ ์บก์ํํ๊ณ ๊ด๋ฆฌํ๋๊ฐ?
-* ์ด๋ฒคํธ ์์ฑ(Event Sourcing) ํจํด์ ๊ตฌํํ ๋, DDD ์ ๋ฌธ์ฑ์ด ํ ๋ด์ ๋ฐ๋์ ์๊ตฌ๋๋ ์ํคํ
์ฒ์ ๋ฐ ๋
ผ๋ฆฌ์ ์ด์ ๋ ๋ฌด์์ธ๊ฐ?
-* ๋ง์ดํฌ๋ก์๋น์ค ์ํคํ
์ฒ์์ ์๋น์ค๊ฐ ๋๋ฌด ์ธ๋ฐํด์ง๊ฑฐ๋ ๋ฐฉ๋ํด์ง๋ ๊ฒ์ ๋ง๊ธฐ ์ํด DDD์ ๋๋ฉ์ธ ๊ฒฝ๊ณ ์๋ณ ์์น์ ์ด๋ป๊ฒ ์ ๋์ /์ ์ฑ์ ์ผ๋ก ์ ์ฉํ ์ ์๋๊ฐ?
-* ๋ชจ๋ํ ๋ชจ๋๋ฆฌ์ค ๊ตฌ์กฐ์์ ๋คํธ์ํฌ ๋ถ๋ฆฌ ์์ด DDD ์์น์ผ๋ก ๋น์ฆ๋์ค ๋ก์ง์ ๊ฒฝ๊ณ๋ฅผ ๊ฐ์ ํ ๋, ๊ธฐ์ ์ ์์กด์ฑ ๋์๋ฅผ ๋ง๊ธฐ ์ํ ๊ตฌ์ฒด์ ์ธ ๋ฐฉ๋ฒ์ ๋ฌด์์ธ๊ฐ?
-* ๊ฐํ๋ฅธ ํ์ต ๊ณก์ ์ ๊ฐ์ง DDD๋ฅผ ํด๋ฆฐ ์ํคํ
์ฒ๋ MSA ํ๊ฒฝ์ ์ ์ ๊ฐ๋ฐ ํ์ ๋์
ํ ๋, ๋น์ฉ ๋๋น ํจ๊ณผ๋ฅผ ๊ทน๋ํํ ์ ์๋ ์ ์ง์ ๋์
์ ๋ต์ ๋ฌด์์ธ๊ฐ?
-
-### Practical Application Contexts
-
-* **Implementation:** ๋น์ฆ๋์ค ๊ท์น๊ณผ ํต์ฌ ๋ก์ง์ ์บก์ํํ๊ธฐ ์ํด ์ฝ๋ ๋ ๋ฒจ์์ 'DDD ์ ๊ทธ๋ฆฌ๊ฑฐํธ(aggregates)'์ ๊ฐ์ ๋น์ฆ๋์ค ์ํฐํฐ๋ฅผ ๊ตฌํํ๋ ๋ฐ ์ ์ฉ๋จ [5].
-* **System Design:** ๋ณต์กํ ์์คํ
์ MSA๋ ๋ชจ๋ํ ๋ชจ๋๋ฆฌ์ค๋ก ์ค๊ณํ ๋, ์๋น์ค ๊ฐ ํต์ ๊ณผ ๋
๋ฆฝ์ฑ์ ๋ณด์ฅํ๊ธฐ ์ํด ๋น์ฆ๋์ค ์ญ๋ ์ค์ฌ์ผ๋ก ๋๋ฉ์ธ ๊ฒฝ๊ณ๋ฅผ ์ ์ํ๋ ๋ฐ ํ์ฉ๋จ [1, 2, 4].
-* **Operation / Maintenance:** (์ด์ ๋ฐ ์ ์ง๋ณด์์ DDD๊ฐ ์ง์ ์ ์ผ๋ก ๋ฏธ์น๋ ์ธ๋ถ ์ง์นจ์ ์์ค์ ๊ด๋ จ ์ ๋ณด๊ฐ ๋ถ์กฑํฉ๋๋ค.)
-* **Learning Path:** ํด๋ฆฐ ์ํคํ
์ฒ๋ ์ด๋ฒคํธ ์์ฑ ํจํด์ ์ค๋ฌด์ ๋์
ํ๊ธฐ ์ , ํ์๋ค์ด ํ์์ ์ผ๋ก ๊ฑฐ์ณ์ผ ํ ํ์ต ๊ณผ์ ์ผ๋ก DDD์ ๊ฐ๋
๋ฐ ๋๋ฉ์ธ ๋ชจ๋ธ๋ง ์์ง๊ฐ ํ์ํจ [6, 7].
-* **My Project Relevance:** ๋ณต์กํ ๋น์ฆ๋์ค ์๊ตฌ์ฌํญ์ ๊ฐ์ง ํ๋ก์ ํธ์ ์ํคํ
์ฒ๋ฅผ ๊ฒฐ์ ํ ๋, ๊ฐ๋ฐ ํ์ ์๋ จ๋(DDD ์ดํด๋)๋ฅผ ๋จผ์ ํ๊ฐํ์ฌ ๋ชจ๋๋ฆฌ์์ผ๋ก ์์ํ ์ง ๋ถ์ฐ ์ํคํ
์ฒ๋ก ์งํํ ์ง ๊ฒฐ์ ํ๋ ๊ธฐ์ค์ผ๋ก ์ผ์ ์ ์์.
-
-### Adjacent Topics
-
-* [[Event Sourcing Pattern]]
- * ํ์ฅ ๋ฐฉํฅ: ๋ฐ์ดํฐ๋ฅผ ํ์ฌ ์ํ๊ฐ ์๋ ์ด๋ฒคํธ์ ์ฐ์๋ ์คํธ๋ฆผ์ผ๋ก ์ ์ฅํ๋ ๊ธฐ๋ฒ์ผ๋ก, DDD ์ ๋ฌธ์ฑ์ด ์๊ตฌ๋๋ ๋งํผ ๋ ํจํด ๊ฐ์ ๋ฐ์ดํฐ ์ผ๊ด์ฑ ๋ฐ ์ถ์ ๋งค์ปค๋์ฆ ์๋์ง ์กฐ์ฌ.
-* [[Clean Architecture]]
- * ํ์ฅ ๋ฐฉํฅ: ๋น์ฆ๋์ค ๋ก์ง์ ์ค์์ ๋๊ณ ์์กด์ฑ์ ์ญ์ ์ํค๋ ์ํคํ
์ฒ๋ก, ์ด๋ณด ํ์ด DDD์ ๊ฒฐํฉ ์ ๊ฒช๋ ํ์ต ํ๊ณ์ ์ด๋ฅผ ํด๊ฒฐํ๋ ์ค๋ฌด์ ์ฝ๋ ๊ตฌ์ฑ ๋ฐฉ๋ฒ ํ๊ตฌ.
-
----
-*Last updated: 2026-05-02*
\ No newline at end of file
diff --git a/10_Wiki/Topics/02_Architecture_Principles/Index.md b/10_Wiki/Topics/02_Architecture_Principles/Index.md
deleted file mode 100644
index cfe82790..00000000
--- a/10_Wiki/Topics/02_Architecture_Principles/Index.md
+++ /dev/null
@@ -1,8 +0,0 @@
-# Index: Topics > 02_Architecture_Principles
-
-## ๐ Documents
-- [[API_Communication_Patterns|API_Communication_Patterns]]
-- [[Component_Design_Patterns|Component_Design_Patterns]]
-- [[Separation_of_Concerns|Separation_of_Concerns]]
-- [[Single_Source_of_Truth|Single_Source_of_Truth]]
-- [[Systemic_Simulation_Principles|Systemic_Simulation_Principles]]
diff --git a/10_Wiki/Topics/02_Architecture_Principles/MVC (Model-View-Controller).md b/10_Wiki/Topics/02_Architecture_Principles/MVC (Model-View-Controller).md
deleted file mode 100644
index 33bbd1f7..00000000
--- a/10_Wiki/Topics/02_Architecture_Principles/MVC (Model-View-Controller).md
+++ /dev/null
@@ -1,37 +0,0 @@
----
-id: P-REINFORCE-AUTO-WIKI-ARCH-005
-category: "10_Wiki/๐ก Topics/02_Architecture_Principles"
-confidence_score: 0.95
-tags: [architecture, design-pattern, mvc, decoupling, ui-architecture, p-reinforce]
-last_reinforced: 2026-05-01
----
-
-# [[MVC (Model-View-Controller)|MVC (Model-View-Controller]]
-
-## ๐ ํ ์ค ํต์ฐฐ (The Karpathy Summary)
-> "๋ฐ์ดํฐ(Model), ์ฌ์ฉ์ ์ธํฐํ์ด์ค(View), ๋ก์ง ์ ์ด(Controller)๋ฅผ ๋ถ๋ฆฌํ์ฌ ์์คํ
์ ๊ด์ฌ์ฌ๋ฅผ ๊ฒฉ๋ฆฌํจ์ผ๋ก์จ, UI์ ๋ณํ๊ฐ ๋ฐ์ดํฐ ๊ตฌ์กฐ์ ์ํฅ์ ์ฃผ์ง ์๋๋ก ์ค๊ณํ๋ ๊ณ ์ ์ ์ด๊ณ ๊ฐ๋ ฅํ ๊ด์ฌ์ฌ ๋ถ๋ฆฌ(SoC) ํจํด."
-
-## ๐ ๊ตฌ์กฐํ๋ ์ง์ (Synthesized Content)
-MVC๋ ์ ํ๋ฆฌ์ผ์ด์
์ ๊ตฌ์กฐ์ ๋ฌด๊ฒฐ์ฑ์ ์ ์งํ๊ธฐ ์ํ ๊ฐ์ฅ ๋๋ฆฌ ์๋ ค์ง ๋์์ธ ํจํด์
๋๋ค.
-
-1. **๊ตฌ์ฑ ์์์ ์ญํ **:
- * **Model**: ์ ํ๋ฆฌ์ผ์ด์
์ ๋ฐ์ดํฐ์ ๋น์ฆ๋์ค ๋ก์ง์ ๋ด๋นํฉ๋๋ค. ๋ฐ์ดํฐ๋ฒ ์ด์ค์์ ์ํธ์์ฉ ๋ฐ ์ํ ๋ณํ๋ฅผ ๊ด๋ฆฌํฉ๋๋ค.
- * **View**: ์ฌ์ฉ์์๊ฒ ์ ๋ณด๋ฅผ ํ์ํ๋ ์ธํฐํ์ด์ค ๋ ์ด์ด์
๋๋ค. ๋ชจ๋ธ์ ๋ฐ์ดํฐ๋ฅผ ์๊ฐ์ ์ผ๋ก ํํํ๋ฉฐ ๋ก์ง์ ํฌํจํ์ง ์์ต๋๋ค.
- * **Controller**: ์ฌ์ฉ์์ ์
๋ ฅ์ ๋ฐ์ ๋ชจ๋ธ์ ์
๋ฐ์ดํธํ๊ฑฐ๋ ๋ทฐ๋ฅผ ์ ํํ๋ ์ ์ด ํ๋ฆ์ ๋ด๋นํฉ๋๋ค. ๋ชจ๋ธ๊ณผ ๋ทฐ ์ฌ์ด์ ์ค์ฌ์ ์ญํ ์ ์ํํฉ๋๋ค.
-2. **๊ด์ฌ์ฌ ๋ถ๋ฆฌ (Separation of Concerns)**:
- * ๊ฐ ๊ตฌ์ฑ ์์๊ฐ ๋
๋ฆฝ์ ์ผ๋ก ๊ฐ๋ฐ ๋ฐ ํ
์คํธ๋ ์ ์๋๋ก ๊ฒฉ๋ฆฌํฉ๋๋ค.
- * ์ฝ๋ ๋ฆฌ๋ทฐ ์, ๋ทฐ์ ๋น์ฆ๋์ค ๋ก์ง์ด ํฌํจ๋์ด ์๊ฑฐ๋ ๋ชจ๋ธ์ด UI ์์๋ฅผ ์ง์ ์ฐธ์กฐํ๋์ง ๋ฑ์ ๊ฒํ ํ์ฌ ํจํด์ ๋ฌด๊ฒฐ์ฑ์ ํ์ธํฉ๋๋ค.
-3. **์์คํ
ํ์ฅ์ฑ**:
- * ์ผ๊ด๋ ๊ตฌ์กฐ๋ฅผ ์ ์งํจ์ผ๋ก์จ ์ฅ๊ธฐ์ ์ธ ์ ์ง๋ณด์ ๋น์ฉ์ ๋ฎ์ถ๊ณ , ์๋ก์ด ๊ธฐ๋ฅ์ ์ถ๊ฐํ ๋ ์์คํ
์ ์ฒด์ ๋ณต์ก์ฑ์ ์ ์ดํฉ๋๋ค.
-
-## โ ๏ธ ๋ชจ์ ๋ฐ ์
๋ฐ์ดํธ (Contradictions & RL Update)
-- **๋น๋ํ ์ปจํธ๋กค๋ฌ (Fat Controller)**: ๋ก์ง์ด ์ปจํธ๋กค๋ฌ์ ์ง์ค๋์ด ์ฝ๋๊ฐ ๋น๋ํด์ง๋ ํ์์ด ์์ฃผ ๋ฐ์ํฉ๋๋ค. ์ด๋ฅผ ๋ฐฉ์งํ๊ธฐ ์ํด ์๋น์ค ๋ ์ด์ด(Service Layer)๋ฅผ ์ถ๊ฐ๋ก ๋์
ํ์ฌ ๋น์ฆ๋์ค ๋ก์ง์ ๋ชจ๋ธ์ด๋ ์๋น์ค๋ก ๋ถ์ฐ์ํค๋ ์ ๋ต์ด ํ์ํฉ๋๋ค.
-- **ํ๋์ ๋ณํ**: ์น ํ๋ ์์ํฌ์ ๋ฐ์ ์ ๋ฐ๋ผ MVP, MVVM ๋ฑ ๋ค์ํ ๋ณํ ํจํด์ด ๋ฑ์ฅํ์์ผ๋, ๊ด์ฌ์ฌ ๋ถ๋ฆฌ๋ผ๋ ํต์ฌ ์ฒ ํ์ MVC์์ ๊ณ์น๋์์ต๋๋ค.
-
-## ๐ ์ง์ ์ฐ๊ฒฐ (Graph)
-- Design Patterns: ์ํคํ
์ฒ ํจํด์ ๋ฒ์ฃผ.
-- [[Clean Architecture|Clean Architecture]]: MVC๋ฅผ ๋ณด๋ค ๊ณ ๋ํํ ๊ณ์ธตํ ๊ตฌ์กฐ.
-- [[SOLID Principles|SOLID Principles]]: ๊ฐ ๊ณ์ธต์ ๋จ์ผ ์ฑ
์์ ์ ์ํ๋ ์์น.
-- [[แแ
ชแซแแ
ตแทแแ
กแแ
ด แแ
ฎแซแ
แ
ต (Separation of Concerns SoC)|Separation of Concerns (SoC]]: ํจํด์ ๊ทผ๋ณธ์ ์ธ ์ค๊ณ ์ฒ ํ.
-- Code Health: ์ผ๊ด๋ ํจํด ์ค์๊ฐ ๊ฐ์ ธ์ค๋ ์์คํ
์ ๊ฑด๊ฐ์ฑ.
----
diff --git a/10_Wiki/Topics/02_Architecture_Principles/Separation_of_Concerns.md b/10_Wiki/Topics/02_Architecture_Principles/Separation_of_Concerns.md
deleted file mode 100644
index 671f641e..00000000
--- a/10_Wiki/Topics/02_Architecture_Principles/Separation_of_Concerns.md
+++ /dev/null
@@ -1,25 +0,0 @@
----
-title: ์์คํ
์ํคํ
์ฒ์ ๊ด์ฌ์ฌ ๋ถ๋ฆฌ ([[_แแ
ฌแแ
ช แแ
กแฏแแ
กแ
แ
ตแแ
ด แแ
ฎแซแ
แ
ต_ - แแ
ชแซแแ
ตแทแแ
กแแ
ด แแ
ฎแซแ
แ
ต (Separation of Concerns)|Separation of Concerns]])
-category: Software [[Architecture|Architecture]]
-tags: [Architecture, SoC, Modular Design, Design Pattern]
-created: 2026-04-20
----
-
-# ์์คํ
์ํคํ
์ฒ์ ๊ด์ฌ์ฌ ๋ถ๋ฆฌ (SoC)
-
-## ๐ฏ ๊ฐ์ (Overview)
-๋ณต์กํ ์ํํธ์จ์ด ์์คํ
์ ์ญํ ๋ณ๋ก ๊ตฌ๋ถ๋ ๋
๋ฆฝ์ ์ธ ๋ชจ๋๋ก ๋๋์ด, ์ ์ง๋ณด์์ฑ๊ณผ ํ์ฅ์ฑ์ ๊ทน๋ํํ๋ ์ค๊ณ ์ฒ ํ์
๋๋ค.
-
-## ๐ ๊ณ์ธต๊ตฌ์กฐ ์์ (Layering Example)
-1. **[[Logic|Logic]] Engine**: ์์ ๋น์ฆ๋์ค ๋ก์ง ๋ฐ ๊ท์น ์ํ (์: `gameWorker.js`)
-2. **[[State|State]] Manager**: ๋ฐ์ดํฐ์ ์ค์ ์ง์ค ์ฒ๋ฆฌ (์: `TetrisGame.jsx`)
-3. **View Layer**: ์ฌ์ฉ์ ์ธํฐํ์ด์ค ํํ ๋ฐ ๋ ๋๋ง (์: React Components)
-
-## ๐ก ๋ ์จ ๋ฐ (Lesson Learned)
-> [!IMPORTANT]
-> **"์ฝ๋์ ๊ฒฝ๊ณ๊ฐ ๋ช
ํํ ๋ ์์คํ
์ ๋น๋ก์ ๊ฑด๊ฐํด์ง๋ค."**
-> ๊ธฐ๋ฅ์ ์ถ๊ฐํ ๋ ๊ธฐ์กด ์ฝ๋๋ฅผ ์์ ํ๊ธฐ๋ณด๋ค ์๋ก์ด ๋ชจ๋์ ๋ง๋ถ์ผ ์ ์๋ ๊ตฌ์กฐ๋ฅผ ๊ณ ๋ฏผํด์ผ ํฉ๋๋ค.
-
-## ๐ ์ฐ๊ฒฐ๋ ์ง์
-- [[WebWorker_Performance|WebWorker_Performance]]
-- [[Single_Source_of_Truth|Single_Source_of_Truth]]
diff --git a/10_Wiki/Topics/02_Architecture_Principles/Single_Source_of_Truth.md b/10_Wiki/Topics/02_Architecture_Principles/Single_Source_of_Truth.md
deleted file mode 100644
index f89b9727..00000000
--- a/10_Wiki/Topics/02_Architecture_Principles/Single_Source_of_Truth.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-title: ์ํ ๊ด๋ฆฌ์ ๋จ์ผ ์ง์ค ๊ณต๊ธ์ ([[Single_Source_of_Truth|Single Source of Truth]])
-category: Software [[Architecture|Architecture]]
-tags: [[State|[State]] [[Management|Management]], Data Consistency, Redux, Architecture]
-created: 2026-04-20
----
-
-# ์ํ ๊ด๋ฆฌ์ ๋จ์ผ ์ง์ค ๊ณต๊ธ์ (Single Source of Truth)
-
-## ๐ฏ ๊ฐ์ (Overview)
-์์คํ
์ ํต์ฌ ๋ฐ์ดํฐ๋ฅผ ์ค์ ์ง์ค์์ผ๋ก ๊ด๋ฆฌํ์ฌ, ๋ฐ์ดํฐ ๋ถ์ผ์น(Inconsistency) ํ์์ ์์ฒ ์ฐจ๋จํ๊ณ ์์ธก ๊ฐ๋ฅํ ๋ฐ์ดํฐ ํ๋ฆ์ ํ๋ณดํ๋ ์ค๊ณ ์์น์
๋๋ค.
-
-## ๐ ์ฃผ์ ์์น (Key [[Principles|Principles]])
-- **๋จ์ผ ์ง์ ์ ์ (Defined at Single Point)**: ์ํ๋ ์ค์ง ํ ๊ณณ์์๋ง ์ ์๋๊ณ ๊ด๋ฆฌ๋์ด์ผ ํฉ๋๋ค.
-- **์์ธก ๊ฐ๋ฅ์ฑ (Predictability)**: ์ํ ๋ณ๊ฒฝ์ ์ ํด์ง ๊ท์น(Action/Setter)์ ํตํด์๋ง ๋ฐ์ํ์ฌ ๋๋ฒ๊น
์ ์ฉ์ดํ๊ฒ ํฉ๋๋ค.
-
-## ๐ก ๋ ์จ ๋ฐ (Lesson Learned)
-> [!TIP]
-> **"์ํ๋ ์ค์ง ํ ๊ณณ์์๋ง ์ ์ํ๊ณ , ๋ชจ๋ ๋ก์ง์ ๊ทธ ์ํ๋ฅผ ์ฝ๊ณ ์ฐ๋ ๋ฐฉ์์ผ๋ก ๋์ํด์ผ ํ๋ค."**
-> ์ฝ๋์ ํํธํ๋ฅผ ๋ง๊ธฐ ์ํด ๋ฐ์ดํฐ์ ์ฑ
์ ๋ฒ์(Responsibility)๋ฅผ ๋ช
ํํ ํ๋ ๊ฒ์ด ๋๊ท๋ชจ ํ๋ก์ ํธ ์ฑ๊ณต์ ์ด์ ์
๋๋ค.
-
-## ๐ ์ฐ๊ฒฐ๋ ์ง์
-- [[Separation_of_Concerns|Separation_of_Concerns]]
-- [[Domain-Driven-Design-DDD|Domain-Driven Design (DDD]]
diff --git a/10_Wiki/Topics/02_Architecture_Principles/๊ณ์ธตํ ์ํคํ
์ฒ (Layered Architecture).md b/10_Wiki/Topics/02_Architecture_Principles/๊ณ์ธตํ ์ํคํ
์ฒ (Layered Architecture).md
deleted file mode 100644
index 00bdd561..00000000
--- a/10_Wiki/Topics/02_Architecture_Principles/๊ณ์ธตํ ์ํคํ
์ฒ (Layered Architecture).md
+++ /dev/null
@@ -1,84 +0,0 @@
----
-id: P-REINFORCE-WIKI-7074CA41
-title: "แแ
จแแ
ณแผแแ
งแผ แแ
กแแ
ตแแ
ฆแจแแ
ฅ (Layered Architecture)"
-category: "10_Wiki/๐ก Topics/02_Architecture_Principles"
-status: verified
-canonical_id: ""
-aliases: []
-duplicate_of: ""
-source_trust_level: A
-confidence_score: 0.95
-tags: ['Layered Architecture']
-raw_sources: ["Datacollector_MAC/out_wiki/แแ
จแแ
ณแผแแ
งแผ แแ
กแแ
ตแแ
ฆแจแแ
ฅ (Layered Architecture).md"]
-last_reinforced: 2026-05-02
-github_commit: ""
----
-
-# [[แแ
จแแ
ณแผแแ
งแผ แแ
กแแ
ตแแ
ฆแจแแ
ฅ (Layered Architecture)]]
-
-## ๐ Brief Summary
-๊ณ์ธตํ ์ํคํ
์ฒ(Layered Architecture)๋ n-tier ์ํคํ
์ฒ๋ก๋ ๋ถ๋ฆฌ๋ฉฐ, ์ํํธ์จ์ด ์์คํ
์ ํน์ ํ ์ฑ
์์ ์ง๋ ์ํ์ ์ธ ๊ณ์ธต(Layer)๋ค๋ก ๊ตฌ์ฑํ๋ ์ ํต์ ์ด๊ณ ์ํฅ๋ ฅ ์๋ ์์คํ
ํจํด์ด๋ค [1]. ๊ฐ ๊ณ์ธต์ ์ฌ์ฉ์ ์ธํฐํ์ด์ค, ๋น์ฆ๋์ค ๋ก์ง, ๋ฐ์ดํฐ ์์์ฑ ๋ฑ ๋ช
ํํ ์ญํ ์ ๊ฐ์ง๋ฉฐ, ์ธ์ ํ ๋ฐ๋ก ์๋์ ๊ณ์ธต์๋ง ์์กดํด์ผ ํ๋ค๋ ์๊ฒฉํ ํต์ ๊ท์น์ ๊ฐ์ง๋ค [1, 2]. ์ด ์ํคํ
์ฒ๋ ๊ด์ฌ์ฌ์ ๋ถ๋ฆฌ(Separation of Concerns)๋ฅผ ๊ฐ์ ํ์ฌ ์์คํ
์ ๊ตฌ์กฐํํ๊ณ ๊ฐ๋ณ ๊ณ์ธต์ ์ ์ง๋ณด์์ ํ
์คํธ๋ฅผ ์ฉ์ดํ๊ฒ ํ๋ ๊ฒ์ ์ฃผ๋ ๋ชฉ์ ์ผ๋ก ํ๋ค [1, 3].
-
-## ๐ Core ์์ค Content
-- **์ฃผ์ ๊ณ์ธต ๊ตฌ์ฑ**: ์ ํต์ ์ผ๋ก ์ ํ๋ฆฌ์ผ์ด์
์ ํ๋ ์ ํ
์ด์
๊ณ์ธต(Presentation Layer), ๋น์ฆ๋์ค ๋ก์ง ๊ณ์ธต(Business Logic Layer/Domain Layer), ๋ฐ์ดํฐ ์ ๊ทผ ๊ณ์ธต(Data Access Layer/Persistence Layer) ๋ฑ์ผ๋ก ๋๋๋ค [4].
- - **ํ๋ ์ ํ
์ด์
๊ณ์ธต**: ์ต์๋จ์ ์์นํ๋ฉฐ UI/UX ๊ด๋ จ ๋ก์ง์ ์ฒ๋ฆฌํ๊ณ ์ฌ์ฉ์์๊ฒ ๋ฐ์ดํฐ๋ฅผ ํ์ํ๋ฉฐ ์
๋ ฅ์ ์บก์ฒํ๋ค [4].
- - **๋น์ฆ๋์ค ๋ก์ง ๊ณ์ธต**: ์ ํ๋ฆฌ์ผ์ด์
์ ํต์ฌ ๋น์ฆ๋์ค ๊ท์น๊ณผ ์ํฌํ๋ก์ฐ๋ฅผ ํฌํจํ๋ฉฐ ํ๋ ์ ํ
์ด์
๊ณ์ธต์ ๋ช
๋ น์ ์ฒ๋ฆฌํ๋ค [4].
- - **๋ฐ์ดํฐ ์ ๊ทผ ๊ณ์ธต**: ๋ฐ์ดํฐ๋ฒ ์ด์ค ๋ฑ ๋ฐ์ดํฐ ์์ค์์ ํต์ (CRUD ์์
)์ ๋ด๋นํ์ฌ ๋น์ฆ๋์ค ๋ก์ง์ ๋ฐ์ดํฐ ์ ์ฅ์ ์ธ๋ถ ์ฌํญ์ผ๋ก๋ถํฐ ๋ถ๋ฆฌํ๋ค [4].
-- **์๊ฒฉํ ์์กด์ฑ ๋ฐ ํต์ ๊ท์น**: ๊ฐ ๊ณ์ธต์ ๋ฐ๋ก ์๋์ ์ธ์ ํ ํ์ ๊ณ์ธตํ๊ณ ๋ง ํต์ ํด์ผ ํ๋ค [5]. ์๋ฅผ ๋ค์ด UI ๋ก์ง(ํ๋ ์ ํ
์ด์
๊ณ์ธต)์ด ๋ฐ์ดํฐ ์ ๊ทผ ๊ณ์ธต์ ์ง์ ํธ์ถํ์ฌ ๋ฐ์ดํฐ๋ฒ ์ด์ค ์ฟผ๋ฆฌ๋ฅผ ์ํํ๋ค๋ฉด ์ด๋ ์ํคํ
์ฒ์ ๋ถํจ๋ฅผ ์๋ฏธํ๋ค [2, 5].
-- **๊ตฌํ ํ๋ํฐ์ค**: ๊ณ์ธต ๊ฐ ํต์ ์ ์ํด ๋ช
ํํ ์ธํฐํ์ด์ค(Clear Interfaces)๋ฅผ ์ ์ํด์ผ ํ๋ฉฐ, ์์ ๊ณ์ธต์ด ํ์ ๊ณ์ธต์ ์ธ์คํด์ค๋ฅผ ์ง์ ์์ฑํ์ง ์๋๋ก ์์กด์ฑ ์ฃผ์
(Dependency Injection)์ ํ์ฉํ์ฌ ๋์จํ ๊ฒฐํฉ(Loose Coupling)์ ์ด์งํด์ผ ํ๋ค [5].
-- **์ฝ๋๋ฒ ์ด์ค ์ฝ๊ธฐ ๊ด์ **: ๋ณต์กํ ์ฝ๋๋ฒ ์ด์ค๋ฅผ ํด๋
ํ ๋ ์์คํ
์ด ๊ณ์ธตํ ์ํคํ
์ฒ๋ฅผ ๋ฐ๋ฅด๋์ง ์๋ณํ๋ ๊ฒ์ ์ฝ๋์ ๋ฐฐ์น์ ์์กด์ฑ ๊ท์น์ ์ดํดํ๋ ์ง๋ฆ๊ธธ์ด๋ค [2]. ๊ฐ๋ฐ์๋ ํํฅ์(Top-down)์ผ๋ก ํ๋
ํ๋ฉฐ ์์กด์ฑ ๋ฐฉํฅ์ด ์ฌ๋ฐ๋ฅด๊ฒ ์ค๊ณ๋์๋์ง ์ ์ฌํ ๊ด์ฐฐํด์ผ ํ๋ค [2].
-
-## โ๏ธ Trade-offs & Caveats
-- ๊ณ์ธตํ ์ํคํ
์ฒ๋ ๊ด๋ฆฌ๊ฐ ๋ถ์ฃผ์ํ ๊ฒฝ์ฐ ์ฝ๋๊ฐ ๊ฐํ๊ฒ ๊ฒฐํฉ(Tightly coupled)๋๋ ๋ถ์์ฉ์ด ๋ฐ์ํ๊ธฐ ์ฝ๋ค [6].
-- ๋ ์ด์ด ๊ฐ ๊ฒฐํฉ์ ๋ง๊ธฐ ์ํด ์์กด์ฑ ์ฃผ์
๊ณผ ๋ช
ํํ ์ธํฐํ์ด์ค๋ฅผ ๊ฐ์ ํ์ง ์์ผ๋ฉด ๊ณ์ธต ๋ถ๋ฆฌ์ ์ฅ์ ์ด ํด์๋๋ฉฐ, ๊ฐ ๊ณ์ธต์ ์ต๋ํ ์๊ฒ(Thin) ์ ์งํด์ผ๋ง ๊ด๋ฆฌ์ ์ด์ ์ ํ๋ณดํ ์ ์๋ค [3, 5].
-- ๊ฐ ๊ณ์ธต๋ณ๋ก ๋ช
ํํ ๊ตฌ๋ถ์ด ์์ด ์ ํต์ ์ธ ์ํฐํ๋ผ์ด์ฆ ์ ํ๋ฆฌ์ผ์ด์
์๋ ๋งค์ฐ ์ด์์ ์ด๋, ๋ง์ดํฌ๋ก์๋น์ค ์ํคํ
์ฒ(MSA)์ฒ๋ผ ๋ชจ๋๋ณ๋ก ์๋ฒฝํ ๋
๋ฆฝ์ ์ธ ๋ฐฐํฌ ๋ฐ ๋ฏผ์ฒฉํ ํ์ฅ์ด ํ์ํ ์์คํ
์ ๋นํด์๋ ๊ฑฐ๋ํ๊ณ ์ ์ ์ธ ๊ตฌ์กฐ(Monolithic)๋ฅผ ๊ฐ์ง ์ ์๋ค [3, 7].
-
-## ๐ Knowledge Connections
-
-### Related Concepts
-
-#### [์ฝ๋๋ฒ ์ด์ค ๋ถ์/ํ์ ์ ๋ต]
-- [[ํํฅ์ ์ ๊ทผ๋ฒ (Top-Down Approach)]]
- - ์ฐ๊ฒฐ ์ด์ : ๊ณ์ธตํ ์ํคํ
์ฒ๋ ์ต์๋จ์ ํ๋ ์ ํ
์ด์
๊ณ์ธต๋ถํฐ ์ตํ๋จ์ ๋ฐ์ดํฐ ๊ณ์ธต์ผ๋ก ์์กด์ฑ์ด ํ๋ฅด๋ฉฐ, ํํฅ์ ํ์์ ์ด๋ฌํ ๊ตฌ์กฐ์ ์ ์ด ํ๋ฆ์ ํ์
ํ๋ ๋ฐ ๊ฐ์ฅ ๋ถํฉํ๋ ์ ๋ต์ด๊ธฐ ๋๋ฌธ์ด๋ค [4, 8].
- - ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ์ง์
์ (UI ๋๋ API)์์ ์์ํด ํธ์ถ ์คํ์ ๋ฐ๋ผ ๋ด๋ ค๊ฐ๋ฉฐ ์ ์ฒด ๋น์ฆ๋์ค ๋ก์ง๊ณผ ์์คํ
๊ตฌ์ฑ ์์๊ฐ ์ด๋ป๊ฒ ์ค์ผ์คํธ๋ ์ด์
(Orchestration)๋๋์ง ๊ด์ฐฐํ๋ ๊ธฐ์ [8].
-
-#### [์ํคํ
์ฒ/๊ธฐ๋ฐ ๊ธฐ์ ]
-- [[๊ด์ฌ์ฌ์ ๋ถ๋ฆฌ (Separation of Concerns, SoC)]]
- - ์ฐ๊ฒฐ ์ด์ : ๊ณ์ธตํ ์ํคํ
์ฒ๊ฐ ๊ฐ ๊ณ์ธต๋ณ๋ก ์ฑ
์(UI, ๋น์ฆ๋์ค, ๋ฐ์ดํฐ)์ ๋๋๋ ๊ทผ๋ณธ์ ์ธ ๋ชฉ์ ์ด์ ์์น์ด๊ธฐ ๋๋ฌธ์ด๋ค [1, 9, 10].
- - ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ๋จ์ผ ์ปดํฌ๋ํธ๊ฐ ๋๋ฌด ๋ง์ ์ญํ ์ ์ง์ด์ง์ง ์๋๋ก ํ์ฌ ์ฝ๋๋ฒ ์ด์ค์ ๋ณต์ก๋๋ฅผ ์ค์ด๊ณ , ๊ฐ๋ณ ์์ญ์ ํ
์คํธ ๋ฐ ์ ์ง๋ณด์๋ฅผ ๋
๋ฆฝ์ ์ผ๋ก ์ํํ ์ ์๊ฒ ํ๋ ์๋ฆฌ [9].
-- [[์์กด์ฑ ์ฃผ์
(Dependency Injection, DI)]]
- - ์ฐ๊ฒฐ ์ด์ : ์์ ๊ณ์ธต์ด ํ์ ๊ณ์ธต์ ์ง์ ์์ฑํ๊ณ ์์กดํ์ฌ ์ฝ๋๊ฐ ๊ฐํ๊ฒ ๊ฒฐํฉ๋๋ ๊ฒ์ ๋ง๊ณ , ์ ์ฐ์ฑ๊ณผ ํ
์คํธ ์ฉ์ด์ฑ์ ํ๋ณดํ๊ธฐ ์ํด ๊ณ์ธตํ ์ค๊ณ์์ ํ์์ ์ผ๋ก ๋์
๋๋ ๊ธฐ๋ฒ์ด๋ค [5, 11].
- - ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ๊ฐ์ฒด์ ์์ฑ์ ์ธ๋ถ๋ก ์์ํ์ฌ ํต์ฌ ๋ก์ง์ ๊ตฌ์ฒด์ ์ธ ์ธํ๋ผ ๊ตฌํ์ฒด๋ก๋ถํฐ ๋ถ๋ฆฌํด๋ด๋ ์ฝ๋ ์ค๊ณ ๊ธฐ๋ฒ [5, 12].
-
-### Deeper Research Questions
-
-- ๊ณ์ธตํ ์ํคํ
์ฒ ํ๊ฒฝ์์ ๊ณ์ธต ๊ฐ ๊ฐํ ๊ฒฐํฉ(Tight Coupling)์ ๋ฐฉ์งํ๊ธฐ ์ํ ์ธํฐํ์ด์ค ์ค๊ณ์ ์์กด์ฑ ์ฃผ์
(DI)์ ๊ตฌ์ฒด์ ์ธ ๊ตฌํ ํจํด์ ๋ฌด์์ธ๊ฐ?
-- ํ๋ ์ ํ
์ด์
๊ณ์ธต์ด ๋ฐ์ดํฐ ์ ๊ทผ ๊ณ์ธต์ ์ง์ ํธ์ถํ๋ '์ํคํ
์ฒ ๋ถํจ(Architecture Rot)'๊ฐ ๋ฐ์ํ์ ๋, ์ด๋ฅผ ํด๊ฒฐํ๊ณ ์ฝ๋๋ฒ ์ด์ค๋ฅผ ์ ์์ ์ธ ๊ตฌ์กฐ๋ก ๋ฆฌํฉํ ๋งํ๋ ๋จ๊ณ์ ์ ๋ต์ ๋ฌด์์ธ๊ฐ?
-- ์ ํต์ ์ธ 3๊ณ์ธต ์ํคํ
์ฒ(Layered Architecture)๊ฐ ํด๋ฆฐ ์ํคํ
์ฒ(Clean Architecture)๋ ๋๋ฉ์ธ ์ฃผ๋ ์ค๊ณ(DDD)๊ฐ ์ ์ฉ๋ ์ํคํ
์ฒ์ ๋น๊ตํ์ฌ ๊ฐ๋ ๊ทผ๋ณธ์ ์ธ ์์กด์ฑ ๋ฐฉํฅ์ ์ฐจ์ด๋ ๋ฌด์์ธ๊ฐ?
-- ๋๊ท๋ชจ ๊ณ์ธตํ ์ฝ๋๋ฒ ์ด์ค์์ ํํฅ์ ํ์(Top-Down)๊ณผ ์ํฅ์ ํ์(Bottom-Up) ์ ๋ต์ ํผํฉํ์ฌ ์์คํ
์ ์ฒด ๊ตฌ์กฐ๋ฅผ ๊ฐ์ฅ ํจ์จ์ ์ผ๋ก ์ธ๋ฑ์ฑํ๊ณ ์จ๋ณด๋ฉํ๋ ๋ฐฉ๋ฒ์ ๋ฌด์์ธ๊ฐ?
-- ๊ฐ ๊ณ์ธต์ ๋ฌผ๋ฆฌ์ ์ผ๋ก ๋ถ๋ฆฌ๋ ๋๋ ํ ๋ฆฌ(Package-per-layer)๋ก ๋๋ ๋์ ๊ธฐ๋ฅ๋ณ๋ก ๋ฌถ๋ ํผ์ฒ ๊ธฐ๋ฐ(Feature-based organization) ๋ฐฉ์ ๊ฐ์ ๊ตฌ์กฐ์ ์ฅ๋จ์ ์ ์ด๋ป๊ฒ ๋ค๋ฅธ๊ฐ?
-
-### Practical Application Contexts
-
-- **Implementation:** ์ฝ๋๋ฅผ ์์ฑํ ๋ ํ๋ ์ ํ
์ด์
, ๋น์ฆ๋์ค, ๋ฐ์ดํฐ ์ ๊ทผ ๋ก์ง์ ๊ฐ๊ฐ ๋
๋ฆฝ๋ ๋๋ ํ ๋ฆฌ์ ๋ ์ด์ด๋ก ๋ถ๋ฆฌํ๊ณ , ์์ ๋ ์ด์ด๊ฐ ํ์ ๋ ์ด์ด์ ์ธํฐํ์ด์ค์๋ง ์์กดํ๋๋ก ์์คํ
์ ๊ตฌ์ถํ๋ค [4-6].
-- **System Design:** ์ ์ง๋ณด์์ ํ
์คํธ๊ฐ ์ฉ์ดํ 3-Tier ๊ธฐ๋ฐ์ ์ ํต์ ์ธ ์ํฐํ๋ผ์ด์ฆ ์ ํ๋ฆฌ์ผ์ด์
์ ์ค๊ณํ ๋ ๊ฐ์ฅ ํต์ฌ์ ์ด๊ณ ์
์ฆ๋ ์ฒญ์ฌ์ง์ผ๋ก ์ฌ์ฉ๋๋ค [1, 3].
-- **Operation / Maintenance:** ๊ธฐ์กด ์ฝ๋๋ฅผ ์์ ํ ๋ ๊ฐ ๋ ์ด์ด ๊ฐ ํต์ ๊ท์น์ ์๋ฐํ์ง ์์๋์ง ํ์ธํ๋ฉฐ, ๊ธฐ๋ฅ ๋ณ๊ฒฝ์ด ๋ฐ์ํ์ ๋ ํด๋น ๋ก์ง์ด UI์ธ์ง, ๋น์ฆ๋์ค ๊ท์น์ธ์ง, DB ์
์ถ๋ ฅ์ธ์ง์ ๋ฐ๋ผ ์ ํํ ๊ณ์ธต์ ์ฝ๋๋ฅผ ์์ ํ์ฌ ์์ ์ฑ์ ํ๋ณดํ๋ค [1, 2].
-- **Learning Path:** ์๋ก์ด ์ฝ๋๋ฒ ์ด์ค๋ ๋ ๊ฑฐ์ ์์คํ
์ ์จ๋ณด๋ฉํ ๋, ์์คํ
์ด ์ธต์ผ๋ก ๋๋์ด์ ธ ์์์ ์ธ์งํ๊ณ UI ๋ผ์ฐํฐ ๊ฐ์ ์ต์์ ์ง์
์ ์์ ์ถ๋ฐํด ๊ณ์ธต์ ์์ฐจ์ ์ผ๋ก ๋ด๋ ค๊ฐ๋ ๋ฐฉ์์ผ๋ก ์์คํ
๊ตฌ์กฐ๋ฅผ ํ์ตํ๋ค [2, 8].
-- **My Project Relevance:** ์ฝ๋๋ฒ ์ด์ค ์ฝ๊ธฐ ๋ฐ ํ์
์, ์ฝ๋๊ฐ ํน์ ํ ๊ณ์ธต ๊ท์น์ ๋ฐ๋ฅด๊ณ ์๋์ง ํ์ธํ๊ณ , ๋ง์ฝ ์ญ๋ฐฉํฅ ํธ์ถ์ด๋ ๊ณ์ธต์ ๊ฑด๋๋ฐ๋ ํธ์ถ์ด ๋ฐ๊ฒฌ๋๋ค๋ฉด ๊ธฐ์ ์ ๋ถ์ฑ๊ฐ ์์ธ ๋ถ๋ถ์ผ๋ก ํ๋จํ๊ณ ๊ฐ์ ํฌ์ธํธ๋ฅผ ๋์ถํ ์ ์๋ค [2].
-
-### Adjacent Topics
-
-- [[ํด๋ฆฐ ์ํคํ
์ฒ (Clean Architecture)]]
- - ํ์ฅ ๋ฐฉํฅ: ๊ณ์ธตํ ์ํคํ
์ฒ๋ ์์ ๊ณ์ธต์ด ํ์ ๊ณ์ธต์ ์์กดํ๋ ๊ตฌ์กฐ๋ฅผ ๊ฐ์ง๋ง, ํด๋ฆฐ ์ํคํ
์ฒ๋ ์์กด์ฑ ์ญ์ ์์น(DIP)์ ํ์ฉํ์ฌ ๋ชจ๋ ์์กด์ฑ์ด ์ค์์ ๋น์ฆ๋์ค ๋๋ฉ์ธ ๋ก์ง์ ํฅํ๊ฒ ํจ์ผ๋ก์จ ์ธ๋ถ ๊ธฐ์ ์์๋ก๋ถํฐ ์ฝ์ด ๋ก์ง์ ์์ ํ ๊ฒฉ๋ฆฌํ๋ ๋ฐ์ ๋ ์ค๊ณ ๋ฐฉ์์ ํ๊ตฌํ ์ ์๋ค [13-15].
-
----
-*Last updated: 2026-05-02*
-## ๐งช ๊ฒ์ฆ ์ํ (Validation)
-- **์ ๋ณด ์ํ:** verified
-- **์ถ์ฒ ์ ๋ขฐ๋:** A
-- **๊ฒํ ์ด์ :** Datacollector์์ ์๋ ์ถ์ถ๋ ์ํค ๋ฐ์ดํฐ์ ์ด๊ธฐ ํตํฉ.
-
-## ๐งฌ ์ค๋ณต ๊ฒ์ฌ (Duplicate Check)
-- **๊ธฐ์กด ์ ์ฌ ๋ฌธ์:** [[แแ
จแแ
ณแผแแ
งแผ แแ
กแแ
ตแแ
ฆแจแแ
ฅ (Layered Architecture).md]]
-- **์ฒ๋ฆฌ ๋ฐฉ์:** UPDATE
-- **์ฒ๋ฆฌ ์ด์ :** ๊ธฐ์กด ๋ฌธ์ ๋ด์ฉ ๋ณด๊ฐ ๋ฐ v3.1 ํ์ค ์ ์ฉ
diff --git a/10_Wiki/Topics/02_Architecture_Principles/๊ด์ฌ์ฌ์ ๋ถ๋ฆฌ (Separation of Concerns).md b/10_Wiki/Topics/02_Architecture_Principles/๊ด์ฌ์ฌ์ ๋ถ๋ฆฌ (Separation of Concerns).md
deleted file mode 100644
index d5c995a3..00000000
--- a/10_Wiki/Topics/02_Architecture_Principles/๊ด์ฌ์ฌ์ ๋ถ๋ฆฌ (Separation of Concerns).md
+++ /dev/null
@@ -1,90 +0,0 @@
----
-id: P-REINFORCE-WIKI-D2716426
-title: "แแ
ชแซแแ
ตแทแแ
กแแ
ด แแ
ฎแซแ
แ
ต (Separation of Concerns)"
-category: "10_Wiki/๐ก Topics/02_Architecture_Principles"
-status: verified
-canonical_id: ""
-aliases: []
-duplicate_of: ""
-source_trust_level: A
-confidence_score: 0.95
-tags: ['Separation of Concerns']
-raw_sources: ["Datacollector_MAC/out_wiki/แแ
ชแซแแ
ตแทแแ
กแแ
ด แแ
ฎแซแ
แ
ต (Separation of Concerns).md"]
-last_reinforced: 2026-05-02
-github_commit: ""
----
-
-# [[แแ
ชแซแแ
ตแทแแ
กแแ
ด แแ
ฎแซแ
แ
ต (Separation of Concerns)]]
-
-## ๐ Brief Summary
-๊ด์ฌ์ฌ์ ๋ถ๋ฆฌ(SoC)๋ ์์คํ
์ ๊ฒน์น์ง ์๋ ๋๋ ทํ ์ฌ๋ฌ ์น์
์ผ๋ก ๋๋์ด ์ํํธ์จ์ด๋ฅผ ์ค๊ณํ๋ ์ํํธ์จ์ด ์์ง๋์ด๋ง์ ํต์ฌ ์์น์ด๋ค [1]. ๋จ์ผ ์ปดํฌ๋ํธ๊ฐ ๋๋ฌด ๋ง์ ๊ด๋ จ ์๋ ์์
์ ์ํํ๋ ๊ฒ์ ๋ฐฉ์งํ์ฌ ๋ณต์ก์ฑ์ ์ค์ด๊ณ ์์คํ
์ ๊ด๋ฆฌ๊ฐ๋ฅํ๊ฒ ๋ง๋ ๋ค [1]. ํ๋ ์ ํ
์ด์
๋ก์ง, ๋น์ฆ๋์ค ๊ท์น, ๋ฐ์ดํฐ ์ ๊ทผ ๋ฉ์ปค๋์ฆ์ ๋ถ๋ฆฌํจ์ผ๋ก์จ ๊ฐ ๋ชจ๋์ ๋
๋ฆฝ์ ์ธ ๊ฐ๋ฐ, ์ดํด ๋ฐ ํ
์คํธ๋ฅผ ์ฉ์ดํ๊ฒ ํ๋ ์ญํ ์ ํ๋ค [1].
-
-## ๐ Core ์ค์ง Content
-* **์์น์ ํต์ฌ ๋ชฉ์ **: ์์คํ
์ ๋ณต์ก์ฑ์ ์ค์ด๋ ๊ฒ์ด ์ฃผ๋ ๋ชฉํ์ด๋ค [1]. ํ๋์ ๋ชจ๋์ด๋ ์ปดํฌ๋ํธ๊ฐ ์์ ์ด ๋งก์ ํน์ ํ '๊ด์ฌ์ฌ(concern)'์๋ง ์ง์คํ๋๋ก ๊ฒฉ๋ฆฌํจ์ผ๋ก์จ, ์ฝ๋๊ฐ ๋ถ์์ง๊ธฐ ์ฝ๊ณ ๊ด๋ฆฌ ๋ถ๊ฐ๋ฅํด์ง๋ ๊ฒ์ ๋ฐฉ์งํ๋ค [1].
-* **์ฃผ์ ๊ตฌํ ๋ฐ ์ํคํ
์ฒ ํจํด**:
- * **MVC (Model-View-Controller)**: ๋ฐ์ดํฐ์ ๋น์ฆ๋์ค ๋ก์ง์ ๊ด๋ฆฌํ๋ Model, ์ฌ์ฉ์ ์ธํฐํ์ด์ค๋ฅผ ๋ค๋ฃจ๋ View, ์
๋ ฅ์ ๋ฐ์ ์กฐ์จํ๋ Controller๋ก ์ ํ๋ฆฌ์ผ์ด์
์ ๊ด์ฌ์ฌ๋ฅผ ์ธ ๋ถ๋ถ์ผ๋ก ๋ถ๋ฆฌํ๋ค [2].
- * **๊ณ์ธตํ ์ํคํ
์ฒ (Layered Architecture)**: ํ๋ ์ ํ
์ด์
๊ณ์ธต, ๋น์ฆ๋์ค ๋ก์ง ๊ณ์ธต, ๋ฐ์ดํฐ ์ ๊ทผ ๊ณ์ธต ๋ฑ ์ํ์ ์ธ ์ธต์ผ๋ก ๊ด์ฌ์ฌ๋ฅผ ๋ถ๋ฆฌํ๋ฉฐ, ๊ฐ ๊ณ์ธต์ ๋ฐ๋ก ์๋ ๊ณ์ธต๊ณผ๋ง ํต์ ํ๋๋ก ์ ํํ๋ค [2-4].
- * **๋ง์ดํฌ๋ก์๋น์ค ์ํคํ
์ฒ (Microservices Architecture)**: ์ฌ์ฉ์ ๊ด๋ฆฌ, ๊ฒฐ์ ์ฒ๋ฆฌ ๋ฑ ํน์ ๋น์ฆ๋์ค ๊ธฐ๋ฅ์ ์ค์ฌ์ผ๋ก ์๊ณ ๋
๋ฆฝ์ ์ธ ์๋น์ค๋ค๋ก ์ ํ๋ฆฌ์ผ์ด์
์ ๋ถํ ํ์ฌ ๋งค์ฐ ์ธ๋ฐํ ์์ค์์ ๊ด์ฌ์ฌ๋ฅผ ๋ถ๋ฆฌํ๋ค [2, 5].
-* **์ฝ๋๋ฒ ์ด์ค ๋ด ์ค์ฒ ์ ๋ต**:
- * **์ด๊ธฐ ์ฑ
์ ์๋ณ**: ์์คํ
์ค๊ณ ์ด๊ธฐ ๋จ๊ณ์์ ์ฌ์ฉ์ ์ธ์ฆ, ๋ฐ์ดํฐ ์ฒ๋ฆฌ, UI ๋ ๋๋ง ๋ฑ์ ์ฃผ์ ์ฑ
์์ ๋ช
ํํ ์ ์ํ๊ณ , ์ด๋ฅผ ๊ฐ๊ธฐ ๋ค๋ฅธ ๋ชจ๋์ ๋งคํํด์ผ ํ๋ค [6].
- * **๋ช
ํํ ์ธํฐํ์ด์ค (Clear Interfaces) ์ฌ์ฉ**: ์๋ก ๋ค๋ฅธ ์ปดํฌ๋ํธ ๊ฐ์ ํต์ ์ ์ํด ์ ๋ฌธ์ํ๋๊ณ ์์ ์ ์ธ ์ธํฐํ์ด์ค๋ฅผ ์ ์ํ์ฌ, ํ๋์ ๊ด์ฌ์ฌ ๋ด๋ถ ๋ณ๊ฒฝ์ด ๋ค๋ฅธ ๊ด์ฌ์ฌ๋ฅผ ๋ง๊ฐ๋จ๋ฆฌ์ง ์๋๋ก ๋ณดํธํ๋ค [6].
- * **์์กด์ฑ ์ฃผ์
(Dependency Injection, DI) ํ์ฉ**: DI ํ๋ ์์ํฌ๋ฅผ ์ฌ์ฉํ์ฌ ์ปดํฌ๋ํธ ๊ฐ ๊ฒฐํฉ๋๋ฅผ ๋ฎ์ถ๊ณ ์ฝ์ด ๋ก์ง์ ๋ณ๊ฒฝ ์์ด ๊ตฌํ์ฒด๋ฅผ ๊ต์ฒดํ ์ ์๋๋ก ํ์ฌ ์ ์ง๋ณด์์ฑ์ ๊ทน๋ํํ๋ค [6].
- * **์ํ ์์กด์ฑ ํด๊ฒฐ**: ํ๋ก์ ํธ ํด๋ ์กฐ์ง ๋ฐ ๋ชจ๋ํ ๋จ๊ณ์์ ๋ฐ์ํ๋ ์ํ ์์กด์ฑ(Cyclic dependencies) ๋ฌธ์ ๋ ๊ด์ฌ์ฌ์ ๋ถ๋ฆฌ ์์น์ ์ค์ํจ์ผ๋ก์จ ์บก์ํ๋ฅผ ํตํด ๊ทผ๋ณธ์ ์ผ๋ก ํด๊ฒฐํ ์ ์๋ค [7, 8].
-
-## โ๏ธ Trade-offs & Caveats
-* **์ด๊ธฐ ์ค๊ณ์ ๋ณต์ก์ฑ**: ๊ฒฝ๊ณ๋ฅผ ์ค๊ณํ๊ธฐ ์ํ ์ฌ์ ์ค๊ณ(upfront boundary design) ๊ณผ์ ์ด ํ์ํ๋ฏ๋ก ๊ตฌํ ๋ณต์ก์ฑ์ด ์ฆ๊ฐํ๋ค [9].
-* **๊ณผ๋ํ ์ถ์ํ์ ์ํ**: ์๋ชป๋ ๊ฒฝ๊ณ ์ค์ ์ด๋ ๋ฌด๋ฆฌํ ๋ถ๋ฆฌ๋ ์คํ๋ ค ๋ชจ๋ ๊ฐ์ ํต์ ์ ๋ณต์กํ๊ฒ ๋ง๋ค์ด ์์คํ
ํ์
์ ๋ ์ด๋ ต๊ฒ ํ ์ ์๋ค [6].
-* **์ฝ๋ ํ์์ ํํธํ**: ๊ด์ฌ์ฌ๊ฐ ์ฒ ์ ํ ๋ถ๋ฆฌ๋ ๊ฐ์ฒด ์งํฅ ์์คํ
์ด๋ ๋๊ท๋ชจ ์ฝ๋๋ฒ ์ด์ค์์๋ ๊ธฐ๋ฅ ํ๋๋ฅผ ํ์
ํ๊ธฐ ์ํด ์ฌ๋ฌ ํ์ผ๊ณผ ๊ณ์ธต์ ์ด๋ฆฌ์ ๋ฆฌ ๋๋๋ค์ด์ผ(jumping back and forth) ํ๋ ์ธ์ง์ ํผ๋ก๋์ ํ์ ์๊ฐ์ด ์ฆ๊ฐํ๋ ๋จ์ ์ด ๋ฐ์ํ ์ ์๋ค [10].
-
-## ๐ Knowledge Connections
-
-### Related Concepts
-
-#### [์ํคํ
์ฒ/๊ธฐ๋ฐ ๊ธฐ์ ]
-- [[๊ณ์ธตํ ์ํคํ
์ฒ (Layered Architecture)]]
- - ์ฐ๊ฒฐ ์ด์ : ๊ด์ฌ์ฌ๋ฅผ ์ํ์ ๊ณ์ธต(ํํ, ๋น์ฆ๋์ค ๋ก์ง, ๋ฐ์ดํฐ ์ ๊ทผ ๋ฑ)์ผ๋ก ๋ถ๋ฆฌํ์ฌ ๊ฐ ๊ณ์ธต์ ์ญํ ์ ์๊ฒฉํ ์ ํํ๋ ๊ฐ์ฅ ๋ํ์ ์ธ ์ํคํ
์ฒ ํจํด์ด๊ธฐ ๋๋ฌธ์ด๋ค [2, 3].
- - ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ์ฝ๋๋ฒ ์ด์ค๋ฅผ ์ฝ์ ๋ ์ฝ๋๊ฐ ์ด๋ค ๊ณ์ธต์ ์ํ๋์ง๋ฅผ ํ์
ํจ์ผ๋ก์จ ํด๋น ์ฝ๋์ ์ฑ
์๊ณผ ํต์ ํ๋ฆ(ํํฅ์ ํ๋ฆ ๋ฑ)์ ์ ์ถํ ์ ์๋ค [4, 11].
-- [[๋๋ฉ์ธ ์ฃผ๋ ์ค๊ณ (Domain-Driven Design, DDD)]]
- - ์ฐ๊ฒฐ ์ด์ : ๋ฐ์ด๋๋ ์ปจํ
์คํธ(Bounded Context)๋ฅผ ํตํด ๋น์ฆ๋์ค ๋๋ฉ์ธ์ ๊ธฐ์ค์ผ๋ก ์์คํ
์ ๊ฒฝ๊ณ๋ฅผ ๋ช
ํํ ๋ถ๋ฆฌํ๋ ์ ๋ต์ด ๊ด์ฌ์ฌ ๋ถ๋ฆฌ์ ํต์ฌ๊ณผ ์ฐ๊ฒฐ๋๊ธฐ ๋๋ฌธ์ด๋ค [12, 13].
- - ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ๋น์ฆ๋์ค ์ฉ์ด๋ก ๋ช
๋ช
๋ ๋ชจ๋ ๊ตฌ์กฐ(Ubiquitous Language)๋ฅผ ๋ฐํ์ผ๋ก ๊ธฐ์ ์ ์์ธ์ ๋งค๋ชฐ๋์ง ์๊ณ ์ฝ๋๋ฒ ์ด์ค์ ๊ตฌ์กฐ์ ์๋๋ฅผ ์์ ์์ค์์ ํ์
ํ๋ ๋ฐฉ๋ฒ์ ๋ฐฐ์ธ ์ ์๋ค [14-16].
-- [[๋ง์ดํฌ๋ก์๋น์ค ์ํคํ
์ฒ (Microservices Architecture)]]
- - ์ฐ๊ฒฐ ์ด์ : ๊ด์ฌ์ฌ์ ๋ถ๋ฆฌ ์๋ฆฌ๋ฅผ ๋จ์ผ ์ ํ๋ฆฌ์ผ์ด์
์ ๋์ด ๋
๋ฆฝ์ ๋ฐฐํฌ๊ฐ ๊ฐ๋ฅํ ๋ถ์ฐ ์์คํ
๋จ์๋ก ํ์ฅํ ๊ตฌ์กฐ์ด๊ธฐ ๋๋ฌธ์ด๋ค [2, 5].
- - ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ์์คํ
์ ๊ธฐ๋ฅ์ ๊ด์ฌ์ฌ๊ฐ ๋คํธ์ํฌ ๊ฒฝ๊ณ๋ฅผ ๋์ด ์ด๋ป๊ฒ ํต์ ํ๊ณ ํ๋ ฅํ๋์ง, ์ธํ๋ผ ์์ค์์์ ๋ถ๋ฆฌ์ ๊ฒฐํฉ๋ ๋ฌธ์ ๋ฅผ ์ดํดํ ์ ์๋ค [17, 18].
-
-#### [๊ตฌํ/์ค๊ณ ์์น]
-- [[์์กด์ฑ ์ฃผ์
(Dependency Injection)]]
- - ์ฐ๊ฒฐ ์ด์ : ๋ถ๋ฆฌ๋ ๊ด์ฌ์ฌ(๋ชจ๋, ๊ณ์ธต ๋ฑ)๋ค์ด ๊ฐํ๊ฒ ๊ฒฐํฉ๋์ง ์๋๋ก ๋์จํ ๊ฒฐํฉ(Loose Coupling)์ ์ ๊ณตํ๋ ํต์ฌ ๊ตฌํ ๊ธฐ๋ฒ์ด๊ธฐ ๋๋ฌธ์ด๋ค [6, 11, 19].
- - ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ํ์ ๋ชจ๋์ด ์๋ ์ถ์ํ(์ธํฐํ์ด์ค)์ ์์กดํ๊ฒ ํ์ฌ ๊ฐ ๊ด์ฌ์ฌ๊ฐ ๋
๋ฆฝ์ ์ผ๋ก ํ
์คํธ ๊ฐ๋ฅํ๊ณ ๊ต์ฒด ๊ฐ๋ฅํ๊ฒ ์ ์ง๋๋ ์๋ฆฌ๋ฅผ ๋ฐฐ์ธ ์ ์๋ค [11, 19, 20].
-- [[๋จ์ผ ์ฑ
์ ์์น (Single Responsibility Principle, SRP)]]
- - ์ฐ๊ฒฐ ์ด์ : ๊ฐ์ฒด ์งํฅ ์ค๊ณ(SOLID)์์ ํด๋์ค๋ ๋ชจ๋์ด ๋จ ํ๋์ ๋ณ๊ฒฝ ์ด์ (ํ๋์ ์์
)๋ง์ ๊ฐ์ ธ์ผ ํ๋ค๋ ์์น์ผ๋ก, ์ฝ๋ ๋ ๋ฒจ์์์ ๊ด์ฌ์ฌ ๋ถ๋ฆฌ์ด๊ธฐ ๋๋ฌธ์ด๋ค [19].
- - ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ๋จ์ผ ํ์ผ์ด๋ ํด๋์ค์ ๋ณต์ก์ฑ์ ์ ์ดํ๊ณ , ์ฝ๋๋ฒ ์ด์ค ๋ด ๊ฐ ์ปดํฌ๋ํธ์ ๋ช
ํํ ๊ฒฝ๊ณ์ ์์ง๋๋ฅผ ๋์ด๋ ์ธ๋ถ ์ค๊ณ ์ง์์ ํ์ตํ ์ ์๋ค [19].
-
-### Deeper Research Questions
-- ์ด๊ธฐ ์ค๊ณ ๋จ๊ณ์์ ์์คํ
์ '๊ด์ฌ์ฌ(Concern)'๋ฅผ ๋์ถํ๊ณ ๋ชจ๋ ๊ฒฝ๊ณ๋ฅผ ์ง๊ธฐ ์ํด Event Storming ๊ฐ์ ์ํฌ์ต์ ์ด๋ป๊ฒ ํ์ฉํ ์ ์๋๊ฐ?
-- ๊ด์ฌ์ฌ๊ฐ ์๊ฒฉํ๊ฒ ๋ถ๋ฆฌ๋ ๊ณ์ธตํ ์ํคํ
์ฒ ๊ตฌ์กฐ์์, ๊ณ์ธต ๊ฐ ๋ฐ์ดํฐ๋ฅผ ์ ๋ฌํ ๋ ๋ฐ์ํ๋ ๋ณด์ผ๋ฌํ๋ ์ดํธ ์ฝ๋์ ๋ณํ ์ค๋ฒํค๋๋ฅผ ์ด๋ค ๋ฐฉ์์ผ๋ก ์ต์ํํ๋๊ฐ?
-- ๋๊ท๋ชจ ์์คํ
์ ์ฝ๋๋ฒ ์ด์ค์์ ๊ธฐ๋ฅ(Feature) ๊ธฐ๋ฐ์ผ๋ก ๊ด์ฌ์ฌ๋ฅผ ๋๋ ๋์ ๊ธฐ์ ์ ๊ณ์ธต(Layer) ๊ธฐ๋ฐ์ผ๋ก ๋๋ ๋, ์ฝ๋ ์ ์ง๋ณด์์ฑ๊ณผ ํ์ ํจ์จ์ฑ ์ธก๋ฉด์์ ์ด๋ค ์ฐจ์ด๊ฐ ์๋๊ฐ?
-- ๋๋ฉ์ธ ์ฃผ๋ ์ค๊ณ(DDD)์ ๋ฐ์ด๋๋ ์ปจํ
์คํธ์ ๋ง์ดํฌ๋ก์๋น์ค์ ๊ฒฝ๊ณ๋ฅผ ์ ์ํ ๋, ๋ ๊ด์ฌ์ฌ ๋ถ๋ฆฌ ๊ธฐ๋ฒ์ ์ด๋ป๊ฒ ์ํธ ์์ฉํ๋ฉฐ ์ฐจ์ด์ ์ ๋ฌด์์ธ๊ฐ?
-- ๊ธฐ์กด์ ๋ ๊ฑฐ์ ๋ชจ๋๋ฆฌ์ ์์คํ
์ ์ฝํ์๋ ์ํ ์์กด์ฑ(Cyclic Dependency)์ ์๋ณํ๊ณ , ๊ด์ฌ์ฌ ๋ถ๋ฆฌ ์์น์ ์ ์ฉํด ์์ ํ๊ฒ ๋ฆฌํฉํ ๋งํ๋ ๋จ๊ณ์ ํ๋ก์ธ์ค๋ ๋ฌด์์ธ๊ฐ?
-
-### Practical Application Contexts
-- **Implementation:** ๋ช
ํํ ์ธํฐํ์ด์ค๋ฅผ ์ค์ ํ๊ณ ์์กด์ฑ ์ฃผ์
์ ํ์ฉํ์ฌ, ๋น์ฆ๋์ค ๊ท์น์ ๋ค๋ฃจ๋ ์ฝ๋์ ๋ฐ์ดํฐ๋ฒ ์ด์ค ์ ๊ทผ ์ฝ๋๋ฅผ ์๋ก ๋ค๋ฅธ ๋ชจ๋์ ๊ฒฉ๋ฆฌํ์ฌ ์์ฑํ๋ค [4, 6, 11].
-- **System Design:** ์ํํธ์จ์ด ์ค๊ณ ์ MVC ํจํด์ด๋ ๊ณ์ธตํ, ํด๋ฆฐ ์ํคํ
์ฒ ๋ฑ์ ์ฑํํ์ฌ, ๊ฐ ๊ตฌ์กฐ๊ฐ ๋ด๋นํ '๊ด์ฌ์ฌ'์ ๊ฒฝ๊ณ๋ฅผ ์ด๊ธฐ๋ถํฐ ๋ช
ํํ ์๋ฆฝํด ๊ฒฐํฉ๋๋ฅผ ๋ฎ์ถ๋ค [2, 3, 21].
-- **Operation / Maintenance:** ์ฝ๋ ๋ณ๊ฒฝ์ด๋ ๋ฒ๊ทธ ๋ฐ์ ์(์: UI ๋ ์ด์์ ๊นจ์ง, DB ์ ์ฅ ์ค๋ฅ), ๊ด์ฌ์ฌ๊ฐ ๋ถ๋ฆฌ๋์ด ์์ผ๋ฏ๋ก ์ ์ฒด ์์คํ
์ ๋ค์ง์ง ์๊ณ ์์ธ์ด ๋๋ ํน์ ์ปดํฌ๋ํธ๋ ๊ณ์ธต๋ง์ ์ง์ค์ ์ผ๋ก ๊ฒํ ํ์ฌ ์ ์ง๋ณด์๋ฅผ ํจ์จํํ๋ค [1, 3, 7].
-- **Learning Path:** ๋ณต์กํ ๋ํ ์ฝ๋๋ฒ ์ด์ค๋ฅผ ์๋กญ๊ฒ ๋ถ์ํ ๋, ์ํคํ
์ฒ ์ ๋ถ๋ฆฌ๋ ๊ด์ฌ์ฌ์ ํํ(๊ณ์ธตํ์ธ์ง, ๋๋ฉ์ธ ์ค์ฌ์ธ์ง)๋ฅผ ๋จผ์ ํ์
ํ ํ, ํํฅ์ ๋๋ ์ํฅ์ ํ์ ๊ธฐ๋ฒ์ ์กฐํฉํ์ฌ ๋ถ๋ถ์ ์ผ๋ก ์์คํ
์ ์ ๋ณตํด ๋๊ฐ๋ ํ์ต ์งํ๋ก ํ์ฉํ๋ค [22, 23].
-- **My Project Relevance:** ํ ํ๋ก์ ํธ ๊ฐ๋ฐ ์ ๊ฐ ํ์ผ๊ณผ ํด๋๋ฅผ ์ฑ
์(UI, ์ ํธ๋ฆฌํฐ, ์๋น์ค ๋ก์ง ๋ฑ)์ ๋ง๊ฒ ์กฐ์งํ๊ณ ์ค๊ณ ํจํด์ ์ ์ฉํ์ฌ, ์ถํ ์๋ก์ด ํ์์ด ํฉ๋ฅํ๊ฑฐ๋ ๋ณธ์ธ์ด ์ฝ๋๋ฅผ ์ฌํ๋
ํ ๋ ๋
ผ๋ฆฌ์ ํ์์ ์ฉ์ดํ๊ฒ ๋ง๋ ๋ค.
-
-### Adjacent Topics
-- [[SOLID ์์น]]
- - ํ์ฅ ๋ฐฉํฅ: ๊ด์ฌ์ฌ์ ๋ถ๋ฆฌ๋ฅผ ํด๋์ค ๋ฐ ๊ฐ์ฒด ์งํฅ ํ๋ก๊ทธ๋๋ฐ ์์ค์์ ๋์ฑ ๊ตฌ์ฒดํํ๋ 5๊ฐ์ง ์ค๊ณ ์์น(ํนํ ๋จ์ผ ์ฑ
์ ์์น๊ณผ ์์กด์ฑ ์ญ์ ์์น)์ ํตํด ์ ์ฐํ๊ณ ์ ์ง๋ณด์ํ๊ธฐ ์ฌ์ด ์ฝ๋ ์์ฑ๋ฒ์ผ๋ก ์ดํด๋ฅผ ํ์ฅํ ์ ์๋ค [19, 24].
-
----
-*Last updated: 2026-05-02*
-## ๐งช ๊ฒ์ฆ ์ํ (Validation)
-- **์ ๋ณด ์ํ:** verified
-- **์ถ์ฒ ์ ๋ขฐ๋:** A
-- **๊ฒํ ์ด์ :** Datacollector์์ ์๋ ์ถ์ถ๋ ์ํค ๋ฐ์ดํฐ์ ์ด๊ธฐ ํตํฉ.
-
-## ๐งฌ ์ค๋ณต ๊ฒ์ฌ (Duplicate Check)
-- **๊ธฐ์กด ์ ์ฌ ๋ฌธ์:** [[แแ
ชแซแแ
ตแทแแ
กแแ
ด แแ
ฎแซแ
แ
ต (Separation of Concerns).md]]
-- **์ฒ๋ฆฌ ๋ฐฉ์:** UPDATE
-- **์ฒ๋ฆฌ ์ด์ :** ๊ธฐ์กด ๋ฌธ์ ๋ด์ฉ ๋ณด๊ฐ ๋ฐ v3.1 ํ์ค ์ ์ฉ
diff --git a/10_Wiki/Topics/02_Architecture_Principles/๋ฐ์ด๋๋ ์ปจํ
์คํธ (Bounded Context).md b/10_Wiki/Topics/02_Architecture_Principles/๋ฐ์ด๋๋ ์ปจํ
์คํธ (Bounded Context).md
deleted file mode 100644
index 207d91b5..00000000
--- a/10_Wiki/Topics/02_Architecture_Principles/๋ฐ์ด๋๋ ์ปจํ
์คํธ (Bounded Context).md
+++ /dev/null
@@ -1,88 +0,0 @@
----
-id: P-REINFORCE-WIKI-EC57F85A
-title: "แแ
กแแ
ฎแซแแ
ตแแ
ณ แแ
ฅแซแแ
ฆแจแแ
ณแแ
ณ (Bounded Context)"
-category: "10_Wiki/๐ก Topics/02_Architecture_Principles"
-status: verified
-canonical_id: ""
-aliases: []
-duplicate_of: ""
-source_trust_level: A
-confidence_score: 0.95
-tags: ['Bounded Context']
-raw_sources: ["Datacollector_MAC/out_wiki/แแ
กแแ
ฎแซแแ
ตแแ
ณ แแ
ฅแซแแ
ฆแจแแ
ณแแ
ณ (Bounded Context).md"]
-last_reinforced: 2026-05-02
-github_commit: ""
----
-
-# [[แแ
กแแ
ฎแซแแ
ตแแ
ณ แแ
ฅแซแแ
ฆแจแแ
ณแแ
ณ (Bounded Context)]]
-
-## ๐ Brief Summary
-๋ฐ์ด๋๋ ์ปจํ
์คํธ(Bounded Context)๋ ๋๋ฉ์ธ ์ฃผ๋ ์ค๊ณ(DDD)์์ ๊ฑฐ๋ํ๊ณ ๋ณต์กํ ๋น์ฆ๋์ค ๋๋ฉ์ธ์ ๊ด๋ฆฌํ๊ธฐ ์ฝ๋๋ก ๋ถํ ํ ๋
๋ฆฝ์ ์ธ ํ์ ๋๋ฉ์ธ ๊ฒฝ๊ณ๋ฅผ ์๋ฏธํฉ๋๋ค [1]. ๊ฐ ์ปจํ
์คํธ๋ ๊ณ ์ ํ ๋ชจ๋ธ๊ณผ ์ ๋น์ฟผํฐ์ค ์ธ์ด(Ubiquitous Language)๋ฅผ ๋ณด์ ํ์ฌ ์ผ๊ด์ฑ์ ์ ์งํ๋ฉฐ ๋
๋ฆฝ์ ์ผ๋ก ๊ตฌํ ๋ฐ ์งํํ ์ ์์ต๋๋ค [1-3]. ๋๊ท๋ชจ ์์คํ
์ ์ฝ๋๋ฒ ์ด์ค๋ฅผ ์ฝ์ ๋, ์ด๋ฌํ ๋น์ฆ๋์ค ์ค์ฌ์ ๊ฒฝ๊ณ๋ฅผ ๋จผ์ ํ์
ํ๋ ๊ฒ์ ์์ธ ๋ก์ง์ ํด๋
ํ๊ธฐ ์ํ ๊ฐ๋ ฅํ ์ธ์ง์ ๊ธฐ๋ฐ์ ์ ๊ณตํฉ๋๋ค [4].
-
-## ๐ Core Content
-
-- **๋น์ฆ๋์ค ๊ธฐ๋ฐ์ ๊ฒฝ๊ณ ๋ถ๋ฆฌ์ ๋
๋ฆฝ์ฑ**: ๋ฐ์ด๋๋ ์ปจํ
์คํธ๋ ๋ณต์กํ ์์คํ
์ '์ฃผ๋ฌธ ๊ด๋ฆฌ', '๊ณ ๊ฐ ์ง์', '๊ฒฐ์ ์ฒ๋ฆฌ' ๋ฑ ๋น์ฆ๋์ค ๊ธฐ๋ฅ(๊ธฐ๋ฅ๋ณ ๋ชจ๋)์ ๊ธฐ์ค์ผ๋ก ๋ถ๋ฆฌํ์ฌ ๋ช
ํํ ๊ฒฝ๊ณ๋ฅผ ์ค์ ํฉ๋๋ค [1, 5]. ๊ฐ ์ปจํ
์คํธ๋ ๋ชจ๋ธ์ด ์๋ก ๊ฒน์น๊ฑฐ๋ ์ํฅ์ ์ฃผ์ง ์๋๋ก ๋
๋ฆฝ์ฑ์ ๋ณด์ฅํ์ฌ ์ํคํ
์ฒ๋ฅผ ๊น๋ํ๊ฒ ์ ์งํฉ๋๋ค [3].
-- **์ฝ๋๋ฒ ์ด์ค ๋
ํด๋ฅผ ์ํ ์ธ์ง์ ๊ธฐ๋ฐ**: ๋๋ฉ์ธ ์ฃผ๋ ์ค๊ณ๊ฐ ์ ์ฉ๋ ์ฝ๋๋ฒ ์ด์ค๋ ๊ธฐ์ ์ ์ธ ๊ธฐ๋ฅ์ด ์๋, ๋ฐ์ด๋๋ ์ปจํ
์คํธ๋ผ๋ ๋น์ฆ๋์ค ์ฉ์ด๋ฅผ ์ค์ฌ์ผ๋ก ํด๋(๋๋ ํ ๋ฆฌ)๊ฐ ๊ตฌ์ฑ๋ฉ๋๋ค [4]. ์์ง๋์ด๋ ๊ฐ๋ณ ์ฝ๋์ ์์ธ ๋ก์ง์ ๋งค๋ชฐ๋๊ธฐ ์ ์ ์ด ๊ตฌ์กฐ์ ํน์ง์ ํ์
ํจ์ผ๋ก์จ ์ ์ฒด ๋น์ฆ๋์ค์ ์๋์ ๋งฅ๋ฝ์ ๋จผ์ ์ดํดํ๋ ์ธ์ง์ ๊ธฐ๋ฐ์ ๋ค์ง ์ ์์ต๋๋ค [4].
-- **์ ๋น์ฟผํฐ์ค ์ธ์ด(Ubiquitous Language)๋ฅผ ํตํ ์๋ฏธ์ ๋ช
ํํ**: ์ปจํ
์คํธ ๋ด๋ถ์์๋ ๋น์ฆ๋์ค ์ดํด๊ด๊ณ์์ ๊ฐ๋ฐ์๊ฐ ๊ณตํต์ผ๋ก ์ฌ์ฉํ๋ ์ ๋น์ฟผํฐ์ค ์ธ์ด๊ฐ ์ผ๊ด๋๊ฒ ์ ์ฉ๋ฉ๋๋ค [3, 6]. ์ด๋ ๊ท์น์ด๋ ์ปจํ
์คํธ๊ฐ ์ด๋์ ์ ์ฉ๋๋์ง์ ๋ํ ํผ๋(ambiguity)์ ์ค์ด๊ณ , ์ฝ๋ ๋ฐ ๋ฌธ์ ๋ด์์ ์ดํด์ ์ํต์ ๊ทน๋ํํฉ๋๋ค [6, 7].
-- **์ ์ง๋ณด์์ฑ๊ณผ ํ์ฅ์ฑ(Scalability)**: ๊ฐ ๋ฐ์ด๋๋ ์ปจํ
์คํธ๋ ๋ค๋ฅธ ์์คํ
์ ๋ฐฉํดํ์ง ์๊ณ ๊ฐ๋ณ์ ์ผ๋ก ์ฒ๋ฆฌ(๋จ์ ํ
์คํธ, ๋ฒ๊ทธ ์์ ๋ฑ)๋ ์ ์์ผ๋ฏ๋ก ์ ์ง๋ณด์๊ฐ ์ฝ์ต๋๋ค [8]. ๋ํ ๋น์ฆ๋์ค๋ ๊ธฐ์ ์ ์๊ตฌ๊ฐ ๋ณํํจ์ ๋ฐ๋ผ ์๋ก์ด ์ปจํ
์คํธ๋ฅผ ์ฝ๊ฒ ์ถ๊ฐํ ์ ์์ด ์ ์ฒด ์์คํ
์ ํ๊ดด ์์ด ์์ ํ๊ฒ ๊ท๋ชจ๋ฅผ ํ์ฅํ ์ ์์ต๋๋ค [8].
-- **๋ชจ๋ํ ๋ชจ๋๋ฆฌ์ค(Modular Monolith) ๊ตฌํ์ ํต์ฌ**: ๋ฐ์ด๋๋ ์ปจํ
์คํธ๋ ๋ง์ดํฌ๋ก์๋น์ค๋ฟ๋ง ์๋๋ผ ๋ชจ๋ํ ๋ชจ๋๋ฆฌ์ค๋ฅผ ๊ตฌํํ ๋๋ ํ์์ ์
๋๋ค [6]. ๋ชจ๋๋ฆฌ์ค ๋ด์์ ๊ฐ๋ณ ๋น์ฆ๋์ค ์ญ๋์ ๋ด๋ ๋ชจ๋์ ๋ถ๋ฆฌํ๊ณ ๋ด๋ถ ์์ง๋๋ฅผ ๋์ด๋ฉฐ, ๊ฒฐํฉ๋๋ฅผ ์ต์ํํ๋ ๊ธฐ์ค์ด ๋ฉ๋๋ค [6, 9].
-
-## โ๏ธ Trade-offs & Caveats
-์์ค์ ๊ด๋ จ ์ ๋ณด๊ฐ ๋ถ์กฑํฉ๋๋ค. (๋จ, ๋ฐ์ด๋๋ ์ปจํ
์คํธ๋ค์ด ์์ ํ ๋ถ๋ฆฌ๋์ด ์๋ํ๊ธฐ ๋๋ฌธ์, ์ฌ๋ฌ ์ปจํ
์คํธ ๊ฐ์ ์ํธ ๊ด๊ณ(Interrelationships)๋ฅผ ๋ช
์์ ์ผ๋ก ์ ์ํ๊ณ ์กฐ์จํ๊ธฐ ์ํด์๋ '์ปจํ
์คํธ ๋งคํ(Context Mapping)'์ด๋ผ๋ ์ถ๊ฐ์ ์ธ ๊ฐ์ด๋ ์ฅ์น๊ฐ ์๋ฐ๋์ด์ผ ํ๋ค๋ ์ ์ด ์ ํ์ ์ผ๋ก ์ธ๊ธ๋์ด ์์ต๋๋ค [3, 7].)
-
-## ๐ Knowledge Connections
-
-### Related Concepts
-
-#### [์ค๊ณ ์ฒ ํ/์ํคํ
์ฒ]
-- [[๋๋ฉ์ธ ์ฃผ๋ ์ค๊ณ (DDD)]]
- - ์ฐ๊ฒฐ ์ด์ : ๋ฐ์ด๋๋ ์ปจํ
์คํธ๋ ๋ณต์กํ ๋น์ฆ๋์ค ๋ก์ง์ ์ํํธ์จ์ด์ ์ค์ฌ์ ๋๋ DDD(Domain-Driven Design)์ ๊ฐ์ฅ ํต์ฌ์ ์ธ ์ค๊ณ ํจํด(ํ์ ๋๋ฉ์ธ ๋ถํ )์ด๊ธฐ ๋๋ฌธ์
๋๋ค [1, 10].
- - ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ์ํํธ์จ์ด ์์คํ
์ด ๊ธฐ์ ์คํ ์ค์ฌ์ด ์๋๋ผ ์ค์ ๋น์ฆ๋์ค ๋๋ฉ์ธ(ํ์ค ์ธ๊ณ)์ ์ค์ฌ์ผ๋ก ๋ชจ๋ธ๋ง๋๊ณ ์ฝ๋๋ฒ ์ด์ค๊ฐ ๊ตฌ์ถ๋๋ ๊ทผ๋ณธ ์๋ฆฌ๋ฅผ ์ดํดํ ์ ์์ต๋๋ค [5, 10].
-
-- [[๋ง์ดํฌ๋ก์๋น์ค ์ํคํ
์ฒ (Microservices Architecture)]]
- - ์ฐ๊ฒฐ ์ด์ : ๋ฐ์ด๋๋ ์ปจํ
์คํธ๋ ๊ฑฐ๋ํ๊ณ ๋จ์ผํ ์์คํ
์ ๋
๋ฆฝ์ ์ผ๋ก ๋ฐฐํฌ ๋ฐ ํ์ฅ ๊ฐ๋ฅํ ๋ง์ดํฌ๋ก์๋น์ค๋ ๋ชจ๋ํ ๋ชจ๋๋ฆฌ์ค๋ก ๋ถํดํ ๋ ๊ธฐ์ค์ด ๋๋ '๋น์ฆ๋์ค ๋๋ฉ์ธ ๊ฒฝ๊ณ'๋ฅผ ์ ๊ณตํ๊ธฐ ๋๋ฌธ์
๋๋ค [6, 11].
- - ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ๊ฑฐ๋ํ ์ฝ๋๋ฒ ์ด์ค๋ฅผ ์ํธ ๋
๋ฆฝ์ ์ธ ์๋น์ค๋ค๋ก ๋๋ ๋ ๋ฐ์ดํฐ์ ๊ธฐ๋ฅ์ด ์ด๋ป๊ฒ ๋ฌถ์ฌ์ผ ๊ฒฐํฉ๋๋ฅผ ๋ฎ์ถ ์ ์๋์ง์ ๋ํ ์์คํ
๋ถ์ฐ ์ ๋ต์ ํ์
ํ ์ ์์ต๋๋ค [6, 11, 12].
-
-#### [๊ตฌ์กฐ/๊ตฌํ ํจํด]
-- [[์ ๋น์ฟผํฐ์ค ์ธ์ด (Ubiquitous Language)]]
- - ์ฐ๊ฒฐ ์ด์ : ํ๋์ ๋ฐ์ด๋๋ ์ปจํ
์คํธ ๋ด์ ๋ชจ๋ธ ์์์ฑ์ ์ ์งํ๊ธฐ ์ํด ๋ชจ๋ ๊ตฌ์ฑ์(๊ฐ๋ฐ์, ๋น์ฆ๋์ค ์ ๋ฌธ๊ฐ)์ด ์ฝ๋์ ๋ํ์์ ๊ณตํต์ผ๋ก ์ฌ์ฉํ๋ ์ดํ์ง์ด๊ธฐ ๋๋ฌธ์
๋๋ค [3, 10].
- - ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ์ฝ๋๋ฒ ์ด์ค ๋ด๋ถ์ ๋ณ์, ํจ์, ํด๋์ค ๋ช
๋ช
๊ท์น์ด ์ด๋ค ๋น์ฆ๋์ค์ ํฉ์๋ฅผ ๊ฑฐ์ณ ์ง์ด์ก๋์ง ๋ช
ํํ ๋งฅ๋ฝ์ ํ์
ํ ์ ์์ต๋๋ค [3, 6, 13].
-
-- [[์ ๊ทธ๋ฆฌ๊ฑฐํธ (Aggregates)]]
- - ์ฐ๊ฒฐ ์ด์ : ๋ฐ์ด๋๋ ์ปจํ
์คํธ(ํด๋) ๋ด๋ถ๋ฅผ ๊ตฌ์ฑํ๋ DDD์ ์ธ๋ถ ์ค๊ณ ํจํด ์ค ํ๋๋ก, ๋จ์ผ ๋จ์๋ก ์ทจ๊ธ๋๋ ๋๋ฉ์ธ ๊ฐ์ฒด์ ๊ตฐ์ง์ด๊ธฐ ๋๋ฌธ์
๋๋ค [1, 4].
- - ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ๋ฐ์ด๋๋ ์ปจํ
์คํธ ๋ด๋ถ์ ์ฌ๋ฌ ๊ฐ์ฒด(์ํฐํฐ ๋ฑ)๋ค์ด ์ด๋ป๊ฒ ํธ๋์ญ์
์ ์ผ๊ด์ฑ์ ์ ์งํ๋ฉฐ ๊ทธ๋ฃนํ๋์ด ์๋์ง ์ธ๋ถ์ ์ธ ์ฝ๋ ๊ตฌํ ํจํด์ ์ถ์ ํ ์ ์์ต๋๋ค [1, 4].
-
-### Deeper Research Questions
-
-- ์ฌ๋ฌ ๊ฐ์ ๋ฐ์ด๋๋ ์ปจํ
์คํธ๊ฐ ์ํธ์์ฉํด์ผ ํ ๋, ์ปจํ
์คํธ ๋งคํ(Context Mapping)์ ์ฝ๋๋ฒ ์ด์ค์์ ์ด๋ ํ ์ธํฐํ์ด์ค๋ ํต์ ๊ท์ฝ์ผ๋ก ๊ตฌ์ฒดํ๋๋๊ฐ?
-- ๋๊ท๋ชจ ๋ ๊ฑฐ์ ๋ชจ๋๋ฆฌ์ค ์ฝ๋๋ฅผ ๋ถ์ํ์ฌ ๋ฐ์ด๋๋ ์ปจํ
์คํธ ๋จ์๋ก ์ฌ๊ตฌ์ฑ(๋ชจ๋๋์ด์ ์ด์
)ํ ๋, ์จ๊ฒจ์ง ๋ฐ์ดํฐ ์์กด์ฑ์ ์ด๋ป๊ฒ ์์ ํ๊ฒ ๋์ด๋ผ ์ ์๋๊ฐ?
-- ํํฅ์(Top-Down) ๋๋ ์ํฅ์(Bottom-Up)์ผ๋ก ์ฝ๋๋ฅผ ํ์ํ ๋, ๋ฐ์ด๋๋ ์ปจํ
์คํธ ํด๋ ๊ตฌ์กฐ๋ ์ ๋ณด ์ถ์ ๊ฒฝ๋ก์ ์ธ์ง์ ๋ถํ๋ฅผ ์ด๋ป๊ฒ ๊ฐ์์ํค๋๊ฐ?
-- ์ ๋น์ฟผํฐ์ค ์ธ์ด๊ฐ ์๋ก ๋ค๋ฅธ ๋ฐ์ด๋๋ ์ปจํ
์คํธ์์ ์ค๋ณต๋๊ฑฐ๋ ๋ค๋ฅด๊ฒ ํด์๋ ๋(์: '๊ณ ๊ฐ'์ด๋ผ๋ ๋จ์ด์ ์๋ฏธ ์ถฉ๋), ์ฝ๋ ๋ช
๋ช
๊ท์น๊ณผ ๋ฐ์ดํฐ ๋ชจ๋ธ์ ์ด๋ฅผ ์ด๋ป๊ฒ ๊ตฌ๋ถํ๋๊ฐ?
-- ๋ฐ์ด๋๋ ์ปจํ
์คํธ ๋ด๋ถ๋ฅผ ๊ตฌ์ฑํ๋ ์ ๊ทธ๋ฆฌ๊ฑฐํธ(Aggregates), ์ํฐํฐ(Entities), ๊ฐ ๊ฐ์ฒด(Value Objects) ๊ฐ์ ์์กด์ฑ ํ๋ฆ์ ๊ฐ์ฅ ํจ์จ์ ์ผ๋ก ํ์
ํ๋ ์ฝ๋ ๋ฆฌ๋ฉ ์์๋ ๋ฌด์์ธ๊ฐ?
-
-### Practical Application Contexts
-
-- **Implementation:** ๋น์ฆ๋์ค ๊ธฐ๋ฅ์ ์ฝ๋๋ก ๊ตฌํํ ๋ ํน์ ๊ธฐ๋ฅ์ ํ์ํ ๋ฆฌ์์ค์ ํด๋์ค๋ฅผ ๋ชจ๋ ํ๋์ ํจํค์ง(์ปจํ
์คํธ) ์์ ์ง์ค์์ผ ๊ฒฐํฉ๋๋ฅผ ๋ฎ์ถ๊ณ ๋ชจ๋ํ๋ ๊ตฌํ์ ์งํํฉ๋๋ค [3, 6, 14].
-- **System Design:** ์ด์ปค๋จธ์ค ๋ฑ ๋ณต์กํ ์ํํธ์จ์ด ์์คํ
์ ์ค๊ณํ ๋ '์ฃผ๋ฌธ ์ฒ๋ฆฌ', '์ธ๋ฒคํ ๋ฆฌ', '์ฌ์ฉ์ ๊ด๋ฆฌ' ๋ฑ ๊ฐ๊ฐ์ ์ปจํ
์คํธ ๊ฒฝ๊ณ๋ฅผ ๋ช
ํํ ๋ถ๋ฆฌํ์ฌ, ์๋ก ์ํฅ์ ์ฃผ์ง ์๋ ๋ชจ๋ํ ๋ชจ๋๋ฆฌ์ค๋ ๋ง์ดํฌ๋ก์๋น์ค ๊ตฌ์กฐ๋ฅผ ๋์ถํฉ๋๋ค [2, 5, 6].
-- **Operation / Maintenance:** ๊ฐ๋ณ ๋ถ๋ถ์ด ์๋ฒฝํ ๋ถ๋ฆฌ๋์ด ์์ผ๋ฏ๋ก ์์คํ
์ ์ง๋ณด์ ์ ๋ฒ๊ทธ๊ฐ ๋ฐ์ํ ์์ญ์ ๋ฐ์ด๋๋ ์ปจํ
์คํธ ๋ด์์๋ง ์ ๋ ํ
์คํธ ๋ฐ ์์ ์์
์ ์งํํ ์ ์์ด ์์ ์ ์ธ ์ด์์ด ๊ฐ๋ฅํฉ๋๋ค [8].
-- **Learning Path:** ๋ณต์กํ ๋๊ท๋ชจ ์ฝ๋๋ฒ ์ด์ค์ ์จ๋ณด๋ฉํ๋ ๊ฐ๋ฐ์๋ ๊ฐ์ฅ ๋จผ์ ์ฝ๋์ ๋๋ ํ ๋ฆฌ(ํด๋)๊ฐ ์ด๋ค ๋น์ฆ๋์ค ๋ฐ์ด๋๋ ์ปจํ
์คํธ๋ก ๋ถ๋ฅ๋์ด ์๋์ง ํ์
ํจ์ผ๋ก์จ ์์คํ
์ค๊ณ ์๋๋ฅผ ๊ฑฐ์์ ์ผ๋ก ์ธ์งํ๊ณ ์ฝ๋ ๋
ํด์ ์ฐฉ์ํฉ๋๋ค [4].
-- **My Project Relevance:** ๋ฐฉ๋ํ ๋ ๊ฑฐ์ ๋๋ ๋ง์ดํฌ๋ก์๋น์ค ์ฝ๋๋ฅผ ๋ถ์ํ๊ฑฐ๋ ๋ฆฌ๋ทฐํด์ผ ํ ๋, ์ฝ๋๊ฐ ์ฒ ์ ํ๊ฒ ๋น์ฆ๋์ค ๋๋ฉ์ธ(๋ฐ์ด๋๋ ์ปจํ
์คํธ)์ ๊ธฐ์ค์ผ๋ก ์์ง๋ ฅ์ ๊ฐ์ถ๊ณ ์๋์ง ํ๊ฐํ๊ณ ๋ถ๋ฆฌํ๋ ๋ฆฌํฉํ ๋ง ์ ๋ต์ ์๋ฆฝํ๋ ๋ฐ ์ ์ฉํ ์ ์์ต๋๋ค.
-
-### Adjacent Topics
-
-- [[ํด๋ฆฐ ์ํคํ
์ฒ (Clean Architecture)]]
- - ํ์ฅ ๋ฐฉํฅ: ๋น์ฆ๋์ค ์ค์ฌ์ ๋ฐ์ด๋๋ ์ปจํ
์คํธ๋ฅผ ๊ตฌํํ ๋, ํต์ฌ ๋๋ฉ์ธ ๋น์ฆ๋์ค ๋ก์ง์ ์ธ๋ถ์ ๋ฐ์ดํฐ๋ฒ ์ด์ค๋ ํ๋ ์์ํฌ๋ก๋ถํฐ ๋
๋ฆฝ์ํค๊ณ ๋ณดํธํ๋ ์์กด์ฑ ๊ท์น(Dependency Rule)์ ๋ํด ์ถ๊ฐ๋ก ํ์ตํฉ๋๋ค [4, 15].
-- [[์ฝ๋๋ฒ ์ด์ค ์ค๋ฆฌ์ํ
์ด์
๋งต (Codebase Orientation Map)]]
- - ํ์ฅ ๋ฐฉํฅ: ์๋ณ๋ ๋ฐ์ด๋๋ ์ปจํ
์คํธ ๋จ์์ ๋๋ ํ ๋ฆฌ ๊ตฌ์กฐ์ ํ์ผ ๊ฐ์ ๊ด๊ณ๋ฅผ ํ๋์ ๋ณผ ์ ์๋๋ก ์๊ฐํํ์ฌ, ํ์๋ค์ ์์คํ
๊ตฌ์กฐ ํ์
๊ณผ ์ฝ๋ ํ์ ํจ์จ์ฑ์ ๊ทน๋ํํ๋ ๋ฌธ์ํ ์ ๋ต์ ํ๊ตฌํฉ๋๋ค [16, 17].
-
----
-*Last updated: 2026-05-02*
-## ๐งช ๊ฒ์ฆ ์ํ (Validation)
-- **์ ๋ณด ์ํ:** verified
-- **์ถ์ฒ ์ ๋ขฐ๋:** A
-- **๊ฒํ ์ด์ :** Datacollector์์ ์๋ ์ถ์ถ๋ ์ํค ๋ฐ์ดํฐ์ ์ด๊ธฐ ํตํฉ.
-
-## ๐งฌ ์ค๋ณต ๊ฒ์ฌ (Duplicate Check)
-- **๊ธฐ์กด ์ ์ฌ ๋ฌธ์:** [[แแ
กแแ
ฎแซแแ
ตแแ
ณ แแ
ฅแซแแ
ฆแจแแ
ณแแ
ณ (Bounded Context).md]]
-- **์ฒ๋ฆฌ ๋ฐฉ์:** UPDATE
-- **์ฒ๋ฆฌ ์ด์ :** ๊ธฐ์กด ๋ฌธ์ ๋ด์ฉ ๋ณด๊ฐ ๋ฐ v3.1 ํ์ค ์ ์ฉ
diff --git a/10_Wiki/Topics/02_Architecture_Principles/์์กด์ฑ ์ญ์ (Dependency Inversion).md b/10_Wiki/Topics/02_Architecture_Principles/์์กด์ฑ ์ญ์ (Dependency Inversion).md
deleted file mode 100644
index 9b92ac14..00000000
--- a/10_Wiki/Topics/02_Architecture_Principles/์์กด์ฑ ์ญ์ (Dependency Inversion).md
+++ /dev/null
@@ -1,80 +0,0 @@
----
-id: P-REINFORCE-WIKI-2FA6CA41
-title: "แแ
ดแแ
ฉแซแแ
ฅแผ แแ
งแจแแ
ฅแซ (Dependency Inversion)"
-category: "10_Wiki/๐ก Topics/02_Architecture_Principles"
-status: verified
-canonical_id: ""
-aliases: []
-duplicate_of: ""
-source_trust_level: A
-confidence_score: 0.95
-tags: ['Dependency Inversion']
-raw_sources: ["Datacollector_MAC/out_wiki/แแ
ดแแ
ฉแซแแ
ฅแผ แแ
งแจแแ
ฅแซ (Dependency Inversion).md"]
-last_reinforced: 2026-05-02
-github_commit: ""
----
-
-# [[แแ
ดแแ
ฉแซแแ
ฅแผ แแ
งแจแแ
ฅแซ (Dependency Inversion)]]
-
-## ๐ Brief Summary
-**์์กด์ฑ ์ญ์ (Dependency Inversion Principle, DIP)**์ ์์ ์์ค์ ๋ชจ๋์ด ํ์ ์์ค์ ๋ชจ๋์ ์ง์ ์์กดํ์ง ์๊ณ , ์์ชฝ ๋ชจ๋ **์ถ์ํ(Abstractions)**์ ์์กดํ๋๋ก ์ค๊ณํด์ผ ํ๋ค๋ ๊ฐ์ฒด ์งํฅ ํ๋ก๊ทธ๋๋ฐ์ ํต์ฌ ์์น์ด๋ค [1]. ์ด๋ ์ฃผ๋ก ์์กด์ฑ ์ฃผ์
(Dependency Injection, DI) ํ๋ ์์ํฌ๋ฅผ ํตํด ๊ตฌํ๋๋ฉฐ ์ปดํฌ๋ํธ ๊ฐ์ ๊ฒฐํฉ๋๋ฅผ ํ๊ธฐ์ ์ผ๋ก ๋ฎ์ถ๋ค [1-3]. ๋ณต์กํ ์ฝ๋๋ฒ ์ด์ค ๋ด์์ ํด๋ฆฐ ์ํคํ
์ฒ๋ ํฅ์ฌ๊ณ ๋ ์ํคํ
์ฒ๋ฅผ ๊ตฌํํ ๋ ํต์ฌ์ ์ผ๋ก ์์ฉํ์ฌ, ์์คํ
์ ๋น์ฆ๋์ค ๋ก์ง์ด ์ธ๋ถ ๊ธฐ์ ์ ์ข
์๋์ง ์๋๋ก ๋ณดํธํ๋ค [4, 5].
-
-## ๐ Core ์ถ์ํ Content
-- **์ถ์ํ ์ค์ฌ์ ์์กด์ฑ ๊ด๋ฆฌ:** ๋์ ์์ค์ ๋ชจ๋(High-level modules)์ ๋ฎ์ ์์ค์ ๋ชจ๋(Low-level modules)์ ์์กดํด์๋ ์ ๋๋ฉฐ, ๋ ๋ชจ๋ ๋ชจ๋ ์ธํฐํ์ด์ค์ ๊ฐ์ ์ถ์ํ์ ์์กดํด์ผ ํ๋ค [1]. ์ปดํฌ๋ํธ๊ฐ '์ด๋ป๊ฒ' ์ํํ๋์ง(๊ตฌํ) ์ฝ๋๋ฅผ ์์ฑํ๊ธฐ ์ ์ '๋ฌด์์' ํด์ผ ํ๋์ง(์ธํฐํ์ด์ค)๋ฅผ ๋จผ์ ์ ์ํ๋ ์ค๊ณ ์ ๊ทผ ๋ฐฉ์์ด ์ด๋ฅผ ๊ฐ๋ฅํ๊ฒ ํ๋ค [2].
-- **ํด๋ฆฐ ์ํคํ
์ฒ ๋ด์์์ ์ญํ :** ํต์ฌ ๋น์ฆ๋์ค ๋ก์ง์ด UI๋ ๋ฐ์ดํฐ๋ฒ ์ด์ค ๊ฐ์ ์ธ๋ถ ํ๋ ์์ํฌ์ ๋
๋ฆฝ์ ์ผ๋ก ์กด์ฌํ๋๋ก ๋ง๋ ๋ค [4, 5]. ๋ด๋ถ ๊ณ์ธต์ ์ธํฐํ์ด์ค(ํฌํธ)๋ฅผ ์ ์ํ๊ณ , ์ธ๋ถ ๊ณ์ธต์ด ์ด์ ๋ํ ๊ตฌ์ฒด์ ์ธ ๊ตฌํ์ฒด(์ด๋ํฐ)๋ฅผ ์ ๊ณตํ๋๋ก ์์กด์ฑ์ ๋ฐฉํฅ์ ๊ฐ์ ๋ก ์์ชฝ์ผ๋ก ํฅํ๊ฒ ํ์ฌ ๋ด๋ถ ์ฝ๋๋ฅผ ์ธ๋ถ ๋ณ๊ฒฝ์ผ๋ก๋ถํฐ ๊ฒฉ๋ฆฌํ๋ค [4].
-- **์์กด์ฑ ์ฃผ์
(Dependency Injection)์ ํตํ ๊ฒฐํฉ๋ ๊ฐ์:** ์์ ๊ณ์ธต์ด ํ์ ๊ณ์ธต์ ์ธ์คํด์ค๋ฅผ ์ง์ ์์ฑํ์ง ์๊ณ ์ธ๋ถ๋ก๋ถํฐ ์ฃผ์
(Injected)๋ฐ๊ฒ ํจ์ผ๋ก์จ, ๋์จํ ๊ฒฐํฉ(Loose coupling)์ ๋ณด์ฅํ๋ค [3]. ๋ฐํ์์ ์์กด์ฑ์ด ์ฐ๊ฒฐ๋๋ฏ๋ก ๊ตฌํ์ฒด๋ฅผ ์ฝ๊ฒ ๊ต์ฒดํ ์ ์์ผ๋ฉฐ, ์ด๋ ํน์ ํ๋ ์์ํฌ๋ ๋ฐ์ดํฐ๋ฒ ์ด์ค ๊ธฐ์ ์ข
์์ฑ์ ์ ๊ฑฐํ์ฌ ๋
๋ฆฝ์ ์ธ ํ
์คํธ ๋ฐ ์ ์ง๋ณด์๋ฅผ ๊ฐ๋ฅํ๊ฒ ํ๋ค [3, 4, 6].
-
-## โ๏ธ Trade-offs & Caveats
-์์กด์ฑ ์ญ์ ์์น์ ์์คํ
์ ๋์
ํ๋ฉด ๊ณ ๋๋ก ์ ์ฐํ๊ณ ํ
์คํธ ๊ฐ๋ฅํ ์ฝ๋๋ฅผ ์ป์ ์ ์์ง๋ง, ๋ฐ๋๊ธ๋ถ๋ก **๊ตฌํ ๋ณต์ก์ฑ(Implementation Complexity)**์ด ๋์์ง๋ ์ ์ฝ ์ฌํญ์ด ์กด์ฌํ๋ค [7]. ์ถ์ํ ๊ณ์ธต์ด ์ถ๊ฐ๋๊ณ ์๊ฒฉํ ์์กด์ฑ ๋ฐฉํฅ ๊ท์น์ ๊ฐ์ ํด์ผ ํ๋ฏ๋ก, ์๋ จ๋ ๊ฐ๋ฐ ์ญ๋๊ณผ ๋์ ์์ค์ ์ค๊ณ ๊ท์จ(Design discipline)์ด ์๊ตฌ๋๋ค [4, 7]. ๋ํ Spring(Java)์ด๋ ASP.NET Core์ ๊ฐ์ DI ํ๋ ์์ํฌ๋ฅผ ์ฌ๋ฐ๋ฅด๊ฒ ๋ค๋ฃฐ ์ ์๋ ์ง์์ด ํ์์ ์ด๋ฉฐ, ์ฝ๋ ์์์ ์ง์ ์ ์ธ ํธ์ถ ํ๋ฆ์ ์จ๊ธฐ๊ธฐ ๋๋ฌธ์ ๋ฐํ์์ ๊ฒฐํฉ ๊ด๊ณ๋ฅผ ์ง๊ด์ ์ผ๋ก ํ์
ํ๊ธฐ ์ด๋ ค์์ง ์ ์๋ค [2, 7].
-
-## ๐ Knowledge Connections
-
-### Related Concepts
-
-#### [์ํคํ
์ฒ ๋ฐ ์ค๊ณ ์์น]
-- [[SOLID ์์น (SOLID Principles)]]
- - ์ฐ๊ฒฐ ์ด์ : ์์กด์ฑ ์ญ์ ์ ๊ฐ์ฒด ์งํฅ ํ๋ก๊ทธ๋๋ฐ์ ๊ทผ๊ฐ์ ์ด๋ฃจ๋ SOLID ์ค๊ณ ์์น์ 5๊ฐ์ง ์ค ๋ง์ง๋ง(D) ์์น์ ํด๋นํ๊ธฐ ๋๋ฌธ์ด๋ค [8].
- - ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ๋จ์ผ ์ฑ
์(SRP)์ด๋ ๊ฐ๋ฐฉ-ํ์ ์์น(OCP) ๋ฑ ๋ค๋ฅธ ์์น๋ค์ด ์์กด์ฑ ์ญ์ ๊ณผ ์ด๋ป๊ฒ ์ํธ์์ฉํ์ฌ ์์คํ
์ ์ ์ฐํ๊ณ ํ์ฅ ๊ฐ๋ฅํ๊ฒ ๋ง๋๋์ง ๊ฑฐ์์ ๊ด์ ์ ์ ๊ณตํ๋ค [1, 2, 8].
-- [[ํด๋ฆฐ ์ํคํ
์ฒ (Clean Architecture)]]
- - ์ฐ๊ฒฐ ์ด์ : ์์ค ์ฝ๋์ ์์กด์ฑ์ด ์ค์ง ๋ด๋ถ ๋น์ฆ๋์ค ๋ก์ง๋ง์ ํฅํ๋๋ก(Dependency Rule) ๊ฐ์ ํ๋ ํด๋ฆฐ ์ํคํ
์ฒ์ ์ค์ฌ์ ์์กด์ฑ ์ญ์ ์ด ํ์์ ์ผ๋ก ์ฌ์ฉ๋๊ธฐ ๋๋ฌธ์ด๋ค [4, 5].
- - ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ๋ณต์กํ ๋๊ท๋ชจ ์ฝ๋๋ฒ ์ด์ค์์ ๋น์ฆ๋์ค ๋ก์ง๊ณผ ์ธํ๋ผ/ํ๋ ์์ํฌ ์ฝ๋๋ฅผ ์ด๋ป๊ฒ ๋ฌผ๋ฆฌ์ , ๋
ผ๋ฆฌ์ ์ผ๋ก ๊ฒฉ๋ฆฌ์ํค๋์ง ์ดํดํ ์ ์๋ค [4, 9].
-
-#### [๊ตฌํ ๋ฐ ํ์ฉ ๋๊ตฌ]
-- [[์์กด์ฑ ์ฃผ์
(Dependency Injection)]]
- - ์ฐ๊ฒฐ ์ด์ : ์์กด์ฑ ์ญ์ ์์น์ ์ค์ ์ํํธ์จ์ด ์ฝ๋ ๋ ๋ฒจ์์ ์คํํ๋ ๊ฐ์ฅ ๋ณดํธ์ ์ด๊ณ ๊ตฌ์ฒด์ ์ธ ๋ฐฉ๋ฒ๋ก ์ด๋ค [1, 3].
- - ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ํ์ ๋ชจ๋์ด ์์ ๋ชจ๋๋ก ์ด๋ป๊ฒ '์ฃผ์
'๋๋์ง, ํ๋ ์์ํฌ(Spring ๋ฑ)๊ฐ ๋ฐํ์์ ์ด๋ป๊ฒ ๊ฐ์ฒด์ ์๋ช
์ฃผ๊ธฐ์ ๋ฐ์ธ๋ฉ์ ์ค์ผ์คํธ๋ ์ด์
ํ๋์ง ํ์
ํ ์ ์๋ค [2-4].
-- [[์ธํฐํ์ด์ค์ ํฌํธ/์ด๋ํฐ (Interfaces and Ports/Adapters)]]
- - ์ฐ๊ฒฐ ์ด์ : ์ถ์ํ์ ์์กดํ๊ธฐ ์ํด ๋ด๋ถ ๊ณ์ธต์ ์ธํฐํ์ด์ค(ํฌํธ)๋ฅผ ์ ์ํ๊ณ , ์ธ๋ถ์ ๊ตฌ์ฒด์ ๊ตฌํ(์ด๋ํฐ)์ ๋์ด ์์กด์ฑ์ ์ญ์ ์ํค๋ ๊ตฌํ ํจํด์ด๊ธฐ ๋๋ฌธ์ด๋ค [4, 5].
- - ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ์ฝ๋๋ฒ ์ด์ค๋ฅผ ์ฝ์ ๋ ์ธํฐํ์ด์ค ์ ์ธ๋ถ์ ์ค์ ๊ตฌํ๋ถ๊ฐ ๋ถ๋ฆฌ๋ ๊ตฌ์กฐ๋ฅผ ํด์ํ๊ณ ์ปดํฌ๋ํธ ๊ฐ ํต์ ๊ท์ฝ์ ์ดํดํ๋ ๋ฐฉ๋ฒ๋ก ์ ์ ๊ณตํ๋ค [4, 5].
-
-### Deeper Research Questions
-- ์์ ๋ชจ๋๊ณผ ํ์ ๋ชจ๋์ด ๋ชจ๋ ์ถ์ํ๋ ์ธํฐํ์ด์ค์๋ง ์์กดํ ๋, ์ ํ๋ฆฌ์ผ์ด์
๋ฐํ์์ ๊ตฌ์ฒด์ ์ธ ๊ตฌํ์ฒด(Concrete Implementation)๋ค์ ์ด๋ค ๋ฉ์ปค๋์ฆ์ ํตํด ์์ ํ๊ฒ ๋ฐ์ธ๋ฉ(Wiring)๋๋๊ฐ?
-- ๋๊ท๋ชจ ๋ ๊ฑฐ์ ๋ชจ๋๋ฆฌ์ ์ฝ๋๋ฒ ์ด์ค์์ ๊ฐํ๊ฒ ๊ฒฐํฉ๋ ์ฝ๋๋ค์ ๋ถ๋ฆฌํ์ฌ ์์กด์ฑ ์ญ์ ์์น์ ์ ์ง์ ์ผ๋ก ์ ์ฉ(Refactoring)ํ๋ ค ํ ๋ ๋ง์ฃผํ๋ ๊ธฐ์ ์ ๋๊ด๊ณผ ํด๊ฒฐ์ฑ
์ ๋ฌด์์ธ๊ฐ?
-- ์คํ๋ง(Spring)๊ณผ ๊ฐ์ DI ํ๋ ์์ํฌ์ ๋์
์ด ์์กด์ฑ ๊ด๋ฆฌ์ ํธ์์ฑ์ ๋์ฌ์ฃผ๋ ๋ฐ๋ฉด, ์ฝ๋๋ฒ ์ด์ค์ ์ ์ ํ์์ ์ด๋ ต๊ฒ ๋ง๋๋ ๋ฐํ์ ๋ฐ์ธ๋ฉ์ ๋ณต์ก์ฑ์ ์ด๋ป๊ฒ ์์ํ ์ ์๋๊ฐ?
-- ์์กด์ฑ ์ญ์ ์ ํตํด ๋ชจ๋ ๊ฐ ๊ฒฐํฉ๋๋ฅผ ๋ฎ์ถ๋ ๊ฒ์ด ๋จ์ ํ
์คํธ(Unit Testing) ํ๊ฒฝ ๊ตฌ์ฑ ๋ฐ ๋ชจ์ ๊ฐ์ฒด(Mock Object) ํ์ฉ์ ์ ํํ ์ด๋ค ๊ตฌ์กฐ์ ์ด์ ์ ์ ๊ณตํ๋๊ฐ?
-- ๋๋ฉ์ธ ์ฃผ๋ ์ค๊ณ(DDD)์ ํด๋ฆฐ ์ํคํ
์ฒ ํ๊ฒฝ์์ ์์กด์ฑ ์ญ์ ์ด ๋ฌด๋ถ๋ณํ๊ฒ ์ ์ฉ๋์์ ๋ ๋ฐ์ํ ์ ์๋ ์ค๋ฒ์์ง๋์ด๋ง(Over-engineering)์ ๊ฒฝ๊ณ๋ ์ด๋ป๊ฒ ํ๋จํด์ผ ํ๋๊ฐ?
-
-### Practical Application Contexts
-- **Implementation:** ์ฝ๋๋ฅผ ์์ฑํ ๋, ์์กด์ฑ ์ญ์ ์์น์ ๋ฐ๋ผ ์ปดํฌ๋ํธ๊ฐ ์ํํ '์ธํฐํ์ด์ค'๋ฅผ ์ฐ์ ์ ์ผ๋ก ์ ์ํ๊ณ , ๊ตฌ์ฒด์ ์ธ ์๋ ๋ฐฉ์(๊ตฌํ์ฒด)์ ์ธ๋ถ๋ก๋ถํฐ ์์กด์ฑ ์ฃผ์
(DI)์ ๋ฐ๋๋ก ์ฝ๋ฉํ๋ค [1, 2].
-- **System Design:** ๊ณ์ธตํ ์ํคํ
์ฒ๋ ํด๋ฆฐ ์ํคํ
์ฒ ์ค๊ณ ์, ํต์ฌ ๋๋ฉ์ธ ๋ก์ง์ด ์ธ๋ถ DB๋ UI์ ์์กดํ์ง ์๊ฒ๋ ์ธํฐํ์ด์ค ๊ฒฝ๊ณ๋ฅผ ์ค์ ํ์ฌ ์์คํ
์ด ํ๋ ์์ํฌ์ ๊ตฌ์ ๋ฐ์ง ์๋๋ก ์ค๊ณํ๋ค [4, 5].
-- **Operation / Maintenance:** ์์กด์ฑ ์ญ์ ์ ํตํด ๊ฐ ๊ณ์ธต์ ๋
๋ฆฝ์ ์ผ๋ก ๋ถ๋ฆฌํ์ผ๋ฏ๋ก, ๋ฐ์ดํฐ๋ฒ ์ด์ค ๋ง์ด๊ทธ๋ ์ด์
์ด๋ ํน์ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ๊ต์ฒด ์ ํต์ฌ ๋น์ฆ๋์ค ๋ก์ง์ ์ ํ ์์ ํ ํ์๊ฐ ์์ด ์ ์ง๋ณด์์ฑ์ด ๊ทน๋ํ๋๋ค [3, 4, 6].
-- **Learning Path:** ๋ณต์กํ ์์ค ์ฝ๋๋ฅผ ์ฝ๊ณ ๋ถ์ํ ๋, ๊ตฌ์ฒด์ ์ธ ํด๋์ค ํธ์ถ ํ๋ฆ๋ง์ ๋ฐ๋ผ๊ฐ๋ ๋์ '์ถ์ํ๋ ์ธํฐํ์ด์ค'์ ์ด๋ฅผ ๊ตฌํํ๋ '์ด๋ํฐ ํจํค์ง' ๊ตฌ์กฐ๋ฅผ ๋จผ์ ์ฐพ์ ๋น์ฆ๋์ค์ ์๋์ ๊ธฐ์ ์ ๊ตฌํ์ ๋ถ๋ฆฌํด์ ํ์
ํ๋ ํ๋ จ์ด ํ์ํ๋ค [1, 5, 8].
-- **My Project Relevance:** '์ฝ๋๋ฒ ์ด์ค ์ฝ๊ธฐ ์ง์'์ ๋์ด๊ธฐ ์ํด, ๋๊ท๋ชจ ํ๋ก์ ํธ์ ์์กด์ฑ์ด ์ด๋ป๊ฒ ์ญ์ ๋์ด ์๋์ง ํ์
ํด์ผ ํ๋ค. ์ธํฐํ์ด์ค ์ ์ธ๋ถ๋ฅผ ํตํด ์์คํ
์ ํฐ ๊ทธ๋ฆผ(Top-Down)์ ์ธ์งํ๊ณ , ์์กด์ฑ ์ฃผ์
์ค์ ์ ์ญ์ถ์ ํ์ฌ ๋ฐํ์์ ๊ฒฐํฉ๋๋ ๊ตฌ์ฒด ํด๋์ค(Bottom-Up)๋ฅผ ๋ถ์ํ๋ ๋งตํ ์ญ๋์ด ์ฝ๋ ๊ตฌ์กฐ ํ์
์ ์ฑํจ๋ฅผ ๊ฐ๋ฅธ๋ค [1, 5, 10].
-
-### Adjacent Topics
-- [[๋จ์ผ ์ฑ
์ ์์น (Single Responsibility Principle, SRP)]]
- - ํ์ฅ ๋ฐฉํฅ: ํด๋์ค๋ ๋ชจ๋์ ๋จ์ผ ์ฑ
์์ ๋จผ์ ๋ช
ํํ ์ ์ํด์ผ [1], ์์กด์ฑ ์ญ์ ์ ์ด๋ค ์ญํ ์ ์ธํฐํ์ด์ค๋ฅผ ์ถ์ถํ์ฌ ์ฃผ์
ํ ์ง ํจ๊ณผ์ ์ผ๋ก ์ค๊ณํ ์ ์๋ค๋ ์ํธ๋ณด์์ ๊ด์ ์ผ๋ก ์ดํด๋ฅผ ํ์ฅํ ์ ์๋ค [1, 2].
-- [[ํ
์คํธ ์ฉ์ด์ฑ ๊ธฐ๋ฐ ์ํคํ
์ฒ (Testability in Architecture)]]
- - ํ์ฅ ๋ฐฉํฅ: ์์กด์ฑ ์ญ์ ์ ํตํด ์ฝ๋ ๋ด ์ธ๋ถ ์์กด์ฑ์ ๊ฒฉ๋ฆฌํจ์ผ๋ก์จ, ํ
์คํธ ๋๋ธ(Test Double)์ ์ฃผ์
ํด ๊ณ ๋ฆฝ๋ ์ํ์์ ์์ ๋น์ฆ๋์ค ๋ก์ง์ ๋จ์ ํ
์คํธํ๋ ๊ธฐ๋ฒ์ผ๋ก ํ์ต์ ํ์ฅํ ์ ์๋ค [3, 4, 6].
-
----
-*Last updated: 2026-05-02*
-## ๐งช ๊ฒ์ฆ ์ํ (Validation)
-- **์ ๋ณด ์ํ:** verified
-- **์ถ์ฒ ์ ๋ขฐ๋:** A
-- **๊ฒํ ์ด์ :** Datacollector์์ ์๋ ์ถ์ถ๋ ์ํค ๋ฐ์ดํฐ์ ์ด๊ธฐ ํตํฉ.
-
-## ๐งฌ ์ค๋ณต ๊ฒ์ฌ (Duplicate Check)
-- **๊ธฐ์กด ์ ์ฌ ๋ฌธ์:** [[แแ
ดแแ
ฉแซแแ
ฅแผ แแ
งแจแแ
ฅแซ (Dependency Inversion).md]]
-- **์ฒ๋ฆฌ ๋ฐฉ์:** UPDATE
-- **์ฒ๋ฆฌ ์ด์ :** ๊ธฐ์กด ๋ฌธ์ ๋ด์ฉ ๋ณด๊ฐ ๋ฐ v3.1 ํ์ค ์ ์ฉ
diff --git a/10_Wiki/Topics/02_Architecture_Principles/ํด๋ฆฐ ์ํคํ
์ฒ (Clean Architecture).md b/10_Wiki/Topics/02_Architecture_Principles/ํด๋ฆฐ ์ํคํ
์ฒ (Clean Architecture).md
deleted file mode 100644
index ed6a3d5d..00000000
--- a/10_Wiki/Topics/02_Architecture_Principles/ํด๋ฆฐ ์ํคํ
์ฒ (Clean Architecture).md
+++ /dev/null
@@ -1,67 +0,0 @@
----
-id: P-REINFORCE-WIKI-9A9A2669
-category: "10_Wiki/๐ก Topics/02_Architecture_Principles"
-confidence_score: 0.95
-tags: ['ํด๋ฆฐ-์ํคํ
์ฒ-(clean-architecture)', 'ํฅ์ฌ๊ณ ๋ -์ํคํ
์ฒ-(hexagonal-architecture)', '๊ณ์ธตํ-์ํคํ
์ฒ-(layered-architecture)', '์์กด์ฑ-์ญ์ -์์น-(dependency-inversion-principle)', '๋ง์ดํฌ๋ก์๋น์ค-์ํคํ
์ฒ-(microservices-architecture)', 'architecture-principles']
-last_reinforced: 2026-05-02
----
-
-# [[ํด๋ฆฐ ์ํคํ
์ฒ (Clean Architecture)]]
-
-## ๐ Brief Summary
-๋ก๋ฒํธ C. ๋งํด(Robert C. Martin)์ด ๋์คํํ ํด๋ฆฐ ์ํคํ
์ฒ๋ ์ํํธ์จ์ด๋ฅผ ์ฌ๋ฌ ์ถ์ํ ์์ค์ ๋ํ๋ด๋ ๋์ฌ์ ๊ณ์ธต์ผ๋ก ๊ตฌ์ฑํ๋ ์ค๊ณ ํจ๋ฌ๋ค์์
๋๋ค [1]. ์ด ์ํคํ
์ฒ์ ํต์ฌ ๋ชฉ์ ์ ๋ฐ์ดํฐ๋ฒ ์ด์ค, UI, ํ๋ ์์ํฌ์ ๊ฐ์ ์ธ๋ถ ๊ธฐ์ ์์๋ก๋ถํฐ ์ ํ๋ฆฌ์ผ์ด์
์ ํต์ฌ ๋น์ฆ๋์ค ๊ท์น์ ์๋ฒฝํ๊ฒ ๊ฒฉ๋ฆฌํ๊ณ ๋ณดํธํ๋ ๊ฒ์
๋๋ค [1, 2]. ์์กด์ฑ์ ํญ์ ์ธ๋ถ์์ ๋ด๋ถ๋ก๋ง ํฅํด์ผ ํ๋ค๋ ์๊ฒฉํ ๊ท์น์ ์ ์ฉํ์ฌ, ์ฅ๊ธฐ์ ์ธ ์ ์ง๋ณด์์ฑ๊ณผ ๊ธฐ์ ๋
๋ฆฝ์ฑ, ๊ทธ๋ฆฌ๊ณ ๋ฐ์ด๋ ํ
์คํธ ์ฉ์ด์ฑ์ ์ ๊ณตํฉ๋๋ค [3].
-
-## ๐ Core Content
-- **๋์ฌ์ ๊ตฌ์กฐ์ 4๊ฐ์ง ๊ณ์ธต**: ํด๋ฆฐ ์ํคํ
์ฒ๋ ์ผ๋ฐ์ ์ผ๋ก 4๊ฐ์ ๋์ฌ์ ๊ณ์ธต์ผ๋ก ๋๋ฉ๋๋ค.
- - **์ํฐํฐ(Entities)**: ๊ฐ์ฅ ์์ชฝ์ ์์นํ๋ฉฐ ๊ธฐ์ ์ด๋ ํน์ ์ ์ค์ผ์ด์ค์ ์ฝ๋งค์ด์ง ์๋ ํต์ฌ์ ์ด๊ณ ์ฌ์ฌ์ฉ ๊ฐ๋ฅํ ๋น์ฆ๋์ค ๊ท์น์ ์บก์ํํฉ๋๋ค [2].
- - **์ ์ค์ผ์ด์ค(Use Cases)**: ์ ํ๋ฆฌ์ผ์ด์
์ ํนํ๋ ๋น์ฆ๋์ค ๊ท์น์ ํฌํจํ๋ฉฐ, ์ํฐํฐ๋ฅผ ์ค๊ฐ๋ ๋ฐ์ดํฐ์ ํ๋ฆ์ ์กฐ์จํฉ๋๋ค [2].
- - **์ธํฐํ์ด์ค ์ด๋ํฐ(Interface Adapters)**: ์ ์ค์ผ์ด์ค๋ ์ํฐํฐ์ ๊ฐ์ฅ ํธ๋ฆฌํ ๋ฐ์ดํฐ ํ์์ ์น, ๋ฐ์ดํฐ๋ฒ ์ด์ค, UI ๋ฑ์ ์ธ๋ถ ๊ธฐ๊ด์ด ์๊ตฌํ๋ ํ์์ผ๋ก ๋ณํํ๋ ์ญํ ์ ํฉ๋๋ค [2].
- - **ํ๋ ์์ํฌ ๋ฐ ๋๋ผ์ด๋ฒ(Frameworks and Drivers)**: ๊ฐ์ฅ ๋ฐ๊นฅ์ชฝ ๊ณ์ธต์ผ๋ก, ์น ํ๋ ์์ํฌ, ๋ฐ์ดํฐ๋ฒ ์ด์ค, ๋ฉ์์ง ์์คํ
๋ฑ์ ์ธ๋ถ ๋๊ตฌ์ ๊ธฐ์ ์ ํฌํจํฉ๋๋ค [2].
-- **์์กด์ฑ ๊ท์น(Dependency Rule)**: ํด๋ฆฐ ์ํคํ
์ฒ์ ๊ฐ์ฅ ์ค์ํ ์์น์ ์์กด์ฑ์ด ๋ฐ๋์ '๋ฐ๊นฅ์ชฝ์์ ์์ชฝ์ผ๋ก๋ง' ํฅํด์ผ ํ๋ค๋ ๊ฒ์
๋๋ค [3, 4]. ์ธ๋ถ ๊ณ์ธต์ ๋ด๋ถ ๊ณ์ธต์ ์์กดํ์ง๋ง, ๋ด๋ถ ๊ณ์ธต์ ์ธ๋ถ์ ๋ฐ์ดํฐ ํ์์ด๋ ๊ธฐ์ ๊ตฌํ์ ์ ํ ์์ง ๋ชปํฉ๋๋ค [3, 5].
-- **๋ณด์ ๋ฐ ๊ท์ ์ค์ ํฅ์**: ์ธ๋ถ ์์คํ
๊ณผ ๋๋ฉ์ธ ๋ก์ง์ ๊ฒฉ๋ฆฌํ์ฌ ๋ฐฉ์ด์ ์ธ ์ค๊ณ๊ฐ ๊ฐ๋ฅํด์ง๋๋ค [5]. ์
๋ ฅ๊ฐ ์ ํจ์ฑ ๊ฒ์ฌ, ์ธ์ฆ ๋ฐ ์ธ๊ฐ๋ ์ด๋ํฐ ๊ณ์ธต์ ์ง์ค๋์ด ์
์์ ์ธ ํ์ด๋ก๋๋ SQL ์ธ์ ์
์ ์ํ์ ์ค์ด๊ณ ํต์ฌ ๋ก์ง์ ๋ณดํธํฉ๋๋ค [5]. ๋ํ, ์กฐ์ ๋ ์ ๊ทผ ์ ์ด๋ฅผ ํตํด GDPR์ด๋ HIPAA์ ๊ฐ์ ๊ท์ ์ค์ ํ๋ ์์ํฌ๋ฅผ ์ฝ๊ฒ ์ถฉ์กฑ์ํฌ ์ ์์ต๋๋ค [6].
-- **๋๋ฉ์ธ ์ค์ฌ(Domain-centric)์ ๊ตฌ์กฐ**: ๊ธฐ์กด์ ์ ํต์ ์ธ ๊ณ์ธตํ ์ํคํ
์ฒ(Layered Architecture)๊ฐ ํํฅ์(Presentation โ Business โ Database)์ผ๋ก ๊ตฌ์ฑ๋์๋ค๋ฉด, ํด๋ฆฐ ์ํคํ
์ฒ๋ ๋น์ฆ๋์ค ๋๋ฉ์ธ์ด ์ค์ฌ์ด ๋์ด ์์ชฝ ๊ธฐ์ ์์๋ก๋ถํฐ ๋ณดํธ๋ฐ๋ ๊ตฌ์กฐ(Presentation โ Business โ Database)๋ฅผ ์งํฅํฉ๋๋ค [7].
-
-## โ๏ธ Trade-offs & Caveats
-- **๊ณผ๋ํ ์ค๋ฒํค๋์ ๋ณต์ก์ฑ**: ๋๊ท๋ชจ ์ํฐํ๋ผ์ด์ฆ ์์คํ
์์๋ ์ฅ๊ธฐ์ ์ธ ์ ์ง๋ณด์์ฑ์ ์ ๊ณตํ์ฌ ํฐ ์ด์ ์ ์ฃผ์ง๋ง, ๋จ์ํ ํ๋ก์ ํธ๋ ์คํํธ์
์ ๋น ๋ฅธ MVP(Minimum Viable Product) ๊ฐ๋ฐ์ ์ ์ฉํ๊ธฐ์๋ ์ด๊ธฐ ์ค์ ๊ณผ ์๊ฒฉํ ๊ณ์ธต ๊ตฌ์กฐ๊ฐ ๊ณผ๋ํ ์ค๋ฒํค๋๋ฅผ ์ ๋ฐํฉ๋๋ค [8-10].
-- **๋ณด์ผ๋ฌํ๋ ์ดํธ ์ฝ๋ ์ฆ๊ฐ**: ๊ฐ ๊ณ์ธต๋ง๋ค ๋ฐ์ดํฐ ๋ชจ๋ธ(๋๋ ๊ฐ ๊ฐ์ฒด)์ ๋
๋ฆฝ์ ์ผ๋ก ์ ์ํ๊ณ ์ด๋ฅผ ๋ณํ(Mapping)ํ๋ ๊ณผ์ ์ด ํ์ํ๊ธฐ ๋๋ฌธ์, ์ด๊ธฐ์๋ ํจํค์ง๋ง๋ค ๋ณต์ฌ-๋ถ์ฌ๋ฃ๊ธฐ ํ ๊ฒ๊ณผ ๊ฐ์ ์ ์ฌํ ๋ณด์ผ๋ฌํ๋ ์ดํธ(Boilerplate) ์ฝ๋๊ฐ ๋ค์ ๋ฐ์ํ ์ ์์ต๋๋ค [4].
-- **๊ฐํ๋ฅธ ํ์ต ๊ณก์ **: ์ถ์ํ, ๋์์ธ ํจํด ๋ฑ์ ๋ํ ๋์ ์ดํด๋์ ์์น์ ์ค์ํ๊ธฐ ์ํ ์๊ฒฉํ ๊ท์จ์ด ์๊ตฌ๋๋ฏ๋ก, ๊ฒฝํ์ด ๋ถ์กฑํ ์ฃผ๋์ด ํ์๊ฒ๋ ๋์
๊ณผ ์ ์ง๊ฐ ์ด๋ ค์ธ ์ ์์ต๋๋ค [8, 11].
-
-## ๐ Knowledge Connections
-
-### Related Concepts
-
-#### [๊ด๊ณ ์ ํ A: ์ํคํ
์ฒ/๊ธฐ๋ฐ ๊ธฐ์ ]
-- [[ํฅ์ฌ๊ณ ๋ ์ํคํ
์ฒ (Hexagonal Architecture)]]
- - ์ฐ๊ฒฐ ์ด์ : ํด๋ฆฐ ์ํคํ
์ฒ๋ ํฅ์ฌ๊ณ ๋ ์ํคํ
์ฒ์ ํฌํธ์ ์ด๋ํฐ(Ports and Adapters) ๊ฐ๋
์ ์์ฉํ๊ณ ๋ ๊ตฌ์ฒดํํ ํํ์ด๋ฉฐ, ์ธ๋ถ ์ธํ๋ผ๋ก๋ถํฐ ํต์ฌ ๋ก์ง์ ๊ฒฉ๋ฆฌํ๋ค๋ ์ฒ ํ์ ์ง์ ์ ์ผ๋ก ๊ณต์ ํฉ๋๋ค [1, 12].
- - ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ์ด๋ป๊ฒ ์ธ๋ถ ์ธ๊ณ์ ๋ณ๊ฒฝ(๋ฐ์ดํฐ๋ฒ ์ด์ค ๋ณ๊ฒฝ, API ํต์ ๋ฐฉ์ ๋ณ๊ฒฝ)์๋ ์ ํ๋ฆฌ์ผ์ด์
์ฝ์ด๊ฐ ์ํฅ์ ๋ฐ์ง ์๋๋ก ํ๋ฌ๊ทธ ์ค ํ๋ ์ด(Plug-and-play) ๋ฐฉ์์ ์ ์ฐ์ฑ์ ํ๋ณดํ ์ ์๋์ง ํ์
ํ ์ ์์ต๋๋ค [13].
-- [[๊ณ์ธตํ ์ํคํ
์ฒ (Layered Architecture)]]
- - ์ฐ๊ฒฐ ์ด์ : ํด๋ฆฐ ์ํคํ
์ฒ๊ฐ ๊ทน๋ณตํ๊ณ ์ ํ๋ ๋ฌธ์ ์ (์๊ฐ์ด ์ง๋จ์ ๋ฐ๋ฅธ ์ปดํฌ๋ํธ ๊ฐ ๊ฐํ ๊ฒฐํฉ ๋ฐ ๋น์ฆ๋์ค ๋ก์ง ๋ถ์ฐ)์ ์ดํดํ๊ธฐ ์ํ ๊ธฐ๋ณธ ๋์กฐ๊ตฐ ์ํคํ
์ฒ์
๋๋ค [7, 8, 14].
- - ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ์ํคํ
์ฒ๋ฅผ ๋งคํฌ๋ก ๊ด์ (ํ ๋ฐ ์กฐ์ง ๊ตฌ์กฐ ๋งคํ)์์ ๋ฐ๋ผ๋ณด๋ ๊ฒ๊ณผ, ํต์ฌ ๋น์ฆ๋์ค ๋ ์ด์ด ๋ด๋ถ๋ฅผ ๋ณดํธํ๊ธฐ ์ํ ๋ง์ดํฌ๋ก ๊ด์ ์ค๊ณ์ ์ฐจ์ด๋ฅผ ์ดํดํ ์ ์์ต๋๋ค [15, 16].
-
-#### [๊ด๊ณ ์ ํ B: ๊ตฌํ/ํ์ฉ ๋๊ตฌ]
-- [[์์กด์ฑ ์ญ์ ์์น (Dependency Inversion Principle)]]
- - ์ฐ๊ฒฐ ์ด์ : ์ธ๋ถ ์ด๋ํฐ(๋ฐ์ดํฐ๋ฒ ์ด์ค ๋ฑ)๊ฐ ๋ด๋ถ ์ธํฐํ์ด์ค(๋๋ฉ์ธ)์ ์์กดํ๋๋ก ์์กด์ฑ ๋ฐฉํฅ์ ๋ค์ง์ด(Inversion), ํด๋ฆฐ ์ํคํ
์ฒ์ ํต์ฌ์ธ '์์กด์ฑ ๊ท์น'์ ์ฝ๋๋ก ์คํ์ํค๋ ์๋ฆฌ์
๋๋ค [17, 18].
- - ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ์ธํฐํ์ด์ค๋ฅผ ๋น์ฆ๋์ค ๋ก์ง ์ชฝ์ ์ ์ํ๊ณ ๊ตฌํ์ ์ธํ๋ผ ์์ญ์ ๋ ์ผ๋ก์จ ๊ฒฐํฉ๋๋ฅผ ์ด๋ป๊ฒ ๊ทน์ ์ผ๋ก ๋ฎ์ถ๋์ง ์ ์ ์์ต๋๋ค.
-
-### Deeper Research Questions
-- ํด๋ฆฐ ์ํคํ
์ฒ๋ฅผ ์ ์ฉํ ๋ ๊ฐ ๊ณ์ธต์ ํต๊ณผํ๋ฉฐ ๋ฐ์ํ๋ ๊ฐ์ฒด ๋งคํ(Mapping) ์ค๋ฒํค๋์ ๋ณด์ผ๋ฌํ๋ ์ดํธ ์ฝ๋๋ฅผ ์ต์ํํ๋ฉด์๋ ๊ณ์ธต์ ๋
๋ฆฝ์ฑ์ ๋ณด์ฅํ๋ ์ค์ฉ์ ์ธ ์ค๊ณ ์ ๋ต์ ๋ฌด์์ธ๊ฐ?
-- ๋๊ท๋ชจ ๋ณต์ก์ฑ์ ๋ค๋ฃจ๊ธฐ ์ํ ํด๋ฆฐ ์ํคํ
์ฒ๋ฅผ ์์ ๋จ์๋ก ์ชผ๊ฐ์ง '๋ง์ดํฌ๋ก์๋น์ค' ๋ด๋ถ์ ์ ์ฉํ๋ ๊ฒ์ด ์ฑ๋ฅ ๋ฐ ๊ฐ๋ฐ ์๋ ์ธก๋ฉด์์ ํญ์ ํฉ๋ฆฌ์ ์ธ๊ฐ? (๋ง์ดํฌ๋ก์๋น์ค์ ํด๋ฆฐ ์ํคํ
์ฒ์ ๊ฒฐํฉ ํ๊ณ)
-- ์คํํธ์
ํ๊ฒฝ์์ ๊ฐ๋ฐ ์๋๋ฅผ ์ํด ๊ณ์ธตํ ์ํคํ
์ฒ๋ก ์์ํ ์์คํ
์ ์์คํ
์ฑ์ฅ์ ๋ง์ถฐ ์ ์ง์ ์ผ๋ก ํด๋ฆฐ ์ํคํ
์ฒ๋ก ๋ฆฌํฉํ ๋งํ๋ ๋จ๊ณ๋ณ ์ ๊ทผ๋ฒ์ ๋ฌด์์ธ๊ฐ?
-- ์์กด์ฑ ์ญ์ ์์น(DIP) ๊ตฌํ ์ DI(Dependency Injection) ์ปจํ
์ด๋์ ๋ํ ์์กด์ด ์ํคํ
์ฒ์ ํ๋ ์์ํฌ ๋
๋ฆฝ์ฑ์ ํด์น ์ ์๋ ๋๋ ๋ง๋ฅผ ์ด๋ป๊ฒ ํด๊ฒฐํ ์ ์๋๊ฐ?
-- ๋ฐ์ดํฐ๋ฒ ์ด์ค๋ ์ธ๋ถ API ๊ฐ์ ์ธ๋ถ ๊ตฌํ ๊ธฐ์ ์ด ์ ํ ์ ํด์ง์ง ์์ ํ๋ก์ ํธ ์ด๊ธฐ ๋จ๊ณ์, ํด๋ฆฐ ์ํคํ
์ฒ์ ์ํฐํฐ์ ์ ์ค์ผ์ด์ค๋ง์ ์ฌ์ฉํ์ฌ ๋น์ฆ๋์ค ๋ก์ง์ ๊ตฌ์ถํ๊ณ ํ
์คํธํ๋ ๊ตฌ์ฒด์ ์ฌ๋ก๋ ์ด๋ ํ๊ฐ?
-
-### Practical Application Contexts
-- **Implementation:** ์ธํ๋ผ ์ค์ ์ ์ด๋ผ๋ ์ํฐํฐ์ ์ ์ค์ผ์ด์ค๋ฅผ ๋จผ์ ์ฝ๋ฉํ๊ณ , ์ธ๋ฉ๋ชจ๋ฆฌ(in-memory) ๊ตฌํ์ฒด๋ฅผ ์ฌ์ฉํ์ฌ ๋๋ฉ์ธ ๋ก์ง์ ๋ํ ์์ํ ์ ๋ ํ
์คํธ๋ฅผ ๋น ๋ฅด๊ณ ์์ ์ ์ผ๋ก ์คํํ๋ ํ๊ฒฝ์ ๊ตฌ์ถํฉ๋๋ค [19].
-- **System Design:** ๋ณด์ ๋ฐ ๊ฐ์ฌ ์๊ตฌ์ฌํญ์ด ๋์ ์๋ฃ ๋ฐ์ดํฐ ์์คํ
(HIPAA ์ค์ ๋ฑ)์ด๋ ๊ธ๋ก๋ฒ ๊ธ์ต ๋ฑ
ํน ํ๋ซํผ ์ค๊ณ ์, ๊ท์ ๋ก์ง๊ณผ ์ธ๋ถ ์ธํฐํ์ด์ค ์ด๋ํฐ๋ฅผ ์ค์ ํต์ฌ ๋น์ฆ๋์ค ๋ก์ง์ผ๋ก๋ถํฐ ๋ถ๋ฆฌํ๊ธฐ ์ํด ์ ๊ทน ๋์
ํฉ๋๋ค [5, 6, 20].
-- **Operation / Maintenance:** ์๋น์ค ์ค์ธ ์์คํ
์ UI ํ๋ ์์ํฌ๋ฅผ ๋ณ๊ฒฝํ๊ฑฐ๋(์: React์์ Angular๋ก), ๊ธฐ์กด ์์ฉ ๋ฐ์ดํฐ๋ฒ ์ด์ค๋ฅผ ์คํ์์ค(์: Oracle์์ PostgreSQL)๋ก ์ด๊ดํด์ผ ํ ๋, ๋ด๋ถ ๋น์ฆ๋์ค ๋ก์ง์ ์์ ์์ด ์ต์ธ๊ณฝ ์ด๋ํฐ๋ง ๊ต์ฒดํ์ฌ ์์ ์ ์ธ ์ด์ ๋ง์ด๊ทธ๋ ์ด์
์ ๋์ต๋๋ค [3, 20, 21].
-- **Learning Path:** ๋จ์ MVC ๋๋ ๊ณ์ธตํ ์ํคํ
์ฒ์์ ์ถ๋ฐํ์ฌ ํ๊ณ๋ฅผ ๊ฒฝํํ ๊ฐ๋ฐ์๊ฐ SOLID ์์น(ํนํ ์์กด์ฑ ์ญ์ )์ ํจ์ฉ์ฑ์ ๊นจ๋ซ๊ณ , ์ ์ฐํ๊ณ ํ
์คํธ ๊ฐ๋ฅํ ์ํํธ์จ์ด ์ค๊ณ๋ฅผ ํ์ตํ๋ ๊ณ ๊ธ ๊ณผ์ ์ ์์นํฉ๋๋ค.
-- **My Project Relevance:** ๋์ ํ๋ก์ ํธ๊ฐ ์ฅ๊ธฐ์ ์ธ ์๋ช
์ฃผ๊ธฐ๋ฅผ ๊ฐ์ง๋ฉฐ ๋น์ฆ๋์ค ๋ก์ง์ด ๊ณ ๋๋ก ๋ณต์กํ ๊ฒฝ์ฐ ์ฑํํ ์ ์์ผ๋, ๋ง์ฝ ๋น ๋ฅธ ์๊ฐ ์์ ๊ธฐ๋ฅ ๊ฒ์ฆ์ด ๋ชฉํ์ธ ์ด๊ธฐ MVP ํ๋ก์ ํธ๋ผ๋ฉด ๋์
์ด ์ค๋ฒ์์ง๋์ด๋ง์ผ ์ ์์ด ์ ์คํ ํ๋จ์ด ํ์ํฉ๋๋ค [9, 22].
-
-### Adjacent Topics
-- [[๋ง์ดํฌ๋ก์๋น์ค ์ํคํ
์ฒ (Microservices Architecture)]]
- - ํ์ฅ ๋ฐฉํฅ: ์์คํ
์ ์ฌ๋ฌ ์๋น์ค๋ก ๋ถํ ํ ๋ค, ๋ณต์กํ ๋น์ฆ๋์ค ๋ก์ง์ ์ง๋ ๊ฐ๋ณ ๋ง์ดํฌ๋ก์๋น์ค '๋ด๋ถ'์ ๊ฒฌ๊ณ ํจ์ ํ๋ณดํ๊ธฐ ์ํด ํด๋ฆฐ/ํฅ์ฌ๊ณ ๋ ์ค๊ณ ์ฌ์์ ์ด๋ป๊ฒ ๊ฒฐํฉํ๋์ง ํ์ฅํ์ฌ ์ฐ๊ตฌํ ์ ์์ต๋๋ค [21].
-- [[๋๋ฉ์ธ ์ฃผ๋ ์ค๊ณ (Domain-Driven Design, DDD)]]
- - ํ์ฅ ๋ฐฉํฅ: ํด๋ฆฐ ์ํคํ
์ฒ์ ์ฝ์ด์ธ '์ํฐํฐ'์ '์ ์ค์ผ์ด์ค'๋ฅผ ํ๋ถํ๊ณ ์ ์๋ฏธํ๊ฒ ์ค๊ณํ๊ธฐ ์ํด, ๋น์ฆ๋์ค ๋๋ฉ์ธ์ ํ์ํ๊ณ ๋ฐ์ด๋๋ ์ปจํ
์คํธ(Bounded Context)๋ฅผ ๋ชจ๋ธ๋งํ๋ ๊ตฌ์ฒด์ ์ธ ์ํํธ์จ์ด ๊ณตํ ๊ธฐ๋ฒ์ผ๋ก ํ์ต์ด ์ด์ด์ง๋๋ค.
-
----
-*Last updated: 2026-05-02*
\ No newline at end of file
diff --git a/10_Wiki/Topics/02_Software_Engineering/์ ์ ์ ํ๋ฆฌ์ผ์ด์
๋ณด์ ํ
์คํธ (SAST).md b/10_Wiki/Topics/02_Software_Engineering/์ ์ ์ ํ๋ฆฌ์ผ์ด์
๋ณด์ ํ
์คํธ (SAST).md
deleted file mode 100644
index 2edeff49..00000000
--- a/10_Wiki/Topics/02_Software_Engineering/์ ์ ์ ํ๋ฆฌ์ผ์ด์
๋ณด์ ํ
์คํธ (SAST).md
+++ /dev/null
@@ -1,86 +0,0 @@
----
-id: P-REINFORCE-WIKI-66B2389E
-title: "แแ
ฅแผแแ
ฅแจ แแ
ขแแ
ณแฏแ
แ
ตแแ
ฆแแ
ตแแ
งแซ แแ
ฉแแ
กแซ แแ
ฆแแ
ณแแ
ณ (SAST)"
-category: "10_Wiki/๐ก Topics/02_Software_Engineering"
-status: verified
-canonical_id: ""
-aliases: []
-duplicate_of: ""
-source_trust_level: A
-confidence_score: 0.95
-tags: ['SAST']
-raw_sources: ["Datacollector_MAC/out_wiki/แแ
ฅแผแแ
ฅแจ แแ
ขแแ
ณแฏแ
แ
ตแแ
ฆแแ
ตแแ
งแซ แแ
ฉแแ
กแซ แแ
ฆแแ
ณแแ
ณ (SAST).md"]
-last_reinforced: 2026-05-02
-github_commit: ""
----
-
-# [[แแ
ฅแผแแ
ฅแจ แแ
ขแแ
ณแฏแ
แ
ตแแ
ฆแแ
ตแแ
งแซ แแ
ฉแแ
กแซ แแ
ฆแแ
ณแแ
ณ (SAST)]]
-
-## ๐ Brief Summary
-์ ์ ์ ํ๋ฆฌ์ผ์ด์
๋ณด์ ํ
์คํธ(SAST, Static Application Security Testing)๋ ์ ํ๋ฆฌ์ผ์ด์
์ ์คํํ์ง ์์ ์ํ(at rest)์์ ์์ค ์ฝ๋์ ๊ตฌ์กฐ์ ๊ตฌ๋ฌธ์ ๋ถ์ํ์ฌ ์ค๋ฅ, ๋ณด์ ์ทจ์ฝ์ ๋ฐ ์ฝ๋ฉ ๋นํจ์จ์ฑ์ ์๋์ผ๋ก ์ฐพ์๋ด๋ ์ํํธ์จ์ด ๋ถ์ ๊ธฐ์ ์
๋๋ค [1-3]. ์ด ๊ธฐ์ ์ ๊ฐ๋ฐ ์๋ช
์ฃผ๊ธฐ(SDLC) ์ด๊ธฐ์ ๋ฒ๊ทธ์ ์์ ํ์ง ์์ ํจํด์ ํ์งํ์ฌ, ๊ฒฐํจ์ด ํ๋ก๋์
ํ๊ฒฝ์ ๋๋ฌํ๊ธฐ ์ ์ ์ ์ ์ ์ผ๋ก ๋ฌธ์ ๋ฅผ ํด๊ฒฐํ๋๋ก ๋์ต๋๋ค [1, 4, 5].
-
-## ๐ Core Content
-* **์๋ ๋ฐฉ์ ๋ฐ ๋ชฉ์ **: SAST ๋๊ตฌ๋ ๋ฐํ์ ํ๊ฒฝ ์์ด ์ ์ ์ผ๋ก ์ฝ๋๋ฅผ ์ค์บํ์ฌ ์ ์๋์ง ์์ ๋ณ์, SQL ์ธ์ ์
, ํฌ๋ก์ค ์ฌ์ดํธ ์คํฌ๋ฆฝํ
(XSS), ๋ฒํผ ์ค๋ฒํ๋ก์ฐ์ ๊ฐ์ ๋ณด์ ๊ฒฐํจ๊ณผ ์ฝ๋ ์ค๋ฉ(Code smell)์ ์๋ณํฉ๋๋ค [1, 3, 6]. ์ผ๋ถ ์ํฐํ๋ผ์ด์ฆ ๋๊ตฌ๋ ์ทจ์ฝ์ ์ ์ ๋ฐํ๊ฒ ํ์
ํ๊ธฐ ์ํด ๋ฐ์ดํฐ ํ๋ฆ(Data-flow) ๋ถ์ ๋ฐ ๊ธฐํธ ์คํ(Symbolic execution)๊ณผ ๊ฐ์ ๊ณ ๊ธ ๊ธฐ์ ์ ํ์ฉํฉ๋๋ค [7].
-* **์ฃผ์ ์ด์ **: ๋ณด์ ๊ฒฐํจ์ ๋ฐฐํฌ ์ (์ด๊ธฐ ๊ฐ๋ฐ ๋จ๊ณ)์ ๋ฐ๊ฒฌํจ์ผ๋ก์จ, ๋ฆด๋ฆฌ์ค ์ดํ์ ์ทจ์ฝ์ ์ ์์ ํ๋ ๊ฒ๋ณด๋ค ์๊ฐ๊ณผ ๋น์ฉ์ ํฌ๊ฒ ์ ๊ฐํ ์ ์์ต๋๋ค [4, 5]. ๋ํ, ๊ฐ๋ฐํ ์ ์ฒด์ ์ผ๊ด๋ ์ฝ๋ฉ ํ์ค์ ์ ์ฉํ์ฌ ์ฝ๋ ํ์ง์ ํฅ์์ํค๋ฉฐ, PCI DSS, HIPAA, GDPR๊ณผ ๊ฐ์ ์ฐ์
๊ท์ ๋ฐ ๋ณด์ ์ปดํ๋ผ์ด์ธ์ค(Compliance) ์ค์ ์๊ฑด์ ์ถฉ์กฑํ๋ ๊ฐ์ฌ ์ฆ๊ฑฐ๋ฅผ ์ ๊ณตํฉ๋๋ค [4, 5, 8].
-* **AI ๋ฐ ์ต์ ๊ธฐ์ ๊ณผ์ ๊ฒฐํฉ**: ์ต์ SAST ๋๊ตฌ๋ค์ ์์ฑํ AI ๋ฐ ๋จธ์ ๋ฌ๋ ๊ธฐ์ ๊ณผ ๊ฒฐํฉํ์ฌ ์ถ์ ๊ตฌ๋ฌธ ํธ๋ฆฌ(AST) ๋ถ์์ ๊ณ ๋ํํ๊ณ ์์ต๋๋ค [9-11]. ์ด๋ฅผ ํตํด ์คํ(False Positives)์ ์ค์ด๊ณ , ์ต์คํ๋ก์ ๊ฐ๋ฅ์ฑ(Exploitability)์ด ๋์ ์ํ์ ์ฐ์ ์์๋ฅผ ๋ถ์ฌํ๋ฉฐ, ํ ๋ฆฌํ์คํธ(PR) ์์์ ์ทจ์ฝ์ ์ ์๋์ผ๋ก ์์ (Autofix)ํ๋ ์ ์์ ์ ๊ณตํ์ฌ ๋ณด์ ์ ๊ฒ์ ํจ์จ์ฑ์ ๊ทน๋ํํฉ๋๋ค [9, 10, 12].
-* **์ํฌํ๋ก์ฐ ํตํฉ (DevSecOps)**: ์ฐ์ํ SAST ๋๊ตฌ๋ ๊ฐ๋ฐ์์ IDE, ๋ฒ์ ๊ด๋ฆฌ ์์คํ
(GitHub ๋ฑ), CI/CD ํ์ดํ๋ผ์ธ์ ๋งค๋๋ฝ๊ฒ ํตํฉ๋์ด ๊ฐ๋ฐ ํ๋ฆ์ ๋ฐฉํดํ์ง ์๊ณ ๋ฐฑ๊ทธ๋ผ์ด๋์์ ์ค์๊ฐ ํ์ง ๊ฒ์ดํธ(Quality gates) ์ญํ ์ ์ํํฉ๋๋ค [13-15].
-
-## โ๏ธ Trade-offs & Caveats
-* **์คํ๋ฅ (False Positives)๊ณผ ๊ฒฝ๊ณ ํผ๋ก**: ์ ์ ๋ถ์ ๋๊ตฌ๋ ๊ตฌ์กฐ์ ํ๊ณ๋ก ์ธํด ์ค์ ์ทจ์ฝ์ ์ด ์๋ ์ฝ๋๋ฅผ ์ํ์ผ๋ก ์๋ชป ํ์งํ๋ ์คํ๋ฅ ์ด ๋ฐ์ํ๊ธฐ ์ฝ์ต๋๋ค [16, 17]. ์ง๋์น๊ฒ ๋ง์ ์คํ์ ๊ฐ๋ฐ์์ ๊ฒฝ๊ณ ํผ๋ก(Alert fatigue)๋ฅผ ์ ๋ฐํ๊ณ ๋๊ตฌ์ ๋ํ ์ ๋ขฐ๋ฅผ ๋จ์ด๋จ๋ฆฌ๋ฉฐ ์์ ์์
์ ์๋๋ฅผ ์ ํ์ํฌ ์ ์์ต๋๋ค [16, 17]. ์ด๋ฅผ ๋ฐฉ์งํ๊ธฐ ์ํด ๋๊ตฌ์ ์ปจํ
์คํธ ํํฐ๋ง ๋ฐ AI ๊ธฐ๋ฐ์ ์ฐ์ ์์ ์ง์ ๊ธฐ๋ฅ์ด ์๊ตฌ๋ฉ๋๋ค [12, 17].
-* **์ค์บ ์๋์ ์ฑ๋ฅ ํ๊ณ**: ๋ถ์์ ๊น์ด์ ์ ๋ฐ๋๊ฐ ๋์์๋ก ์ฝ๋ ์ค์บ์ ์์๋๋ ์๊ฐ์ด ๊ธธ์ด์ ธ ๋น๋ ์๊ฐ๊ณผ ํ์ดํ๋ผ์ธ ์ฑ๋ฅ์ ๋ถ์ ์ ์ธ ์ํฅ์ ๋ฏธ์น ์ ์์ต๋๋ค [11, 17]. ๋ฐ๋ผ์ ๊ฐ๋ฐํ์ ์ ํ๋๋ ๋์ง๋ง ๋๋ฆฐ ์ค์บ(์์ฝ ์ค์บ)๊ณผ, ๋น ๋ฅด์ง๋ง ๊ฐ๋ฒผ์ด ์ค์๊ฐ ์ค์บ ๋๊ตฌ ์ฌ์ด์์ ์ ์ ํ ๊ท ํ(Trade-off)์ ๋ง์ถฐ์ผ ํฉ๋๋ค [17].
-* **์ฌ์ฉ์ ์ ์ ๊ท์น์ ๊ด๋ฆฌ ๋น์ฉ**: ๋ง์ SAST ๋๊ตฌ(์: Semgrep, Checkmarx)๋ ์กฐ์ง์ ํน์ํ ํ๊ฒฝ์ ๋ง๊ฒ ๊ท์น์ ์์ฑํ๊ณ ์ฌ์ฉ์ ์ ์(Customization)ํ ์ ์๋ ๊ธฐ๋ฅ์ ์ ๊ณตํฉ๋๋ค [18, 19]. ํ์ง๋ง ์ด๋ฅผ ํจ๊ณผ์ ์ผ๋ก ๊ตฌ์ถํ๊ณ ์ ์ง๋ณด์ํ๊ธฐ ์ํด์๋ ๊ฐํ๋ฅธ ํ์ต ๊ณก์ ๊ณผ ์ง์์ ์ธ ํ๋ ์ธ๋ ฅ์ด ํ์ํ๋ค๋ ๋จ์ ์ด ์์ต๋๋ค [11, 12, 20].
-
-## ๐ Knowledge Connections
-
-### Related Concepts
-
-#### [์ํํธ์จ์ด ๋ณด์ ๋ถ์ ๊ธฐ์ ]
-* [[๋์ ์ ํ๋ฆฌ์ผ์ด์
๋ณด์ ํ
์คํธ (DAST)]]
- * ์ฐ๊ฒฐ ์ด์ : SAST๊ฐ ์ฝ๋๋ฅผ ์คํํ์ง ์๊ณ ์ ์ ์ผ๋ก ๋ถ์ํ๋ ๋ฐ๋ฉด, DAST๋ ์คํ ์ค์ธ ์ ํ๋ฆฌ์ผ์ด์
์ ํ
์คํธํ์ฌ ๋ฐํ์ ์ค๋ฅ๋ฅผ ์ฐพ๋ ์ํธ ๋ณด์์ ์ธ ์ ๊ทผ ๋ฐฉ์์ด๊ธฐ ๋๋ฌธ์
๋๋ค [1].
- * ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ์ ์ ๋ถ์๋ง์ผ๋ก๋ ์ฐพ์๋ผ ์ ์๋ ๋ฐํ์ ํ๊ฒฝ์ ๊ฒฐํจ๊ณผ ์
๋ ฅ ์ ํจ์ฑ ๊ฒ์ฌ ์ทจ์ฝ์ ์ ํตํฉ์ ์ผ๋ก ํ์
ํ๋ ๋ฐฉ๋ฒ์ ์ดํดํ ์ ์์ต๋๋ค [1].
-* [[์ํํธ์จ์ด ๊ตฌ์ฑ ๋ถ์ (SCA)]]
- * ์ฐ๊ฒฐ ์ด์ : ํ๋์ ๋ณด์ ํ๋ซํผ์ ๊ฐ๋ฐ์๊ฐ ์์ฑํ ์ฝ๋๋ฅผ ๋ถ์ํ๋ SAST์ ์คํ ์์ค ์ข
์์ฑ ๋ฐ ๋ผ์ด์ ์ค๋ฅผ ๋ถ์ํ๋ SCA๋ฅผ ํจ๊ป ๊ฒฐํฉํ์ฌ ์ฝ๋๋ฒ ์ด์ค์ ์ ์ฒด ์ํ์ ๊ฐ์ํํฉ๋๋ค [7, 19, 21].
- * ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ๊ฐ๋ฐํ์ด ์ ์ดํ๋ 1์ ์ฝ๋์ ์๋ํํฐ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ ํตํ ๊ณต๊ธ๋ง ์ํ์ด ์ฝ๋๋ฒ ์ด์ค ํ๊ฒฝ์์ ์ด๋ป๊ฒ ์ด์ฒด์ ์ผ๋ก ๋ฐฉ์ด๋๋์ง ์ดํดํ ์ ์์ต๋๋ค [16, 19].
-
-#### [๋๊ตฌ ๋ฐ ๊ฐ๋ฐ ์ธํ๋ผ]
-* [[CI/CD ํ์ดํ๋ผ์ธ]]
- * ์ฐ๊ฒฐ ์ด์ : SAST ๋๊ตฌ๊ฐ ์ค์ง์ ์ธ ๊ฐ์น๋ฅผ ๋ฐํํ๋ ค๋ฉด CI/CD ํ์ดํ๋ผ์ธ ๋ด์ ์๋ํ๋ ํ์ง ๊ฒ์ดํธ(Quality gate)๋ก ํตํฉ๋์ด, ๋ฌธ์ ๊ฐ ์๋ ์ฝ๋๊ฐ ๋ณํฉ๋๊ธฐ ์ ์ ์ฌ์ ์ฐจ๋จํด์ผ ํฉ๋๋ค [13, 22-24].
- * ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ๋ณด์ ๊ฒ์ฌ๊ฐ ์ํํธ์จ์ด ๋ฆด๋ฆฌ์ค ํ๋ก์ธ์ค์ ๋ณ๋ชฉ์ ์ผ์ผํค์ง ์๊ณ ์ด๋ป๊ฒ ์๋ํ๋ 'DevSecOps' ๋ฌธํ๋ฅผ ํ๋ฆฝํ๋์ง ํ์
ํ ์ ์์ต๋๋ค [13, 24].
-* [[AI ์ฝ๋ ๋ฆฌ๋ทฐ (AI Code Review)]]
- * ์ฐ๊ฒฐ ์ด์ : ์ ์ ๋ถ์ ์์ง์ ์ต๊ทผ ์์ฑํ AI ์ฝ๋ ๋ฆฌ๋ทฐ ๋๊ตฌ(์: CodeRabbit, Qodo)์ ๊ฒฐํฉ๋์ด, ๋จ์ํ ๊ตฌ๋ฌธ ๊ฒ์ฌ๋ฅผ ๋์ด ์ฝ๋๋ฒ ์ด์ค์ ๋ชจ๋์ฑ, ์ปจํ
์คํธ ์ ํฉ์ฑ์ ํ๊ฐํ๊ณ ํด๊ฒฐ์ฑ
์ ์๋ ์ ์ํ๋ ํํ๋ก ๋ฐ์ ํ๊ณ ์์ต๋๋ค [6, 9, 10].
- * ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ๋๊ท๋ชจ ์์คํ
์์ ์๋ํ๋ AI๊ฐ AST ๋ถ์ ๋ฐ ์ ์ ๋ณด์ ๋ฃฐ์ ์ด๋ป๊ฒ ํด์ํ๊ณ ๋ฆฌ๋ทฐ ์์ฐ์ฑ์ ๋์ด์ฌ๋ฆฌ๋์ง ์ดํดํ ์ ์์ต๋๋ค [9, 25].
-
-### Deeper Research Questions
-
-* SAST์ DAST, ๊ทธ๋ฆฌ๊ณ SCA(์ํํธ์จ์ด ๊ตฌ์ฑ ๋ถ์)๋ฅผ ๊ฒฐํฉํ ํ์ด๋ธ๋ฆฌ๋ ์ ํ๋ฆฌ์ผ์ด์
๋ณด์ ํ
์คํธ ํ๊ฒฝ์ ๋ณต์กํ ๋ง์ดํฌ๋ก์๋น์ค ์ํคํ
์ฒ์์ ์ด๋ป๊ฒ ์ํธ ๋ณด์์ ์ผ๋ก ์์ฉํ๋๊ฐ?
-* ์๋ฐฑ๋ง ๋ผ์ธ์ ๋ฌํ๋ ๋ ๊ฑฐ์ ์์คํ
์์ ์ํฐํ๋ผ์ด์ฆ๊ธ SAST ๋๊ตฌ๋ฅผ ํ์ฉํ ๋ ๋ฐ์ํ๋ ๋น๋ ์๋ ์ ํ ๋ฐ ๋ฆฌ์์ค ๋ณ๋ชฉ ํ์์ ์ด๋ป๊ฒ ์ต์ ํํ ์ ์๋๊ฐ?
-* ์ฝ๋ ์์ฑ ๊ทธ๋ํ(Code Property Graph) ๋ฐ AI ์ถ๋ก ๊ธฐ์ ์ ๊ธฐ์กด ๊ท์น ๊ธฐ๋ฐ ์ ์ ๋ถ์์ ๊ณ ์ง์ ๋ฌธ์ ์ธ '์คํ(False Positive)'์ ์ด๋ค ๋ฉ์ปค๋์ฆ์ผ๋ก ์ต์ ํ๊ณ ์๋๊ฐ?
-* ๊ฐ๋ ฅํ ๋ณด์ ๊ท์น ์ค์์ ๊ฐ๋ฐ์์ ๋น ๋ฅธ ๋ฐฐํฌ ์ํฌํ๋ก์ฐ ์ฌ์ด์ ์ถฉ๋์ ์ต์ํํ๊ธฐ ์ํ ์ด์์ ์ธ ํ์ดํ๋ผ์ธ ํตํฉ ๋ฐ ํ์ง ๊ฒ์ดํธ(Quality Gate) ์ค๊ณ ์ ๋ต์ ๋ฌด์์ธ๊ฐ?
-* ์ฌ์ฉ์ ์ ์ ์ค์บ ๊ท์น(Custom Rules)์ ์ง์ํ๋ ๋๊ตฌ(์: Semgrep)๋ฅผ ๋์
ํ ๋, ์ ์ง๋ณด์ ์ค๋ฒํค๋๋ฅผ ์ค์ด๋ฉด์ ์กฐ์ง์ ํนํ๋ ๋ณด์ ์ ์ฑ
์ ํจ๊ณผ์ ์ผ๋ก ๋ฐ์ํ๋ ๋ฐฉ๋ฒ์ ๋ฌด์์ธ๊ฐ?
-
-### Practical Application Contexts
-
-* **Implementation:** ์ ๊ท ์ฝ๋๋ฅผ ์์ฑํ๊ฑฐ๋ ๊ธฐ์กด ์ฝ๋๋ฅผ ์์ ํ ๋ ๋ก์ปฌ IDE๋ ํ ๋ฆฌํ์คํธ ๋จ๊ณ์ SAST ํ์ฅ์ ์ฐ๋ํ์ฌ, ์ฝ๋ ๋ณํฉ ์ ์ SQL ์ธ์ ์
, ๋ฏผ๊ฐ ์ ๋ณด ๋
ธ์ถ ๋ฑ์ ์น๋ช
์ ๊ฒฐํจ์ ์กฐ๊ธฐ์ ์์ ํ ์ ์๋๋ก ๊ฐ์ ํฉ๋๋ค.
-* **System Design:** ์ํํธ์จ์ด ๊ฐ๋ฐ ํ์ดํ๋ผ์ธ ์ํคํ
์ฒ๋ฅผ ์ค๊ณํ ๋, ์ฝ๋ ์ ์ฅ์(GitHub, GitLab ๋ฑ)์ ์ก์
/ํ
(Hooks)์ ์ ์ ๋ถ์ ์์ง์ ์ฝ์
ํ์ฌ ๋ณด์ ํ
์คํธ๊ฐ ๋ด์ฌํ๋(Shift-left) DevSecOps ์ํฌํ๋ก์ฐ๋ฅผ ๊ตฌ์ฑํฉ๋๋ค.
-* **Operation / Maintenance:** ๊ท์ ๊ฐ ์๊ฒฉํ ์ธํ๋ผ(๊ธ์ต, ํฌ์ค์ผ์ด ๋ฑ)์์ ์ด์ ์ค์ธ ๊ฑฐ๋ ๋ ๊ฑฐ์ ์ฝ๋๋ฒ ์ด์ค์ ๊ธฐ์ ์ ๋ถ์ฑ ๋ฐ ๋ณด์ ์ํ ์์ค์ ๊ณ๋ํํ๊ณ , ์ปดํ๋ผ์ด์ธ์ค ์ค์ ์ฆ์ (Audit) ๋ฌธ์๋ฅผ ์๋์ผ๋ก ์ฐ์ถํ๋ ๋ฐ ํ์ฉํฉ๋๋ค.
-* **Learning Path:** ๋ฏ์ค๊ณ ๋ฐฉ๋ํ ์์คํ
์ ์ฒ์ ์จ๋ณด๋ฉํ ๋, SAST ๋๊ตฌ๊ฐ ๋ฑ์ด๋ด๋ ์์กด์ฑ ๊ฒฝ๊ณ ๋ ๊ตฌ์กฐ์ ๋ณต์ก์ฑ ๋ณด๊ณ ์๋ฅผ ์ญ์ผ๋ก ์ถ์ ํจ์ผ๋ก์จ ์ํคํ
์ฒ์ ์ทจ์ฝํ ์ฐ๊ฒฐ ๊ณ ๋ฆฌ๋ ๋ ๊ฑฐ์ ๊ตฌ์ฑ ์์๋ฅผ ๋น ๋ฅด๊ฒ ์๋ณํ๊ณ ์ฝ๋์ ์งํ์ ์ดํดํ ์ ์์ต๋๋ค.
-* **My Project Relevance:** ํ์ฌ ์ ์ง๋ณด์ํ๊ณ ์๋ ํ๋ก์ ํธ์ ๋ค์์ ์๋ํํฐ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ์ฐ๋ ๋ฐ ๋ณต์กํ ๋น์ฆ๋์ค ๋ก์ง์ด ์กด์ฌํ๋ค๋ฉด, SAST ๋๊ตฌ๋ฅผ ํตํด ์ ์ฌ์ ์ธ ๋ณด์ ๋์์ ์ฑ๋ฅ ๋ณ๋ชฉ ์ฝ๋๋ฅผ ๊ฐ์ํํ๊ณ , ์์ ํ๊ณ ๊ตฌ์กฐํ๋ ์ฝ๋ฉ ๊ฐ์ด๋๋ฅผ ์๋ฆฝํ๋ ๋ฐ ์ง์ ์ ์ฉํ ์ ์์ต๋๋ค.
-
-### Adjacent Topics
-
-* [[์ถ์ ๊ตฌ๋ฌธ ํธ๋ฆฌ (AST, Abstract Syntax Tree)]]
- * ํ์ฅ ๋ฐฉํฅ: ์์ค ์ฝ๋๊ฐ ์ด๋ป๊ฒ ํ
์คํธ ํํ์์ ๊ตฌ์กฐ์ ๋ชจ๋ธ๋ก ์ปดํ์ผ ๋ฐ ํ์ฑ๋๋์ง ์ดํดํจ์ผ๋ก์จ, ์ฝ๋ ๋ถ์ ์ํํธ์จ์ด๊ฐ ์ทจ์ฝ์ ํจํด์ ํ์งํ๋ ํต์ฌ ์๋ฆฌ๋ก ์ง์์ ํ์ฅํ ์ ์์ต๋๋ค.
-* [[๊ธฐ์ ์ ๋ถ์ฑ (Technical Debt)]]
- * ํ์ฅ ๋ฐฉํฅ: SAST๊ฐ ํฌ์ฐฉํ๋ ์ฝ๋ ๋ณต์ก์ฑ๊ณผ ๊ตฌ์กฐ์ ๊ฒฐํจ์ด ๋จ์ํ ๋ณด์ ๋ฌธ์ ๋ฅผ ๋์ด, ์ฅ๊ธฐ์ ์ธ ์ํํธ์จ์ด ์ ์ง๋ณด์์ฑ ๋ฐ ๊ฐ๋ฐ ๋ฏผ์ฒฉ์ฑ์ ์ด๋ ํ ์ฌ๋ฌด์ ยท๊ธฐ์ ์ ๋ถ์ฑ๋ก ์์ฉํ๋์ง ๋
ผ์๋ฅผ ์ฌํํ ์ ์์ต๋๋ค.
-
----
-*Last updated: 2026-05-02*
-## ๐งช ๊ฒ์ฆ ์ํ (Validation)
-- **์ ๋ณด ์ํ:** verified
-- **์ถ์ฒ ์ ๋ขฐ๋:** A
-- **๊ฒํ ์ด์ :** Datacollector์์ ์๋ ์ถ์ถ๋ ์ํค ๋ฐ์ดํฐ์ ์ด๊ธฐ ํตํฉ.
-
-## ๐งฌ ์ค๋ณต ๊ฒ์ฌ (Duplicate Check)
-- **๊ธฐ์กด ์ ์ฌ ๋ฌธ์:** [[แแ
ฅแผแแ
ฅแจ แแ
ขแแ
ณแฏแ
แ
ตแแ
ฆแแ
ตแแ
งแซ แแ
ฉแแ
กแซ แแ
ฆแแ
ณแแ
ณ (SAST).md]]
-- **์ฒ๋ฆฌ ๋ฐฉ์:** UPDATE
-- **์ฒ๋ฆฌ ์ด์ :** ๊ธฐ์กด ๋ฌธ์ ๋ด์ฉ ๋ณด๊ฐ ๋ฐ v3.1 ํ์ค ์ ์ฉ
diff --git a/10_Wiki/Topics/03_DevOps_Environment/CI-CD Pipeline.md b/10_Wiki/Topics/03_DevOps_Environment/CI-CD Pipeline.md
deleted file mode 100644
index 4a444ae2..00000000
--- a/10_Wiki/Topics/03_DevOps_Environment/CI-CD Pipeline.md
+++ /dev/null
@@ -1,35 +0,0 @@
----
-id: P-REINFORCE-AUTO-WIKI-DEV-003
-category: "10_Wiki/๐ก Topics/Development"
-confidence_score: 0.95
-tags: [development, ci-cd, automation, quality-gate, devops, p-reinforce]
-last_reinforced: 2026-05-01
----
-
-# [[CI-CD Pipeline|CI-CD Pipeline]]
-
-## ๐ ํ ์ค ํต์ฐฐ (The Karpathy Summary)
-> "์ํํธ์จ์ด์ ๋น๋, ํ
์คํธ, ๋ฐฐํฌ ์ ๊ณผ์ ์ ์๋ํํ์ฌ, ์ธ๊ฐ ๋ฆฌ๋ทฐ์ด๋ณด๋ค ๋จผ์ ๊ฒฐํจ์ ์ฐพ์๋ด๋ '๊ธฐ๊ณ์ ํ์๊พผ'์ด์ ๋ฐฐํฌ์ ์ ๋ขฐ์ฑ์ ๋ณด์ฅํ๋ ํต์ฌ ์ธํ๋ผ."
-
-## ๐ ๊ตฌ์กฐํ๋ ์ง์ (Synthesized Content)
-CI-CD๋ ํ๋์ ๊ฐ๋ฐ ์ํฌํ๋ก์ฐ์์ ํ์ง๊ณผ ์๋๋ฅผ ๋์์ ์ก๋ ํต์ฌ ์์ง์
๋๋ค.
-
-1. **์๋ํ๋ ํ์ง ๊ฒ์ดํธ (Quality Gates)**:
- * **CI (Continuous Integration)**: ์ฝ๋ ๋ณ๊ฒฝ ์๋ง๋ค ๋น๋์ ํ
์คํธ๋ฅผ ์๋์ผ๋ก ์ํํฉ๋๋ค. ๋ฆฐํฐ, SAST, SCA ๋ฑ์ด ํตํฉ๋์ด ์ธ๊ฐ ๋ฆฌ๋ทฐ์ด์๊ฒ ๋๋ฌํ๊ธฐ ์ ๊ธฐ์ด ๊ฒฐํจ์ ํํฐ๋งํฉ๋๋ค.
- * **CD (Continuous Delivery/Deployment)**: ๊ฒ์ฆ๋ ์ฝ๋๋ฅผ ์คํ
์ด์ง์ด๋ ํ๋ก๋์
ํ๊ฒฝ์ผ๋ก ์๋ ๋ฐฐํฌํฉ๋๋ค.
-2. **๋ณํฉ ์ฐจ๋จ (Blocking Merges)**:
- * ์๋ํ ํ
์คํธ๊ฐ ์คํจํ๊ฑฐ๋ ๋ณด์ ์ค์บ์์ ์ทจ์ฝ์ ์ด ๋ฐ๊ฒฌ๋๋ฉด ๋ฉ์ธ ๋ธ๋์น๋ก์ ๋ณํฉ์ ์์คํ
์ ์ผ๋ก ์ฐจ๋จํ์ฌ ์์ ์ฑ์ ํ๋ณดํฉ๋๋ค.
-3. **์ธ์ง ๋ถํ ๊ฐ์**:
- * ์ฌ์ํ ์คํ์ผ ์๋ฐ์ด๋ ์คํ ๋ฑ์ ๊ธฐ๊ณ๊ฐ ์ฒ๋ฆฌํ๋ฏ๋ก, ์ธ๊ฐ ๋ฆฌ๋ทฐ์ด๋ ์ํคํ
์ฒ์ ๋น์ฆ๋์ค ๋ก์ง ๊ฐ์ ๊ณ ์ฐจ์์ ๊ฒํ ์ ์ง์คํ ์ ์์ต๋๋ค.
-
-## โ ๏ธ ๋ชจ์ ๋ฐ ์
๋ฐ์ดํธ (Contradictions & RL Update)
-- **ํ์ดํ๋ผ์ธ ์ง์ฐ์ ์ญ์ค**: ํ์ง ๊ฒ์ฆ์ ์ํด ๋๋ฌด ๋ง์ ๋จ๊ณ(๋ฌด๊ฑฐ์ด E2E ํ
์คํธ ๋ฑ)๋ฅผ ์ถ๊ฐํ๋ฉด ํ์ดํ๋ผ์ธ ์๋๊ฐ ๋๋ ค์ ธ ๊ฐ๋ฐ ํผ๋๋ฐฑ ๋ฃจํ๋ฅผ ์ ํดํฉ๋๋ค. ๊ฒ์ฆ ๊ฐ๋์ ์คํ ์๋ ์ฌ์ด์ ์ ๊ตํ ๋ฐธ๋ฐ์ฑ์ด ํ์์ ์
๋๋ค.
-- **์๋ํ์ ํ๊ณ**: CI-CD๋ ์ ํด์ง ํจํด์ ์ ์ฐพ์ง๋ง ๋น์ฆ๋์ค์ ๋งฅ๋ฝ์ด๋ ์ค๊ณ์์ ๋
ผ๋ฆฌ์ ์ค๋ฅ๋ ์ก์ง ๋ชปํฉ๋๋ค. ๊ธฐ๊ณ์ ๊ฒ์ฆ๊ณผ ์ธ๊ฐ์ ์ ์ฑ์ ๋ฆฌ๋ทฐ๊ฐ ๊ฒฐํฉ๋ ์ํธ ๋ณด์ ๊ตฌ์กฐ๋ฅผ ์ ์งํด์ผ ํฉ๋๋ค.
-
-## ๐ ์ง์ ์ฐ๊ฒฐ (Graph)
-- Shift-Left Security: ๋ณด์ ์ ๊ฒ์ CI ๋จ๊ณ๋ก ์๋น๊ธฐ๋ ์ ๋ต.
-- Automated Testing: ํ์ดํ๋ผ์ธ์ ํต์ฌ ๊ด๋ฌธ.
-- Pull Request Workflow: CI-CD๊ฐ ํธ๋ฆฌ๊ฑฐ๋๋ ์ง์ .
-- [[DevSecOps|DevSecOps]]: ๋ณด์์ด ๋ด์ฌํ๋ ์๋ํ ์ฒ ํ.
-- [[Infrastructure-as-Code-IaC|Infrastructure as Code (IaC]]: ์ธํ๋ผ ๋ฐฐํฌ์ ์๋ํ ํ์ฅ.
----
diff --git a/10_Wiki/Topics/03_DevOps_Environment/Deployment_Final_Gate.md b/10_Wiki/Topics/03_DevOps_Environment/Deployment_Final_Gate.md
deleted file mode 100644
index 307f3b06..00000000
--- a/10_Wiki/Topics/03_DevOps_Environment/Deployment_Final_Gate.md
+++ /dev/null
@@ -1,26 +0,0 @@
----
-title: ๋ฐฐํฌ ํ๋กํ ์ฝ ๋ฐ CI/CD ์๋ํ
-category: Software [[Architecture|Architecture]]
-tags: [Deployment, CI/CD, [[GitHub Actions|GitHub Actions]], Vercel, DevOps]
-created: 2026-04-20
----
-
-# [[Deployment_Final_Gate|Deployment_Final_Gate]] (๋ฐฐํฌ ๋ฐ ์๋ํ)
-
-## ๐ ํ ์ค ํต์ฐฐ (The Karpathy Summary)
-> ์๋ ๋ฐฐํฌ๋ '์ค๋ฒ ๋ถ๋ '์ด ์๋๋ผ '์ํํญํ'์ด๋ค. ์ธ๊ฐ์ ์์ ๊ฑฐ์น์ง ์๋ ์๋ํ๋ ๋ณด๊ธ๋ก๋ง์ด ์์คํ
์ ์์์ฑ์ ๋ณด์ฅํ๋ค.
-
-## ๐ ๊ตฌ์กฐํ๋ ์ง์ (Synthesized Content)
-- **CI (Continuous Integration)**:
- - ์ฝ๋๊ฐ ์ ์ฅ์์ ํฉ์ณ์ง๊ธฐ ์ , ๋ฆฐํธ(Lint) ๊ฒ์ฌ, ๋น๋ ํ
์คํธ, ์ ๋ ํ
์คํธ๋ฅผ ์๋์ผ๋ก ์ํํ์ฌ '์ค์ผ๋ ์ฝ๋'์ ์ ์
์ ์์ฒ ์ฐจ๋จํ๋ค.
-- **CD (Continuous Deployment)**:
- - ๊ฒ์ฆ๋ ์ฝ๋๋ฅผ ์ค์๋ฒ์ ์๋์ผ๋ก ๋ฆด๋ฆฌ์ฆํ๋ค. `Vercel`, `Netlify` ๊ฐ์ ํ๋ซํผ์ ๋ธ๋์น๋ณ '๋ฏธ๋ฆฌ๋ณด๊ธฐ' ์ฃผ์๋ฅผ ์ ๊ณตํ์ฌ ๋ฐฐํฌ ์ ์ต์ข
๊ฒ์๋ฅผ ๋๋๋ค.
-- **Environment Variables (๋ณด์ ํ๊ฒฝ)**:
- - `.env` ํ์ผ์ ํตํ ๋ฏผ๊ฐ ์ ๋ณด ๊ฒฉ๋ฆฌ๋ ๊ธฐ๋ณธ ์ค์ ๊ธฐ๋ณธ์ด๋ค. ๊นํ๋ธ์ API Key๊ฐ ํ๋๋ผ๋ ๋
ธ์ถ๋๋ ์๊ฐ, ๊ทธ ํ๋ก์ ํธ๋ ๋ณด์์ ์ผ๋ก ์ฌ๋งํ ๊ฒ๊ณผ ๋ค๋ฆ์๋ค.
-
-## โ ๏ธ ๋ชจ์ ๋ฐ ์
๋ฐ์ดํธ (RL Update)
-- ๋ฌด์กฐ๊ฑด์ ์ธ '์๋ ๋ฐฐํฌ'๊ฐ ๋ ์ ๋ต์ ์๋๋ค. ์ด์ ๋จ๊ณ์์๋ '๋ธ๋ฃจ-๊ทธ๋ฆฐ ๋ฐฐํฌ'๋ '์นด๋๋ฆฌ ๋ฐฐํฌ'์ฒ๋ผ ํธ๋ํฝ์ ์กฐ๊ธ์ฉ ํ๋ ค๋ณด๋ด๋ฉฐ ์์ ์ฑ์ ํ์ธํ๋ ๊ณ ๊ธ ์ ๋ต์ด ํ์ํ๋ค.
-
-## ๐ ์ง์ ์ฐ๊ฒฐ (Graph)
-- Related: [[Modern_Environment_Ecosystem|Modern_Environment_Ecosystem]] , [[Collaboration_Governance|Collaboration_Governance]]
-- Pre-requisite: [[React_Testing_Strategy|React_Testing_Strategy]]
diff --git a/10_Wiki/Topics/03_DevOps_Environment/DevOps_Environment_Setup.md b/10_Wiki/Topics/03_DevOps_Environment/DevOps_Environment_Setup.md
deleted file mode 100644
index 84e926dd..00000000
--- a/10_Wiki/Topics/03_DevOps_Environment/DevOps_Environment_Setup.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-title: ๊ฐ๋ฐ ํ๊ฒฝ ๋ฐ ์คํ ํ๋ก์ธ์ค ๊ด๋ฆฌ (DevOps & Setup)
-category: DevOps
-tags: [DevOps, Environment, CI/CD, Process [[Management|Management]]]
-created: 2026-04-20
----
-
-# ๊ฐ๋ฐ ํ๊ฒฝ ๋ฐ ์คํ ํ๋ก์ธ์ค ๊ด๋ฆฌ
-
-## ๐ฏ ๊ฐ์ (Overview)
-์ฝ๋ฉ ์์ฑ๋๋งํผ์ด๋ ์ค์ํ **์คํ ํ๊ฒฝ(Runtime Environment)**๊ณผ **์ค์ ํ์ผ(Configuration)**์ ๋ฌด๊ฒฐ์ฑ์ ํ๋ณดํ์ฌ, '๋ด ์ปดํจํฐ์์ ๋๋๋ฐ ์ ์ ๊ธฐ์ ์ ๋์ง?'๋ผ๋ ๋ฌธ์ ๋ฅผ ํด๊ฒฐํ๋ ํ๋ก์ธ์ค์
๋๋ค.
-
-## ๐ ํ์ ์ฒดํฌ๋ฆฌ์คํธ (Checklist)
-- **์์กด์ฑ ๊ด๋ฆฌ**: `npm install` ๋ฑ ํจํค์ง ๋ฌด๊ฒฐ์ฑ ํ์ธ.
-- **๋ฌผ๋ฆฌ์ ํ์ผ ๊ตฌ์กฐ**: `index.html` ๋ฑ ํ์ ์ง์
์ ํ์ผ ์กด์ฌ ํ์ธ.
-- **๋ณด์ ๋ฐ ๊ถํ**: OS ๋ ๋ฒจ์ ์คํ ์ ์ฑ
(`Execution Policy`) ๋ฐ ๊ถํ ์ค์ .
-
-## ๐ก ๋ ์จ ๋ฐ (Lesson Learned)
-> [!NOTE]
-> **"์ด์ ํ๊ฒฝ์ ๋ํ ์ดํด๋ ์ฝ๋ฉ ๋ฅ๋ ฅ์ ์ ๋ฐ์ด๋ค."**
-> ๋
ผ๋ฆฌ์ ๋ก์ง์ ์์ฑ๋ฟ๋ง ์๋๋ผ, ๊ทธ๊ฒ์ด ์ค์ ๋ก ๊ตฌ๋๋๋ ๋ฌผ๋ฆฌ์ ์ธํ๋ผ ์ค์ ์ ๋ฌธ์ํํ๊ณ ์๋ํํ๋ ๋ฅ๋ ฅ์ด ํ์์ ์
๋๋ค.
-
-## ๐ ์ฐ๊ฒฐ๋ ์ง์
-- [[Systemic_Simulation_Principles|Systemic_Simulation_Principles]]
diff --git a/10_Wiki/Topics/03_DevOps_Environment/Engineering Metrics (DORA).md b/10_Wiki/Topics/03_DevOps_Environment/Engineering Metrics (DORA).md
deleted file mode 100644
index 85a7e948..00000000
--- a/10_Wiki/Topics/03_DevOps_Environment/Engineering Metrics (DORA).md
+++ /dev/null
@@ -1,39 +0,0 @@
----
-id: P-REINFORCE-AUTO-WIKI-GOV-002
-category: "10_Wiki/๐ก Topics/04_Governance_Reliability"
-confidence_score: 0.95
-tags: [governance, dora-metrics, engineering-metrics, performance, devops, cycle-time, p-reinforce]
-last_reinforced: 2026-05-01
----
-
-# [[Engineering Metrics (DORA)|Engineering Metrics (DORA]]
-
-## ๐ ํ ์ค ํต์ฐฐ (The Karpathy Summary)
-> "๋ฐ์ดํฐ์ ๊ธฐ๋ฐํ์ฌ ์ํํธ์จ์ด ์ธ๋ ์ฑ๊ณผ(Delivery Performance)๋ฅผ ์ ๋ํํ๊ณ , ์๋ฆฌํธ ํ์ ๋ฒค์น๋งํฌ๋ฅผ ํตํด ๊ฐ๋ฐ ํ๋ก์ธ์ค์ ๋ณ๋ชฉ๊ณผ ๊ฐ์ ๋ฐฉํฅ์ ์ ์ํ๋ ์์ง๋์ด๋ง ํ์ค ์งํ."
-
-## ๐ ๊ตฌ์กฐํ๋ ์ง์ (Synthesized Content)
-DORA ์งํ๋ ๋ฐ๋ธ์ต์ค(DevOps) ์ฐ๊ตฌ๋ฅผ ํตํด ์
์ฆ๋ ๊ณ ์ฑ๊ณผ ํ์ ํต์ฌ ์งํ์
๋๋ค.
-
-1. **4๋ ํต์ฌ ์งํ**:
- * **Deployment Frequency (DF)**: ๋ฐฐํฌ ๋น๋.
- * **Lead Time for Changes (MLT)**: ์ฝ๋ ์ปค๋ฐ๋ถํฐ ๋ฐฐํฌ๊น์ง ๊ฑธ๋ฆฌ๋ ์๊ฐ.
- * **Change Failure Rate (CFR)**: ๋ฐฐํฌ ํ ์คํจ์จ.
- * **Failed Service Recovery Time (MTTR)**: ์ฅ์ ๋ฐ์ ์ ๋ณต๊ตฌ๊น์ง ๊ฑธ๋ฆฌ๋ ์๊ฐ.
-2. **์๋ฆฌํธ ์ฑ๊ณผ์ (Elite Performers)์ ํน์ง**:
- * **PR ์ฌ์ด์ฆ ์ ํ**: ์ฝ๋ ๋ณ๊ฒฝ๋์ 400 LOC ์ดํ๋ก ์ ์งํ์ฌ ์ธ์ง ๋ถํ๋ฅผ ์ค์
๋๋ค.
- * **๋น ๋ฅธ ๋ฆฌ๋ทฐ ์๋ต**: ์ฒซ ๋ฆฌ๋ทฐ ์๋ต ์๊ฐ(TTR)์ 1์๊ฐ ์ด๋ด๋ก, ์ ์ฒด ์๋ฃ๋ฅผ 6์๊ฐ ์ด๋ด๋ก ์ ์งํฉ๋๋ค.
- * **์๋ํ ์ต์ ํ**: ์คํ์ผ ๋ฐ ๋จ์ ๊ฒ์ฆ์ ์๋ํํ์ฌ ์ธ๊ฐ ๋ฆฌ๋ทฐ์ด๊ฐ ์ํคํ
์ฒ์ ์ง์ ๊ณต์ ์ ์ง์คํ๊ฒ ํฉ๋๋ค.
-3. **์ฑ๊ณผ์ ๋ฆฌ๋ทฐ์ ์๊ด๊ด๊ณ**:
- * ํจ์จ์ ์ธ ์ฝ๋ ๋ฆฌ๋ทฐ ํ๋ก์ธ์ค๋ฅผ ๊ฐ์ถ ํ์ ๊ทธ๋ ์ง ์์ ํ๋ณด๋ค ์ธ๋ ์ฑ๊ณผ๊ฐ 50% ์ด์ ๋๊ฒ ๋ํ๋ฉ๋๋ค.
-
-## โ ๏ธ ๋ชจ์ ๋ฐ ์
๋ฐ์ดํธ (Contradictions & RL Update)
-- **์๋ vs ์์ ์ฑ**: ์งํ ๊ฐ์ ์ ์ํด ์๋์๋ง ์ง์ฐฉํ๋ฉด ์คํจ์จ(CFR)์ด ์ฌ๋ผ๊ฐ ์ ์์ต๋๋ค. 4๋ ์งํ๋ ์๋ก ๊ฒฌ์ ํ๋ฉฐ ๊ท ํ์ ์ด๋ฃจ์ด์ผ ์ง์ ํ ์ฑ๊ณผ ๊ฐ์ ์ผ๋ก ์ด์ด์ง๋๋ค.
-- **๋ฐ์ดํฐ์ ๋งฅ๋ฝ**: ๋จ์ ์์น๋ง์ผ๋ก ํ์ ํ๊ฐํ๊ธฐ๋ณด๋ค, ์งํ์ ๋ณํ ์ถ์ด๋ฅผ ํตํด ํ์ ํ๋ก์ธ์ค ๊ฑด์ ์ฑ์ ์ง๋จํ๊ณ ๋ณ๋ชฉ์ ํด๊ฒฐํ๋ ๋๊ตฌ๋ก ํ์ฉํด์ผ ํฉ๋๋ค.
-
-## ๐ ์ง์ ์ฐ๊ฒฐ (Graph)
-- [[Review Performance & Flow|Review Performance & Flow]]: DORA ์งํ๋ฅผ ๋ฌ์ฑํ๊ธฐ ์ํ ๊ตฌ์ฒด์ ์ด์ ์ ๋ต.
-- Small Pull Requests (์์ PR: Lead Time์ ๋จ์ถํ๋ ๊ฐ์ฅ ๊ฐ๋ ฅํ ์๋จ.
-- [[Automated Quality & Review|Automated Quality & Review]]: ์ธ๊ฐ์ ์๊ฐ์ ์ ์ฝํ์ฌ ์ฑ๊ณผ๋ฅผ ๊ทน๋ํํ๋ ๊ธฐ๋ฐ.
-- [[CI-CD Pipeline|CI-CD Pipeline]]: ์งํ ์์ง๊ณผ ์๋ํ๊ฐ ์ด๋ฃจ์ด์ง๋ ์ธํ๋ผ.
-- [[DORA-Metrics|DORA Metrics]]: ์๋ณธ ๊ฐ๋
์ ์.
----
diff --git a/10_Wiki/Topics/03_DevOps_Environment/Index.md b/10_Wiki/Topics/03_DevOps_Environment/Index.md
deleted file mode 100644
index 2ea162f6..00000000
--- a/10_Wiki/Topics/03_DevOps_Environment/Index.md
+++ /dev/null
@@ -1,8 +0,0 @@
-# Index: Topics > 03_DevOps_Environment
-
-## ๐ Documents
-- [[Deployment_Final_Gate|Deployment_Final_Gate]]
-- [[DevOps_Environment_Setup|DevOps_Environment_Setup]]
-- [[Git_Operation_Protocol|Git_Operation_Protocol]]
-- [[Modern_Environment_Ecosystem|Modern_Environment_Ecosystem]]
-- [[Tetris_Project_Retrospective|Tetris_Project_Retrospective]]
diff --git a/10_Wiki/Topics/03_DevOps_Environment/Internet of Things (IoT).md b/10_Wiki/Topics/03_DevOps_Environment/Internet of Things (IoT).md
deleted file mode 100644
index 47710c29..00000000
--- a/10_Wiki/Topics/03_DevOps_Environment/Internet of Things (IoT).md
+++ /dev/null
@@ -1,75 +0,0 @@
----
-id: P-REINFORCE-WIKI-0DC3AE4A
-category: "10_Wiki/๐ก Topics/03_DevOps_Environment"
-confidence_score: 0.95
-tags: ['internet-of-things-(iot)', 'event-driven-architecture-pattern', 'serverless-architecture-pattern', 'broker-architecture-pattern', 'microkernel-architecture-pattern', 'devops-environment']
-last_reinforced: 2026-05-02
----
-
-# [[Internet of Things (IoT)]]
-
-## ๐ Brief Summary
-Internet of Things (IoT)๋ ์ค๋งํธ ํ, ์๋ฃ ๋ชจ๋ํฐ๋ง ์ฅ์น, ๋ฌผ๋ฆฌ์ ์ผ์ ๋ฑ ๋๊ท๋ชจ ์ด๋ฒคํธ๋ฅผ ์ค์๊ฐ์ผ๋ก ์์ฑํ๊ณ ๊ตํํ๋ ๋ฌผ๋ฆฌ์ ๋๋ฐ์ด์ค ๋ฐ ๋ถ์ฐ ๋คํธ์ํฌ๋ฅผ ์๋ฏธํฉ๋๋ค [1-3]. ์ํํธ์จ์ด ์ํคํ
์ฒ ๊ด์ ์์ IoT ์์คํ
์ ๋ฐฉ๋ํ ๋ณผ๋ฅจ๊ณผ ๋น ๋ฅธ ์๋๋ฅผ ๊ฐ์ง ๋ฐ์ดํฐ๋ฅผ ๋น๋๊ธฐ์ ์ผ๋ก ์ฒ๋ฆฌํ๊ณ ์์งํด์ผ ํ๋ฏ๋ก, ๋์ ํ์ฅ์ฑ์ ์ ๊ณตํ๋ ์ด๋ฒคํธ ๊ธฐ๋ฐ ์ํคํ
์ฒ(EDA) ๋ฐ ์๋ฒ๋ฆฌ์ค(Serverless), ๋ธ๋ก์ปค(Broker) ํจํด ๋ฑ๊ณผ ๋ฐ์ ํ๊ฒ ์ฐ๊ด๋ฉ๋๋ค [1, 4-6].
-
-## ๐ Core Content
-* **์ด๋ฒคํธ ๊ธฐ๋ฐ ์ํคํ
์ฒ(EDA)์์ ๊ฒฐํฉ:** EDA๋ ์ผ์์์ ๋ฐ์ํ๋ ์ค์๊ฐ ๋ฐ์ดํฐ๋ฅผ ๋น๋๊ธฐ์ ์ผ๋ก ์ฒ๋ฆฌํ ์ ์์ด ์ค๋งํธ ํ ๋ฑ IoT ์์คํ
์ ๊ฐ์ฅ ์ด์์ ์ธ ์ํคํ
์ฒ ํจํด์ผ๋ก ๊ผฝํ๋๋ค [1, 7]. IoT ํ๊ฒฝ์์๋ ๋ฐ์ดํฐ์ ์์ฑ๋๊ณผ ์๋(Volume and Velocity)๊ฐ ๋งค์ฐ ๋๊ธฐ ๋๋ฌธ์ ํ์ฅ์ฑ๊ณผ ๋น๊ฒฐํฉ์ฑ์ด ๋ฐ์ด๋ EDA์ ์ด์ ์ ๊ทน๋ํํ ์ ์์ต๋๋ค [5, 8].
-* **์ด๋ฒคํธ ์คํธ๋ฆผ ์ฒ๋ฆฌ(Event Stream Processing):** ๊ฑด๊ฐ ๋ชจ๋ํฐ๋ง ์์คํ
๊ณผ ๊ฐ์ IoT ์๋ฃจ์
์ ์ง์์ ์ธ ์์ฒด ๋ณํ๋ฅผ ์์คํ
์ ์๋ฆฌ๊ธฐ ์ํด ๋น๋ฒํ๊ณ ๋ฐฉ๋ํ ์ด๋ฒคํธ๋ฅผ ์์ฑํฉ๋๋ค [2]. Azure IoT Hub๋ Event Hubs์ ๊ฐ์ ๋ฐ์ดํฐ ์คํธ๋ฆฌ๋ฐ ํ๋ซํผ์ ํ์ดํ๋ผ์ธ์ผ๋ก ํ์ฉํ๋ฉด, ๋์ฉ๋์ ์ด๋ฒคํธ๋ฅผ ์์ง(Ingest)ํ๊ณ ์คํธ๋ฆผ ํ๋ก์ธ์์ ๊ณต๊ธํ๋ ๋ฐ ๋งค์ฐ ์ ํฉํฉ๋๋ค [3, 9, 10]. ์ด๋ฒคํธ ์คํธ๋ฆผ์ ์ฌ์ฉํ๋ฉด ์ด๋ฒคํธ๋ฅผ ์๊ตฌ์ ์ผ๋ก ์ ์ฅํ ์ ์์ด, ์ฆ๊ฐ์ ์ฒ๋ฆฌ๊ฐ ํ์ํ ๋ฐ์ดํฐ์ ์ฃผ๊ธฐ์ ๋ถ์์ด ํ์ํ ๋ฐ์ดํฐ๋ฅผ ์ฌ๋ฌ ์ด๋ฒคํธ ํธ๋ค๋ฌ๊ฐ ๊ฐ์์ ์๋์ ๋ง์ถฐ ๋ณ๋ ฌ๋ก ์ฒ๋ฆฌํ ์ ์๊ฒ ํด์ค๋๋ค [2].
-* **๋ค์ํ ์ํคํ
์ฒ ํจํด์ ์ ์ฉ:**
- * **์๋ฒ๋ฆฌ์ค(Serverless):** IoT ๋ฐ์ดํฐ ์ฒ๋ฆฌ์ ๊ฐ์ ์ด๋ฒคํธ ์ค์ฌ ์ํฌ๋ก๋๋ฅผ ๊ตฌํํ ๋ ๋ฐฑ์๋ ์๋ฒ ๊ด๋ฆฌ ๋ถ๋ด์ ์ค์ฌ์ฃผ๊ณ ๋น์ฉ ํจ์จ์ ์ธ ์คํ ์ค์ผ์ผ๋ง์ ์ ๊ณตํฉ๋๋ค [1, 11].
- * **๋ธ๋ก์ปค(Broker) ํจํด:** IoT ํ๋ธ ๋ฐ ์ผ์ ๋คํธ์ํฌ ํ๊ฒฝ์์ IoT ๋๋ฐ์ด์ค์ ํด๋ผ์ฐ๋ ์๋น์ค ๊ฐ์ ํต์ ๊ณผ ๋ฉ์์ง ๋ถ๋ฐฐ๋ฅผ ์ํํ๊ฒ ์กฐ์จํ๋ ๋ฐ ์ฌ์ฉ๋ฉ๋๋ค [6, 12].
- * **๋ง์ดํฌ๋ก์ปค๋(Microkernel):** ๋์ ๋ชจ๋์ฑ๊ณผ ํ์ฅ์ฑ์ด ์๊ตฌ๋๋ ๊ฐ๋ณ IoT ๋๋ฐ์ด์ค(์ฃ์ง ํ๊ฒฝ)์ ์ํํธ์จ์ด๋ฅผ ๊ตฌ์ถํ ๋ ์ฝ์ด ๊ธฐ๋ฅ๊ณผ ํ์ฅ ํ๋ฌ๊ทธ์ธ์ ๋ถ๋ฆฌํ์ฌ ์ ์ฉํ๊ฒ ํ์ฉ๋ฉ๋๋ค [13].
- * **๋ง์ดํฌ๋ก์๋น์ค ๋ฐ ํฅ์ฌ๊ณ ๋ (Hexagonal):** ๋ง์ดํฌ๋ก์๋น์ค๋ IoT ์์คํ
์ ๋ชจ๋์ ์
๋ฐ์ดํธ๋ฅผ ์ฉ์ดํ๊ฒ ๋ง๋ค๋ฉฐ [1], ํฅ์ฌ๊ณ ๋ ์ํคํ
์ฒ๋ ์ธ๋ถ IoT ์ผ์ ๊ธฐ์ ๊ณผ ๋ด๋ถ ํต์ฌ ๋๋ฉ์ธ ๋ก์ง์ ๋
๋ฆฝ์ ์ผ๋ก ๋ถ๋ฆฌํ๋ ๋ฐ ๋์์ ์ค๋๋ค [14].
-
-## โ๏ธ Trade-offs & Caveats
-* **๋ฉ์์ง ์ ๋ฌ ๋ณด์ฅ(Guaranteed Delivery)์ ์ด๋ ค์:** IoT ์๋๋ฆฌ์ค์์๋ ์์คํ
๊ฐ ํต์ ์ด ๋น๋๊ธฐ์ ์ผ๋ก ์ด๋ฃจ์ด์ง๋๋ผ๋ ์ผ์์์ ์์ฑ๋ ์ด๋ฒคํธ๊ฐ ๋ฐ๋์ ๋ชฉ์ ์ง์ ๋์ฐฉํ๋๋ก ๋ณด์ฅํ๋ ๊ฒ์ด ์ค์ํ์ง๋ง, ๋ณต์กํ ๋ถ์ฐ ํ๊ฒฝ์์ ์ด๋ฅผ ๋ณด์ฅํ๊ธฐ ์ํ ์ํคํ
์ฒ์ ๊ตฌํ์ ๊น๋ค๋ก์ด ๊ณผ์ ์
๋๋ค [15].
-* **๋์ฉ๋ ๋ฐ์ดํฐ ์์ง(Ingestion) ์ ์ฝ:** IoT ๋๋ฐ์ด์ค๋ ์์คํ
์ธ๋ถ์ ์กด์ฌํ๋ ๋ฐ์ดํฐ ์์ค๋ก์ ๋ฐฉ๋ํ ์์ ๋ฐ์ดํฐ๋ฅผ ์์ฐํ๋ฏ๋ก, IoT ์์คํ
์ ๋ฐ์ดํฐ ์์ค๊ฐ ์๊ตฌํ๋ ์์ค์ ๋ง๋ํ ๋ณผ๋ฅจ๊ณผ ์ฒ๋ฆฌ๋(Throughput)์ ์ง์ฐ ์์ด ์์งํ ์ ์๋ ๊ฐ๋ ฅํ ์ธํ๋ผ ๊ตฌ์กฐ๋ฅผ ๋ฐ๋์ ๊ฐ์ถฐ์ผ ํฉ๋๋ค [3].
-* **๋ณต์ก์ฑ ๋ฐ ๋น์ฉ ๊ตฌ์กฐ์ ์ฆ๊ฐ:** IoT ์ฒ๋ฆฌ์ ์ ํฉํ ๋ถ์ฐ ์ด๋ฒคํธ ์ํคํ
์ฒ๋ ๋ง์ดํฌ๋ก์๋น์ค๋ฅผ ๋์
ํ๋ฉด ํ์ฅ์ฑ์ ์ป์ ์ ์์ง๋ง, ๊ทธ ๋๊ฐ๋ก ๋คํธ์ํฌ ์ค๋ฒํค๋, ๋๋ฒ๊น
์ ์ด๋ ค์, ๋ฉ์์ง ๋ธ๋ก์ปค ์ ์ง ๋ฐ ํด๋ผ์ฐ๋ ์ธํ๋ผ ๋น์ฉ ์์น์ด๋ผ๋ ๋จ์ ์ ๊ฐ์ํด์ผ ํฉ๋๋ค [1, 16].
-
-## ๐ Knowledge Connections
-
-### Related Concepts
-
-#### [๊ด๊ณ ์ ํ A: ์ํคํ
์ฒ/๊ธฐ๋ฐ ๊ธฐ์ ]
-- [[Event-Driven Architecture Pattern]]
- - ์ฐ๊ฒฐ ์ด์ : IoT ๋๋ฐ์ด์ค์์ ์์ง๋๋ ์ค์๊ฐ ์ผ์ ๋ฐ์ดํฐ๋ฅผ ๋น๋๊ธฐ์ ์ผ๋ก ์ฒ๋ฆฌํ๊ณ ๋์ ํ์ฅ์ฑ์ ์ ๊ณตํ๋ ๊ฐ์ฅ ํต์ฌ์ ์ธ ์ํคํ
์ฒ์
๋๋ค [1, 4, 5].
- - ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ์ํ ๋ณํ(์ด๋ฒคํธ)๋ฅผ ์์ฐ, ์๋น, ๋ผ์ฐํ
ํ๋ ์๋ฆฌ์ ๋ธ๋ก์ปค/๋ฉ๋์์ดํฐ ํ ํด๋ก์ง์ ๊ตฌ์กฐ.
-- [[Serverless Architecture Pattern]]
- - ์ฐ๊ฒฐ ์ด์ : ํ์ผ ์
๋ก๋๋ IoT ๋ฐ์ดํฐ ์ฒ๋ฆฌ์ฒ๋ผ ๋ถ๊ท์นํ๊ฒ ๋ฐ์ํ๋ ์ด๋ฒคํธ ์ํฌ๋ก๋๋ฅผ ๊ด๋ฆฌ ์๋ฒ ์์ด ๋น์ฉ ํจ์จ์ ์ผ๋ก ์ฒ๋ฆฌํ ์ ์๊ฒ ํฉ๋๋ค [1, 11].
- - ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ํธ๋ํฝ ๊ธ์ฆ ์์ ์คํ ์ค์ผ์ผ๋ง ์๋ฆฌ์ ๊ณผ๊ธ ๋ชจ๋ธ, ์ด๋ฒคํธ ํธ๋ฆฌ๊ฑฐ ๋ฉ์ปค๋์ฆ.
-- [[Broker Architecture Pattern]]
- - ์ฐ๊ฒฐ ์ด์ : IoT ๋๋ฐ์ด์ค์ ํด๋ผ์ฐ๋ ์๋น์ค ๊ฐ์ ๋๊ท๋ชจ ํต์ ์ ์ฐ๊ฒฐํ๊ณ ๋ฉ์์ง๋ฅผ ๋ถ๋ฐฐํ๋ IoT ํ๋ธ์ ๊ธฐ๋ณธ ๊ตฌ์กฐ๊ฐ ๋ฉ๋๋ค [6, 12].
- - ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ํด๋ผ์ด์ธํธ์ ์๋ฒ ๊ฐ์ ๋น๊ฒฐํฉ ํต์ ๋ฐฉ์๊ณผ ๋ผ์ฐํ
, ๊ทธ๋ฆฌ๊ณ ๋จ์ผ ์ฅ์ ์ (SPOF) ๋์ ๋ฐฉ๋ฒ.
-- [[Microkernel Architecture Pattern]]
- - ์ฐ๊ฒฐ ์ด์ : ๊ณ ๋์ ๋ชจ๋์ฑ์ด ํ์ํ IoT ๊ธฐ๊ธฐ ์์ฒด์ ์๋ฒ ๋๋ ์ด์์ฒด์ ๋ ์ํํธ์จ์ด ์ค๊ณ์ ์ ์ฉ๋ฉ๋๋ค [13].
- - ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ์ฝ์ด ์์คํ
์ ์ ์งํ๋ฉด์ ํ๋ฌ๊ทธ์ธ์ ํตํด ๊ธฐ๋ฅ์ ํ์ฅํ๋ ๋ฐฉ๋ฒ๊ณผ ์ฃ์ง ๋๋ฐ์ด์ค ์ค๊ณ.
-
-#### [๊ด๊ณ ์ ํ B: ๋ฐ์ดํฐ ์ฒ๋ฆฌ ํจํด]
-- [[Event Stream Processing]]
- - ์ฐ๊ฒฐ ์ด์ : IoT ์ผ์ ๋ฐ์ดํฐ ์คํธ๋ฆผ๊ณผ ๊ฐ์ ๋๊ท๋ชจ/๊ณ ์์ ์ด๋ฒคํธ๋ฅผ ํ์ดํ๋ผ์ธ์ผ๋ก ์ญ์ทจ(Ingestion)ํ๊ณ ์ค์๊ฐ์ผ๋ก ๋ถ์ํ๋ ๋ฐ ์ฌ์ฉ๋ฉ๋๋ค [10].
- - ์ด ๊ฐ๋
์ ํตํด ๋ ๊น๊ฒ ์ดํดํ ์ ์๋ ๋ถ๋ถ: ์ด๋ฒคํธ ๋ก๊ทธ์ ์๊ตฌ ์ ์ฅ, ๋ฐ์ดํฐ ์ฌ์(Replay), ์๋์ฐ ๊ธฐ๋ฐ ์คํธ๋ฆผ ๋ถ์.
-
-### Deeper Research Questions
-
-- IoT ํ๊ฒฝ์์ Event-Driven Architecture๋ฅผ ์ฌ์ฉํ ๋, ๋ฉ์์ง ์ ์ค์ ๋ฐฉ์งํ๊ณ Guaranteed Delivery๋ฅผ ๋ณด์ฅํ๊ธฐ ์ํ ํ/์คํธ๋ฆผ์ ๊ธฐ์ ์ ๊ตฌ์ฑ ๋ฐ ์ค์ ๋ฐฉ๋ฒ์ ๋ฌด์์ธ๊ฐ?
-- ์๋ง์ IoT ์ผ์์์ ๋ฐ์ํ๋ ๋์ฉ๋ ๋ฐ์ดํฐ๋ฅผ ๋ณ๋ชฉ ์์ด ์์งํ๊ธฐ ์ํด Azure IoT Hub์ ๊ฐ์ ์ด๋ฒคํธ ์คํธ๋ฆผ ์ฒ๋ฆฌ ํ๋ซํผ์ ์ด๋ ํ ์ํคํ
์ฒ ๊ตฌ์กฐ๋ฅผ ํ์ฉํ๋๊ฐ?
-- IoT ๊ธฐ๊ธฐ(์ฃ์ง ๋๋ฐ์ด์ค)์ ์ํํธ์จ์ด์ Microkernel Architecture๋ฅผ ์ ์ฉํ ๋ ๋ฐ์ํ ์ ์๋ ์ฝ์ด์ ํ๋ฌ๊ทธ์ธ ๊ฐ์ ํต์ (IPC) ์ฑ๋ฅ ์ค๋ฒํค๋์ ๊ทธ ํด๊ฒฐ์ฑ
์ ๋ฌด์์ธ๊ฐ?
-- ์์ธก ๋ถ๊ฐ๋ฅํ IoT ํธ๋ํฝ ๊ธ์ฆ(Spikes)์ ์ฒ๋ฆฌํ๊ธฐ ์ํด Event-Driven ๋ฐฉ์๊ณผ Serverless Architecture๋ฅผ ํจ๊ป ์ค๊ณํ ๋ ๋ฐ์ํ๋ Cold Start ์ง์ฐ ๋ฌธ์ ๋ ์ด๋ป๊ฒ ๊ทน๋ณตํ ์ ์๋๊ฐ?
-- Hexagonal Architecture๋ฅผ ํ์ฉํ์ฌ ์ธ๋ถ IoT ์ผ์์ ๋ฐ์ดํฐ๋ฒ ์ด์ค, ํต์ฌ ๋น์ฆ๋์ค ๋ก์ง์ ๋ถ๋ฆฌํ ๋ ํฌํธ์ ์ด๋ํฐ์ ๊ตฌ์ฒด์ ์ธ ๊ตฌํ ์ ๋ต์ ๋ฌด์์ธ๊ฐ?
-
-### Practical Application Contexts
-
-- **Implementation:** ์ค๋งํธ ํฉํ ๋ฆฌ๋ ์๋ฃ ๋ชจ๋ํฐ๋ง ์์คํ
๊ตฌ์ถ ์, ์์ฒ ๊ฐ์ IoT ๋๋ฐ์ด์ค์์ ๋ฐ์ํ๋ ์ผ์ ๋ฐ์ดํฐ๋ฅผ Kafka๋ Azure IoT Hub ๊ฐ์ ๋ธ๋ก์ปค๋ฅผ ํตํด ํ์ดํ๋ผ์ธ์ผ๋ก ์ฐ๊ฒฐํ๋ ์์คํ
๊ตฌํ.
-- **System Design:** ์ด๋ฒคํธ ์คํธ๋ฆฌ๋ฐ ํจํด์ ์ ์ฉํ์ฌ ์ค์๋๊ฐ ๋์ ์๋ ์ด๋ฒคํธ๋ ์ฆ๊ฐ ์ฒ๋ฆฌํ๊ณ , ์ด๋ ฅ ๋ถ์ ๋ฐ์ดํฐ๋ ์ ์ฅ์์ ๊ธฐ๋ก ํ ๋น๋๊ธฐ๋ก ์ฒ๋ฆฌํ๋๋ก ์ค๊ณ.
-- **Operation / Maintenance:** Serverless ์ํคํ
์ฒ๋ฅผ ๋์
ํ์ฌ IoT ๋๋ฐ์ด์ค ๋ฐ์ดํฐ๊ฐ ๊ธ์ฆํ ๋ ๋ณ๋์ ์๋ฒ ํ๋ก๋น์ ๋ ์์ด ์๋์ผ๋ก ์์์ด ํ์ฅ๋๋๋ก ํ์ฌ ์ด์ ์ธํ๋ผ ๊ด๋ฆฌ ๋น์ฉ ๊ฐ์.
-- **Learning Path:** ๋ถ์ฐ ์์คํ
๋ฐ ๋ฉ์์ง ์งํฅ ๋ฏธ๋ค์จ์ด๋ฅผ ์ดํดํ ๋ค, ์ด๋ฅผ ๊ธฐ๋ฐ์ผ๋ก ์๋ํ๋ Event-Driven Architecture์ Broker Pattern์ ์๋ ๋ฐฉ์์ ํ์
ํ์ฌ ๋๊ท๋ชจ ๋ฐ์ดํฐ ์์คํ
์ค๊ณ ์ญ๋ ๊ฐํ.
-- **My Project Relevance:** ์ค์๊ฐ์ผ๋ก ๋ฐ์ํ๋ ๋์ฉ๋ ์ผ์ ๋ฐ์ดํฐ๋ฅผ ๊ธฐ๋ฐ์ผ๋ก ๋์ํ๋ ์ํํธ์จ์ด ์๋น์ค๋ฅผ ์ค๊ณํ ๋, ๋จ์ผ ๋ชจ๋๋ฆฌ์ ์ํคํ
์ฒ์ ํ๊ณ๋ฅผ ์ธ์ํ๊ณ EDA, ๋ง์ดํฌ๋ก์๋น์ค ๋ฑ ์๊ตฌ์ฌํญ์ ๋ถํฉํ๋ ์ ํฉํ ์ํคํ
์ฒ ํจํด์ ์ ์ ํ๋ ๊ธฐ์ค ํ๋ฆฝ.
-
-### Adjacent Topics
-
-- [[Microservices Architecture Pattern]]
- - ํ์ฅ ๋ฐฉํฅ: ๋ณต์กํ IoT ์ ํ๋ฆฌ์ผ์ด์
์ ๋ฐฑ์๋ ์์คํ
์ ๊ฐ๋ณ ๋น์ฆ๋์ค ๋๋ฉ์ธ ๋จ์๋ก ๋๋์ด ๋
๋ฆฝ์ ์ผ๋ก ๋ฐฐํฌ ๋ฐ ํ์ฅํ ์ ์๋ MSA์ ์ฅ๋จ์ ๋ฐ ์ค๊ณ ์์น ํ๊ตฌ.
-- [[Hexagonal Architecture (Ports and Adapters)]]
- - ํ์ฅ ๋ฐฉํฅ: ์ธ๋ถ ์ฅ์น(IoT ์ผ์)๋ ํน์ ๊ธฐ์ ์์์ ์์กดํ์ง ์๋ ์์ํ ๋๋ฉ์ธ ๋ก์ง์ ๋ณดํธํ๊ธฐ ์ํด ๊ด์ฌ์ฌ๋ฅผ ๋ถ๋ฆฌํ๊ณ ์์กด์ฑ์ ์ญ์ ์ํค๋ ์ค๊ณ ๋ฐฉ์ ์ฐ๊ตฌ.
-
----
-*Last updated: 2026-05-02*
\ No newline at end of file
diff --git a/10_Wiki/Topics/03_DevOps_Environment/Modern_Environment_Ecosystem.md b/10_Wiki/Topics/03_DevOps_Environment/Modern_Environment_Ecosystem.md
deleted file mode 100644
index 40949316..00000000
--- a/10_Wiki/Topics/03_DevOps_Environment/Modern_Environment_Ecosystem.md
+++ /dev/null
@@ -1,26 +0,0 @@
----
-title: ๋ชจ๋ ๊ฐ๋ฐ ํ๊ฒฝ ๋ฐ ํ๋ ์์ํฌ ์ํ๊ณ
-category: Software [[Architecture|Architecture]]
-tags: [Vite, [[Next.js|Next.js]], Ecosystem, Modern Stack]
-created: 2026-04-20
----
-
-# [[Modern_Environment_Ecosystem|Modern_Environment_Ecosystem]] (๋ชจ๋ ๊ฐ๋ฐ ์ํ๊ณ)
-
-## ๐ ํ ์ค ํต์ฐฐ (The Karpathy Summary)
-> ๋๊ตฌ๋ ๋ชฉ์ ์ด ์๋๋ผ '์์ฐ์ฑ'์ ์ํ ์๋จ์ด๋ค. ํ์ง๋ง ์ต์ ์ํ๊ณ์ ๋ณํ๋ฅผ ๋์น๋ ๊ฒ์ ์ค์ค๋ก ์์ฐ์ฑ์ ๊น์๋ด๋ ๊ฒ๊ณผ ๊ฐ๋ค.
-
-## ๐ ๊ตฌ์กฐํ๋ ์ง์ (Synthesized Content)
-- **Build Tools: Vite vs Webpack**:
- - `Vite`๋ ๋ค์ดํฐ๋ธ ESM์ ํ์ฉํ์ฌ ๊ฐ๋ฐ ์๋ฒ ๊ตฌ๋ ์๋๋ฅผ ํ์ ์ ์ผ๋ก ์ค์๋ค. ํ๋ก์ ํธ ๊ท๋ชจ๊ฐ ์ปค์ง์๋ก Vite์ HMR(Hot Module Replacement) ์๋๋ ๋น์ ๋ฐํ๋ค.
-- **Framework: Next.js (The Fullstack Edge)**:
- - ๋จ์ํ SEO๋ฅผ ์ํ SSR ๋๊ตฌ๊ฐ ์๋๋ค. API Routes๋ฅผ ํตํ ์๋ฒ๋ฆฌ์ค ํจ์ ๊ตฌํ, ๋ฐ์ดํฐ ์บ์ฑ ์ ๋ต(ISR/SSG) ๋ฑ ํ๋ ์น์ด ์๊ตฌํ๋ ๊ฑฐ์ ๋ชจ๋ ๊ธฐ๋ฅ์ ํ์ฌํ '๊ฑฐ๋ฒ๋์ค' ๊ทธ ์์ฒด๋ค.
-- **ํจํค์ง ๋งค๋์ ์ ์ ํ**:
- - `pnpm` ๋๋ `npm v7+`์ ์ํฌ์คํ์ด์ค ๊ธฐ๋ฅ์ ํตํด ๋ชจ๋
ธ๋ ํฌ([[Monorepo|Monorepo]]) ๊ตฌ์กฐ๋ฅผ ํจ์จ์ ์ผ๋ก ๊ด๋ฆฌํ๊ณ , ํจํค์ง ์ค๋ณต ์ค์น๋ฅผ ์ต์ํํ์ฌ ๋น๋ ์ฑ๋ฅ์ ์ต์ ํํ๋ค.
-
-## โ ๏ธ ๋ชจ์ ๋ฐ ์
๋ฐ์ดํธ (RL Update)
-- ์ต์ ๊ธฐ์ ์ด ํญ์ ์ ๋ต์ ์๋๋ค. ์์ ์ฑ์ด ์ต์ฐ์ ์ธ ๊ธฐ์
ํ๊ฒฝ์์๋ ๊ฒ์ฆ๋ `CRA` ํน์ `Webpack` ๊ธฐ๋ฐ์ ์ค์ ์ ์ ์งํ๋ ๊ฒ์ด ๋ณด์์ ์ธ ๋ฉด์์ ์ ๋ฆฌํ ์ ์๋ค. ๊ธฐ์ ๋ถ์ฑ(Tech Debt)์ ๋์
๋น์ฉ์ ํญ์ ์ ์ธ์งํ๋ผ.
-
-## ๐ ์ง์ ์ฐ๊ฒฐ (Graph)
-- Related: [[Deployment_Final_Gate|Deployment_Final_Gate]] , Project_Architecture_Guidelines
-- Foundation: [[TypeScript_Type_Safety|TypeScript_Type_Safety]]
diff --git a/10_Wiki/Topics/03_DevOps_Environment/Tetris_Project_Retrospective.md b/10_Wiki/Topics/03_DevOps_Environment/Tetris_Project_Retrospective.md
deleted file mode 100644
index fc46e7c0..00000000
--- a/10_Wiki/Topics/03_DevOps_Environment/Tetris_Project_Retrospective.md
+++ /dev/null
@@ -1,30 +0,0 @@
----
-title: ํ๋ก์ ํธ ํ๊ณ : ๊ณ ์ฑ๋ฅ ํ
ํธ๋ฆฌ์ค ์ํคํ
์ฒ
-category: Projects
-tags: [Retrospective, Tetris, [[Architecture|Architecture]], Performance]
-created: 2026-04-20
----
-
-# ํ๋ก์ ํธ ํ๊ณ : ๊ณ ์ฑ๋ฅ ํ
ํธ๋ฆฌ์ค ์ํคํ
์ฒ ([[P-Reinforce|P-Reinforce]])
-
-## ๐ ํ๋ก์ ํธ ์ํคํ
์ฒ ์์ฝ
-๋ณธ ํ๋ก์ ํธ๋ **Web Worker**๋ฅผ ํ์ฉํ ์์ ํ ์ฐ์ฐ-๋ ๋๋ง ๋ถ๋ฆฌ๋ฅผ ์คํํ์ฌ, ์ค์๊ฐ ๊ฒ์ ํ๊ฒฝ์์ ๊ทน๊ฐ์ ๋ถ๋๋ฌ์์ ํ๋ณดํ๋ ๋ฐ ์ฑ๊ณตํ์ต๋๋ค.
-
-### ๐งฉ ์ปดํฌ๋ํธ๋ณ ๊ธฐ์ ์ ์ญํ
-- **Game Engine**: ๋ฌผ๋ฆฌ ๊ณ์ฐ ๋ฐ ์ํ ์ ์ด (`public/gameWorker.js`).
-- **[[State|State]] Manager**: UI์ ์ ์ผํ ์ง์ค ๊ณต๊ธ์ (`src/App.js`).
-- **Renderer**: Props ๊ธฐ๋ฐ์ ์์ ๋งคํ ๋ ๋๋ฌ (`src/components/GameBoard.jsx`).
-
-## โ ๏ธ ํต์ฌ ๊ตํ ([[Lessons Learned|Lessons Learned]])
-> [!IMPORTANT]
-> **"๋
ผ๋ฆฌ๊ฐ ์๋ฒฝํด๋ ์คํ ํ๊ฒฝ์ด ๋ฌด๋์ง๋ฉด ์๋ฌด ์๋ฏธ๊ฐ ์๋ค."**
-> ์ํคํ
์ฒ ์ค๊ณ๋งํผ์ด๋ 'ํ์ผ ๋ฌด๊ฒฐ์ฑ ๊ฒ์ฆ'๊ณผ 'ํ๊ฒฝ ์ฌ์ค์ ๋ฃจํด'์ด ๊ฐ๋ฐ ์์ฐ์ฑ์ ์ง๋ํ ์ํฅ์ ๋ฏธ์น๋ค๋ ๊ฒ์ ํ์ธํ์ต๋๋ค.
-
-## ๐ ์ฑ๊ณผ
-- [x] Web Worker ๊ธฐ๋ฐ ๋น๋๊ธฐ ์์ง ๊ตฌ์ถ ์๋ฃ.
-- [x] ํ์ค ํต์ ํ๋กํ ์ฝ ๊ธฐ๋ฐ์ Decoupling ์ฑ๊ณต.
-- [x] ์ฒด๊ณ์ ์ธ ๋๋ฒ๊น
ํ๋กํ ์ฝ ์๋ฆฝ.
-
-## ๐ ์ฐ๊ฒฐ๋ ์ง์
-- [[System_Debugging_Protocol|System_Debugging_Protocol]]
-- Project_Architecture_Guidelines
diff --git a/10_Wiki/Topics/04_Governance_Reliability/Accessibility_Inclusivity.md b/10_Wiki/Topics/04_Governance_Reliability/Accessibility_Inclusivity.md
deleted file mode 100644
index 7aaaa770..00000000
--- a/10_Wiki/Topics/04_Governance_Reliability/Accessibility_Inclusivity.md
+++ /dev/null
@@ -1,26 +0,0 @@
----
-title: ์น ์ ๊ทผ์ฑ ๋ฐ ํฌ์ฉ์ ์ค๊ณ (a11y)
-category: Software [[Architecture|Architecture]]
-tags: [[Accessibility|[Accessibility]], a11y, Semantic HTML, Inclusivity]
-created: 2026-04-20
----
-
-# [[Accessibility_Inclusivity|Accessibility_Inclusivity]] (ํฌ์ฉ์ ์ค๊ณ์ ์ ๊ทผ์ฑ)
-
-## ๐ ํ ์ค ํต์ฐฐ (The Karpathy Summary)
-> ์น์ '๋ชจ๋'๋ฅผ ์ํ ๊ณต๊ฐ์ด์ด์ผ ํ๋ค. ์ ์ฒด์ ์ ์ฝ์ด ์์คํ
์ด์ฉ์ ์ ์ฝ์ด ๋์ง ์๊ฒ ํ๋ ๊ฒ์ '๋งค๋'๊ฐ ์๋๋ผ ์ ๋ฌธ ๊ฐ๋ฐ์์ '์ฑ
์'์ด๋ค.
-
-## ๐ ๊ตฌ์กฐํ๋ ์ง์ (Synthesized Content)
-- **Semantic HTML (์๋ฏธ๋ก ์ ํ๊ทธ)**:
- - `
`๋ก๋ง ๋๋ฐฐํ์ง ๋ง๋ผ. `
`, ``, ``, `