Files
sam-docs/projects/api-integration/phase-3-api-mapping/README.md
kent 2d9b02f74e docs: API 통합 프로젝트 계획 및 Flow Test 스펙 추가
- INDEX.md: TODO.md 링크 추가
- TODO.md: 프로젝트 할일 목록 신규 생성
- plans/flow-tests/: Flow Tester 테스트 시나리오 JSON 추가
  - auth-api-flow.json: 인증 API 플로우 테스트
  - pricing-validation-test.json: 가격 검증 테스트
- projects/api-integration/: 마이그레이션 계획 문서
  - MASTER_PLAN.md: 전체 마이그레이션 전략
  - PROGRESS.md: 진행 상황 추적
  - WORKFLOW.md: 작업 워크플로우
  - phase-1 ~ phase-4: 단계별 상세 계획

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-21 01:35:43 +09:00

88 lines
2.4 KiB
Markdown

# 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 작업 시작 시 이 체크리스트를 업데이트하세요.*