---
source: Phase A - Step A.1 분석 결과
section: 문서 간 교차 참조 맵
created: 2025-11-12
bp_mes_phase: Phase A - Step A.1 완료
related: [all_summaries]
tags: [cross-reference, integration, roadmap, gap-analysis]
---

# BP-MES 문서 간 교차 참조 맵

**생성일:** 2025-11-12
**Phase:** A - Step A.1 완료
**분석 범위:** 핵심 문서 6개 (API 1개, React 3개, Business 2개)

---

## Executive Summary

### 📚 분석 문서 목록

| # | 카테고리 | 원본 문서 | 요약 문서 | 줄수 | 주요 내용 |
|---|----------|----------|----------|------|----------|
| 1 | API | SAM_Item_DB_API_Analysis_v3_FINAL.md | api_item_analysis_summary.md | 1,262 | 가격 시스템, BOM, 품목 통합 조회 |
| 2 | React | ATOMIC_DESIGN_SYSTEM.md | react_atomic_design_summary.md | 1,548 | 컴포넌트 계층, 통합 전략 |
| 3 | React | DEVELOPMENT_GUIDELINES.md | react_dev_guidelines_summary.md | 1,120 | 코딩 규칙, TS, Tailwind |
| 4 | React | SCREEN_DESIGN_SPECIFICATION.md | react_screen_spec_summary.md | 2,014 | 15모듈, 30+화면, UI 컴포넌트 |
| 5 | Business | ERP_QUOTATION_GUIDE.md | business_quotation_guide_summary.md | 498 | 견적 자동화, 6단계 Phase |
| 6 | Business | USER_STORY_GUIDE.md | business_user_story_summary.md | 623 | 역할별 17개 스토리 |

**총 줄수:** 7,065줄 → 요약본 6개 생성

---

## 🎯 핵심 주제 매핑

### 1. 품목 관리 (Item Management)

**관련 문서:**
- `api_item_analysis_summary.md` (주)
- `react_screen_spec_summary.md` (화면)
- `business_quotation_guide_summary.md` (워크플로우)
- `business_user_story_summary.md` (유저 스토리 S1-S3, S8)

**핵심 발견:**

**API 관점:**
- 품목 타입: RM (원자재), PT (부품), FG (완제품)
- materials 테이블 (18컬럼): 타입 구분 필드 없음 (category만)
- products 테이블 (18컬럼): product_type 존재하지만 활용 미흡
- **통합 품목 조회 API 부재** (🔴 Critical)
- 현재: GET /api/v1/products + GET /api/v1/materials (분리)
- 필요: GET /api/v1/items?type=FG,PT,RM (통합)

**React 화면:**
- `src/pages/sales/ItemManagement.tsx` (품목 관리 화면)
- `react_screen_spec_summary.md`의 "10.1 품목 관리" 섹션
- 가변 크기 제품 체크박스 필요
- 치수/규격 탭 필요
- BOM 탭 필요

**비즈니스 워크플로우:**
- Phase 2: 원자재 등록 (S1)
- Phase 3: 구매 부품 등록 (S2), 제작 부품 등록 (S3)
- Phase 5: 완제품 등록 (S8)
- 치수/옵션 정의 (S4, S9)

**Gap Analysis:**
| 측면 | 백엔드 | 프론트엔드 | 비즈니스 요구 | 갭 |
|------|--------|----------|--------------|-----|
| 통합 조회 | ❌ 없음 | ❌ 2번 호출 | ✅ 필요 | 🔴 API 신설 필요 |
| 타입 구분 | ⚠️ 불명확 | ❌ category 추론 | ✅ RM/PT/FG | 🟡 material_type 컬럼 추가 |
| 가변 크기 | ❓ 미확인 | ❌ 미확인 | ✅ 필수 | 🔴 확인 및 구현 필요 |
| 치수 정의 | ❓ 미확인 | ❌ 미확인 | ✅ 필수 | 🔴 확인 및 구현 필요 |
| 옵션 정의 | ❓ 미확인 | ❌ 미확인 | ✅ 필수 | 🔴 확인 및 구현 필요 |

