sam-docs/plans/quote-system-development-plan.md

# 견적 시스템 개발 계획

> **작성일**: 2025-12-24
> **목표**: mng 수식 시뮬레이터를 완전한 견적 시스템으로 확장 후 React API 개발

---

## 1. 개발 단계

### Stage 1: mng 견적 시스템 완성 (현재)
**목표**: 스크린샷과 동일한 견적 시스템을 mng Plain Blade로 구현

### Stage 2: API 개발
**목표**: React 프론트엔드에서 호출할 견적 산출 REST API 개발

---

## 2. 현재 상태 vs 목표 상태

### 2.1 입력 폼 비교

| 필드 | 현재 시뮬레이터 | 목표 (스크린샷) | 상태 |
|------|----------------|----------------|------|
| 층수 | ❌ | 예: 1층, B1, 지하1층 | 추가 필요 |
| 부호 | ❌ | 예: A, B, C | 추가 필요 |
| 제품 카테고리 (PC) | ✅ | 스크린, 철재 등 | 완료 |
| 제품명 | ✅ | 방화 스크린 셔터 등 | 완료 |
| 오픈사이즈 W0 | ✅ | 가로 | 완료 |
| 오픈사이즈 H0 | ✅ | 세로 | 완료 |
| 가이드레일 설치유형 (GT) | ✅ | 벽면형, 측면형 | 완료 |
| 모터 전원 (MP) | ✅ | 220V, 380V | 완료 |
| 연동제어기 (CT) | ✅ | 단독, 연동 | 완료 |
| 수량 (QTY) | ✅ | 1, 2, 3... | 완료 |
| 마구리 날개치수 (WS) | ❌ | 50 등 | 추가 필요 |
| 검사비 (INSP) | ❌ | 50000 등 | 추가 필요 |

### 2.2 출력 결과 비교

| 섹션 | 현재 시뮬레이터 | 목표 (스크린샷) | 상태 |
|------|----------------|----------------|------|
| 입력 정보 요약 | ❌ | 제품명, 카테고리, 오픈사이즈, 설치유형 등 요약 | 추가 필요 |
| 기본 산출 공식 | ❌ | 제작폭(W1), 제작높이(H1), 면적(M), 중량(K) 표시 | 추가 필요 |
| BOM 목록 테이블 | ⚠️ 공정별 그룹화 | 순번, 품목코드, 품목명, 품목유형, 규격, 기준수량, 산출수량, 단위, 단가, 금액, 작업 | 구조 변경 필요 |
| 품목 추가/삭제 | ❌ | + 품목 추가 버튼, 휴지통 삭제 버튼 | 추가 필요 |
| 할인율 | ❌ | 할인율(%) 입력 | 추가 필요 |
| 금액 요약 | ⚠️ 합계만 | 합계, 공급가, 최종 금액 | 확장 필요 |

---

## 3. Stage 1: mng 견적 시스템 상세 계획

### Phase 1: UI 확장 (1일)
**파일**: `resources/views/quote-formulas/simulator.blade.php`

#### 1.1 입력 폼 확장
```
추가 필드:
- 층수 (floor): text input, placeholder "예: 1층, B1, 지하1층"
- 부호 (code): text input, placeholder "예: A, B, C"
- 마구리 날개치수 (WS): number input, default 50
- 검사비 (INSP): number input, default 50000
```

#### 1.2 견적 항목 다중 입력
```
- 견적 1, 견적 2, ... 탭 형태
- "+ 견적 추가" 버튼
- 복사, 삭제 버튼
```

#### 1.3 결과 출력 섹션
```
1. 입력 정보 요약 카드
   - 제품명, 제품 카테고리, 오픈사이즈, 가이드레일 설치, 모터 전원, 연동제어기, 수량

2. 기본 산출 공식 카드
   - 제작폭 (W1): 값 + 계산식
   - 제작높이 (H1): 값 + 계산식
   - 면적 (M): 값 + 단위
   - 중량 (K): 값 + 단위

3. 부품구성표(BOM) 목록 테이블
   - 컬럼: 순번, 품목코드, 품목명, 품목유형, 규격, 기준수량, 산출수량, 단위, 단가, 금액, 작업
   - "+ 품목 추가" 버튼
   - 행별 삭제 버튼

4. 금액 요약
   - 할인율(%) 입력
   - 합계, 공급가, 최종 금액
```

### Phase 2: 백엔드 로직 확장 (1일)
**파일**: `app/Services/Quote/FormulaEvaluatorService.php`

#### 2.1 executeAll() 반환 구조 확장
```php
return [
    'input_summary' => [
        'product_name' => '방화 스크린 셔터 (소형)',
        'product_category' => '스크린',
        'open_size' => 'W2000 × H2500',
        'guide_rail_type' => '벽면형',
        'motor_power' => '220V',
        'controller' => '단독',
        'quantity' => 1,
    ],
    'calculation_formula' => [
        'W1' => ['value' => 2140, 'formula' => 'W0 + 140'],
        'H1' => ['value' => 2850, 'formula' => 'H0 + 350'],
        'M' => ['value' => 6.10, 'unit' => '㎡'],
        'K' => ['value' => 0.00, 'unit' => 'kg'],
    ],
    'bom_items' => [
        [
            'seq' => 1,
            'item_code' => 'SF-SCR-F01',
            'item_name' => '스크린 원단',
            'item_type' => 'SF',
            'spec' => '-',
            'base_quantity' => 1.10,
            'calculated_quantity' => 6.099,
            'unit' => 'M2',
            'unit_price' => 213465,
            'total_price' => 1301923.035,
            'editable' => true,
        ],
        // ... more items
    ],
    'summary' => [
        'subtotal' => 2806523.035,
        'discount_rate' => 0,
        'discount_amount' => 0,
        'supply_price' => 2806523.035,
        'total_amount' => 2806523.035,
    ],
];
```

