# 🚀 빠른 시작 가이드 - ERP 견적 시스템

## 📌 현재 구현 상태

✅ **Phase 1-6 완료**: 치수 자동 연결, 실시간 견적 계산, BOM 전개 등 핵심 기능 구현
✅ **3개 핵심 화면 완료**: ItemManagement, BOMManagementEnhanced, QuoteManagement
✅ **메뉴 연결 완료**: 모든 역할에서 접근 가능

---

## 🎯 1분 안에 시작하기

### Step 1: 화면 열기
브라우저에서 애플리케이션을 엽니다.

### Step 2: 역할 확인 (우측 상단)
```
현재 역할: CEO ✅ (또는 SystemAdmin)
```
- CEO와 SystemAdmin 역할에서 모든 메뉴 접근 가능
- 다른 역할을 선택하면 제한된 메뉴만 표시됨

### Step 3: 메뉴 접근
좌측 사이드바에서 다음 메뉴를 찾습니다:

#### 🏭 생산관리 (클릭하여 확장)
```
생산관리 ▼
├─ 📦 품목관리 (개선)  ← S1~S9, S12 실행
├─ 🌳 BOM관리 (개선)   ← S5~S6, S10~S11 실행
├─ 📦 품목관리 (기존)
├─ 🌳 BOM관리 (기존)
├─ 📦 스크린 생산
├─ 📦 슬랫 생산
├─ 📦 절곡 생산
└─ 📦 재고 생산
```

#### 📊 영업관리 (클릭하여 확장)
```
영업관리 ▼
├─ 👥 리드관리
├─ 🏢 매출처관리
├─ 🏢 거래처관리
├─ 🧮 견적관리 (개선)  ← S13~S17 실행
├─ 🧮 견적관리 (기존)
├─ 🛒 수주관리
└─ 📊 영업실적
```

---

## ✨ 핵심 기능 3가지

### 1️⃣ 품목관리 (개선)
**위치**: 생산관리 > 품목관리 (개선)

**할 수 있는 것**:
- ✅ 원자재(RM), 부품(PT), 완제품(FG) 등록
- ✅ 가변 크기 제품 설정 (치수 정의)
- ✅ 원가/단가 자동 계산
- ✅ BOM 라인 정의 (수식 입력 가능)

**예시**:
```
[신규 등록] 클릭
→ 품목 유형: 부품 (PT)
→ 품목명: 가이드레일 (가변 길이)
→ ✅ "가변 크기 제품" 체크
→ [치수/규격 탭] → 치수명: G, 단위: mm
→ [BOM 라인 탭] → 하위 품목: RM-001, 수량 수식: G/1000*1.02
→ [원가 탭] → 가공비: 3,000원, 마진율: 20%
→ [등록]
```

---

### 2️⃣ BOM관리 (개선)
**위치**: 생산관리 > BOM관리 (개선)

**할 수 있는 것**:
- ✅ 다단계 BOM 구조 생성
- ✅ 치수 자동 연결 매핑 (핵심!)
- ✅ 조건부 BOM 라인 (옵션에 따라 포함/제외)
- ✅ 실시간 BOM 전개 미리보기

**예시**:
```
[BOM 등록] 클릭
→ 상위 품목: FG-SHUTTER-SET-VAR
→ [BOM 라인 탭] 
  → 하위 품목: PT-RAIL-VAR, 수량: 2
  → 하위 품목: PT-MOTOR-001, 수량: 1, 조건: MOTOR='Y'
→ [치수 연결 탭] ⭐ 핵심!
  → 하위 품목: PT-RAIL-VAR
  → 상위 치수: W → 하위 치수: G
  → [매핑 추가]
→ [저장]
```

**치수 연결이란?**
```
견적 입력: 세트.W = 3500mm

↓ 자동 전달 (치수 매핑)

가이드레일.G = 3500mm

↓ BOM 계산

알루미늄 소요량 = 3500/1000 × 1.02 = 3.57M
```

---

### 3️⃣ 견적관리 (개선)
**위치**: 영업관리 > 견적관리 (개선)

**할 수 있는 것**:
- ✅ 실시간 견적 계산 (치수 입력 즉시 계산)
- ✅ BOM 전개 자동화
- ✅ 다단계 원가 계산 (RM → PT → FG)
- ✅ PDF 견적서 출력

**예시**:
```
[신규 견적 작성] 클릭
→ 거래처: ABC건설, 납기일: 2025-02-15
→ [품목 추가] 클릭
→ 품목: FG-SHUTTER-SET-VAR
→ 치수 입력:
  - 폭 (W): 3500mm
  - 높이 (H): 2500mm
→ 옵션 선택:
  - 모터 포함 (MOTOR): Y
→ 수량: 1
→ 실시간 계산 결과 확인:
  - 판매단가: 883,760원
  - 부가세: 88,376원
  - 총액: 972,136원
→ [견적서에 추가] 클릭
→ [견적서 저장] 클릭
→ 목록에서 [출력] 버튼 클릭 → PDF 생성
```

