Fix: Restore unified Topics folder and reorganize specialized category folders

This commit is contained in:
Antigravity Agent
2026-05-02 23:25:02 +09:00
parent b71a0b82d3
commit fdfbc83535
6241 changed files with 147626 additions and 194 deletions
@@ -0,0 +1,34 @@
# ISSUE REPORT: [v13.1] Engine Stabilization & Tactical Boundary Overhaul
## 1. 개요
Skybound 엔진의 초기 구동 안정성을 확보하고, 게임의 장르적 성향(전략 슈터)을 강화하기 위한 적기 이동 로직 및 레벨업 시스템의 결함을 해결함.
## 2. 해결된 결함 (Level-Up Loop)
### 2.1 현상
- 게임 시작 직후 `TAC LEVEL UP` 모달이 무한 반복 출력되어 조작 불능 상태 발생.
- 엔진 내부 레벨과 Zustand 스토어 레벨 간의 동기화 불일치.
### 2.2 원인 분석
- `StageDirectorSystem`: 타임라인 이벤트가 최소 시간 가드 없이 초기화 시점에 조기 발동.
- `ProgressionSystem`: 스킬 선택 시 Zustand 구독과 엔진 로직 양쪽에서 레벨을 이중 증가시킴.
### 2.3 수정 사항
- **StageDirectorSystem**: 15초/30초 최소 시간 가드 및 `processed[[Events|Events]]econds` 중복 발동 방지 락 도입.
- **ProgressionSystem**: 이중 증가 로직 제거 및 Zustand [[Single_Source_of_Truth|Single Source of Truth]](SSOT) 강화.
- **UI**: `LevelUpModal``isChest` 플래그를 추가하여 일반 레벨업과 보급품(Supply Drop) 보상을 시각적으로 분리.
## 3. 기능 개선 (Enemy Tactical Boundary)
### 3.1 현상
- 적기가 격파되지 않은 상태에서 화면 하단으로 유유히 사라짐 (전통적 슈팅 게임 방식).
- 플레이어의 전략적 대응 영역 및 경험치 수급 기회 상실.
### 3.2 수정 사항 (CombatSystem)
- **Boundary Clamp**: 적기의 이동 허용 범위를 `height + 300`에서 `height - 40`으로 타이트하게 조정.
- **Chase Pattern**: 플레이어 추격 시 화면 하단 경계를 인식하도록 가드 추가.
- **Zigzag Pattern**: 화면 하단 도달 시 방향을 반전시키는 '핑퐁(Ping-pong)' 패턴으로 업그레이드.
- **Striker AI**: 하단 돌진 후 상단으로 복귀하는 순찰 로직 추가.
## 4. 기대 효과
- **안정성**: 게임 초기화 및 재개 시 발생하는 상태 데드락 원천 차단.
- **전략성**: 모든 적이 화면 내에 유지됨으로써 플레이어의 통제권 강화 및 생존 슈터로서의 긴장감 극대화.
- **경제**: 경험치 젬 및 루트 아이템의 화면 밖 유실 방지.