sam-docs/projects/mes/v1-analysis/quotation-analysis.md

# 견적 시스템 통합 분석 문서

**작성일:** 2025-11-12 (v1 분석)
**원본 문서:** 00_baseline 폴더 내 14개 파일에서 견적 관련 내용 추출
**분석 범위:** 비즈니스 로직, 화면 설계, API 스펙, 구현 현황, Gap 분석

---

## 1. 시스템 개요

### 1.1 견적 시스템 핵심 기능

가변 크기 제품(셔터)의 견적을 자동 계산하는 ERP 시스템으로 4가지 핵심 자동화 기능 제공:

| 기능 | 설명 | 구현 상태 |
|------|------|----------|
| 🔗 치수 자동 연결 | 상위 제품 치수 → 하위 제품 치수 자동 전달 | ❌ 미구현 |
| 💰 단가 자동 연동 | 하위 품목 판매단가 → 상위 품목 원가 자동 반영 | ⚠️ 부분 |
| 📊 BOM 전개 | 계층 구조 기반 구성품 자동 계산 | ✅ 프론트 구현 |
| 💲 원가/판매가 자동 계산 | 치수 기반 실시간 견적 산출 | ✅ 프론트 구현 |

### 1.2 품목 코드 체계

```
RM-XXX   : 원자재 (Raw Material) - BOM 최하위, 가격만 정의
PT-XXX   : 부품 (Part) - 구매/제작 구분
FG-XXX   : 완제품 (Finished Goods) - 견적 대상
```

---

## 2. 비즈니스 프로세스 (6단계 Phase)

### Phase 1: 기초 데이터 설정
- **메뉴:** 기준정보 관리 > 사원 관리, 영업관리 > 매출처 관리
- **목적:** 견적서 작성을 위한 마스터 데이터 등록
- **항목:** 사원 정보, 매출처 정보

### Phase 2: 원자재 등록 (RM)
- **메뉴:** 생산관리 > 품목관리 (개선)
- **등록 정보:** 품목명, 단위, 구매단가
- **예시:** RM-001 (알루미늄 압출재, 8,000원/M)

### Phase 3: 구매 부품 등록 (PT-구매)
- **메뉴:** 생산관리 > 품목관리 (개선)
- **등록 정보:** 품목명, 구매단가, 마진율
- **자동 계산:** `판매단가 = 구매단가 × (1 + 마진율/100)`
- **예시:** PT-MOTOR-001 (구매 120,000원, 마진 50%, 판매 180,000원)

### Phase 4: 제작 부품 등록 (PT-제작, 가변 크기)
- **중요 설정:** ✅ "가변 크기 제품" 체크
- **Step 1:** 치수 정의 (L: 길이, 기본값 3000mm)
- **Step 2:** BOM 등록 (계산식: `L/1000` - 길이에 따른 자재 소요량)
- **Step 3:** 원가 설정 (자재비 자동, 가공비 입력, 마진율 설정)

### Phase 5: 완제품 등록 (FG, 가변 크기 + 옵션)
- **Step 1:** 기본 정보 + 가변 크기 체크
- **Step 2:** 치수 정의 (W, H) + 옵션 정의 (MOTOR, REMOTE)
- **Step 3:** BOM 등록 (조건부 BOM: `MOTOR='Y'`)
- **Step 4:** 원가 설정 (공임비, 설치비, 마진율)
- **Step 5:** ⭐ **치수 연결 매핑** (세트.W → 레일.L, 세트.W → 커튼.W)

### Phase 6: 견적서 작성 (실시간 계산)
- **메뉴:** 영업관리 > 견적관리 (개선)
- **프로세스:** 품목 선택 → 치수/옵션 입력 → 실시간 계산 → 저장/출력

---

## 3. 유저 스토리 (S1~S17)

### Phase 1: 자재/부품 마스터 등록
| Story | 역할 | 내용 |
|-------|------|------|
| S1 | 기준정보 담당자 | 원자재(RM) 등록 |
| S2 | 기준정보 담당자 | 구매 부품(PT) 등록 |
| S3 | 기준정보 담당자 | 제작 부품 등록 |

### Phase 2: 부품 BOM 및 원가 정의
| Story | 역할 | 내용 |
|-------|------|------|
| S4 | 생산기술 담당자 | 제작 부품 치수 정의 |
| S5 | 생산기술 담당자 | 부품 BOM 생성 |
| S6 | 생산기술 담당자 | BOM 소요량 수식 입력 (`G/1000*1.02`) |
| S7 | 원가 관리팀 | 부품 매출 단가 설정 |