---

## 🎓 유저 스토리 따라하기

### 준비사항
1. 역할: CEO 또는 SystemAdmin
2. 메뉴: 생산관리, 영업관리 접근 가능
3. 가이드: USER_STORY_GUIDE.md 참고

### 실행 순서
```
Phase 1: 자재/부품 마스터 등록
├─ S1: RM-001 (알루미늄) 등록
├─ S2: PT-MOTOR-001 (모터) 등록
└─ S3: PT-RAIL-VAR (가이드레일) 등록

Phase 2: 부품 BOM 및 원가 정의
├─ S4: 치수 정의 (G)
├─ S5-S6: BOM 생성 및 수식 입력 (G/1000*1.02)
└─ S7: 원가 설정 (가공비, 마진)

Phase 3: 제품 BOM 및 최종 정책 정의
├─ S8-S9: FG 등록 및 치수/옵션 정의
├─ S10: 제품 BOM 생성
├─ S11: 치수 연결 매핑 (W→G) ⭐ 핵심!
└─ S12: 제품 원가 설정

Phase 4: 견적 산출
├─ S13: 견적서 생성
├─ S14-S15: 품목 추가 및 치수 입력
├─ S16: 실시간 계산 확인
└─ S17: 저장 및 PDF 출력 ✅
```

---

## 📱 모바일에서 사용하기

### 메뉴 열기
1. 좌측 상단 **햄버거 메뉴 (≡)** 클릭
2. 사이드바 열림
3. 생산관리 / 영업관리 클릭하여 확장
4. 원하는 서브메뉴 클릭

### 반응형 디자인
- 데스크톱: 테이블 형식
- 모바일: 카드 형식
- 모달/다이얼로그: 자동 크기 조정

---

## 🔧 문제 해결

### Q: 메뉴가 보이지 않아요
**A**: 우측 상단에서 역할을 **CEO** 또는 **SystemAdmin**으로 변경하세요.

### Q: 생산관리를 클릭했는데 아무것도 안 나와요
**A**: 생산관리를 다시 클릭하여 서브메뉴를 확장하세요. 아래쪽 화살표(▼) 아이콘이 보여야 합니다.

### Q: "품목관리 (개선)"과 "품목관리 (기존)"의 차이는?
**A**: 
- **품목관리 (개선)**: 새로운 ItemManagement 컴포넌트 (치수 연결, 수식 입력 지원)
- **품목관리 (기존)**: 이전 ProductsManagement 컴포넌트 (기본 CRUD만 지원)

유저 스토리를 따라하려면 반드시 **(개선)** 버전을 사용하세요!

### Q: 견적 계산이 안 돼요
**A**: 다음을 확인하세요:
1. 품목이 "가변 크기 제품"으로 등록되었는지
2. 치수가 정의되었는지
3. BOM 라인에 수식이 입력되었는지
4. 치수 연결 매핑이 설정되었는지

### Q: PDF 출력이 안 돼요
**A**: 
1. 견적을 먼저 저장하세요
2. 견적 목록에서 해당 견적의 [출력] 버튼을 클릭하세요
3. 브라우저 프린트 창이 열리면 "PDF로 저장" 선택

---

## 📚 추가 문서

- **USER_STORY_GUIDE.md**: 상세한 유저 스토리 (S1~S17)
- **MENU_ACCESS_GUIDE.md**: 메뉴 접근 방법 상세 가이드
- **ERP_QUOTATION_GUIDE.md**: 견적 시스템 기술 문서

---

## 🎉 완료 체크리스트

완벽하게 설정되었는지 확인하세요:

- [ ] 역할이 CEO 또는 SystemAdmin으로 설정됨
- [ ] 좌측 사이드바에서 "생산관리" 메뉴 확인
- [ ] 생산관리 확장 시 "품목관리 (개선)" 표시
- [ ] 생산관리 확장 시 "BOM관리 (개선)" 표시
- [ ] 좌측 사이드바에서 "영업관리" 메뉴 확인
- [ ] 영업관리 확장 시 "견적관리 (개선)" 표시
- [ ] 각 화면에서 신규 등록 버튼 확인
- [ ] 다이얼로그가 정상적으로 열림

모든 항목이 체크되면 준비 완료! 🚀

---

**SAM ERP 견적 시스템 v1.0**
**2025.01.22 - Phase 1-6 완료**
