docs: record combat progression implementation raw data

00_Raw/2026-04-22_CombatProgression_Finalization.md

@@ -0,0 +1,56 @@
+# 작업 로그: Combat Progression — Nova Burst, Permanent Upgrades & Event Pass 구현
+
+## 📋 작업 내용 (What)
+Skybound 프로젝트의 핵심 성장 루프(Dopamine Loop)를 완성하기 위해 다음 3대 요소를 구현함:
+1. **Nova Burst (aoe_nova)**: 광범위 충격파 및 넉백 기능을 갖춘 신규 액티브 스킬 인게임 로직 구현.
+2. **Permanent Upgrade (Hangar Shop)**: 런 간 유지되는 기체 스탯 영구 강화 시스템 및 전용 상점 UI 구축.
+3. **Event Pass System**: 포인트 적립형 티어 시스템 및 S/SS급 장비 보장 쿠폰 보상 체계 수립.
+
+## 🎯 왜 했는지 (Why)
+- **전투 카타르시스 부족**: 기존 스킬들은 투사체 중심이라 '물량'을 한 번에 정리하는 쾌감이 부족함.
+- **메타 게임 부재**: 게임이 끝나면 모든 성장이 초기화되어 장기 리텐션(Retention) 유인이 약함.
+- **아이템 가치 인플레이션 방지**: S/SS급 아이템이 너무 쉽게 드롭되지 않도록 희귀도를 극한으로 조정하고, 확정 획득 경로(Pass/Crafting)를 명확히 함.
+
+## 💡 기대값 (Expected Value)
+- **Nova Burst**: 5초마다 발생하는 강력한 충격파로 위기 탈출 및 대량 처치 쾌감 (Dopamine Spike).
+- **영구 성장**: 골드(Gold) 소모처를 제공하여 "한 판 더" 할 이유를 제공 (Meta-Progression).
+- **희귀도 밸런스**: SS급 장비의 자연 드롭율을 0%로 설정하여 제작(Cosmic Cast) 및 패스 최종 보상의 가치 극대화.
+- **UI 일관성**: Hangar 내 7개 탭(EQUIP, MERGE, DISASSEMBLE, COSMIC, FORGE, UPGRADE, PASS) 통합 관리.
+
+## 🔧 처리 과정 (How)
+
+### 1. ModularWeaponSystem.ts (Nova Burst 로직)
+- `updateNovaBurst()`: 5/4/3초 주기로 동작하는 전방위 충격파 로직 구현.
+- **넉백 물리**: 중심점으로부터의 거리(dist)에 반비례하는 벡터 힘을 적군 vx, vy에 가산.
+- **시각 연출**: Lv1~2(16방향 링), Lv3(24방향 2중 링) 파티클 및 강력한 화면 흔들림(Screen Shake) 연동.
+
+### 2. useGameStore.ts (상태 관리 확장)
+- `permanentUpgrades`: HP, ATK, SPEED, MAGNET, GOLD_GAIN 5종 스탯 정의 (최대 5레벨).
+- `purchasePermanentUpgrade()`: Gold 차감 및 지수적 비용(300~8000G) 테이블 적용.
+- `eventPass`: 500pts당 1티어 상승, Tier 10(S급 쿠폰), Tier 20(SS급 쿠폰) 보상 로직 구현.
+
+### 3. LootGenerator.ts (희귀도 조정)
+- `rollLoot()`: S급(엘리트 1.5%), SS급(자연 드롭 0%)으로 드롭률 극한 하향 조정.
+- `rollWithCoupon()`: 패스 보상용 S/SS급 확정 생성 메서드 추가.
+
+### 4. HangarOverlay.tsx & CSS (UI/UX)
+- **탭 확장**: 기존 5탭에서 UPGRADE(🛸), PASS(🎫) 포함 7탭으로 확장.
+- **UPGRADE UI**: 레벨별 Pip 바(5칸) 시각화 및 구매 가능 여부 실시간 피드백.
+- **PASS UI**: 티어 진행도 바, 마일스톤 카드, 프리미엄 패스 구매 CTA 구현.
+- **Premium Style**: 네온 블루/황금색 그라디언트, 마이크로 애니메이션(Hover Scale) 적용.
+
+## 🧠 사용한 지식 (Knowledge Used)
+- **Dopamine Loop Design**: 'Pop Effect'와 'Satisfaction of Scale'을 위한 파티클/넉백 결합.
+- **Resource Scarcity**: 고가치 자산(SS_CLASS)의 인위적 희소성 관리.
+- **Exponential Cost Curve**: 후반부 성장을 위한 지수적 비용 설계.
+- **Meta-Progression Architecture**: Zustand를 이용한 영구 상태(Persistent State) 관리.
+
+## ✅ 결과 (Result)
+- TypeScript 에러 0개 (`npx tsc --noEmit` 통과)
+- Git Commit: `0ac0084` (feat_nova_burst_perm_upgrade_event_pass)
+- Push 완료: `origin/main`
+
+## 🔗 연결 지식 (Relevant Knowledge)
+- E:\Wiki\2nd\10_Wiki\Topics\Game-Design (Meta-Progression, Dopamine Loop, Scarcity)
+- E:\Wiki\2nd\10_Wiki\Topics\Software-Architecture (Persistent State, Action-Reducer Pattern)
+- E:\Wiki\2nd\10_Wiki\Topics\UI-UX (Tab System, Progress Visualization)