### Phase 3: 검사비 품목 추가 (0.5일)
**파일**: `database/seeders/DesignItemSeeder.php`

```php
// 서비스 품목 추가
$serviceItems = [
    ['code' => 'SVC-INSP', 'name' => '검사비', 'unit' => '식', 'price' => 50000, 'type' => 'CS'],
    ['code' => 'SVC-INSTALL', 'name' => '설치비', 'unit' => '식', 'price' => 100000, 'type' => 'CS'],
    ['code' => 'SVC-DELIVERY', 'name' => '운송비', 'unit' => '식', 'price' => 80000, 'type' => 'CS'],
];
```

### Phase 4: 테스트 및 검증 (0.5일)
- Playwright로 전체 플로우 테스트
- Design 시스템 결과와 비교 검증

---

## 4. Stage 2: API 개발 상세 계획

### Phase 1: API 엔드포인트 설계 (0.5일)

#### 4.1 견적 산출 API
```
POST /api/v1/quotes/calculate

Request:
{
    "items": [
        {
            "floor": "1층",
            "code": "A",
            "product_category": "screen",
            "product_id": "screen_standard",
            "open_width": 2000,
            "open_height": 2500,
            "guide_rail_type": "wall",
            "motor_power": "220V",
            "controller": "single",
            "quantity": 1,
            "wing_size": 50,
            "inspection_fee": 50000
        }
    ],
    "discount_rate": 0
}

Response:
{
    "success": true,
    "data": {
        "quotes": [
            {
                "quote_id": "quote-1",
                "input_summary": { ... },
                "calculation_formula": { ... },
                "bom_items": [ ... ],
                "summary": { ... }
            }
        ],
        "total_summary": {
            "total_items": 1,
            "total_amount": 2806523.035
        }
    }
}
```

#### 4.2 제품 목록 API
```
GET /api/v1/quotes/products?category=screen

Response:
{
    "success": true,
    "data": [
        {
            "id": "screen_standard",
            "name": "스크린 셔터 (표준형)",
            "category": "screen"
        }
    ]
}
```

#### 4.3 옵션 목록 API
```
GET /api/v1/quotes/options

Response:
{
    "success": true,
    "data": {
        "product_categories": [...],
        "guide_rail_types": [...],
        "motor_powers": [...],
        "controllers": [...]
    }
}
```

### Phase 2: API 컨트롤러 구현 (1일)
**파일**: `api/app/Http/Controllers/Api/V1/QuoteCalculationController.php`

### Phase 3: API 테스트 (0.5일)
- Postman/Swagger 테스트
- React 연동 테스트

---

## 5. 일정 요약

| Stage | Phase | 작업 내용 | 예상 일정 |
|-------|-------|----------|----------|
| **Stage 1** | Phase 1 | mng UI 확장 | 1일 |
| | Phase 2 | 백엔드 로직 확장 | 1일 |
| | Phase 3 | 검사비 품목 추가 | 0.5일 |
| | Phase 4 | 테스트 및 검증 | 0.5일 |
| | **소계** | | **3일** |
| **Stage 2** | Phase 1 | API 설계 | 0.5일 |
| | Phase 2 | API 구현 | 1일 |
| | Phase 3 | API 테스트 | 0.5일 |
| | **소계** | | **2일** |
| **합계** | | | **5일** |

---

## 6. 파일 구조

### Stage 1 (mng)
```
/SAM/mng/
├── app/Services/Quote/
│   └── FormulaEvaluatorService.php    # 로직 확장
├── database/seeders/
│   └── DesignItemSeeder.php           # 서비스 품목 추가
└── resources/views/quote-formulas/
    └── simulator.blade.php            # UI 확장
```

### Stage 2 (api)
```
/SAM/api/
├── app/Http/Controllers/Api/V1/
│   └── QuoteCalculationController.php  # 신규
├── app/Services/Quote/
│   └── QuoteCalculationService.php     # 신규 (또는 mng 서비스 공유)
└── routes/
    └── api.php                         # 라우트 추가
```

---

## 7. 성공 기준

### Stage 1
1. ✅ 스크린샷과 동일한 입력 폼 (층수, 부호, WS, INSP 포함)
2. ✅ 입력 정보 요약 섹션 표시
3. ✅ 기본 산출 공식 섹션 표시
4. ✅ BOM 테이블 (순번~금액 컬럼)
5. ✅ 품목 추가/삭제 기능
6. ✅ 할인율 + 최종 금액 계산

### Stage 2
1. ✅ POST /api/v1/quotes/calculate 정상 작동
2. ✅ GET /api/v1/quotes/products 정상 작동
3. ✅ GET /api/v1/quotes/options 정상 작동
4. ✅ Swagger 문서화 완료
5. ✅ React에서 API 호출 테스트 완료

---

## 8. 참고 문서

- `docs/plans/simulator-calculation-logic-mapping.md` - 계산 로직 상세
- `react/src/components/quotes/QuoteRegistration.tsx` - React UI 참조
- `design/src/components/AutoCalculationSimulator.tsx` - Design 시뮬레이터 참조

---

*이 문서는 mng 견적 시스템 완성 및 API 개발 계획을 정의합니다.*