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,277 @@
import 'package:flutter/foundation.dart';
import 'package:injectable/injectable.dart';
import 'package:superport/core/constants/api_endpoints.dart';
import 'package:superport/core/errors/exceptions.dart';
import 'package:superport/data/datasources/remote/api_client.dart';
import 'package:superport/data/models/warehouse/warehouse_dto.dart';
abstract class WarehouseLocationRemoteDataSource {
Future<WarehouseLocationListDto> getWarehouseLocations({
int page = 1,
int perPage = 20,
String? search,
Map<String, dynamic>? filters,
});
Future<WarehouseLocationDto> getWarehouseLocationDetail(int id);
Future<WarehouseLocationDto> createWarehouseLocation(CreateWarehouseLocationRequest request);
Future<WarehouseLocationDto> updateWarehouseLocation(int id, UpdateWarehouseLocationRequest request);
Future<void> deleteWarehouseLocation(int id);
Future<WarehouseCapacityInfo> getWarehouseCapacity(int id);
Future<WarehouseEquipmentListDto> getWarehouseEquipment({
required int warehouseId,
int page = 1,
int perPage = 20,
});
}
@LazySingleton(as: WarehouseLocationRemoteDataSource)
class WarehouseLocationRemoteDataSourceImpl implements WarehouseLocationRemoteDataSource {
final ApiClient _apiClient;
WarehouseLocationRemoteDataSourceImpl({
required ApiClient apiClient,
}) : _apiClient = apiClient;
@override
Future<WarehouseLocationListDto> getWarehouseLocations({
int page = 1,
int perPage = 20,
String? search,
Map<String, dynamic>? filters,
}) async {
try {
final queryParams = <String, dynamic>{
'page': page,
'per_page': perPage,
};
if (search != null && search.isNotEmpty) {
queryParams['search'] = search;
}
// 필터 적용
if (filters != null) {
filters.forEach((key, value) {
if (value != null) {
queryParams[key] = value;
}
});
}
final response = await _apiClient.get(
ApiEndpoints.warehouseLocations,
queryParameters: queryParams,
);
if (response.data != null && response.data['success'] == true && response.data['data'] != null) {
// API 응답이 배열인 경우와 객체인 경우를 모두 처리
final data = response.data['data'];
if (data is List) {
// 배열 응답을 WarehouseLocationListDto 형식으로 변환
final List<WarehouseLocationDto> warehouses = [];
for (int i = 0; i < data.length; i++) {
try {
final item = data[i];
debugPrint('📦 Parsing warehouse location item $i: ${item['name']}');
// null 검사 및 기본값 설정
final warehouseDto = WarehouseLocationDto.fromJson({
...item,
// 필수 필드 보장
'name': item['name'] ?? '',
'is_active': item['is_active'] ?? true,
'created_at': item['created_at'] ?? DateTime.now().toIso8601String(),
});
warehouses.add(warehouseDto);
} catch (e, stackTrace) {
debugPrint('❌ Error parsing warehouse location item $i: $e');
debugPrint('Item data: ${data[i]}');
debugPrint('Stack trace: $stackTrace');
// 파싱 실패한 항목은 건너뛰고 계속
continue;
}
}
final pagination = response.data['pagination'] ?? {};
return WarehouseLocationListDto(
items: warehouses,
total: pagination['total'] ?? warehouses.length,
page: pagination['page'] ?? page,
perPage: pagination['per_page'] ?? perPage,
totalPages: pagination['total_pages'] ?? 1,
);
} else if (data['items'] != null) {
// 이미 WarehouseLocationListDto 형식인 경우
return WarehouseLocationListDto.fromJson(data);
} else {
// 예상치 못한 형식인 경우
throw ApiException(
message: 'Unexpected response format for warehouse location list',
);
}
} else {
throw ApiException(
message: response.data?['error']?['message'] ?? 'Failed to fetch warehouse locations',
);
}
} catch (e) {
throw _handleError(e);
}
}
@override
Future<WarehouseLocationDto> getWarehouseLocationDetail(int id) async {
try {
final response = await _apiClient.get(
'${ApiEndpoints.warehouseLocations}/$id',
);
if (response.data != null && response.data['success'] == true && response.data['data'] != null) {
return WarehouseLocationDto.fromJson(response.data['data']);
} else {
throw ApiException(
message: response.data?['error']?['message'] ?? 'Failed to fetch warehouse location',
);
}
} catch (e) {
throw _handleError(e);
}
}
@override
Future<WarehouseLocationDto> createWarehouseLocation(CreateWarehouseLocationRequest request) async {
try {
final response = await _apiClient.post(
ApiEndpoints.warehouseLocations,
data: request.toJson(),
);
if (response.data != null && response.data['success'] == true && response.data['data'] != null) {
return WarehouseLocationDto.fromJson(response.data['data']);
} else {
throw ApiException(
message: response.data?['error']?['message'] ?? 'Failed to create warehouse location',
);
}
} catch (e) {
throw _handleError(e);
}
}
@override
Future<WarehouseLocationDto> updateWarehouseLocation(int id, UpdateWarehouseLocationRequest request) async {
try {
final response = await _apiClient.put(
'${ApiEndpoints.warehouseLocations}/$id',
data: request.toJson(),
);
if (response.data != null && response.data['success'] == true && response.data['data'] != null) {
return WarehouseLocationDto.fromJson(response.data['data']);
} else {
throw ApiException(
message: response.data?['error']?['message'] ?? 'Failed to update warehouse location',
);
}
} catch (e) {
throw _handleError(e);
}
}
@override
Future<void> deleteWarehouseLocation(int id) async {
try {
await _apiClient.delete(
'${ApiEndpoints.warehouseLocations}/$id',
);
} catch (e) {
throw _handleError(e);
}
}
@override
Future<WarehouseCapacityInfo> getWarehouseCapacity(int id) async {
try {
final response = await _apiClient.get(
'${ApiEndpoints.warehouseLocations}/$id/capacity',
);
if (response.data != null && response.data['success'] == true && response.data['data'] != null) {
return WarehouseCapacityInfo.fromJson(response.data['data']);
} else {
throw ApiException(
message: response.data?['error']?['message'] ?? 'Failed to fetch warehouse capacity',
);
}
} catch (e) {
throw _handleError(e);
}
}
@override
Future<WarehouseEquipmentListDto> getWarehouseEquipment({
required int warehouseId,
int page = 1,
int perPage = 20,
}) async {
try {
final queryParams = <String, dynamic>{
'page': page,
'per_page': perPage,
};
final response = await _apiClient.get(
'${ApiEndpoints.warehouseLocations}/$warehouseId/equipment',
queryParameters: queryParams,
);
if (response.data != null && response.data['success'] == true && response.data['data'] != null) {
final data = response.data['data'];
final pagination = response.data['pagination'] ?? {};
if (data is List) {
// 배열 응답을 WarehouseEquipmentListDto 형식으로 변환
final List<WarehouseEquipmentDto> equipment = [];
for (var item in data) {
try {
equipment.add(WarehouseEquipmentDto.fromJson(item));
} catch (e) {
debugPrint('❌ Error parsing warehouse equipment: $e');
debugPrint('Item data: $item');
continue;
}
}
return WarehouseEquipmentListDto(
items: equipment,
total: pagination['total'] ?? equipment.length,
page: pagination['page'] ?? page,
perPage: pagination['per_page'] ?? perPage,
totalPages: pagination['total_pages'] ?? 1,
);
} else {
// 이미 올바른 형식인 경우
return WarehouseEquipmentListDto.fromJson(data);
}
} else {
throw ApiException(
message: response.data?['error']?['message'] ?? 'Failed to fetch warehouse equipment',
);
}
} catch (e) {
throw _handleError(e);
}
}
Exception _handleError(dynamic error) {
if (error is ApiException) {
return error;
}
return ApiException(
message: error.toString(),
);
}
}