Files
sam-docs/projects/api-integration/phase-3-api-mapping/README.md

88 lines
2.4 KiB
Markdown
Raw Normal View History

# Phase 3: React ↔ API 매핑 분석
> **상태**: ✅ 완료
> **완료일**: 2025-12-20
> **선행 조건**: Phase 2와 병행 가능
---
## 목표
React 페이지별 필요 API 식별 및 매핑 분석
## 체크리스트
- [x] React 페이지별 API 호출 분석
- [x] 기존 API 엔드포인트 매핑
- [x] Gap 분석 (신규/수정 필요 API)
- [x] 중복/유사 API 정리
- [x] 매핑 매트릭스 완성
## 분석 대상
### 핵심 페이지
| 페이지 | 경로 | 예상 API |
|--------|------|----------|
| 대시보드 | /dashboard | /dashboard/* |
| 품목 목록 | /items | /items |
| 품목 상세 | /items/[id] | /items/{id}, /items/{id}/bom |
| 품목 생성 | /items/create | POST /items |
### 회계 모듈
| 페이지 | 경로 | 예상 API |
|--------|------|----------|
| 매출 목록 | /accounting/sales | /sales |
| 매입 목록 | /accounting/purchase | /purchases |
| 거래처 | /accounting/vendors | /clients |
### 영업 모듈
| 페이지 | 경로 | 예상 API |
|--------|------|----------|
| 견적 관리 | /sales/quote-management | /quotes |
| 단가 관리 | /sales/pricing-management | /pricing |
| 거래처 | /sales/client-management-sales-admin | /clients |
### 인사 모듈
| 페이지 | 경로 | 예상 API |
|--------|------|----------|
| 사원 관리 | /hr/employee-management | /employees |
| 근태 | /hr/attendance | /attendances |
| 휴가 | /hr/vacation-management | /leaves |
## 매핑 상태 분류
| 상태 | 설명 |
|------|------|
| ✅ 완료 | API 연동 완료 |
| 🔄 수정필요 | API 응답 수정 필요 |
| 🆕 신규필요 | 신규 API 개발 필요 |
| 🔍 확인필요 | 상세 분석 필요 |
## 산출물
- [x] `api-endpoints-list.md` - 전체 API 목록 (150+ endpoints)
- [x] `mapping-matrix.md` - 페이지-API 매핑 (109 pages)
- [x] `gap-analysis.md` - Gap 분석 결과
## 매핑 매트릭스 템플릿
```markdown
| React 페이지 | API 엔드포인트 | 상태 | 불일치 내용 | 조치 |
|-------------|---------------|------|------------|------|
| /items | GET /items | ✅ | - | - |
| /items/[id] | GET /items/{id} | 🔄 | category 누락 | API 수정 |
```
---
## 작업 순서
1. React 코드에서 API 호출 검색
2. 각 페이지별 필요 데이터 정리
3. API 엔드포인트 매핑
4. 불일치 항목 식별
5. 조치 방안 수립
---
*Phase 3 작업 시작 시 이 체크리스트를 업데이트하세요.*