2nd/00_Raw/2026-04-22_CombatProgression_Finalization.md

작업 로그: 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)