[P-Reinforce] Global knowledge consolidation, massive deduplication (5,249 files), and high-density wikification (45 nodes)

2026-05-05 15:28:22 +09:00
parent a7d1e60ccf
commit dd01e01bea
3430 changed files with 42739 additions and 52263 deletions
@@ -0,0 +1,33 @@
+# 🕵️ Skybound: Boss Combat [[Stability]] Fix Log (2026-04-23)
+
+## 1. Issue Overview (이슈 개요)
+- **Problem**: 보스 기체의 체력이 0이 되었음에도 불구하고 파괴되지 않고 게임이 정지되거나, `STAGE_CLEAR` 페이즈로 전환되지 않는 결함 발생.
+- **Occurrence**: 특정 페이즈(BOSS_INTRO) 또는 특정 무기 조합에서 보스 처치 시 간헐적 발생.
+
+## 2. Root Cause [[Analysis]] (원인 분석)
+
+### 🔍 [[Logic]]al Flaws
+1. **Scope Restriction**: 기존 사망 판정 로직이 `BOSS` 페이즈 내부에만 존재하여, `BOSS_INTRO` 연출 도중 보스가 파괴될 경우 이를 감지하지 못함.
+2. **Entity Lifecycle**: 보스 엔티티 파괴 후에도 `[[State]].boss` 참조가 남아있어, 렌더러와 AI 시스템이 유령 객체를 계속 업데이트하려고 시도함.
+3. **HUD Desync**: 보스의 실제 HP와 HUD의 게이지 바 업데이트 주기가 일치하지 않아 유저에게 혼동을 줌.
+
+## 3. Implemented Fixes (수정 사항)
+
+### 🛠️ Core Engine Modification
+- **Unified Death Check**: `StageDirectorSystem.checkBossDefeat()` 메서드로 로직을 통합하여 모든 보스 관련 페이즈에서 사망을 실시간 감지하도록 수정.
+- **Explicit Nullification**: 보스 파괴 즉시 `state.boss = null`을 수행하여 시스템의 불필요한 참조를 원천 차단.
+- **Feedback Reinforcement**: 
+  - 보스 사망 시 8개의 순차적 폭발(`Explosion`) 생성.
+  - 화면 흔들림(`SHAKE`) 강도 증가 및 지속 시간 조정.
+
+### 📊 HUD Synchronization
+- `useGameEngine.ts` 루프 내에 HP 퍼센트(`hp / maxHp`) 동기화 로직 추가.
+
+## 4. Verification (검증 결과)
+- **Test Case 1**: 보스 등장 애니메이션 도중 처치 시 정상적으로 스테이지 클리어 전환 확인. (Pass)
+- **Test Case 2**: 보스 사망 후 렌더러의 Null 참조 에러 발생 여부 확인. (Pass)
+- **Test Case 3**: HUD HP 바 실시간 동기화 확인. (Pass)
+
+---
+**Related Cluster**: [[05_Project_Issues/2026-04-21_Stability_and_[[Optimization]]_Report|Stability & Optimization]]
+**Status**: Resolved & Wikified 🫡
@@ -0,0 +1,41 @@
+# 👾 Boss Encounter & Timeline Design
+
+**Category:** Combat Design / Level Design
+**Status:** Optimized (v12.1)
+**Related:** [[02_Combat_AI/[[Combat-System-and-Bullet-Interaction-Pipeline]]|Combat System]], [[04_Mechanics_Progression/Campaign_and_Dual_Loop[[_system]]|Campaign System]]
+
+---
+
+## 1. Timeline Compression [[Strategy]]
+Skybound의 전투는 '긴장감의 밀도'를 최우선으로 한다. 기존의 지루한 대기 시간을 제거하고 핵심 인카운터를 전면에 배치한다.
+
+### A. Accelerated Engagement
+- **초반 30초**: 기본 적 편대와의 교전으로 빌드업.
+- **60초 지점**: 중간 보스 또는 특수 기믹 적기 등장.
+- **120초 지점**: 스테이지 최종 보스 조우 (기존 대비 50% 단축).
+
+### B. Power Spike Reward
+- 보스 조우 30초 전, 확정적인 **AoE/Knockback** 스킬 보상을 지급하여 보스전의 '화력 투사' 준비를 도움.
+
+---
+
+## 2. Advanced Boss Mechanics
+
+### 🛡️ Multi-Part Destruction (부위 파괴)
+보스는 단일 개체가 아닌 다중 파츠의 집합체로 구성된다.
+- **Core (핵심)**: 보스의 생명력. 파괴 시 최종 승리.
+- **Wings (날개)**: 보스의 이동 속도 및 회피 기동 제어. 파괴 시 기동성 50% 저하.
+- **Turrets (포탑)**: 주력 화력. 파괴 시 특정 공격 패턴(예: 탄막 방사) 봉쇄.
+
+### 📊 Loot Integration
+- **Guaranteed Drop**: 보스 처치 시 최소 Rare 등급 이상의 모듈 확정 드롭.
+- **Scaling Loot**: 스테이지 인덱스가 높을수록 전설(Legendary) 등급 드롭률 지수적 상승.
+
+---
+
+## 3. Deployment [[Logic]]
+- **Module**: `CombatTimeline.ts`, `ProgressionSystem.ts`
+- **Configuration**: `getStandardTimeline()` 팩토리 함수를 통한 스테이지별 특화 타임라인 생성.
+
+---
+**Last Updated:** 2026-04-22 🫡