update

prompt/00_project_context_restore.md

@@ -40,6 +40,11 @@
   - **Action Feedback:** 공격 빗나감(MISS - 적 위치/회색) 및 방어 실패(FAILED - 내 위치/빨강) 텍스트 오버레이.
   - **Effect Icons:** 공격/방어 및 리스크 레벨에 따른 아이콘 애니메이션 출력.
 - **상태이상:** `Stun`, `Bleed`, `Vulnerable`, `DefenseForbidden`.
+- **행운 시스템 (Luck System):**
+  - 아이템 옵션으로 `luck` 스탯 제공.
+  - `totalLuck` 수치만큼 행동(공격/방어) 성공 확률 증가 (1 Luck = +1%).
+  - 성공 확률은 최대 100%로 제한됨.
+  - **UI:** 인벤토리에서 Luck 수치 확인 가능, 전투 시 Risk 선택 창에서 보정된 확률 표시.
 
 ### C. 데이터 주도 설계 (Data-Driven Design)
 
@@ -61,6 +66,12 @@
 
 - **타입:** Battle, Shop, Rest, Elite.
 - **적 생성:** 스테이지 레벨에 따른 스탯 스케일링 적용.
+- **게임 구조 (Game Structure):**
+  - **총 3라운드 (3 Rounds):** 각 라운드는 12개의 스테이지로 구성 (12/12/12).
+  - **라운드 구성:**
+    1.  **1라운드:** 지하 불법 투기장 (Underground Illegal Arena)
+    2.  **2라운드:** 콜로세움 (Colosseum)
+    3.  **3라운드:** 왕의 투기장 (King's Arena) - 최종 보스(Final Boss) 등장.
 
 ## 3. 핵심 파일 및 아키텍처
 
@@ -100,6 +111,9 @@
   - 캐릭터별 이미지 추가 및 하스스톤 스타일의 공격 모션(대상에게 돌진 후 타격) 구현.
   - **Risky 공격:** 하스스톤의 7데미지 이상 타격감(화면 흔들림, 강렬한 파티클 및 임팩트) 재현.
 - [ ] **체력 조건부 특수 능력:** 캐릭터의 체력이 30% 미만일 때 발동 가능한 특수 능력 시스템 구현.
+- [ ] **영구 스탯 수정자 로직 적용 (필수):**
+  - 현재 `Character` 클래스에 `permanentModifiers` 필드만 선언되어 있음.
+  - 추후 `totalAtk`, `totalDefense`, `totalMaxHp` 계산 시 이 수정자들을 반드시 반영해야 함.
 - [ ] **Google OAuth 로그인 및 계정 연동:**
   - Firebase Auth 등을 활용한 구글 로그인 구현.
   - Firestore 또는 Realtime Database에 유저 계정 정보(진행 상황, 재화 등) 저장 및 불러오기 기능 추가.

prompt/38_permanent_stat_modifiers.md

@@ -0,0 +1,34 @@
+# 영구 스탯 수정자 (Permanent Stat Modifiers)
+
+## 목표
+
+Slay the Spire의 승천(Ascension)이나 유물 시스템처럼, 캐릭터의 스탯에 영구적인 영향을 주는 옵션을 부여할 수 있는 시스템을 구현합니다. 이는 일시적인 `StatusEffect`와는 구별됩니다.
+
+## 구현 계획
+
+### 1. 데이터 모델 정의
+
+- **Enum 추가 (`lib/game/enums.dart`):**
+  - `StatType`: 수정할 스탯의 종류 (`maxHp`, `atk`, `defense`).
+- **클래스 생성 (`lib/game/model/stat_modifier.dart`):**
+  - `PermanentStatModifier`: 스탯 수정 정보를 담는 클래스.
+    - `id`: 식별자.
+    - `name`: 표시 이름.
+    - `description`: 설명.
+    - `statType`: 대상 스탯 (`StatType`).
+    - `type`: 연산 타입 (`ModifierType.flat` 또는 `percent`).
+    - `value`: 수정 값.
+
+### 2. 캐릭터 모델 변경 (`lib/game/model/entity.dart`)
+
+- `Character` 클래스에 `List<PermanentStatModifier> permanentModifiers` 필드 추가.
+- `addModifier(PermanentStatModifier modifier)` 메서드 추가.
+- `removeModifier(String id)` 메서드 추가.
+- **스탯 계산 로직(`totalAtk`, `totalDefense`, `totalMaxHp`) 업데이트:**
+  - 기존: `base + itemBonus`
+  - 변경: `(base + itemBonus + flatModifiers) * (1 + percentModifiers)`
+
+## 기대 효과
+
+- 게임 진행 중 획득하는 영구적인 버프/디버프(예: "힘의 물약: 공격력 +2 영구 증가", "저주: 방어력 -1")를 구현할 수 있습니다.
+- 로그라이크 요소(메타 프로그레션 또는 런 내 성장)의 기반이 됩니다.

prompt/39_luck_system.md

@@ -0,0 +1,39 @@
+# 행운(Luck) 시스템 구현 (Luck System)
+
+## 목표
+
+아이템 옵션을 통해 플레이어의 행동(공격/방어) 성공 확률을 높여주는 '행운(Luck)' 스탯을 구현합니다.
+
+## 구현 계획
+
+### 1. 데이터 모델 변경
+
+- **`lib/game/model/item.dart`**: `Item` 클래스에 `final int luck` 필드 추가 (기본값 0).
+- **`lib/game/data/item_table.dart`**: `ItemTemplate` 클래스에 `luck` 필드 추가 및 JSON 파싱 로직 업데이트.
+- **`assets/data/items.json`**: 아이템 데이터에 `"luck"` 필드 지원 (기존 아이템은 0 또는 생략 가능).
+
+### 2. 캐릭터 모델 변경 (`lib/game/model/entity.dart`)
+
+- `Character` 클래스에 `int get totalLuck` getter 추가.
+  - 장착된 모든 아이템의 `luck` 합계를 반환.
+
+### 3. 전투 로직 변경 (`lib/providers/battle_provider.dart`)
+
+- `playerAction` 메서드에서 성공 여부 계산 시 `totalLuck` 반영.
+  - 기본 성공률 + (totalLuck / 100.0).
+  - 예: Luck 5 = +5% 성공률.
+
+### 4. UI 구현 (UI Implementation)
+
+- **인벤토리 화면 (`lib/screens/inventory_screen.dart`):**
+  - 플레이어 스탯 정보 상단에 `Luck` 수치 표시 (초록색).
+  - 아이템 정보에 `luck` 보너스가 있는 경우 `+N Luck` 표시.
+- **전투 화면 (`lib/screens/battle_screen.dart`):**
+  - 행동 선택(Risk Selection) 다이얼로그에서 표시되는 성공 확률에 행운 수치 반영.
+  - **확률 제한 (Cap):** 표시되는 확률과 실제 적용되는 확률 모두 **100% (1.0)를 초과하지 않도록 제한**.
+
+## 기대 효과
+
+- 플레이어가 "행운의 부적" 같은 아이템을 장착하여 Risky 행동의 성공률을 높일 수 있습니다.
+- 전략적 선택지(깡스탯 vs 확률 보정)가 늘어납니다.
+- UI를 통해 자신의 행운 수치와 실제 적용되는 확률을 직관적으로 확인할 수 있습니다.