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
parent 1f963a5c60
commit 2d9b02f74e
16 changed files with 3127 additions and 0 deletions
--- a/projects/api-integration/phase-4-integration/README.md
+++ b/projects/api-integration/phase-4-integration/README.md
@@ -0,0 +1,176 @@
+# Phase 4: 연동 작업 + 오류 수정
+
+> **상태**: ⏳ 대기
+> **선행 조건**: Phase 3 완료
+
+---
+
+## 목표
+
+React 화면과 API 실제 연동 및 오류 해결
+
+## ⚠️ 중요: "완료" 기준
+
+**소스 코드가 존재한다고 "완료"가 아닙니다!**
+
+### 완료 조건
+1. ✅ API 실제 호출하여 정상 응답 확인
+2. ✅ React 화면에서 데이터 정상 표시
+3. ✅ CRUD 전체 동작 검증
+4. ✅ 오류 없음 확인
+
+### API 검증 방법
+```bash
+# 방법 1: Swagger UI
+http://api.sam.kr/api-docs/index.html
+
+# 방법 2: curl 직접 호출
+curl -X GET "http://api.sam.kr/api/v1/clients" \
+  -H "X-API-KEY: {api_key}" \
+  -H "Authorization: Bearer {token}"
+
+# 방법 3: React 화면에서 직접 확인
+- 브라우저 개발자 도구 → Network 탭
+- 콘솔 오류 확인
+```
+
+### 검증 체크리스트 (각 API별)
+- [ ] GET (목록) - 200 응답, 데이터 정상
+- [ ] GET (상세) - 200 응답, 상세 데이터 정상
+- [ ] POST (생성) - 201 응답, 생성 성공
+- [ ] PUT (수정) - 200 응답, 수정 반영
+- [ ] DELETE (삭제) - 200 응답, 삭제 성공
+
+---
+
+## 체크리스트
+
+> 각 항목은 **실제 API 호출 후 정상 응답 확인** 시에만 체크
+
+### 인증/메뉴
+- [ ] POST /v1/login - 로그인 API 호출 검증
+- [ ] GET /v1/menus - 메뉴 목록 API 호출 검증
+- [ ] GET /v1/permissions - 권한 API 호출 검증
+- [ ] POST /v1/refresh - 토큰 갱신 API 호출 검증
+
+### 품목 관리 (Items)
+- [ ] GET /v1/items - 목록 조회 API 검증
+- [ ] GET /v1/items/{id} - 상세 조회 API 검증
+- [ ] POST /v1/items - 생성 API 검증
+- [ ] PUT /v1/items/{id} - 수정 API 검증
+- [ ] DELETE /v1/items/{id} - 삭제 API 검증
+- [ ] GET /v1/items/{id}/bom - BOM 조회 API 검증
+- [ ] POST /v1/items/{id}/files - 파일 업로드 API 검증
+
+### 거래처/판매
+- [ ] GET /v1/clients - 거래처 목록 API 검증
+- [ ] POST /v1/clients - 거래처 생성 API 검증
+- [ ] PUT /v1/clients/{id} - 거래처 수정 API 검증
+- [ ] DELETE /v1/clients/{id} - 거래처 삭제 API 검증
+- [ ] GET /v1/quotes - 견적 목록 API 검증
+- [ ] POST /v1/quotes - 견적 생성 API 검증
+- [ ] PUT /v1/quotes/{id} - 견적 수정 API 검증
+- [ ] DELETE /v1/quotes/{id} - 견적 삭제 API 검증
+- [ ] GET /v1/pricing - 단가 목록 API 검증
+- [ ] POST /v1/pricing - 단가 생성 API 검증
+- [ ] PUT /v1/pricing/{id} - 단가 수정 API 검증
+- [ ] GET /v1/orders - 주문 목록 API 검증 (미구현 시 구현 필요)
+- [ ] POST /v1/orders - 주문 생성 API 검증
+
+### 인사/재무
+- [ ] GET /v1/employees - 사원 목록 API 검증
+- [ ] POST /v1/employees - 사원 생성 API 검증
+- [ ] GET /v1/attendance - 근태 조회 API 검증
+- [ ] POST /v1/attendance - 근태 등록 API 검증
+- [ ] GET /v1/payroll - 급여 조회 API 검증
+- [ ] GET /v1/deposits - 입금 조회 API 검증
+- [ ] GET /v1/withdrawals - 출금 조회 API 검증
+
+### 기타 기능
+- [ ] GET /v1/boards - 게시판 목록 API 검증
+- [ ] GET /v1/posts - 게시글 목록 API 검증
+- [ ] GET /v1/dashboard - 대시보드 API 검증
+- [ ] GET /v1/settings - 설정 API 검증
+- [ ] GET /v1/reports - 보고서 API 검증
+
+## 작업 프로세스
+
+```
+1. 페이지 접속
+2. 콘솔/네트워크 오류 확인
+3. API 응답 확인
+4. 불일치 해결
+5. 테스트
+6. 로그 기록
+```
+
+## 이슈 관리
+
+### 이슈 파일 생성
+```
+phase-4-integration/issues/
+├── ISSUE-001.md
+├── ISSUE-002.md
+└── ...
+```
+
+### 이슈 템플릿
+```markdown
+# ISSUE-XXX: [제목]
+
+## 상태: 🔴 Open
+
+## 페이지
+[경로]
+
+## 증상
+[설명]
+
+## 원인
+[분석]
+
+## 해결
+[방법]
+
+## 변경 파일
+- [ ] file1
+- [ ] file2
+```
+
+## 산출물
+
+- [ ] `integration-log.md` - 작업 로그
+- [ ] `api-changes.md` - API 변경 내역
+- [ ] `issues/ISSUE-*.md` - 이슈 문서
+
+## 연동 로그 템플릿
+
+```markdown
+## [날짜] 연동 작업
+
+### 완료
+- 페이지: /items
+- API: GET /items
+- 결과: ✅ 정상
+
+### 수정
+- 페이지: /items/[id]
+- API: GET /items/{id}
+- 변경: category 필드 추가
+- 파일: ItemResource.php
+
+### 이슈
+- ISSUE-001: 파일 업로드 실패
+```
+
+---
+
+## 주의사항
+
+1. **React 기준**: API가 React 요구사항에 맞춤
+2. **시스템 구조 예외**: items 통합 등은 정책 기반
+3. **문서화 필수**: 모든 변경사항 기록
+
+---
+
+*Phase 4 작업 시작 시 이 체크리스트를 업데이트하세요.*