# 💰 Meta-Economy & Growth Loop (메타 경제 및 성장 루프)

> **카테고리**: Skybound, Game Design, Economics & Algorithms
> **상태**: 🔵 구현 완료 (Implemented)
> **최종 업데이트**: 2026-04-22

---

## 📌 개요 (Overview)
Skybound의 장기 리텐션을 책임지는 메타 게임 시스템이다. 격렬한 인게임 세션이 종료된 후, 플레이어는 획득한 Gold와 자원을 사용하여 격납고(Hangar)에서 영구적인 성장을 도모한다.

## 🛠️ 시스템 구성 (System Components)

### 1. 영구 업그레이드 (Permanent Upgrade)
- **Hangar Shop**: 인게임에서 획득한 Gold를 소모하여 HP, ATK, SPEED, MAGNET, GOLD_GAIN 등 5종의 스탯을 영구 강화.
- **Stat Injection Engine**: 구매한 업그레이드 레벨은 매 세션 시작 시 `calculateEffectiveStats`를 통해 플레이어 기체에 즉시 주입됨.
- **지수적 비용 곡선**: 후반부 성장을 위해 레벨업 비용이 지수적으로 증가(300~8000G)하도록 설계.

### 2. 크래프팅 경제 (Crafting Economy)
아이템의 가치 보존과 인플레이션 방지를 위한 복합 제작 시스템이다.
- **Disassemble (분해)**: 불필요한 장비를 분해하여 제작 재료(`Eternal Core`, `Destruction Core`, `TechMats`)를 확보.
- **Cosmic Cast (코스믹 캐스트)**: 고가치의 재료를 대량 소모하여 자연 드롭으로 획득 불가능한 **SS급 장비**를 확정 제작.
- **Astral Forge (아스트랄 포지)**: SS/LEGEND급 장비에 S급 장비를 제물로 바쳐 `forgeLevel`(+1~5)을 강화.
- **TechPart Merge**: 동일 등급의 테크 파츠를 합성하여 스탯 보너스(`plusLevel`)를 강화.

### 3. 이벤트 패스 (Event Pass)
- **Atomic Trigger**: 보스 처치, 스테이지 클리어 등 인게임 이벤트 발생 시 실시간으로 패스 포인트 적립.
- **Consolation Reward**: 런 실패 시에도 플레이 시간에 비례하여 포인트가 지급되어 "실패해도 진전이 있다"는 심리적 보상 제공.
- **Reward Tiers**: 특정 티어 도달 시 S/SS급 확정 쿠폰 등 고가치 보상 지급.

## 💡 경제 순환 구조 (Economy Pipeline)
```mermaid
graph TD
    A[적 처치 / 런 완료] -->|Gold / 재료 드롭| B(Hangar)
    B --> C{선택}
    C -->|Gold 소모| D[Permanent Upgrade]
    C -->|장비 분해| E[Crafting Materials]
    E -->|제작| F[SS_CLASS Equipment]
    F -->|포지 강화| G[End-game Stats]
    A -->|Pass Points| H[Event Pass Tier Up]
    H -->|보상| I[S/SS Coupon]
    I -->|사용| F
```

---
**승인인**: AI 개발부장 코다리 🫡
**관련 코드**: `useGameStore.ts`, `HangarOverlay.tsx`, `combatUtils.ts`, `LootGenerator.ts`