### Phase 3: 제품 BOM 및 최종 정책 정의
| Story | 역할 | 내용 |
|-------|------|------|
| S8 | 기준정보 담당자 | 최종 판매 제품(FG) 등록 |
| S9 | 생산기술 담당자 | 제품 치수/옵션 정의 (W, H, MOTOR) |
| S10 | 생산기술 담당자 | 제품 BOM 생성 (조건부: `MOTOR='Y'`) |
| S11 | 생산기술 담당자 | ⭐ 치수 연결 매핑 정의 (W→G) |
| S12 | 원가 관리팀 | 제품 최종 판매 정책 설정 |

### Phase 4: 견적 산출
| Story | 역할 | 내용 |
|-------|------|------|
| S13 | 영업 담당자 | 새 견적서 생성 |
| S14 | 영업 담당자 | 가변 제품 견적서에 추가 |
| S15 | 영업 담당자 | 고객 요구 사이즈/옵션 입력 |
| S16 | 영업 담당자 | 실시간 견적 단가 확인 |
| S17 | 영업 담당자 | 확정 견적 저장 및 PDF 출력 |

---

## 4. 원가 계산 로직

### 4.1 제작 부품 원가 (PT-RAIL-VAR 예시, G=3500mm)

```
[자재비]
알루미늄: G/1000 × 1.02 × 8,000원 = 3.57M × 8,000 = 28,560원
브래킷: 8개 × 500원 = 4,000원
자재비 합계 = 32,560원

[총원가]
총원가 = 자재비 + 가공비 = 32,560 + 3,000 = 35,560원

[판매단가]
판매단가 = 총원가 × (1 + 마진율/100) = 35,560 × 1.2 = 42,672원
```

### 4.2 완제품 원가 (FG-SHUTTER-SET, W=3500, H=2500, MOTOR=Y)

```
[자재비 - 하위 구성품 판매단가 합계]
가이드레일 × 2: 42,672 × 2 = 85,344원
셔터 커튼 × 1: (면적 기반) = 291,664원
셔터 모터 × 1: 180,000원 (MOTOR=Y)
자재비 합계 = 557,008원

[총원가]
총원가 = 자재비 + 공임비 + 설치비 = 557,008 + 100,000 + 50,000 = 707,008원

[판매단가]
판매단가 = 총원가 × (1 + 마진율/100) = 707,008 × 1.25 = 883,760원
```

### 4.3 치수 자동 전달 흐름

```
견적 입력: 세트 W=3500, H=2500
    ↓ 자동 전달 (치수 매핑)
가이드레일 G = 3500 (W→G 매핑)
셔터 커튼 W = 3500, H = 2500
    ↓ 각 하위 품목 원가 자동 계산
상위 품목 자재비 = Σ(하위 판매단가)
```

---

## 5. 화면 설계

### 5.1 견적 관리 목록 (QuoteManagement3List.tsx)
- **파일:** 788 lines
- **StatCards:** 총 견적서, 수주 전환, 최종 확정, 총 견적금액
- **테이블 컬럼:** 견적번호, 작성일, 거래처, 담당자, 견적금액, 상태, 유효기한
- **기능:** 검색/필터, 수정 이력 조회, 산출내역서 보기

### 5.2 견적 작성 (QuoteManagement3Write.tsx)
- **파일:** 1,644 lines
- **섹션:** 기본 정보, 견적 품목, 합계 정보, 특이사항 (Collapsible)
- **핵심 기능:**
  - BOM 기반 자동 견적 계산 ⭐
  - 수식 편집 UI (W, H 변수 지원)
  - 견적 수정 이력 관리 (Revision)
  - 견적번호 자동 생성 (KD-PR-250717-02)
  - 거래처/현장 자동 등록

### 5.3 견적 계산 미리보기 UI

```
┌─────────────────────────────────────┐
│ 구성품 목록 (BOM 전개)              │
├─────────────────────────────────────┤
│ • 가이드레일 (3.5m) × 2   85,344원 │
│ • 셔터 커튼 (8.75㎡) × 1 291,664원  │
│ • 셔터 모터 × 1          180,000원  │
├─────────────────────────────────────┤
│ 원가 내역                           │
├─────────────────────────────────────┤
│ 자재비:     557,008원               │
│ 공임비:     100,000원               │
│ 설치비:      50,000원               │
│ 총 원가:    707,008원               │
├─────────────────────────────────────┤
│ 견적 금액                           │
├─────────────────────────────────────┤
│ 판매단가:   883,760원 (마진 25%)    │
│ 부가세:      88,376원 (10%)         │
│ 총액:       972,136원               │
└─────────────────────────────────────┘
```