---

### 2. 가격 시스템 (Pricing System)

**관련 문서:**
- `api_item_analysis_summary.md` (주)
- `business_quotation_guide_summary.md` (사용)

**핵심 발견:**

**API 관점:**
- ✅ **가격 시스템 완전 구현됨!**
- price_histories 테이블 (14컬럼)
- Pricing API 5개 엔드포인트
- 다형성 가격 관리: item_type_code (PRODUCT|MATERIAL) + item_id
- 가격 유형 구분: price_type_code (SALE=판매가, PURCHASE=매입가)
- 고객그룹별 차별 가격: client_group_id (NULL=기본, 값=그룹별)
- 시계열 이력 관리: started_at ~ ended_at

**비즈니스 요구:**
- 구매 부품: 구매단가 × (1 + 마진율) = 판매단가
- 제작 부품: (자재비 + 가공비) × (1 + 마진율) = 판매단가
- 완제품: (자재비 + 공임비 + 설치비) × (1 + 마진율) = 판매단가

**프론트-백엔드 매핑 불일치 (🔴 Critical):**

**프론트엔드 기대:**
```typescript
interface ItemMaster {
  purchasePrice?: number;  // 단일 값
  salesPrice?: number;     // 단일 값
  marginRate?: number;
}
```

**백엔드 실제:**
```sql
-- 시계열 + 고객별 다중 레코드
price_histories:
  - 2024-01-01 ~ 2024-06-30: 40,000원
  - 2024-07-01 ~ 2024-12-31: 45,000원
  - 2025-01-01 ~ NULL: 50,000원 (현재)
  - 고객 A: 55,000원 (그룹별 가격)
```

**Gap Analysis:**
| 측면 | 백엔드 | 프론트엔드 | 해결 방안 |
|------|--------|----------|----------|
| 데이터 구조 | 시계열 배열 | 단일 값 | ItemMaster에서 가격 필드 제거, 별도 PriceManagement 컴포넌트 |
| 고객 차별화 | client_group_id | 표현 불가 | 견적 산출 시 동적 가격 조회 |
| 시계열 이력 | 과거-현재-미래 | 현재만 | PriceHistoryTable 컴포넌트 신규 개발 |
| 통합 조회 | ✅ 구현됨 | ❌ 미사용 | `/api/v1/items?include_price=true&client_id=5` 패턴 적용 |

---

### 3. BOM 시스템 (Bill of Materials)

**관련 문서:**
- `api_item_analysis_summary.md` (주)
- `business_quotation_guide_summary.md` (워크플로우)
- `business_user_story_summary.md` (유저 스토리 S5-S6, S10-S11)
- `react_screen_spec_summary.md` (화면)

**핵심 발견:**

**API 구조:**
- product_components 테이블 (14컬럼): 실제 제품의 BOM
  - 다형성: ref_type ('material' | 'product') + ref_id
  - 수량: quantity (decimal 18,6)
- bom_templates 테이블 (12컬럼): 설계 단계의 BOM 템플릿
  - model_version_id 기반
  - 계산 공식: calculation_schema (json)

**비즈니스 요구:**
- 다단계 BOM 구조:
  ```
  FG-SHUTTER-SET-VAR (완제품)
  ├─ PT-RAIL-VAR (제작 부품)
  │  ├─ RM-001 (원자재)
  │  └─ RM-003 (원자재)
  ├─ PT-CURTAIN-VAR (제작 부품)
  ├─ PT-MOTOR-001 (구매 부품) [MOTOR='Y']
  └─ PT-REMOTE-001 (구매 부품) [REMOTE='Y']
  ```

**핵심 기능:**
1. **소요량 계산식 (S6):**
   - 계산식 필드 지원: `G/1000*1.02` (연실율 반영)
   - 변수: 치수 값 (G, W, H)

