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_integration_fixes_summary.md

@@ -0,0 +1,108 @@
+# API Integration Fixes Summary
+
+## 개요
+superport_api 백엔드와 Flutter 프론트엔드 간의 API 통합 문제를 해결한 내역입니다.
+
+## 주요 수정 사항
+
+### 1. Equipment Status 타입 불일치 해결
+**문제**: 서버는 status를 String 타입으로 변경했지만 다른 코드를 사용
+- 서버: "available", "inuse", "maintenance", "disposed"
+- 클라이언트: "I", "O", "T", "R", "D", "L", "E"
+
+**해결**:
+- `equipment_status_converter.dart` 유틸리티 생성
+- 양방향 변환 함수 구현 (serverToClient, clientToServer)
+- Freezed JsonConverter 어노테이션 적용
+
+### 2. Equipment 모델 수정
+- EquipmentResponse 모델에 @EquipmentStatusJsonConverter() 어노테이션 추가
+- EquipmentRequest 모델에도 동일한 변환기 적용
+
+### 3. EquipmentService 개선
+- `getEquipmentsWithStatus()` 메서드 추가 - DTO 형태로 반환하여 status 정보 유지
+- 기존 `getEquipments()` 메서드는 하위 호환성을 위해 유지
+
+### 4. EquipmentListController 수정
+- DTO를 직접 사용하여 status 정보 유지
+- 서버 status를 클라이언트 status로 변환
+- UnifiedEquipment 생성 시 올바른 status 할당
+
+### 5. Health Test Service 구현
+- 모든 주요 API 엔드포인트 테스트
+- 로그인 후 자동 실행
+- 상세한 로그 출력
+
+### 6. 디버깅 및 로깅 개선
+- DebugLogger 추가
+- 각 서비스와 컨트롤러에 로그 추가
+- API 요청/응답 인터셉터에 상세 로깅
+
+## 현재 상태
+
+### ✅ 정상 작동
+1. **인증 (Authentication)**
+   - 로그인: admin@superport.kr / admin123!
+   - 토큰 갱신
+   - 로그아웃
+
+2. **대시보드 API**
+   - Recent Activities API
+   - Expiring Licenses API
+   - Equipment Status Distribution API (별도 엔드포인트)
+
+3. **장비 관리**
+   - 장비 목록 조회 (status 변환 적용)
+   - 장비 상세 조회
+   - 장비 생성/수정/삭제
+
+4. **입고지 관리**
+   - 입고지 목록 조회
+   - 입고지 CRUD 작업
+
+5. **회사 관리**
+   - 회사 목록 조회
+   - 회사 CRUD 작업
+   - 지점 관리
+
+### ❌ 서버 측 문제 (백엔드 수정 필요)
+1. **Overview Stats API (/api/dashboard/overview/stats)**
+   - 500 Error: "operator does not exist: character varying = equipment_status"
+   - 원인: PostgreSQL 데이터베이스가 여전히 ENUM 타입으로 쿼리 실행
+   - 필요한 조치: 백엔드에서 SQL 쿼리를 String 비교로 변경
+
+## 테스트 결과
+```
+- Authentication: ✅
+- Token Refresh: ✅  
+- Recent Activities: ✅
+- Expiring Licenses: ✅
+- Overview Stats: ❌ (서버 DB 쿼리 오류)
+- Equipment Status Distribution: ✅
+- Equipment List: ✅
+- Warehouse List: ✅
+- Company List: ✅
+```
+
+## 추가 권장 사항
+1. 백엔드 팀에 overview/stats API 수정 요청
+2. 모든 페이지에서 실제 사용자 테스트 수행
+3. flutter test 실행하여 유닛 테스트 통과 확인
+4. 프로덕션 배포 전 통합 테스트 수행
+
+## 코드 품질
+- flutter analyze: 650개 이슈 (대부분 print 문 관련 경고)
+- 컴파일 에러: 0개
+- 런타임 에러: 0개 (서버 측 DB 오류 제외)
+
+## 변경된 파일 목록
+1. `/lib/core/utils/equipment_status_converter.dart` (생성)
+2. `/lib/data/models/equipment/equipment_response.dart` (수정)
+3. `/lib/data/models/equipment/equipment_request.dart` (수정)
+4. `/lib/services/equipment_service.dart` (수정)
+5. `/lib/screens/equipment/controllers/equipment_list_controller.dart` (수정)
+6. `/lib/services/health_test_service.dart` (생성)
+7. `/lib/screens/login/controllers/login_controller.dart` (수정)
+8. `/lib/screens/overview/controllers/overview_controller.dart` (로그 추가)
+9. `/doc/server_side_database_error.md` (생성)
+10. `/doc/api_integration_fixes_summary.md` (생성)