---

## 6. API 스펙 (필요/현황)

### 6.1 필요한 API 엔드포인트

| 엔드포인트 | 용도 | 구현 상태 |
|------------|------|----------|
| `POST /api/v1/quotes` | 견적서 생성 | ❓ 확인 필요 |
| `POST /api/v1/quotes/{id}/items` | 품목 추가 | ❓ 확인 필요 |
| `POST /api/v1/quotes/calculate` | 실시간 견적 계산 | ❌ 미구현 |
| `GET /api/v1/quotes/{id}/pdf` | PDF 출력 | ❓ 확인 필요 |
| `POST /api/v1/boms/{id}/dimension-mappings` | 치수 연결 매핑 | ❌ 미구현 |

### 6.2 견적 계산 API 스펙 (제안)

```json
// POST /api/v1/quotes/calculate
// Request
{
  "product_id": 123,
  "dimensions": { "W": 3500, "H": 2500 },
  "options": { "MOTOR": "Y", "REMOTE": "Y" },
  "quantity": 1
}

// Response
{
  "bom_breakdown": [
    { "item_code": "PT-RAIL-VAR", "quantity": 2, "unit_price": 42672, "amount": 85344 },
    { "item_code": "PT-CURTAIN-VAR", "quantity": 1, "unit_price": 291664, "amount": 291664 },
    { "item_code": "PT-MOTOR-001", "quantity": 1, "unit_price": 180000, "amount": 180000 }
  ],
  "cost_breakdown": {
    "material_cost": 557008,
    "labor_cost": 100000,
    "installation_cost": 50000,
    "total_cost": 707008
  },
  "pricing": {
    "unit_price": 883760,
    "margin_rate": 25,
    "vat": 88376,
    "total": 972136
  }
}
```

---

## 7. 데이터 모델

### 7.1 필요한 테이블/필드

| 테이블 | 필드 | 용도 | 상태 |
|--------|------|------|------|
| products | dimensions (JSON) | 치수 정의 | ❌ 없음 |
| products | options (JSON) | 옵션 정의 | ⚠️ Material만 |
| product_components | formula | BOM 소요량 계산식 | ❌ 없음 |
| product_components | condition | 조건부 BOM | ❌ 없음 |
| dimension_mappings | - | 치수 연결 매핑 | ❌ 테이블 없음 |
| quotes | - | 견적서 | ✅ 존재 추정 |
| quote_items | - | 견적 품목 | ✅ 존재 추정 |

### 7.2 치수 연결 매핑 테이블 (제안)

```sql
CREATE TABLE dimension_mappings (
    id BIGINT PRIMARY KEY,
    bom_id BIGINT NOT NULL,
    parent_product_id BIGINT NOT NULL,
    child_product_id BIGINT NOT NULL,
    parent_dimension VARCHAR(50) NOT NULL,  -- 'W', 'H'
    child_dimension VARCHAR(50) NOT NULL,   -- 'G', 'L'
    created_at TIMESTAMP,
    updated_at TIMESTAMP,
    FOREIGN KEY (bom_id) REFERENCES boms(id),
    FOREIGN KEY (parent_product_id) REFERENCES products(id),
    FOREIGN KEY (child_product_id) REFERENCES products(id)
);
```

---

## 8. Gap 분석 (견적 관련)

### 8.1 Critical Gaps (P0)

| Gap # | 항목 | 상태 | 예상 작업량 |
|-------|------|------|------------|
| #2 | 치수 연결 매핑 시스템 | ❌ 백엔드+프론트 미구현 | 1-2주 |
| #3 | 주문 기반 견적 계산 API | ⚠️ 설계 BOM만 존재 | 1-2주 |
| #4 | BOM formula 필드 | ❌ 프론트 로컬만 | 1주 |
| #5 | BOM condition 필드 | ❌ 미구현 | 1-2주 |

### 8.2 현재 구현 상태

**✅ 프론트엔드 구현 완료:**
- BOM 기반 자동 견적 계산 (QuoteManagement3Write.tsx)
- 수식 편집 UI (W, H 변수 지원)
- 견적 수정 이력 관리 (Revision)
- 견적번호 자동 생성

**❌ 백엔드 미구현:**
- 치수 연결 매핑 (dimension_mappings)
- BOM formula/condition 필드
- 주문 기반 견적 계산 API
- 프론트엔드에서 중복 구현 중 (백엔드 연동 필요)

### 8.3 해결 우선순위