2. **조건부 BOM (S10):**
   - 조건식 필드 지원: `MOTOR='Y'`
   - 옵션에 따라 구성품 포함/제외

3. **치수 연결 매핑 (S11) ⭐ 핵심!:**
   - 상위 치수 → 하위 치수 자동 전달
   - 예: 세트.W=3500 → 가이드레일.G=3500
   - 필요: dimension_mappings 테이블 또는 JSON 필드

**React 화면:**
- `src/pages/production/BomManagement.tsx` 존재 여부 확인 필요
- `react_screen_spec_summary.md`에 BOM 화면 명세 없음

**Gap Analysis:**
| 측면 | 백엔드 | 프론트엔드 | 비즈니스 요구 | 갭 |
|------|--------|----------|--------------|-----|
| BOM 구조 | ✅ 다형성 지원 | ❓ 미확인 | ✅ 필요 | 🟡 화면 확인 필요 |
| 계산식 | ❓ calculation_schema | ❌ 미확인 | ✅ 필수 | 🔴 formula 필드 확인/추가 |
| 조건식 | ❓ 미확인 | ❌ 미확인 | ✅ 필수 | 🔴 condition 필드 추가 필요 |
| 치수 연결 | ❌ 없음 | ❌ 없음 | ✅ 필수 (핵심!) | 🔴 dimension_mappings 테이블 신설 |
| BOM 화면 | ❓ 미확인 | ❌ 명세 없음 | ✅ 필요 | 🔴 화면 명세 및 구현 필요 |

---

### 4. 견적 시스템 (Quotation System)

**관련 문서:**
- `business_quotation_guide_summary.md` (주)
- `business_user_story_summary.md` (유저 스토리 S13-S17)
- `react_screen_spec_summary.md` (화면)
- `api_item_analysis_summary.md` (가격 연동)

**핵심 발견:**

**비즈니스 워크플로우:**
- S13: 견적서 생성 (헤더)
- S14: 품목 추가
- S15: 치수/옵션 입력
- S16: 실시간 견적 계산 (BOM 전개, 원가 내역)
- S17: 저장 및 PDF 출력

**자동 계산 프로세스:**
```
1. 치수 전달 (매핑 규칙)
   세트.W=3500 → 가이드레일.G=3500

2. 하위 품목 계산 (PT-RAIL-VAR)
   알루미늄: 3500/1000 × 1.02 = 3.57M
   자재비: 3.57 × 8,000 = 28,560원
   브래킷: 8 × 500 = 4,000원
   가공비: 3,000원
   판매단가: 35,560 × 1.2 = 42,672원

3. 상위 품목 계산 (FG-SHUTTER-SET-VAR)
   자재비: 42,672×2 + 291,664 + 180,000 = 557,008원
   총원가: 557,008 + 100,000 + 50,000 = 707,008원
   판매단가: 707,008 × 1.25 = 883,760원
```

**React 화면:**
- `src/pages/sales/QuoteManagement3List.tsx` ✅ 업데이트 완료
- `src/pages/sales/QuoteManagement3Write.tsx` ✅ 업데이트 완료
- 실시간 계산 미리보기 필요

**API 요구사항:**
- `POST /api/v1/quotes/calculate` (실시간 견적 계산)
  - 입력: 품목ID, 치수값 (W, H), 옵션값 (MOTOR, REMOTE), 수량
  - 출력: BOM 전개 트리, 원가 내역, 판매단가

