# 00. 프로젝트 컨텍스트 및 복구 (Project Context & Restore Point)

이 파일은 다른 개발 환경이나 새로운 AI 세션에서 프로젝트의 현재 상태를 빠르게 파악하고 작업을 이어가기 위해 작성되었습니다.

## 1. 프로젝트 개요

- **프로젝트명:** Colosseum's Choice
- **플랫폼:** Flutter (Android/iOS/Web/Desktop)
- **장르:** 텍스트 기반의 턴제 RPG + GUI (로그라이크 요소 포함)
- **상태:** 프로토타입 단계 (전투 시각화, 데이터 주도 시스템, 반응형 UI 구현 완료)

## 2. 현재 구현된 핵심 기능 (Feature Status)

### A. 게임 흐름 (Game Flow)

1.  **메인 메뉴 (`MainMenuScreen`):** 게임 시작 버튼.
2.  **캐릭터 선택 (`CharacterSelectionScreen`):** 'Warrior' 직업 구현.
3.  **메인 게임 (`MainWrapper`):** 하단 탭 네비게이션 (Battle / Inventory).
4.  **반응형 레이아웃 (Responsive UI):**
    - `ResponsiveContainer` 위젯을 통해 최대 너비(600px) 및 높이(1000px) 제한.
    - 웹/태블릿 환경에서도 모바일 앱처럼 중앙 정렬된 화면 제공.
    - **Battle UI Layout:** 플레이어(좌측 하단) vs 적(우측 상단) 대각선 구도 배치 및 캐릭터 임시 아이콘 적용.

### B. 전투 시스템 (`BattleProvider`)

- **턴제 전투:** 플레이어 턴 -> 적 턴.
- **행동 선택:** 공격(Attack) / 방어(Defend).
- **리스크 시스템 (Risk System):** Safe(100%/50%), Normal(80%/100%), Risky(40%/200%) 선택.
- **적 인공지능 (Enemy AI & Intent):**
  - **Intent UI:** 적의 다음 행동(공격/방어, 리스크)을 미리 표시.
  - **선제 방어 (Pre-emptive Defense):** 적이 방어를 선택하면 턴 시작 전에 즉시 방어도가 적용됨.
  - **Defense Restriction:** `DefenseForbidden` 상태 시 방어 행동 선택 불가.
  - **Variance Removed:** 적의 공격/방어 수치 계산 시 랜덤 분산(Variance) 제거 (고정 수치).
- **시각 효과 (Visual Effects):**
  - **Floating Text:** 데미지 발생 시 캐릭터 위에 데미지 수치가 떠오름 (일반: 빨강, 출혈: 보라, 취약: 주황).
  - **Action Feedback:** 공격 빗나감(MISS - 적 위치/회색) 및 방어 실패(FAILED - 내 위치/빨강) 텍스트 오버레이.
  - **Effect Icons:** 공격/방어 및 리스크 레벨에 따른 아이콘 애니메이션 출력.
- **상태이상:** `Stun`, `Bleed`, `Vulnerable`, `DefenseForbidden`.

### C. 데이터 주도 설계 (Data-Driven Design)

- **JSON 데이터:** `assets/data/items.json`, `assets/data/enemies.json`.
- **데이터 로더:** `ItemTable`, `EnemyTable`.

### D. 아이템 및 경제 (`Item`, `Inventory`)

- **장비:** 무기, 방어구, 방패, 장신구.
- **아이콘 및 색상 (`ItemUtils`):**
  - 무기: 빨강 삼각형 (`Icons.change_history`)
  - 방패: 파랑 방패 (`Icons.shield`)
  - 갑옷: 파랑 옷 (`Icons.checkroom`)
  - 장신구: 보라 다이아몬드 (`Icons.diamond`)
- **가격:** JSON 고정 가격 사용. 판매 시 60% (`GameMath.floor`) 획득.
- **인벤토리:** 장착 슬롯 및 가방(Bag) 그리드 UI 구현.

### E. 스테이지 시스템 (`StageModel`)

- **타입:** Battle, Shop, Rest, Elite.
- **적 생성:** 스테이지 레벨에 따른 스탯 스케일링 적용.

## 3. 핵심 파일 및 아키텍처

- **`lib/providers/battle_provider.dart`:**
  - **Core Logic:** 상태 관리, 전투 루프.
  - **Streams:** `damageStream`, `effectStream`을 통해 UI(`BattleScreen`)에 비동기 이벤트 전달.
- **`lib/game/enums.dart`:** 프로젝트 전반의 Enum 통합 관리 (`ActionType`, `RiskLevel`, `StageType` 등).
- **`lib/utils/item_utils.dart`:** 아이템 타입별 아이콘 및 색상 로직 중앙화.
- **`lib/widgets/responsive_container.dart`:** 반응형 레이아웃 컨테이너.
- **`lib/game/model/`:**
  - `damage_event.dart`, `effect_event.dart`: 이벤트 모델.
  - `entity.dart`: `Character` (Player/Enemy).
  - `item.dart`: `Item`.
- **`lib/screens/battle_screen.dart`:**
  - `StreamSubscription`을 통해 이펙트 이벤트 수신 및 `Overlay` 애니메이션 렌더링.

## 4. 작업 컨벤션 (Working Conventions)

- **Prompt Driven Development:** `prompt/XX_description.md` 유지.
- **State Management:** `Provider` + `Stream` (이벤트성 데이터).
- **Data:** JSON 기반.

## 5. 다음 단계 작업 (Next Steps)

1.  **상점 구매 기능:** `Shop` 스테이지 구매 UI 구현.
2.  **이미지 리소스 적용:** JSON 경로에 맞는 실제 이미지 파일 추가 및 UI 표시.
3.  **밸런싱 및 콘텐츠 확장:** 아이템/적 데이터 추가 및 밸런스 조정.

## 6. 장기 목표 (Future Roadmap / TODO)

- [ ] **출혈 상태 이상 조건 변경:** 공격 시 상대방의 방어도에 의해 공격이 완전히 막힐 경우, 출혈 상태 이상이 적용되지 않도록 로직 변경.
- [ ] **장비 분해 시스템 (적 장비):** 플레이어 장비의 옵션으로 상대방의 장비를 분해하여 '언암드' 상태로 만들 수 있는 시스템 구현.
- [ ] **플레이어 공격 데미지 분산(Variance) 적용 여부 검토:** 현재 적에게만 적용된 +/- 20% 데미지 분산을 플레이어에게도 적용할지 결정.
- [ ] **애니메이션 및 타격감 고도화:**
  - 캐릭터별 이미지 추가 및 하스스톤 스타일의 공격 모션(대상에게 돌진 후 타격) 구현.
  - **Risky 공격:** 하스스톤의 7데미지 이상 타격감(화면 흔들림, 강렬한 파티클 및 임팩트) 재현.
- [ ] **체력 조건부 특수 능력:** 캐릭터의 체력이 30% 미만일 때 발동 가능한 특수 능력 시스템 구현.
- [ ] **Google OAuth 로그인 및 계정 연동:**
  - Firebase Auth 등을 활용한 구글 로그인 구현.
  - Firestore 또는 Realtime Database에 유저 계정 정보(진행 상황, 재화 등) 저장 및 불러오기 기능 추가.
  - _Note: 이 기능은 게임의 핵심 로직이 안정화된 후, 완전 나중에 진행할 예정입니다._

---

**이 프롬프트를 읽은 AI 에이전트는 위 내용을 바탕으로 즉시 개발을 이어가십시오.**