# API 인벤토리 및 활용도 분석 보고서

> 작성일: 2025년 8월 26일
> 대상: Superport ERP 시스템 (Flutter Frontend + Rust Backend)

## 1. 백엔드 API 총 인벤토리

### 백엔드 API 엔드포인트 총계: **83개**

| 모듈 | 엔드포인트 수 | 인증 요구 사항 |
|------|-------------|---------------|
| Auth | 5개 | 일부 (2/5) |
| Health | 1개 | 불필요 |
| Users | 6개 | 관리자 권한 |
| Companies | 6개 | 관리자 권한 |
| Equipments | 9개 | 관리자 권한 |
| Equipment History | 10개 | 관리자 권한 |
| Maintenances | 6개 | 관리자 권한 |
| Vendors | 7개 | 관리자 권한 |
| Models | 6개 | 관리자 권한 |
| Warehouses | 6개 | 관리자 권한 |
| Rents | 6개 | 관리자 권한 |
| Administrators | 6개 | 관리자 권한 |
| Lookups | 4개 | 관리자 권한 |
| Zipcodes | 5개 | 관리자 권한 |

## 2. 프론트엔드 API 사용 현황

### 실제 사용중인 API 모듈

| 모듈 | 사용 여부 | 구현된 DataSource |
|------|---------|------------------|
| Auth | ✅ 사용중 | AuthRemoteDataSource |
| Users | ✅ 사용중 | UserRemoteDataSource |
| Companies | ✅ 사용중 | CompanyRemoteDataSource |
| Equipment | ⚠️ 부분 사용 | EquipmentRemoteDataSource |
| Warehouses | ✅ 사용중 | WarehouseLocationRemoteDataSource |
| Dashboard | ⚠️ 대체 구현 | DashboardRemoteDataSource |
| Lookups | ✅ 사용중 | LookupRemoteDataSource |
| **Vendors** | ❌ **미사용** | - |
| **Models** | ❌ **미사용** | - |
| **Equipment History** | ❌ **미사용** | - |
| **Maintenances** | ❌ **미사용** | - |
| **Rents** | ❌ **미사용** | - |
| **Administrators** | ❌ **미사용** | - |
| **Zipcodes** | ❌ **미사용** | - |

## 3. API 활용률 계산

### 전체 활용률
- **백엔드 총 API**: 83개
- **프론트엔드 사용 추정**: 약 35개
- **활용률**: **42.2%**

### 모듈별 활용률 상세

| 모듈 | 백엔드 API | 프론트엔드 사용 | 활용률 |
|------|-----------|--------------|--------|
| Auth | 5개 | 3개 | 60% |
| Users | 6개 | 5개 | 83% |
| Companies | 6개 | 4개 | 67% |
| Equipment | 9개 | 5개 | 56% |
| Warehouses | 6개 | 5개 | 83% |
| Lookups | 4개 | 2개 | 50% |
| **Vendors** | 7개 | 0개 | **0%** |
| **Models** | 6개 | 0개 | **0%** |
| **Equipment History** | 10개 | 0개 | **0%** |
| **Maintenances** | 6개 | 0개 | **0%** |
| **Rents** | 6개 | 0개 | **0%** |
| **Administrators** | 6개 | 0개 | **0%** |
| **Zipcodes** | 5개 | 0개 | **0%** |

## 4. 주요 불일치 사항

### 🚨 Critical: 완전 미구현 모듈 (43개 API / 52%)
1. **Vendors (제조사 관리)**: 백엔드 구현 완료, 프론트엔드 완전 미구현
2. **Models (모델 관리)**: 백엔드 구현 완료, 프론트엔드 완전 미구현
3. **Equipment History (재고 추적)**: 백엔드 구현 완료, 프론트엔드 완전 미구현
4. **Maintenances (유지보수)**: 백엔드 구현 완료, 프론트엔드 완전 미구현
5. **Rents (임대 관리)**: 백엔드 구현 완료, 프론트엔드 완전 미구현
6. **Administrators**: 백엔드 구현 완료, 프론트엔드 완전 미구현
7. **Zipcodes (우편번호)**: 백엔드 구현 완료, 프론트엔드 완전 미구현

### ⚠️ Warning: 엔드포인트 경로 불일치
1. **Equipment**:
   - 백엔드: `/equipments` (복수형)
   - 프론트엔드: `/equipment` (단수형)

2. **Warehouse**:
   - 백엔드: `/warehouses`
   - 프론트엔드: `/warehouse-locations`

### ⚠️ Warning: 존재하지 않는 API 호출
프론트엔드가 정의했지만 백엔드에 없는 엔드포인트:
- `/licenses/*` (라이선스 관련 모든 API)
- `/overview/*` (대시보드 통계 관련)
- `/files/*` (파일 업로드/다운로드)
- `/reports/*` (보고서 생성)
- `/bulk/*` (대량 처리)
- `/audit-logs` (감사 로그)
- `/backup/*` (백업/복원)

## 5. 영향도 분석

### 비즈니스 임팩트
- **High Impact**: Equipment History 미구현으로 재고 추적 불가능
- **High Impact**: Maintenances 미구현으로 유지보수 관리 불가능
- **Medium Impact**: Vendors/Models 미구현으로 장비 카탈로그 관리 제한
- **Low Impact**: Zipcodes 미구현 (주소 검증 제한)

### 기술 부채
- 43개 API (52%)가 구현되어 있지만 전혀 사용되지 않음
- 프론트엔드가 존재하지 않는 API를 참조하고 있음 (License 등)
- API 경로 불일치로 인한 잠재적 오류 위험

## 6. 권장 사항

### 즉시 조치 필요 (Priority 1)
1. Equipment History API 프론트엔드 구현 (재고 관리 핵심)
2. Maintenances API 프론트엔드 구현 (유지보수 관리 핵심)
3. API 경로 통일 (equipment → equipments)

### 단기 개선 (Priority 2)
1. Vendors/Models API 프론트엔드 구현
2. License → Maintenance 마이그레이션
3. 미사용 API 정의 제거

### 장기 개선 (Priority 3)
1. Rents API 구현 (임대 기능)
2. Administrators API 구현 (관리자 관리)
3. 파일 업로드/보고서 기능 백엔드 구현

## 7. 결론

**현재 API 활용률 42.2%**는 시스템이 절반 이하의 기능만 사용하고 있음을 의미합니다. 특히 재고 관리(Equipment History)와 유지보수(Maintenances) 같은 핵심 기능이 완전히 누락되어 있어, ERP 시스템으로서의 완성도가 매우 낮은 상태입니다.

백엔드는 이미 완성도 높게 구현되어 있으므로, 프론트엔드의 API 통합 작업이 시급히 필요합니다.