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

주요 변경사항:
- 창고 관리 API 응답 구조와 DTO 불일치 수정
  - WarehouseLocationDto에 code, manager_phone 필드 추가
  - RemoteDataSource에서 API 응답을 DTO 구조에 맞게 변환
- 회사 관리 API 응답 파싱 오류 수정
  - CompanyResponse의 필수 필드를 nullable로 변경
  - PaginatedResponse 구조 매핑 로직 개선
- 에러 처리 및 로깅 개선
  - Service Layer에 상세 에러 로깅 추가
  - Controller에서 에러 타입별 처리
- 새로운 유틸리티 추가
  - ResponseInterceptor: API 응답 정규화
  - DebugLogger: 디버깅 도구
  - HealthCheckService: 서버 상태 확인
- 문서화
  - API 통합 테스트 가이드
  - 에러 분석 보고서
  - 리팩토링 계획서

doc/api_response_parsing_fix_summary.md

@@ -0,0 +1,70 @@
+# API 응답 파싱 오류 수정 요약
+
+## 문제 상황
+- API 응답은 정상적으로 수신됨 (로그에서 확인)
+- 화면에는 에러 메시지 표시 (ServerFailure 또는 TypeError)
+- 창고 관리와 회사 관리 페이지 모두 동일한 문제 발생
+
+## 근본 원인
+1. **창고 관리 (Warehouse)**: 
+   - `WarehouseLocationListDto`가 `items` 필드를 기대하나, API는 `data` 배열 직접 반환
+   - DTO 필드와 API 응답 필드 불일치 (code, manager_phone 등)
+
+2. **회사 관리 (Company)**: 
+   - `ApiResponse`가 필수 필드 `message`를 기대하나 API 응답에 없음
+   - `PaginatedResponse` 구조와 API 응답 구조 불일치
+
+## 수정 사항
+
+### 1. WarehouseLocationDto 수정
+```dart
+// 실제 API 응답에 맞게 필드 수정
+- code 필드 추가
+- manager_phone 필드 추가  
+- 없는 필드들을 nullable로 변경 (updated_at 등)
+```
+
+### 2. WarehouseRemoteDataSource 수정
+```dart
+// API 응답을 DTO 구조에 맞게 변환
+final listData = {
+  'items': dataList,  // data → items로 매핑
+  'total': pagination['total'] ?? 0,
+  // ... pagination 데이터 매핑
+};
+```
+
+### 3. CompanyResponse DTO 수정
+```dart
+// API 응답에 없는 필수 필드를 nullable로 변경
+- contact_position: String? (nullable)
+- updated_at: DateTime? (nullable)
+```
+
+### 4. CompanyRemoteDataSource 수정
+```dart
+// ApiResponse/PaginatedResponse 대신 직접 파싱
+// API 응답 구조를 PaginatedResponse 구조로 변환
+return PaginatedResponse<CompanyListDto>(
+  items: items,
+  page: pagination['page'] ?? page,
+  size: pagination['per_page'] ?? perPage,
+  // ... 나머지 필드 매핑
+);
+```
+
+### 5. 에러 처리 개선
+- Service Layer에 상세 로깅 추가
+- Controller에서 에러 타입별 처리
+- Stack trace 로깅으로 디버깅 개선
+
+## 테스트 방법
+1. 웹 애플리케이션을 새로고침
+2. 창고 관리 페이지 접속 → 데이터 정상 표시 확인
+3. 회사 관리 페이지 접속 → 데이터 정상 표시 확인
+4. 콘솔 로그에서 에러 없음 확인
+
+## 향후 개선 사항
+- API 응답 구조 문서화
+- DTO와 API 스펙 일치성 검증 테스트 추가
+- ResponseInterceptor에서 더 강력한 응답 정규화