**Gap Analysis:**
| 측면 | 백엔드 | 프론트엔드 | 비즈니스 요구 | 갭 |
|------|--------|----------|--------------|-----|
| 견적 화면 | ❓ API 확인 필요 | ✅ 화면 완료 | ✅ 필요 | 🟡 API 연동 확인 |
| 치수 입력 | ❓ 미확인 | ❌ 미확인 | ✅ 필수 | 🔴 치수 입력 폼 필요 |
| 옵션 선택 | ❓ 미확인 | ❌ 미확인 | ✅ 필수 | 🔴 옵션 선택 UI 필요 |
| 실시간 계산 | ❌ 없음 | ❌ 없음 | ✅ 필수 (핵심!) | 🔴 계산 엔진 API 신설 |
| BOM 전개 | ❌ 없음 | ❌ 없음 | ✅ 필수 | 🔴 BOM 전개 로직 구현 |
| PDF 출력 | ❓ 미확인 | ❓ 미확인 | ✅ 필요 | 🟡 확인 필요 |

---

### 5. React 컴포넌트 아키텍처

**관련 문서:**
- `react_atomic_design_summary.md` (주)
- `react_dev_guidelines_summary.md` (규칙)
- `react_screen_spec_summary.md` (화면)

**핵심 발견:**

**Atomic Design 계층:**
1. **Atoms (53개):** shadcn/ui 기반
2. **Molecules (5개 신규):**
   - MetaFieldRenderer
   - QuickFilter
   - StatusBadgeGroup
   - ActionButtonGroup
   - DataCardMobile
3. **Organisms (4개 신규):**
   - MetaFormBuilder
   - MetaDataTable
   - ChartGroup
   - PageHeaderWithActions
4. **Templates (4개 신규):**
   - DashboardLayout
   - CrudLayout
   - MasterDetailLayout
   - ReportLayout
5. **Pages (30+개):** 15개 모듈

**컴포넌트 통합 계획:**
- BOM: BomTreeView, BomFormBuilder, BomCalculator (3개 → 1개)
- Quote: QuoteCalculator, QuoteItemSelector, QuotePreview (3개 → 1개)
- Item: ItemForm, ItemList, ItemDetail, ItemSearch, ItemSelector (5개 → 1개)
- Dashboard: 6개 → 6개 (리팩토링만)

**화면 업데이트 상태:**
- ✅ 완료 (6개): VehicleManagement, EquipmentManagement, ItemManagement, OrderManagement, QuoteManagement3List, QuoteManagement3Write
- ⏳ 대기 (40+개): 나머지 화면

**공통 UI 컴포넌트 (6개):**
1. PageLayout
2. PageHeader
3. StatCards
4. SearchFilter
5. EmptyState
6. MobileCard

**Gap Analysis:**
| 측면 | 현재 상태 | 목표 | 갭 |
|------|----------|------|-----|
| Atoms | ✅ shadcn/ui 53개 | 유지 | ✅ 완료 |
| Molecules | ❌ 없음 | 5개 신규 | 🔴 개발 필요 |
| Organisms | ❌ 없음 | 4개 신규 | 🔴 개발 필요 |
| Templates | ❌ 없음 | 4개 신규 | 🔴 개발 필요 |
| Pages | ⚠️ 6/46 완료 (13%) | 100% | 🟡 40개 화면 업데이트 |
| 컴포넌트 통합 | ❌ 미시작 | BOM/Quote/Item | 🔴 통합 개발 필요 |

---

## 🔗 문서 간 의존성 맵

### API ← React 의존성

```
api_item_analysis_summary.md
├─→ react_screen_spec_summary.md (품목 관리 화면)
├─→ react_screen_spec_summary.md (견적 관리 화면)
└─→ react_atomic_design_summary.md (MetaFormBuilder for BOM)
```

**핵심 의존성:**
- 품목 관리 화면 → API 품목 조회 (통합 API 필요)
- 견적 관리 화면 → API 실시간 계산 (신규 API 필요)
- BOM 편집기 → API BOM 관리 (치수 연결 API 필요)

---

### Business ← API/React 의존성

```
business_quotation_guide_summary.md
├─→ api_item_analysis_summary.md (가격 시스템, BOM)
├─→ react_screen_spec_summary.md (품목/견적 화면)
└─→ react_atomic_design_summary.md (QuoteCalculator 컴포넌트)

business_user_story_summary.md
├─→ api_item_analysis_summary.md (데이터 모델)
├─→ react_screen_spec_summary.md (화면 흐름)
└─→ react_dev_guidelines_summary.md (폼 개발 규칙)
```

