Fix: Restore unified Topics folder and reorganize specialized category folders

2026-05-02 23:25:02 +09:00
parent b71a0b82d3
commit fdfbc83535
6241 changed files with 147626 additions and 194 deletions
@@ -0,0 +1,47 @@
+# 💰 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`