```
Week 1-2: 백엔드 핵심 기능
├── dimension_mappings 테이블 생성
├── product_components.formula 필드 추가
├── product_components.condition 필드 추가
└── POST /api/v1/quotes/calculate API 개발

Week 3-4: 프론트엔드 연동
├── 백엔드 API 연동 (중복 로직 제거)
├── 치수 매핑 UI 개발
└── BOM 에디터 리팩토링
```

---

## 9. 프론트엔드 컴포넌트

### 9.1 견적 관련 컴포넌트

| 컴포넌트 | 파일 | 크기 | 상태 |
|----------|------|------|------|
| QuoteManagement3List | QuoteManagement3List.tsx | 788 lines | ✅ 완료 |
| QuoteManagement3Write | QuoteManagement3Write.tsx | 1,644 lines | ⚠️ 리팩토링 필요 |
| QuoteCalculationReport | QuoteCalculationReport.tsx | - | ✅ 존재 |
| QuoteSimulation | QuoteSimulation.tsx | - | ✅ 기존 버전 |

### 9.2 리팩토링 제안 (QuoteManagement3Write.tsx)

```
QuoteManagement3Write.tsx (1,644 lines)
    ↓ 리팩토링
├── pages/QuoteWritePage.tsx (100-150 lines)
├── organisms/QuoteFormSection.tsx (200-300 lines)
├── organisms/ProductSelectionSection.tsx (200-300 lines)
├── organisms/BOMCalculationTable.tsx (300-400 lines) ⭐
├── hooks/useQuoteForm.ts (200-300 lines)
├── hooks/useBOMCalculation.ts (200-300 lines) ⭐
├── hooks/useFormulaCalculator.ts (100-150 lines) ⭐
├── hooks/useQuoteRevision.ts (150-200 lines)
└── utils/quoteNumberGenerator.ts (50-100 lines)
```

---

## 10. 견적 수정 이력 (Revision) 시스템

### 10.1 데이터 구조

```typescript
interface QuoteRevision {
  revisionNumber: number;      // 수정 차수
  revisionDate: string;        // 수정 일자
  revisionReason: string;      // 수정 사유
  data: Partial<QuoteData>;    // 해당 시점 데이터 스냅샷
}

interface QuoteData {
  currentRevision?: number;    // 현재 수정 차수
  isFinal?: boolean;           // 최종 확정 여부
  revisions?: QuoteRevision[]; // 수정 이력 배열
  finalizedDate?: string;
  finalizedBy?: string;
}
```

### 10.2 견적번호 생성 규칙

```
KD-{제품타입}-{날짜}-{순번}
예: KD-PR-250717-02

- KD: 회사 코드
- PR: 제품 타입 (SC: 스크린, PR: 철재)
- 250717: 날짜 (YYMMDD)
- 02: 당일 순번
```

---

## 11. 메뉴 구조

```
영업관리
├── 리드 관리
├── 매출처 관리
├── 거래처 관리
├── 견적 관리 (개선) ⭐
│   ├── 견적 목록 (QuoteManagement3List.tsx)
│   └── 견적 작성 (QuoteManagement3Write.tsx)
├── 견적 관리 (기존 - 시뮬레이션)
├── 수주 관리
└── 영업 실적

생산관리
├── 품목 관리 (개선) ⭐
├── BOM 관리 (개선) ⭐
│   └── 치수 연결 탭 (신규 필요)
└── ...
```

---

## 12. 결론

### 12.1 현재 상태 요약

| 영역 | 상태 | 설명 |
|------|------|------|
| 비즈니스 로직 | ✅ 정의 완료 | 6단계 Phase, 17개 유저 스토리 |
| 화면 설계 | ✅ 구현 완료 | 견적 목록/작성 화면 |
| 프론트엔드 | ⚠️ 부분 완료 | BOM 계산 구현, 리팩토링 필요 |
| 백엔드 API | ❌ 미흡 | 치수 매핑, 계산 API 부재 |
| DB 스키마 | ❌ 미흡 | dimension_mappings 등 부재 |

### 12.2 우선 작업 항목

1. **백엔드 (3-4주)**
   - dimension_mappings 테이블 생성
   - BOM formula/condition 필드 추가
   - 견적 계산 API 개발

2. **프론트엔드 (2-3주)**
   - 백엔드 API 연동
   - 치수 매핑 UI 개발
   - 컴포넌트 리팩토링

---

**문서 버전:** v1.0 (통합 분석본)
**원본:** 00_baseline 폴더 14개 파일
**다음 단계:** v2 분석 (2025-12-18) 진행 중