[P-Reinforce] 2026-04-20: Advanced System Architecture & Debugging Protocols Established

.obsidian/workspace.json

@@ -178,6 +178,10 @@
   },
   "active": "5e19c94f304a33d1",
   "lastOpenFiles": [
+    "Tetris_Project_Retrospective.md",
+    "System_Debugging_Protocol.md",
+    "System_Protocol_Standard.md",
+    "Project_Architecture_Guidelines.md",
     "Systemic_Simulation_Principles.md",
     "DevOps_Environment_Setup.md",
     "Separation_of_Concerns.md",

Project_Architecture_Guidelines.md

@@ -0,0 +1,29 @@
+---
+title: 시스템 설계 가이드라인 (Separation of Concerns)
+category: Software Architecture
+tags: [Architecture, SoC, Modular Design, Layered Architecture]
+created: 2026-04-20
+---
+
+# 시스템 설계 가이드라인 (아키텍처 레이어링)
+
+## 🎯 핵심 목표
+시스템의 각 부분이 독립적으로 작동하며 서로에게 최소한의 영향만 주도록 하는 **관심사의 분리(SoC)**를 극대화합니다.
+
+## 🧱 핵심 레이어 (The Three Pillars)
+1.  **Domain Engine (핵심 규칙)**: 
+    *   물리 법칙, 비즈니스 로직 담당. 
+    *   원칙: **외부 환경 비의존성**. Web Worker 등을 통한 스레드 독립성 확보.
+2.  **State Management (진실의 출처)**: 
+    *   **단일 진실 공급원(SSOT)** 패턴 준수. 
+    *   원칙: 모든 데이터 변경은 오직 이 레이어를 통해서만 발생함.
+3.  **Presentation Layer (렌더링)**: 
+    *   데이터 가시화 담당. 
+    *   원칙: 비즈니스 로직 포함 금지. 순수하게 받은 데이터만 표현.
+
+## 🔁 통신 지침
+- **Decoupling**: 컴포넌트 간 직접 호출 대신 메시지/이벤트 기반 통신 지향.
+
+## 🔗 연결된 지식
+- [[System_Protocol_Standard]]
+- [[WebWorker_Performance]]

System_Debugging_Protocol.md

@@ -0,0 +1,27 @@
+---
+title: 단계별 시스템 디버깅 체크리스트 (L1~L3)
+category: Software Architecture
+tags: [Debugging, Troubleshooting, Checklist, Process]
+created: 2026-04-20
+---
+
+# 단계별 시스템 디버깅 체크리스트 (The Diagnostic Flowchart)
+
+## 🔍 L1: 환경 및 무결성 검증 (Low Level)
+- **대상**: 404 Error, Syntax Error, 파일 경로.
+- **목표**: **'실행 가능한 물리적 토대'**가 마련되어 있는가?
+- **필수 조치**: 강제 새로고침(Ctrl + F5), 서버 재시작(Restart Ritual).
+
+## 🔍 L2: 통신 및 데이터 흐름 검증 (Communication)
+- **대상**: `onmessage`, `postMessage`, 비동기 처리.
+- **목표**: 메시지가 의도한 대로 흐르고 있는가?
+- **필수 조치**: 데이터 흐름 추적(`console.log`), 핸들러 동작 유무 확인.
+
+## 🔍 L3: 논리 엔진 및 비즈니스 검증 (High Level)
+- **대상**: 비즈니스 로직, 수학적 공식, 물리 엔진.
+- **목표**: 코드가 논리적으로 무결한가?
+- **필수 조치**: 최소 실행 예제(MRE)를 통한 격리 테스트.
+
+## 🔗 연결된 지식
+- [[Tetris_Project_Retrospective]]
+- [[DevOps_Environment_Setup]]

System_Protocol_Standard.md

@@ -0,0 +1,26 @@
+---
+title: 표준 시스템 통신 프로토콜 및 상태 제어
+category: Software Architecture
+tags: [Protocol, State Machine, Data Exchange, Lifecycle]
+created: 2026-04-20
+---
+
+# 표준 시스템 통신 프로토콜 및 상태 제어
+
+## 📡 데이터 교환 규약 (Standard Protocol)
+모든 컴포넌트 간 통신은 예측 가능한 형태를 유지해야 합니다.
+- **포맷**: `{ type: 'ACTION_TYPE', payload: { data: value } }`
+- **주요 액션 타입**:
+    - `INIT`: 시스템 초기화 및 동기화 시작.
+    - `KEY_INPUT`: 사용자 인터랙션 데이터 전송.
+    - `UPDATE`: 엔진 계산 결과의 브로드캐스트.
+
+## 🔄 시스템 생명 주기 (Life Cycle)
+시스템은 [초기화 $\rightarrow$ 활성 루프 $\rightarrow$ 종료/정리]의 명확한 단계를 거쳐야 리소스 누수(Memory Leak)를 방지할 수 있습니다.
+
+## 🚨 상태 머신 (State Machine) 도입
+시스템 복잡도가 임계치를 넘을 경우, `READY`, `RUNNING`, `PAUSED` 등 상태를 명시적으로 제어하는 **State Machine** 적용을 원칙으로 삼습니다.
+
+## 🔗 연결된 지식
+- [[Project_Architecture_Guidelines]]
+- [[Single_Source_of_Truth]]

Tetris_Project_Retrospective.md

@@ -0,0 +1,30 @@
+---
+title: 프로젝트 회고: 고성능 테트리스 아키텍처
+category: Projects
+tags: [Retrospective, Tetris, Architecture, Performance]
+created: 2026-04-20
+---
+
+# 프로젝트 회고: 고성능 테트리스 아키텍처 (P-Reinforce)
+
+## 🌊 프로젝트 아키텍처 요약
+본 프로젝트는 **Web Worker**를 활용한 완전한 연산-렌더링 분리를 실현하여, 실시간 게임 환경에서 극강의 부드러움을 확보하는 데 성공했습니다.
+
+### 🧩 컴포넌트별 기술적 역할
+- **Game Engine**: 물리 계산 및 상태 전이 (`public/gameWorker.js`).
+- **State Manager**: UI의 유일한 진실 공급원 (`src/App.js`).
+- **Renderer**: Props 기반의 순수 매핑 렌더러 (`src/components/GameBoard.jsx`).
+
+## ⚠️ 핵심 교훈 (Lessons Learned)
+> [!IMPORTANT]
+> **"논리가 완벽해도 실행 환경이 무너지면 아무 의미가 없다."**
+> 아키텍처 설계만큼이나 '파일 무결성 검증'과 '환경 재설정 루틴'이 개발 생산성에 지대한 영향을 미친다는 것을 확인했습니다.
+
+## 🏆 성과
+- [x] Web Worker 기반 비동기 엔진 구축 완료.
+- [x] 표준 통신 프로토콜 기반의 Decoupling 성공.
+- [x] 체계적인 디버깅 프로토콜 수립.
+
+## 🔗 연결된 지식
+- [[System_Debugging_Protocol]]
+- [[Project_Architecture_Guidelines]]