docs: CHANGELOG 및 아키텍처 문서 추가

- CHANGELOG.md: 리팩토링 내역 기록
- docs/ARCHITECTURE.md: ASCII 다이어그램으로 구조 시각화
This commit is contained in:
JiWoong Sul
2026-01-21 17:34:11 +09:00
parent 97b40ccb1f
commit 742b0d1773
2 changed files with 254 additions and 0 deletions

46
CHANGELOG.md Normal file
View File

@@ -0,0 +1,46 @@
# Changelog
프로젝트의 주요 변경 사항을 기록합니다.
## [Unreleased]
### Refactored (리팩토링)
#### GameSessionController 분할 (SRP 개선)
- 920 LOC → 526 LOC (43% 감소)
- 5개 매니저로 책임 분리:
- `GameStatisticsManager` - 세션/누적 통계 추적
- `SpeedBoostManager` - 광고 배속 부스트 기능
- `ReturnRewardsManager` - 복귀 보상 기능
- `ResurrectionManager` - 사망/부활 처리
- `HallOfFameManager` - 명예의 전당 관리
#### ProgressService 메서드 분할
- `tick()`: 350 LOC → 80 LOC (8개 헬퍼 메서드)
- `_generateNextTask()`: 200 LOC → 35 LOC (6개 헬퍼 메서드)
#### GamePlayScreen 메서드 분할
- `build()`: 300 LOC → 15 LOC (5개 헬퍼 메서드)
#### Clean Architecture 개선
- `MonsterGrade.displayColor` (Color) → `displayColorCode` (int)
- Domain 레이어에서 Flutter 의존성 제거
### Fixed (버그 수정)
#### Analyzer 경고 정리
- 미사용 import 제거 (`panel_header.dart`)
- 미사용 필드 제거 (`new_character_screen.dart`)
- JsonKey 경고 억제 (`equipment_item.dart`, `monetization_state.dart`)
---
## 버전 표기 규칙
- `Added`: 새로운 기능 추가
- `Changed`: 기존 기능 변경
- `Deprecated`: 곧 제거될 기능
- `Removed`: 제거된 기능
- `Fixed`: 버그 수정
- `Security`: 보안 관련 수정
- `Refactored`: 코드 구조 개선 (기능 변화 없음)