refactor: Clean Architecture 적용 및 코드베이스 전면 리팩토링
Some checks failed
Flutter Test & Quality Check / Test on macos-latest (push) Has been cancelled
Flutter Test & Quality Check / Test on ubuntu-latest (push) Has been cancelled
Flutter Test & Quality Check / Build APK (push) Has been cancelled

## 주요 변경사항

### 아키텍처 개선
- Clean Architecture 패턴 적용 (Domain, Data, Presentation 레이어 분리)
- Use Case 패턴 도입으로 비즈니스 로직 캡슐화
- Repository 패턴으로 데이터 접근 추상화
- 의존성 주입 구조 개선

### 상태 관리 최적화
- 모든 Controller에서 불필요한 상태 관리 로직 제거
- 페이지네이션 로직 통일 및 간소화
- 에러 처리 로직 개선 (에러 메시지 한글화)
- 로딩 상태 관리 최적화

### Mock 서비스 제거
- MockDataService 완전 제거
- 모든 화면을 실제 API 전용으로 전환
- 불필요한 Mock 관련 코드 정리

### UI/UX 개선
- Overview 화면 대시보드 기능 강화
- 라이선스 만료 알림 위젯 추가
- 사이드바 네비게이션 개선
- 일관된 UI 컴포넌트 사용

### 코드 품질
- 중복 코드 제거 및 함수 추출
- 파일별 책임 분리 명확화
- 테스트 코드 업데이트

## 영향 범위
- 모든 화면의 Controller 리팩토링
- API 통신 레이어 구조 개선
- 에러 처리 및 로깅 시스템 개선

## 향후 계획
- 단위 테스트 커버리지 확대
- 통합 테스트 시나리오 추가
- 성능 모니터링 도구 통합
This commit is contained in:
JiWoong Sul
2025-08-11 00:04:28 +09:00
parent 6b5d126990
commit 162fe08618
113 changed files with 11072 additions and 3319 deletions

View File

@@ -0,0 +1,209 @@
import 'package:flutter/material.dart';
import '../utils/error_handler.dart';
import '../../data/models/common/pagination_params.dart';
/// 모든 리스트 컨트롤러의 기본 클래스
///
/// 페이지네이션, 검색, 필터, 에러 처리 등 공통 기능을 제공합니다.
/// 개별 컨트롤러는 이 클래스를 상속받아 특화된 로직만 구현하면 됩니다.
abstract class BaseListController<T> extends ChangeNotifier {
/// 전체 아이템 목록
List<T> _items = [];
/// 필터링된 아이템 목록
List<T> _filteredItems = [];
/// 로딩 상태
bool _isLoading = false;
/// 에러 메시지
String? _error;
/// 검색 쿼리
String _searchQuery = '';
/// 현재 페이지 번호
int _currentPage = 1;
/// 페이지당 아이템 수
int _pageSize = 20;
/// 더 많은 데이터가 있는지 여부
bool _hasMore = true;
/// 전체 아이템 수 (서버에서 제공하는 실제 전체 개수)
int _total = 0;
/// 총 페이지 수
int _totalPages = 0;
BaseListController();
// Getters
List<T> get items => _filteredItems;
bool get isLoading => _isLoading;
String? get error => _error;
String get searchQuery => _searchQuery;
int get currentPage => _currentPage;
int get pageSize => _pageSize;
bool get hasMore => _hasMore;
int get total => _total;
int get totalPages => _totalPages;
// Setters
set pageSize(int value) {
_pageSize = value;
notifyListeners();
}
// Protected setters for subclasses
@protected
set isLoadingState(bool value) {
_isLoading = value;
}
@protected
set errorState(String? value) {
_error = value;
}
/// 데이터 로드 (하위 클래스에서 구현)
/// PagedResult를 반환하여 페이지네이션 메타데이터를 포함
Future<PagedResult<T>> fetchData({
required PaginationParams params,
Map<String, dynamic>? additionalFilters,
});
/// 아이템 필터링 (하위 클래스에서 선택적으로 오버라이드)
bool filterItem(T item, String query) {
// 기본 구현: toString()을 사용한 간단한 필터링
return item.toString().toLowerCase().contains(query.toLowerCase());
}
/// 데이터 로드 및 관리
Future<void> loadData({
bool isRefresh = false,
Map<String, dynamic>? additionalFilters,
}) async {
if (_isLoading) return;
if (isRefresh) {
_currentPage = 1;
_items.clear();
_filteredItems.clear();
_hasMore = true;
}
_isLoading = true;
_error = null;
notifyListeners();
try {
// PaginationParams 생성
final params = PaginationParams(
page: _currentPage,
perPage: _pageSize,
search: _searchQuery.isNotEmpty ? _searchQuery : null,
);
// 데이터 가져오기
final result = await fetchData(
params: params,
additionalFilters: additionalFilters,
);
if (isRefresh) {
_items = result.items;
} else {
_items.addAll(result.items);
}
// 메타데이터 업데이트
_total = result.meta.total;
_totalPages = result.meta.totalPages;
_hasMore = result.meta.hasNext;
_applyFiltering();
if (!isRefresh && result.items.isNotEmpty) {
_currentPage++;
}
} catch (e) {
if (e is AppFailure) {
_error = ErrorHandler.getUserFriendlyMessage(e);
} else {
_error = '데이터를 불러오는 중 오류가 발생했습니다.';
}
print('[BaseListController] Error loading data: $e');
} finally {
_isLoading = false;
notifyListeners();
}
}
/// 다음 페이지 로드
Future<void> loadNextPage() async {
if (!_hasMore || _isLoading) return;
await loadData(isRefresh: false);
}
/// 검색
void search(String query) {
_searchQuery = query;
_currentPage = 1;
_applyFiltering();
notifyListeners();
}
/// 필터링 적용
void _applyFiltering() {
if (_searchQuery.isEmpty) {
_filteredItems = List.from(_items);
} else {
_filteredItems = _items.where((item) => filterItem(item, _searchQuery)).toList();
}
}
/// 새로고침
Future<void> refresh() async {
await loadData(isRefresh: true);
}
/// 에러 초기화
void clearError() {
_error = null;
notifyListeners();
}
/// 아이템 추가 (로컬)
void addItemLocally(T item) {
_items.insert(0, item);
_applyFiltering();
_total++;
notifyListeners();
}
/// 아이템 업데이트 (로컬)
void updateItemLocally(T item, bool Function(T) matcher) {
final index = _items.indexWhere(matcher);
if (index != -1) {
_items[index] = item;
_applyFiltering();
notifyListeners();
}
}
/// 아이템 삭제 (로컬)
void removeItemLocally(bool Function(T) matcher) {
_items.removeWhere(matcher);
_applyFiltering();
_total--;
notifyListeners();
}
/// 리소스 정리
@override
void dispose() {
super.dispose();
}
}