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>

projects/api-integration/PROGRESS.md

@@ -0,0 +1,150 @@
+# API Integration Progress
+
+> **마지막 업데이트**: 2025-12-20
+> **현재 세션**: #1
+
+---
+
+## 🎯 현재 상태 (세션 복구 시 여기부터)
+
+| 항목 | 값 |
+|------|-----|
+| **현재 Phase** | Phase 4 진행 중 |
+| **현재 작업** | 각 API 실제 호출 검증 |
+| **진행률** | 55% |
+| **다음 액션** | POST /v1/pricing 오류 확인 및 수정 |
+| **완료 기준** | ⚠️ 소스 존재가 아닌 **실제 API 호출 검증** |
+
+---
+
+## 📋 Phase 체크리스트
+
+### Phase 0: 사전 분석 [✅ 완료]
+- [x] API 프로젝트 구조 분석
+- [x] React 프로젝트 구조 분석
+- [x] 테이블 통합 현황 확인
+- [x] 문서 구조 생성
+- [x] MASTER_PLAN.md 작성
+
+### Phase 1: 테이블 통합 [✅ 이미 완료됨 - 스킵]
+> items 테이블 통합 2025-12-13에 완료됨
+- [x] products/materials → items 마이그레이션
+- [x] ItemsController 통합
+- [x] ItemService 통합
+- [x] BOM 관리 통합
+
+### Phase 2: 메뉴 추출 [✅ 완료]
+- [x] React 라우트 목록 추출 (107개 페이지)
+- [x] 메뉴 구조 정리 (11개 대메뉴, 54개 중메뉴)
+- [x] mng 등록용 포맷 생성 (JSON 포맷)
+- [x] 권한 매핑 (52개 세부 권한)
+
+### Phase 3: API 매핑 [✅ 완료]
+- [x] React 페이지별 API 분석 (109 페이지)
+- [x] 매핑 매트릭스 작성 (`mapping-matrix.md`)
+- [x] Gap 분석 (`gap-analysis.md`)
+- [x] API 엔드포인트 목록 (`api-endpoints-list.md`)
+
+### Phase 4: 연동 작업 [⏳ 진행 중]
+
+> ⚠️ **완료 기준**: 소스 존재가 아닌 **실제 API 호출 검증 후** 체크
+
+- [ ] 인증/메뉴 - 실제 API 호출 검증
+- [ ] 품목 관리 - 실제 API 호출 검증
+- [ ] 거래처/판매 - 실제 API 호출 검증 (POST /v1/pricing 오류 확인 필요)
+- [ ] 인사/재무 - 실제 API 호출 검증
+- [ ] 기타 기능 - 실제 API 호출 검증
+
+### Phase 5: 최종 검증 [⏳ 대기]
+- [ ] 전체 기능 테스트
+- [ ] 최종 리포트 작성
+
+---
+
+## 📊 분석 결과 요약
+
+### API 현황
+| 항목 | 값 |
+|------|-----|
+| 총 엔드포인트 | ~325개 |
+| 주요 도메인 | 8개 |
+| Swagger 문서 | 69개 파일 |
+| 인증 방식 | API Key + Bearer Token |
+
+### React 현황
+| 항목 | 값 |
+|------|-----|
+| 프레임워크 | Next.js 15.5.7 |
+| 라우트 그룹 | 15개+ |
+| API 클라이언트 | Native Fetch |
+| 인증 | HttpOnly Cookie |
+
+### 주요 발견사항
+1. **items 통합 완료**: Phase 1 스킵 가능
+2. **대부분 Mock 데이터**: 87.2%가 generateMockData() 사용
+3. **프록시 패턴 사용**: `/api/proxy/*` → PHP `/api/v1/*`
+4. **API 연동 완료**: Items, Master Data, Clients, Pricing (7.3%)
+5. **권한 관리 이슈**: localStorage 사용 중 (API 전환 필요)
+
+---
+
+## 🚨 중단 시 복구 가이드
+
+### 1. 상태 확인
+```
+serena.list_memories()
+serena.read_memory("api-integration-state")
+```
+
+### 2. 문서 확인
+1. 이 문서의 "현재 상태" 섹션
+2. 해당 Phase 디렉토리의 README.md
+3. "다음 액션"부터 재개
+
+### 3. 작업 재개
+- Phase 2: `phase-2-menu-extraction/README.md`
+- Phase 3: `phase-3-api-mapping/README.md`
+- Phase 4: `phase-4-integration/README.md`
+
+---
+
+## 📝 세션 히스토리
+
+| 세션 | 날짜 | 완료 작업 | 비고 |
+|------|------|----------|------|
+| #1 | 2025-12-20 | Phase 0 완료, 문서 구조 생성, 분석 완료 | 초기 세션 |
+| #2 | 2025-12-20 | Phase 3 완료, API 매핑 분석, Gap 분석 | 109 페이지 분석 |
+| #3 | 2025-12-20 | Phase 2 완료, 메뉴 추출, 권한 매핑 | 11개 대메뉴, 54개 중메뉴, 52개 권한 |
+
+---
+
+## 🔍 다음 세션 시작 시
+
+1. **Serena 메모리 로드**
+   ```
+   serena.read_memory("api-integration-state")
+   ```
+
+2. **이 문서의 "현재 상태" 확인**
+
+3. **"다음 액션" 실행**
+
+---
+
+## 📌 중요 결정 사항
+
+| 날짜 | 결정 | 근거 |
+|------|------|------|
+| 2025-12-20 | Phase 1 스킵 | items 통합 이미 완료됨 (2025-12-13) |
+| 2025-12-20 | React 기준 연동 | 화면 요구사항 우선 |
+| 2025-12-20 | 프록시 패턴 유지 | HttpOnly 쿠키 보안 |
+
+---
+
+## ⚠️ 블로커/이슈
+
+현재 블로커 없음.
+
+---
+
+*이 문서는 작업 진행에 따라 지속 업데이트됩니다.*