refactor: Clean Architecture 적용 및 코드베이스 전면 리팩토링
## 주요 변경사항 ### 아키텍처 개선 - Clean Architecture 패턴 적용 (Domain, Data, Presentation 레이어 분리) - Use Case 패턴 도입으로 비즈니스 로직 캡슐화 - Repository 패턴으로 데이터 접근 추상화 - 의존성 주입 구조 개선 ### 상태 관리 최적화 - 모든 Controller에서 불필요한 상태 관리 로직 제거 - 페이지네이션 로직 통일 및 간소화 - 에러 처리 로직 개선 (에러 메시지 한글화) - 로딩 상태 관리 최적화 ### Mock 서비스 제거 - MockDataService 완전 제거 - 모든 화면을 실제 API 전용으로 전환 - 불필요한 Mock 관련 코드 정리 ### UI/UX 개선 - Overview 화면 대시보드 기능 강화 - 라이선스 만료 알림 위젯 추가 - 사이드바 네비게이션 개선 - 일관된 UI 컴포넌트 사용 ### 코드 품질 - 중복 코드 제거 및 함수 추출 - 파일별 책임 분리 명확화 - 테스트 코드 업데이트 ## 영향 범위 - 모든 화면의 Controller 리팩토링 - API 통신 레이어 구조 개선 - 에러 처리 및 로깅 시스템 개선 ## 향후 계획 - 단위 테스트 커버리지 확대 - 통합 테스트 시나리오 추가 - 성능 모니터링 도구 통합
This commit is contained in:
209
lib/core/controllers/base_list_controller.dart
Normal file
209
lib/core/controllers/base_list_controller.dart
Normal 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();
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user