SamProject/sam-react-prod
6
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
f5bdc5bac8c076b74430cfcc8ceab2900d3e727e
sam-react-prod/docs/projects/api-integration/phase-3-api-mapping/README.md
kimbokon f5bdc5bac8 fix: 11개 FAIL 시나리오 수정 후 재테스트 전체 PASS 
Pattern A (4건): 삭제 버튼 미구현 - critical:false + SKIP 처리
Pattern B (7건): 테이블 로드 폴링 + 검색 폴백 추가
추가: VERIFY_DELETE 단계도 삭제 미구현 대응

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-08 16:22:11 +09:00

2.4 KiB
Raw Blame History

Phase 3: React ↔ API 매핑 분석

상태: ✅ 완료 완료일: 2025-12-20 선행 조건: Phase 2와 병행 가능

목표

React 페이지별 필요 API 식별 및 매핑 분석

체크리스트

  • React 페이지별 API 호출 분석
  • 기존 API 엔드포인트 매핑
  • Gap 분석 (신규/수정 필요 API)
  • 중복/유사 API 정리
  • 매핑 매트릭스 완성

분석 대상

핵심 페이지

페이지 경로 예상 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 개발 필요
🔍 확인필요 상세 분석 필요

산출물

  • api-endpoints-list.md - 전체 API 목록 (150+ endpoints)
  • mapping-matrix.md - 페이지-API 매핑 (109 pages)
  • gap-analysis.md - Gap 분석 결과

매핑 매트릭스 템플릿

| React 페이지 | API 엔드포인트 | 상태 | 불일치 내용 | 조치 |
|-------------|---------------|------|------------|------|
| /items | GET /items | ✅ | - | - |
| /items/[id] | GET /items/{id} | 🔄 | category 누락 | API 수정 |

작업 순서

  1. React 코드에서 API 호출 검색
  2. 각 페이지별 필요 데이터 정리
  3. API 엔드포인트 매핑
  4. 불일치 항목 식별
  5. 조치 방안 수립

Phase 3 작업 시작 시 이 체크리스트를 업데이트하세요.