**핵심 의존성:**
- S1-S12 (품목/BOM 등록) → 품목 관리 화면 + BOM 관리 화면
- S13-S17 (견적 산출) → 견적 관리 화면 + 실시간 계산 API
- 치수 연결 매핑 (S11) → dimension_mappings API + DimensionMappingEditor 컴포넌트

---

### React 내부 의존성

```
react_screen_spec_summary.md (화면)
├─→ react_atomic_design_summary.md (컴포넌트 계층)
└─→ react_dev_guidelines_summary.md (코딩 규칙)

react_atomic_design_summary.md (아키텍처)
└─→ react_dev_guidelines_summary.md (개발 표준)
```

**핵심 의존성:**
- 모든 화면 → PageLayout, PageHeader (Templates)
- 품목/BOM 폼 → MetaFormBuilder (Organisms)
- 견적 계산 미리보기 → QuoteCalculator (Organisms)

---

## 📋 통합 인덱스 (주제별)

### 품목 관리 (Item Management)

| 측면 | 문서 | 섹션 | 페이지/라인 |
|------|------|------|------------|
| API 구조 | api_item_analysis_summary.md | 데이터베이스 현황 | materials/products 테이블 |
| API 엔드포인트 | api_item_analysis_summary.md | API 엔드포인트 현황 | Products API, Materials API |
| 통합 조회 제안 | api_item_analysis_summary.md | 개선 제안 1 | GET /api/v1/items |
| 화면 명세 | react_screen_spec_summary.md | 10.1 품목 관리 | ItemManagement.tsx |
| 비즈니스 워크플로우 | business_quotation_guide_summary.md | Phase 2-5 | 원자재/부품/완제품 등록 |
| 유저 스토리 | business_user_story_summary.md | S1, S2, S3, S8 | 품목 등록 |
| 컴포넌트 | react_atomic_design_summary.md | ItemForm 통합 | 5개 → 1개 |
| 개발 규칙 | react_dev_guidelines_summary.md | 폼 개발 규칙 | 컴포넌트 구조 표준 |

---

### 가격 시스템 (Pricing System)

| 측면 | 문서 | 섹션 | 페이지/라인 |
|------|------|------|------------|
| API 구조 | api_item_analysis_summary.md | price_histories 테이블 | 14 컬럼, 다형성 가격 |
| API 엔드포인트 | api_item_analysis_summary.md | Pricing API | 5개 엔드포인트 |
| 프론트-백 매핑 | api_item_analysis_summary.md | 문제점 2 | 단일값 vs 시계열 |
| 원가 계산 | business_quotation_guide_summary.md | Phase 4-5 | 원가 설정 |
| 판매단가 공식 | business_quotation_guide_summary.md | 데이터 구조 | 제작부품/완제품 공식 |
| 유저 스토리 | business_user_story_summary.md | S7, S12 | 단가 설정 |

---

### BOM 시스템 (Bill of Materials)

| 측면 | 문서 | 섹션 | 페이지/라인 |
|------|------|------|------------|
| API 구조 | api_item_analysis_summary.md | product_components | 다형성 BOM |
| BOM 템플릿 | api_item_analysis_summary.md | bom_templates | 설계 BOM |
| 소요량 수식 | business_quotation_guide_summary.md | Phase 4 Step 3 | G/1000 계산식 |
| 조건부 BOM | business_quotation_guide_summary.md | Phase 5 Step 3 | MOTOR='Y' 조건 |
| 치수 연결 | business_quotation_guide_summary.md | Phase 5-2 | 치수 자동 전달 ⭐ |
| 유저 스토리 | business_user_story_summary.md | S5, S6, S10, S11 | BOM/매핑 정의 |
| 컴포넌트 | react_atomic_design_summary.md | BOM 통합 | 3개 → 1개 |

---

