# 견적 디버깅 가이드

## 개요
견적 관리 시스템에 디버깅 모드가 추가되어 견적 산출 과정을 상세하게 추적할 수 있습니다.

## 주요 기능

### 1. 샘플 데이터 판매단가 자동 설정
- **문제**: 기존 샘플 데이터의 완제품 판매단가가 0원으로 설정되어 견적이 모두 0원으로 계산됨
- **해결**: 샘플 데이터 생성 시 완제품의 판매단가를 자동 계산
  - 스크린 제품: `인건비 + 설치비 + 500,000원 (자재비 기본값)`
  - 철재 제품: `인건비 + 설치비 + 450,000원 (자재비 기본값)`

### 2. 견적 디버깅 패널
견적 산출 과정의 모든 데이터를 시각화하여 표시합니다.

#### 표시 정보
1. **제품 정보**
   - 품목코드, 품목명, 카테고리
   - 판매단가, 인건비, 설치비
   - 오픈사이즈 (폭 × 높이)

2. **BOM 상세 정보**
   - 각 BOM 항목별:
     - 품목코드, 품목명, 품목타입
     - 기준수량, 계산수량
     - 수식 및 수식 평가 과정
     - 단가 및 단가 출처 (판매단가/구매단가/미설정)
     - 합계 금액
     - 경고 메시지

3. **계산 요약**
   - 자재비, 인건비, 설치비
   - 소계 및 최종 금액
   - 계산식 상세 표시

#### 경고 시스템
- 단가가 0원인 품목 자동 감지
- 판매단가 미설정 제품 감지
- 경고 발생 시 디버그 패널 자동 표시

## 사용 방법

### 1. 샘플 데이터 생성
```
1. 견적 관리 > 견적 등록 페이지로 이동
2. 하단의 "견적 산출 샘플 데이터" 카드에서 "샘플 데이터 생성" 버튼 클릭
3. 75개의 품목이 생성되며, 모든 완제품에 판매단가가 자동 설정됨
```

### 2. 견적 산출 및 디버깅
```
1. 제품 선택 및 오픈사이즈 입력
2. BOM이 자동 계산되면 디버그 정보가 자동 생성됨
3. 경고가 있는 경우 디버그 패널이 자동으로 열림
4. 디버그 패널에서 각 섹션을 펼쳐 상세 정보 확인
```

### 3. 디버그 정보 해석

#### 단가 출처 색상 코드
- 🟢 초록색 (판매단가): 품목의 판매단가 사용
- 🔵 파란색 (구매단가): 품목의 구매단가 사용
- 🔴 빨간색 (미설정): 단가가 0원 또는 미설정

#### 수식 평가 예시
```
수식: W*H/1000000
평가: W*H/1000000 = 2000*3000/1000000 = 6.00
```

## 문제 해결

### 견적이 0원으로 계산되는 경우
1. 디버그 패널 확인
2. "BOM 상세" 섹션에서 빨간색으로 표시된 항목 찾기
3. 품목 관리에서 해당 품목의 판매단가 또는 구매단가 입력
4. 견적 재계산

### 수식 오류가 있는 경우
1. 디버그 패널의 "수식" 열에서 오류 항목 확인
2. "수식 평가" 정보로 어떻게 계산되었는지 확인
3. BOM 템플릿이나 품목 BOM에서 수식 수정

## 기술 세부사항

### 파일 구조
- `/components/QuoteDebugPanel.tsx`: 디버그 패널 UI 컴포넌트
- `/components/QuoteManagement3Write.tsx`: 디버그 정보 생성 및 표시 로직
- `/components/contexts/DataContext.tsx`: 샘플 데이터 생성 로직

### 디버그 정보 생성 시점
1. 제품 선택 및 오픈사이즈 변경 시
2. BOM 계산 완료 후
3. BOM 항목 수동 수정 시
4. 수량 변경 시

### 성능 고려사항
- 디버그 정보는 메모리에만 저장되며 localStorage에 저장되지 않음
- 페이지 새로고침 시 디버그 정보 초기화
- 대량의 BOM 항목도 효율적으로 표시 가능

## 향후 개선사항
- [ ] 디버그 정보 내보내기 (JSON, CSV)
- [ ] 견적 비교 모드 (여러 견적의 디버그 정보 비교)
- [ ] 수식 시뮬레이터 (수식 테스트 기능)
- [ ] 단가 히스토리 추적
