update

prompt/00_project_context_restore.md

@@ -0,0 +1,72 @@
+# 00. 프로젝트 컨텍스트 및 복구 (Project Context & Restore Point)
+
+이 파일은 다른 개발 환경이나 새로운 AI 세션에서 프로젝트의 현재 상태를 빠르게 파악하고 작업을 이어가기 위해 작성되었습니다.
+
+## 1. 프로젝트 개요
+*   **프로젝트명:** Colosseum's Choice
+*   **플랫폼:** Flutter (Android/iOS/Web/Desktop)
+*   **장르:** 텍스트 기반의 턴제 RPG + GUI (로그라이크 요소 포함)
+*   **상태:** 프로토타입 단계 (핵심 전투 및 루프 구현 완료)
+
+## 2. 현재 구현된 핵심 기능 (Feature Status)
+
+### A. 게임 흐름 (Game Flow)
+1.  **메인 메뉴 (`MainMenuScreen`):** 게임 시작 버튼.
+2.  **캐릭터 선택 (`CharacterSelectionScreen`):** 현재 'Warrior' 직업만 구현됨. 선택 시 게임 초기화.
+3.  **메인 게임 (`MainWrapper`):** 하단 탭 네비게이션 (Battle / Inventory).
+
+### B. 전투 시스템 (`BattleProvider`)
+*   **턴제 전투:** 플레이어 턴 -> 적 턴.
+*   **행동 선택:** 공격(Attack) / 방어(Defend).
+*   **리스크 시스템:** 행동 시 Safe(100% 성공, 50% 효율), Normal(80% 성공, 100% 효율), Risky(40% 성공, 200% 효율) 중 선택 가능.
+*   **상태이상 (Status Effects):**
+    *   `Stun`: 행동 불가.
+    *   `Bleed`: 턴 시작 시 지속 피해.
+    *   `Vulnerable`: 받는 피해 1.5배 증가.
+    *   `DefenseForbidden`: 방어 행동 불가.
+    *   *특이사항:* 적에게 건 디버프는 플레이어 턴 시작 시 감소함 (직관성).
+
+### C. 아이템 및 인벤토리 (`Item`, `ItemTable`)
+*   **장비:** 무기, 방어구, 방패, 장신구 슬롯.
+*   **아이템 효과 (`ItemEffect`):** 아이템 공격 시 확률적으로 상태이상 부여 (예: 20% 확률로 기절).
+*   **경제:**
+    *   `Gold` 시스템 구현됨.
+    *   아이템마다 스탯 기반 `price` 자동 산출.
+    *   상점 스테이지에서 **판매(Sell)** 기능 구현됨.
+    *   인벤토리에서 장착(Equip), 버리기(Discard), 판매(Sell) 가능.
+
+### D. 스테이지 시스템 (`StageModel`, `StageType`)
+*   **스테이지 진행:** `currentStage` 객체로 관리.
+*   **타입 분기:**
+    *   `Battle`: 일반 몬스터 전투.
+    *   `Shop`: (5, 15... 스테이지) 상점 화면. (현재 판매만 가능, 구매 UI 미구현)
+    *   `Rest`: (8, 18... 스테이지) 휴식 화면. (HP 회복)
+    *   `Elite`: (10, 20... 스테이지) 강력한 적 등장.
+
+## 3. 핵심 파일 및 아키텍처
+
+*   **`lib/providers/battle_provider.dart`:** 게임의 **Core Logic**을 담당하는 거대 Provider. 상태 관리, 전투 계산, 스테이지 생성 등을 모두 처리.
+*   **`lib/game/model/`:**
+    *   `entity.dart`: `Character` 클래스 (Player/Enemy 공용).
+    *   `item.dart`: `Item`, `ItemEffect`.
+    *   `stage.dart`: `StageModel`, `StageType`.
+    *   `status_effect.dart`: 상태이상 정의.
+*   **`lib/game/data/item_table.dart`:** 아이템 템플릿 데이터.
+*   **`lib/screens/`:**
+    *   `battle_screen.dart`: 전투 및 스테이지 상황(상점/휴식) UI.
+    *   `inventory_screen.dart`: 인벤토리 및 장비 관리 UI.
+
+## 4. 작업 컨벤션 (Working Conventions)
+
+*   **Prompt Driven Development:** 새로운 기능을 구현할 때마다 `prompt/XX_description.md` 파일을 생성하여 작업 목표와 내용을 기록한다.
+*   **State Management:** `Provider` 패키지를 사용하며, 로직은 주로 `BattleProvider`에 집중시킨다.
+*   **Data Preservation:** 하드코딩된 데이터(`ItemTable`)를 사용 중이며, DB는 연동되지 않음.
+
+## 5. 다음 단계 작업 (Next Steps)
+
+1.  **상점 구매 기능:** `Shop` 스테이지에서 아이템을 구매하는 UI 및 로직 구현.
+2.  **밸런싱:** 상태이상 확률, 데미지 공식, 골드 획득량 조정.
+3.  **UI 개선:** 텍스트 위주의 로그를 시각적 효과(애니메이션, 플로팅 텍스트)로 개선.
+
+---
+**이 프롬프트를 읽은 AI 에이전트는 위 내용을 바탕으로 즉시 개발을 이어가십시오.**