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

@@ -0,0 +1,193 @@
import 'package:get_it/get_it.dart';
import 'package:superport/services/auth_service.dart';
import 'package:superport/services/dashboard_service.dart';
import 'package:superport/services/equipment_service.dart';
import 'package:superport/services/warehouse_service.dart';
import 'package:superport/services/company_service.dart';
import 'package:superport/core/utils/debug_logger.dart';
import 'package:superport/models/company_model.dart';
/// API 상태 테스트 서비스
class HealthTestService {
final AuthService _authService = GetIt.instance<AuthService>();
final DashboardService _dashboardService = GetIt.instance<DashboardService>();
final EquipmentService _equipmentService = GetIt.instance<EquipmentService>();
final WarehouseService _warehouseService = GetIt.instance<WarehouseService>();
final CompanyService _companyService = GetIt.instance<CompanyService>();
/// 모든 주요 API 엔드포인트 테스트
Future<Map<String, dynamic>> checkAllEndpoints() async {
final results = <String, dynamic>{};
// 1. 인증 상태 확인
try {
final isAuthenticated = await _authService.isLoggedIn();
final accessToken = await _authService.getAccessToken();
final refreshToken = await _authService.getRefreshToken();
results['auth'] = {
'success': isAuthenticated,
'accessToken': accessToken != null,
'refreshToken': refreshToken != null,
};
DebugLogger.log('인증 상태', tag: 'HEALTH_TEST', data: results['auth']);
} catch (e) {
results['auth'] = {'success': false, 'error': e.toString()};
}
// 2. 대시보드 API 체크
try {
DebugLogger.log('대시보드 API 체크 시작', tag: 'HEALTH_TEST');
// Overview Stats
final statsResult = await _dashboardService.getOverviewStats();
results['dashboard_stats'] = {
'success': statsResult.isRight(),
'error': statsResult.fold((l) => l.message, (r) => null),
'data': statsResult.fold((l) => null, (r) => {
'totalEquipment': r.totalEquipment,
'totalCompanies': r.totalCompanies,
'totalUsers': r.totalUsers,
'availableEquipment': r.availableEquipment,
}),
};
// Equipment Status Distribution
final statusResult = await _dashboardService.getEquipmentStatusDistribution();
results['equipment_status_distribution'] = {
'success': statusResult.isRight(),
'error': statusResult.fold((l) => l.message, (r) => null),
'data': statusResult.fold((l) => null, (r) => {
'available': r.available,
'inUse': r.inUse,
'maintenance': r.maintenance,
'disposed': r.disposed,
}),
};
DebugLogger.log('대시보드 API 결과', tag: 'HEALTH_TEST', data: results);
} catch (e) {
results['dashboard'] = {'success': false, 'error': e.toString()};
}
// 3. 장비 API 체크
try {
DebugLogger.log('장비 API 체크 시작', tag: 'HEALTH_TEST');
final equipments = await _equipmentService.getEquipments(page: 1, perPage: 5);
results['equipments'] = {
'success': true,
'count': equipments.length,
'sample': equipments.take(2).map((e) => {
'id': e.id,
'name': e.name,
'manufacturer': e.manufacturer,
'category': e.category,
}).toList(),
};
DebugLogger.log('장비 API 결과', tag: 'HEALTH_TEST', data: results['equipments']);
} catch (e) {
results['equipments'] = {'success': false, 'error': e.toString()};
}
// 4. 입고지 API 체크
try {
DebugLogger.log('입고지 API 체크 시작', tag: 'HEALTH_TEST');
final warehouses = await _warehouseService.getWarehouseLocations();
results['warehouses'] = {
'success': true,
'count': warehouses.length,
'sample': warehouses.take(2).map((w) => {
'id': w.id,
'name': w.name,
'address': w.address.toString(),
}).toList(),
};
DebugLogger.log('입고지 API 결과', tag: 'HEALTH_TEST', data: results['warehouses']);
} catch (e) {
results['warehouses'] = {'success': false, 'error': e.toString()};
}
// 5. 회사 API 체크
try {
DebugLogger.log('회사 API 체크 시작', tag: 'HEALTH_TEST');
final companies = await _companyService.getCompanies();
results['companies'] = {
'success': true,
'count': companies.length,
'sample': companies.take(2).map((c) => {
'id': c.id,
'name': c.name,
'companyTypes': c.companyTypes.map((t) => companyTypeToString(t)).toList(),
}).toList(),
};
DebugLogger.log('회사 API 결과', tag: 'HEALTH_TEST', data: results['companies']);
} catch (e) {
results['companies'] = {'success': false, 'error': e.toString()};
}
return results;
}
/// 특정 엔드포인트만 체크
Future<Map<String, dynamic>> checkEndpoint(String endpoint) async {
switch (endpoint) {
case 'dashboard':
final result = await _dashboardService.getOverviewStats();
return {
'success': result.isRight(),
'error': result.fold((l) => l.message, (r) => null),
'data': result.fold((l) => null, (r) => r.toJson()),
};
case 'equipments':
try {
final equipments = await _equipmentService.getEquipments(page: 1, perPage: 10);
return {
'success': true,
'count': equipments.length,
'data': equipments.map((e) => e.toJson()).toList(),
};
} catch (e) {
return {'success': false, 'error': e.toString()};
}
case 'warehouses':
try {
final warehouses = await _warehouseService.getWarehouseLocations();
return {
'success': true,
'count': warehouses.length,
'data': warehouses.map((w) => {
'id': w.id,
'name': w.name,
'address': w.address.toString(),
'remark': w.remark,
}).toList(),
};
} catch (e) {
return {'success': false, 'error': e.toString()};
}
case 'companies':
try {
final companies = await _companyService.getCompanies();
return {
'success': true,
'count': companies.length,
'data': companies.map((c) => c.toJson()).toList(),
};
} catch (e) {
return {'success': false, 'error': e.toString()};
}
default:
return {'success': false, 'error': 'Unknown endpoint: $endpoint'};
}
}
}