### 견적 시스템 (Quotation System)

| 측면 | 문서 | 섹션 | 페이지/라인 |
|------|------|------|------------|
| 워크플로우 | business_quotation_guide_summary.md | Phase 6 | 견적서 작성 |
| 실시간 계산 | business_quotation_guide_summary.md | 핵심 자동화 | 치수→BOM→원가 |
| 유저 스토리 | business_user_story_summary.md | S13-S17 | 견적 산출 전체 |
| 화면 명세 | react_screen_spec_summary.md | 2.7 견적 관리 3 | Quote3List/Write |
| 컴포넌트 | react_atomic_design_summary.md | Quote 통합 | 3개 → 1개 |
| 계산 예시 | business_user_story_summary.md | S15 자동 계산 | 상세 프로세스 |

---

### React 아키텍처

| 측면 | 문서 | 섹션 | 페이지/라인 |
|------|------|------|------------|
| 컴포넌트 계층 | react_atomic_design_summary.md | 5-Layer | Atoms → Pages |
| 통합 전략 | react_atomic_design_summary.md | 컴포넌트 통합 | BOM/Quote/Item |
| 마이그레이션 | react_atomic_design_summary.md | 4 Phase 전략 | 8주 계획 |
| 화면 목록 | react_screen_spec_summary.md | 15개 모듈 | 30+ 화면 |
| 공통 컴포넌트 | react_screen_spec_summary.md | 6개 공통 UI | PageLayout 등 |
| 코딩 규칙 | react_dev_guidelines_summary.md | 전체 | TS, Tailwind |
| 성능 최적화 | react_dev_guidelines_summary.md | 8. 성능 최적화 | useMemo, React.memo |

---

## 🚨 통합 Gap Analysis

### 🔴 Critical (즉시 해결 필요)

| # | Gap | 현재 상태 | 목표 상태 | 관련 문서 | 우선순위 |
|---|-----|----------|----------|----------|----------|
| 1 | 통합 품목 조회 API 부재 | materials + products 분리 | /api/v1/items 통합 | api_item_analysis | P0 |
| 2 | 치수 연결 매핑 시스템 | 없음 | dimension_mappings 테이블 | business_quotation, S11 | P0 |
| 3 | 실시간 견적 계산 API | 없음 | /api/v1/quotes/calculate | business_quotation, S16 | P0 |
| 4 | BOM 소요량 계산식 필드 | ❓ 미확인 | formula 필드 | business_quotation, S6 | P0 |
| 5 | 조건부 BOM 필드 | 없음 | condition 필드 | business_quotation, S10 | P0 |
| 6 | 가변 크기/치수/옵션 필드 | ❓ 미확인 | dimensions/options JSON | business_quotation, S4/S9 | P0 |
| 7 | 프론트-백 가격 매핑 | 단일값 vs 시계열 | 통합 조회 API | api_item_analysis | P0 |

---

### 🟡 Important (Phase 별 해결)

| # | Gap | 현재 상태 | 목표 상태 | 관련 문서 | Phase |
|---|-----|----------|----------|----------|-------|
| 8 | 품목 타입 구분 | category만 | material_type 컬럼 | api_item_analysis | A.2 |
| 9 | BOM 관리 화면 명세 | 없음 | BOM 화면 명세 작성 | react_screen_spec | A.2 |
| 10 | Molecules 컴포넌트 | 없음 | 5개 신규 개발 | react_atomic_design | B |
| 11 | Organisms 컴포넌트 | 없음 | 4개 신규 개발 | react_atomic_design | B |
| 12 | Templates 컴포넌트 | 없음 | 4개 신규 개발 | react_atomic_design | B |
| 13 | 화면 업데이트 | 6/46 (13%) | 40개 화면 업데이트 | react_screen_spec | C |
| 14 | 컴포넌트 통합 | 미시작 | BOM/Quote/Item 통합 | react_atomic_design | C |

---

### 🟢 Nice to Have (추후 개선)

| # | Gap | 현재 상태 | 목표 상태 | 관련 문서 | 비고 |
|---|-----|----------|----------|----------|------|
| 15 | 가격 이력 UI | 없음 | PriceHistoryTable | api_item_analysis | 저우선순위 |
| 16 | Materials search API | 없음 | /api/v1/materials/search | api_item_analysis | 편의 기능 |
| 17 | PDF 출력 | ❓ 미확인 | 견적서 PDF | business_quotation, S17 | 확인 필요 |

---

## 📊 Phase 별 개발 로드맵 (통합)

### Phase A.2: API 코드 분석 (1-2주)

**목표:** 백엔드 코드 확인 및 누락 기능 파악

**작업:**
1. Laravel API 프로젝트 전체 분석
2. 품목 관리 API 상세 분석 (products, materials)
3. BOM 관리 API 상세 분석 (product_components, bom_templates)
4. Pricing API 상세 분석 (price_histories)
5. 견적 API 존재 여부 및 기능 확인
6. 치수/옵션 관련 필드 존재 여부 확인
7. Gap 7개 (Critical) 검증

**결과물:**
- `api_code_analysis_summary.md` (API 코드 분석 요약)
- `api_gap_validation_report.md` (Gap 검증 보고서)

---

### Phase A.3: React 코드 분석 (1-2주)

**목표:** 프론트엔드 코드 확인 및 재사용 가능 컴포넌트 파악

**작업:**
1. React 프로젝트 전체 구조 분석
2. 품목 관리 화면 상세 분석 (ItemManagement.tsx)
3. 견적 관리 화면 상세 분석 (QuoteManagement3List/Write.tsx)
4. BOM 관련 컴포넌트 존재 여부 확인
5. 공통 컴포넌트 재사용성 평가
6. shadcn/ui 53개 Atoms 활용 현황
7. Gap 14개 (Important) 검증

**결과물:**
- `react_code_analysis_summary.md` (React 코드 분석 요약)
- `react_reusable_components_map.md` (재사용 가능 컴포넌트 맵)

---

### Phase B: API 신규/수정 개발 (3-4주)

**우선순위 1 (Week 1-2):**
1. 통합 품목 조회 API (Gap #1)
   - `GET /api/v1/items?type=FG,PT,RM&search=...`
   - UNION 쿼리로 통합 조회
2. 품목-가격 통합 조회 엔드포인트 (Gap #7)
   - `GET /api/v1/items/{id}?include_price=true&client_id=5`
3. 품목 타입 구분 명확화 (Gap #8)
   - materials 테이블: material_type 컬럼 추가 (RM/SM/CS)

**우선순위 2 (Week 2-3):**
4. 치수/옵션 필드 추가 (Gap #6)
   - products/materials 테이블: dimensions, options JSON 필드
5. BOM 계산식/조건식 필드 (Gap #4, #5)
   - product_components: formula, condition 필드 추가
6. 치수 연결 매핑 시스템 (Gap #2)
   - dimension_mappings 테이블 신설
   - API 엔드포인트: `POST /api/v1/boms/{id}/dimension-mappings`

**우선순위 3 (Week 3-4):**
7. 실시간 견적 계산 API (Gap #3)
   - `POST /api/v1/quotes/calculate`
   - BOM 전개 → 치수 연결 → 소요량 계산 → 원가/판매가 산출
   - 조건부 BOM 처리

**결과물:**
- 7개 Critical Gap 해결
- Swagger 문서 업데이트
- PHPUnit 테스트 작성

---

### Phase C: React 컴포넌트 개발 (4-6주)

**우선순위 1 (Week 1-2): Molecules & Organisms**
1. MetaFieldRenderer (Molecules)
2. MetaFormBuilder (Organisms) - 품목/BOM 폼에 사용
3. QuoteCalculator (Organisms) - 견적 계산 미리보기

**우선순위 2 (Week 2-3): 품목 관리 화면**
4. ItemMasterForm 개선
   - 가변 크기 체크박스
   - 치수/옵션 동적 추가/삭제
   - 원가 설정 (가공비, 공임비, 설치비, 마진율)

**우선순위 3 (Week 3-4): BOM 관리 화면**
5. BomEditor 신규 개발
   - 구성품 트리 뷰
   - 수량/계산식/조건식 입력
6. DimensionMappingEditor 신규 개발
   - 상위-하위 치수 매핑 UI

**우선순위 4 (Week 4-6): 견적 관리 화면**
7. QuoteForm 개선
   - 치수/옵션 입력 폼
   - 실시간 계산 미리보기 (QuoteCalculator 사용)
   - BOM 전개 트리 뷰
   - 원가 내역 표시

**결과물:**
- 3개 신규 Organisms 컴포넌트
- ItemMasterForm, BomEditor, DimensionMappingEditor, QuoteForm 완성
- Storybook 문서화

---

### Phase D: 통합 테스트 및 배포 (1-2주)

**작업:**
1. E2E 테스트 (Playwright)
   - S1-S17 유저 스토리 전체 시나리오
2. 성능 테스트
   - BOM 계산 성능 (다단계 구조)
   - 견적 계산 성능 (실시간 응답)
3. 사용자 테스트
   - 기준정보 담당자, 생산기술 담당자, 원가 관리팀, 영업 담당자
4. 버그 수정 및 개선
5. 배포 및 모니터링

**결과물:**
- E2E 테스트 커버리지 100% (S1-S17)
- 성능 최적화 완료
- 운영 배포

---

## 🎯 다음 단계 (Next Steps)

### Phase A.2 준비 작업

**즉시 시작 가능:**
1. Laravel API 프로젝트 전체 파일 목록 생성
   - `find api/ -name "*.php" | grep -E "(Controller|Service|Model)" > api_files.txt`
2. 품목 관련 파일 우선 분석
   - ProductController.php
   - MaterialController.php
   - ProductService.php
   - MaterialService.php
   - Product.php (Model)
   - Material.php (Model)
3. BOM 관련 파일 분석
   - BomTemplateController.php (존재 여부 확인)
   - ProductComponent.php (Model)
4. Pricing 관련 파일 분석
   - PricingController.php
   - PricingService.php
   - PriceHistory.php (Model)
5. 견적 관련 파일 분석
   - QuoteController.php (존재 여부 확인)

**예상 소요 시간:** 1-2주

---

## 📌 요약 및 결론

### ✅ 분석 완료 항목

1. **문서 분석:** 핵심 문서 6개 (7,065줄) 완료
2. **요약 생성:** 6개 breakdown summary 생성
3. **Gap 발견:** Critical 7개, Important 7개, Nice to Have 3개
4. **교차 참조 맵:** 주제별 통합 인덱스 생성

---

### 🔴 핵심 발견사항

1. **가격 시스템:** ✅ 완전 구현됨! (백엔드 90%, 프론트 0%)
2. **통합 품목 조회:** ❌ API 부재 (프론트 2번 호출 필요)
3. **치수 연결 매핑:** ❌ 시스템 부재 (비즈니스 핵심 기능!)
4. **실시간 견적 계산:** ❌ API 부재 (비즈니스 핵심 기능!)
5. **BOM 계산식/조건식:** ❓ 확인 필요

---

### 🎯 Phase A.1 완료

**달성:**
- 8개 문서 중 6개 분석 완료 (API 1개, React 3개, Business 2개)
- 교차 참조 맵 생성
- Gap Analysis 17개 발견
- Phase 별 개발 로드맵 수립

**다음 단계:**
- Phase A.2: API 코드 분석 (1-2주)
- Phase A.3: React 코드 분석 (1-2주)

---

**문서 버전:** v1.0
**작성일:** 2025-11-12
**BP-MES Phase:** A - Step A.1 완료 ✅
**다음 Phase:** A - Step A.2 (API 코드 분석)
