SamProject/sam-docs
5
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
2d9b02f74e77e42b68fff1f61866bbc456bc8a8b
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

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