fix: API 응답 파싱 오류 수정 및 에러 처리 개선

주요 변경사항:
- 창고 관리 API 응답 구조와 DTO 불일치 수정
  - WarehouseLocationDto에 code, manager_phone 필드 추가
  - RemoteDataSource에서 API 응답을 DTO 구조에 맞게 변환
- 회사 관리 API 응답 파싱 오류 수정
  - CompanyResponse의 필수 필드를 nullable로 변경
  - PaginatedResponse 구조 매핑 로직 개선
- 에러 처리 및 로깅 개선
  - Service Layer에 상세 에러 로깅 추가
  - Controller에서 에러 타입별 처리
- 새로운 유틸리티 추가
  - ResponseInterceptor: API 응답 정규화
  - DebugLogger: 디버깅 도구
  - HealthCheckService: 서버 상태 확인
- 문서화
  - API 통합 테스트 가이드
  - 에러 분석 보고서
  - 리팩토링 계획서
This commit is contained in:
JiWoong Sul
2025-07-31 19:15:39 +09:00
parent ad2c699ff7
commit f08b7fec79
89 changed files with 10521 additions and 892 deletions

View File

@@ -1,6 +1,7 @@
import 'package:dartz/dartz.dart';
import 'package:dio/dio.dart';
import 'package:injectable/injectable.dart';
import 'package:superport/core/constants/api_endpoints.dart';
import 'package:superport/core/errors/failures.dart';
import 'package:superport/data/datasources/remote/api_client.dart';
import 'package:superport/data/models/dashboard/equipment_status_distribution.dart';
@@ -24,56 +25,59 @@ class DashboardRemoteDataSourceImpl implements DashboardRemoteDataSource {
@override
Future<Either<Failure, OverviewStats>> getOverviewStats() async {
try {
final response = await _apiClient.get('/overview/stats');
final response = await _apiClient.get(ApiEndpoints.overviewStats);
if (response.data != null) {
final stats = OverviewStats.fromJson(response.data);
if (response.data != null && response.data['success'] == true && response.data['data'] != null) {
final stats = OverviewStats.fromJson(response.data['data']);
return Right(stats);
} else {
return Left(ServerFailure(message: '응답 데이터가 없습니다'));
final errorMessage = response.data?['error']?['message'] ?? '응답 데이터가 없습니다';
return Left(ServerFailure(message: errorMessage));
}
} on DioException catch (e) {
return Left(_handleDioError(e));
} catch (e) {
return Left(ServerFailure(message: '통계 데이터를 가져오는 중 오류가 발생했습니다'));
return Left(ServerFailure(message: '통계 데이터를 가져오는 중 오류가 발생했습니다: $e'));
}
}
@override
Future<Either<Failure, List<RecentActivity>>> getRecentActivities() async {
try {
final response = await _apiClient.get('/overview/recent-activities');
final response = await _apiClient.get(ApiEndpoints.overviewRecentActivities);
if (response.data != null && response.data is List) {
final activities = (response.data as List)
if (response.data != null && response.data['success'] == true && response.data['data'] != null) {
final activities = (response.data['data'] as List)
.map((json) => RecentActivity.fromJson(json))
.toList();
return Right(activities);
} else {
return Left(ServerFailure(message: '응답 데이터가 올바르지 않습니다'));
final errorMessage = response.data?['error']?['message'] ?? '응답 데이터가 올바르지 않습니다';
return Left(ServerFailure(message: errorMessage));
}
} on DioException catch (e) {
return Left(_handleDioError(e));
} catch (e) {
return Left(ServerFailure(message: '최근 활동을 가져오는 중 오류가 발생했습니다'));
return Left(ServerFailure(message: '최근 활동을 가져오는 중 오류가 발생했습니다: $e'));
}
}
@override
Future<Either<Failure, EquipmentStatusDistribution>> getEquipmentStatusDistribution() async {
try {
final response = await _apiClient.get('/equipment/status-distribution');
final response = await _apiClient.get(ApiEndpoints.overviewEquipmentStatus);
if (response.data != null) {
final distribution = EquipmentStatusDistribution.fromJson(response.data);
if (response.data != null && response.data['success'] == true && response.data['data'] != null) {
final distribution = EquipmentStatusDistribution.fromJson(response.data['data']);
return Right(distribution);
} else {
return Left(ServerFailure(message: '응답 데이터가 없습니다'));
final errorMessage = response.data?['error']?['message'] ?? '응답 데이터가 없습니다';
return Left(ServerFailure(message: errorMessage));
}
} on DioException catch (e) {
return Left(_handleDioError(e));
} catch (e) {
return Left(ServerFailure(message: '장비 상태 분포를 가져오는 중 오류가 발생했습니다'));
return Left(ServerFailure(message: '장비 상태 분포를 가져오는 중 오류가 발생했습니다: $e'));
}
}
@@ -81,22 +85,23 @@ class DashboardRemoteDataSourceImpl implements DashboardRemoteDataSource {
Future<Either<Failure, List<ExpiringLicense>>> getExpiringLicenses({int days = 30}) async {
try {
final response = await _apiClient.get(
'/licenses/expiring-soon',
ApiEndpoints.licensesExpiring,
queryParameters: {'days': days},
);
if (response.data != null && response.data is List) {
final licenses = (response.data as List)
if (response.data != null && response.data['success'] == true && response.data['data'] != null) {
final licenses = (response.data['data'] as List)
.map((json) => ExpiringLicense.fromJson(json))
.toList();
return Right(licenses);
} else {
return Left(ServerFailure(message: '응답 데이터가 올바르지 않습니다'));
final errorMessage = response.data?['error']?['message'] ?? '응답 데이터가 올바르지 않습니다';
return Left(ServerFailure(message: errorMessage));
}
} on DioException catch (e) {
return Left(_handleDioError(e));
} catch (e) {
return Left(ServerFailure(message: '만료 예정 라이선스를 가져오는 중 오류가 발생했습니다'));
return Left(ServerFailure(message: '만료 예정 라이선스를 가져오는 중 오류가 발생했습니다: $e'));
}
}
@@ -110,7 +115,17 @@ class DashboardRemoteDataSourceImpl implements DashboardRemoteDataSource {
return NetworkFailure(message: '서버에 연결할 수 없습니다');
case DioExceptionType.badResponse:
final statusCode = error.response?.statusCode ?? 0;
final message = error.response?.data?['message'] ?? '서버 오류가 발생했습니다';
final errorData = error.response?.data;
// 에러 메시지 추출 개선
String message;
if (errorData is Map) {
message = errorData['error']?['message'] ??
errorData['message'] ??
'서버 오류가 발생했습니다';
} else {
message = '서버 오류가 발생했습니다';
}
if (statusCode == 401) {
return AuthenticationFailure(message: '인증이 만료되었습니다');
@@ -119,6 +134,10 @@ class DashboardRemoteDataSourceImpl implements DashboardRemoteDataSource {
} else if (statusCode >= 400 && statusCode < 500) {
return ServerFailure(message: message);
} else {
// 500 에러의 경우 더 자세한 메시지 표시
if (message.contains('DATABASE_ERROR')) {
return ServerFailure(message: '서버 데이터베이스 오류가 발생했습니다. 관리자에게 문의하세요.');
}
return ServerFailure(message: '서버 오류가 발생했습니다 ($statusCode)');
}
case DioExceptionType.cancel: