# 생산지시 시 bending_info 자동 생성 계획

> **작성일**: 2026-02-19
> **목적**: 수주 → 생산지시 시 절곡 공정의 bending_info JSON을 work_orders.options에 자동 삽입
> **기준 문서**: `api/app/Services/OrderService.php` (createProductionOrder), `react/.../bending/types.ts`
> **상태**: 🔄 진행중

---

## 📍 현재 진행 상태

| 항목 | 내용 |
|------|------|
| **마지막 완료 작업** | 분석 완료 + 계획 문서 작성 |
| **다음 작업** | Phase 1.1: BendingInfoBuilder 서비스 생성 |
| **진행률** | 0/7 (0%) |
| **마지막 업데이트** | 2026-02-20 |

---

## 1. 개요

### 1.1 배경

현재 절곡 작업일지(BendingWorkLogContent)에 표시할 bending_info 데이터를 **수동으로 DB에 INSERT** 해야 함.
수주(Order) → 생산지시(WorkOrder) 생성 시 `OrderService::createProductionOrder()`에서 자동으로 bending_info를
생성하여 `work_orders.options.bending_info`에 저장하는 로직이 필요함.

### 1.2 현재 데이터 흐름 vs 목표

#### 현재 (Before)
```
OrderNode.options
  ├─ product_code: "FG-KSS02-벽면형-SUS"
  ├─ width: 3560, height: 4450
  └─ bom_result.items[]: (steel category BOM 품목)

→ OrderService::createProductionOrder() (라인 959)
  → WorkOrder::create() (라인 1111)
    → ⚠️ options 미설정 (null)
  → work_order_items INSERT (라인 1183)
    → options.bending_info = node.options.bending_info ?? null  (라인 1179)
    → ⚠️ 현재 order_nodes.options에 bending_info 없음 → null 저장
```

#### 목표 (After)
```
OrderService::createProductionOrder() (라인 959)
  │
  ├─ 공정별 아이템 그룹핑 (라인 1035~1089)
  │   └─ $itemsByProcess[$processId] = [items...]
  │
  ├─ foreach ($itemsByProcess) → WorkOrder 생성 (라인 1103)
  │   │
  │   ├─ 절곡 공정인지 확인 (process.process_name === '절곡')
  │   │   └─ YES → BendingInfoBuilder::build($order, $processId)
  │   │            ├─ OrderNode.options.product_code 파싱
  │   │            ├─ OrderNode.options.bom_result.items 분석
  │   │            └─ bending_info JSON 조립
  │   │
  │   └─ WorkOrder::create([
  │        ...기존 필드들,
  │        'options' => ['bending_info' => $bendingInfo]  ← 신규
  │      ]) (라인 1111)
  │
  └─ work_order_items INSERT (라인 1183, 기존 유지)
```

#### 핸들러 자동 생성 원리
```
BendingInfoBuilder::build($order, $processId)
    │
    ├─ 1. 절곡 공정 확인 (process.process_name === '절곡')
    │
    ├─ 2. product_code 파싱
    │   └─ "FG-KSS02-벽면형-SUS" → productCode: "KSS02", guideType: "벽면형", finishMaterial: "SUS마감"
    │
    ├─ 3. BOM items 카테고리 분류 (item_code 패턴 매칭)
    │   ├─ BD-가이드레일-* → guideRail
    │   ├─ BD-케이스-* → shutterBox
    │   ├─ BD-마구리-* → shutterBox (마구리)
    │   ├─ *하장바* → bottomBar
    │   ├─ EST-SMOKE-* → smokeBarrier
    │   ├─ BD-L-BAR-* → detailParts
    │   └─ BD-보강평철-* → detailParts
    │
    ├─ 4. 다중 노드 집계 (길이별 수량 합산)
    │   ├─ height → 가이드레일 길이별 수량
    │   ├─ width → 셔터박스/하단마감재 길이별 수량
    │   └─ BOM quantity × 노드 수 → 총 수량
    │
    └─ 5. BendingInfoExtended 구조 JSON 반환
```

### 1.3 기준 원칙

```
┌─────────────────────────────────────────────────────────────────┐
│  🎯 핵심 원칙                                                    │
├─────────────────────────────────────────────────────────────────┤
│  1. BendingInfoBuilder는 독립 서비스 (OrderService 변경 최소화)    │
│  2. 기존 createProductionOrder 흐름은 유지, options 삽입만 추가    │
│  3. order_nodes.options.bom_result + product_code가 유일한 소스   │
│  4. 프론트엔드 BendingInfoExtended 인터페이스 완전 호환            │
│  5. 절곡 공정이 아닌 WorkOrder에는 절대 bending_info 미생성        │
│  6. 기존 work_order_items.options.bending_info 흐름은 유지 (하위호환) │
└─────────────────────────────────────────────────────────────────┘
```

### 1.4 변경 승인 정책

| 분류 | 예시 | 승인 |
|------|------|------|
| ✅ 즉시 가능 | BendingInfoBuilder 서비스 클래스 신규 생성, 헬퍼 메서드 추가 | 불필요 |
| ⚠️ 컨펌 필요 | OrderService::createProductionOrder 수정 (options 삽입), BOM 파싱 규칙 확정 | **필수** |
| 🔴 금지 | 기존 BOM 계산 로직 변경, order_nodes 스키마 변경, 기존 work_order_items.options 구조 변경 | 별도 협의 |

---

## 2. 현황 분석

### 2.1 OrderService::createProductionOrder 흐름 (라인 959~1214)

현재 `createProductionOrder`는 다음 순서로 동작:

```
1. 수주 로드 (라인 966)
   $order = Order::with(['items', 'rootNodes'])->findOrFail($orderId)

2. 공정별 아이템 매핑 조회 (라인 1008~1014)
   DB::table('process_items') → $itemProcessMap

3. 아이템을 공정별로 그룹핑 (라인 1035~1089)
   3단계 fallback:
   ├─ item_id → process_items 직접 매핑 (라인 1041~1042)
   ├─ order_node_id → BOM item_name → process_items (라인 1045~1050)
   └─ item_code → item_id → process_items (라인 1054~1078)
   결과: $itemsByProcess[$processId] = ['items' => [...], 'processId' => int]

4. 공정별 WorkOrder 생성 (라인 1103)
   foreach ($itemsByProcess as $key => $group) {
       $workOrder = WorkOrder::create([...])  // 라인 1111~1124
       // ⚠️ 현재 'options' 필드 미설정
   }

5. work_order_items INSERT (라인 1183~1197)
   $woItemOptions = [
       'floor', 'code', 'width', 'height',
       'cutting_info', 'slat_info',
       'bending_info' => $nodeOptions['bending_info'] ?? null,  // 라인 1179
       'wip_info'
   ]
```

**핵심 발견**: WorkOrder::create (라인 1111~1124)에 `options` 필드가 **전혀 설정되지 않음**. bending_info는 `work_order_items.options`에만 들어가는데, 이마저도 `order_nodes.options.bending_info`가 null이면 null 저장.

### 2.2 order_nodes.options 구조 (실제 데이터)

order_id=43 (WO 74의 원천 수주)의 root_nodes (id=116~125, 5개소 × 2=10 노드):

```json
{
  "product_code": "FG-KSS02-벽면형-SUS",
  "width": 3560,
  "height": 4450,
  "bom_result": {
    "items": [
      { "item_code": "BD-케이스-500*380", "item_name": "케이스 500*380", "category": "steel", "quantity": 3.62 },
      { "item_code": "BD-마구리-505*385", "item_name": "마구리 505*385", "category": "steel", "quantity": 1 },
      { "item_code": "BD-가이드레일-KSS02-SUS-120*70", "item_name": "가이드레일 KSS02...", "category": "steel", "quantity": 8.7 },
      { "item_code": "EST-SMOKE-레일용", "item_name": "연기차단재(레일)", "category": "steel", "quantity": 8.7 },
      { "item_code": "EST-SMOKE-케이스용", "item_name": "연기차단재(케이스)", "category": "steel", "quantity": 3.62 },
      { "item_code": "00035", "item_name": "철재용하장바(SUS)3000", "category": "steel", "quantity": 3.4 },
      { "item_code": "BD-L-BAR-KSS02-17*60", "item_name": "L-BAR KSS02...", "category": "steel", "quantity": 3.62 },
      { "item_code": "BD-보강평철-50", "item_name": "보강평철 50", "category": "steel", "quantity": 3.62 },
      // ... (parts, motor, controller 등 다른 category도 포함)
    ]
  }
}
```

**중요**: `bom_result.items[]`에는 `category: "steel"`인 아이템만 절곡(bending) 관련. `parts`, `motor`, `controller` 등은 다른 공정용.

### 2.3 work_orders.options 현재 상태

| work_order_id | process_name | options |
|---------------|-------------|---------|
| 74 (수동 삽입) | 절곡 | `{"bending_info": {...전체 JSON...}}` |
| 기타 | 절곡 외 | `null` |

- WO 74만 수동으로 bending_info를 삽입한 상태
- 다른 WorkOrder는 options가 null (createProductionOrder에서 미설정)

### 2.4 프론트엔드 데이터 소비 경로

```
API: GET /work-orders/{id}
  → WorkOrderService::show()
  → WorkOrder 모델 (options JSON 자동 디코딩)
  → API 응답: { ..., options: { bending_info: {...} } }

React: transformApiToFrontend() (types.ts 라인 495)
  → bendingInfo: api.options?.bending_info || undefined
  → BendingWorkLogContent에 props.bendingInfo로 전달
  → BendingInfoExtended 인터페이스로 사용
```

### 2.5 BendingInfoExtended 구조 (프론트엔드 목표 스키마)

```typescript
// react/src/components/production/WorkOrders/documents/bending/types.ts (라인 32~68)
interface BendingInfoExtended {
  productCode: string;        // "KSS02"
  finishMaterial: string;     // "SUS마감"
  common: {
    kind: string;             // "혼합형 120X70"
    type: string;             // "벽면형(120*70)"
    lengthQuantities: LengthQuantity[];  // [{length: 4450, quantity: 5}]
  };
  detailParts: Array<{
    partName: string;         // "엘바", "하장바"
    material: string;         // "EGI 1.6T"
    barcyInfo: string;        // "16 I 75"
  }>;
  guideRail: {
    wall: GuideRailTypeData | null;   // 벽면형 가이드레일
    side: GuideRailTypeData | null;   // 측면형 가이드레일
  };
  bottomBar: {
    material: string;         // "SUS 1.5T"
    extraFinish: string;      // "없음"
    length3000Qty: number;
    length4000Qty: number;
  };
  shutterBox: ShutterBoxData[];  // [{direction, size, lengths[]}]
  smokeBarrier: {
    w50: LengthQuantity[];    // 레일용 W50
    w80Qty: number;           // 케이스용 W80 수량
  };
}
```

### 2.6 BOM item_code → bending_info 카테고리 매핑

| item_code 패턴 | bending_info 필드 | 추출 정보 | 확인된 실제 코드 |
|----------------|-------------------|----------|----------------|
| `BD-케이스-{W}*{H}` | `shutterBox[].size` | 사이즈 "500*380" | BD-케이스-500*380 |
| `BD-마구리-{W}*{H}` | `shutterBox[].finCoverQty` | 마구리 수량 | BD-마구리-505*385 |
| `BD-가이드레일-{model}-{finish}-{W}*{H}` | `guideRail.wall/side` | baseSize "120*70" | BD-가이드레일-KSS02-SUS-120*70 |
| `EST-SMOKE-레일용` | `smokeBarrier.w50` | 레일 연기차단재 수량 | EST-SMOKE-레일용 |
| `EST-SMOKE-케이스용` | `smokeBarrier.w80Qty` | 케이스 연기차단재 수량 | EST-SMOKE-케이스용 |
| `BD-L-BAR-{model}-{W}*{H}` | `detailParts[]` | L-BAR 상세 | BD-L-BAR-KSS02-17*60 |
| `BD-보강평철-{size}` | `detailParts[]` | 보강평철 상세 | BD-보강평철-50 |
| `*하장바*` (item_name 기준) | `bottomBar` | 하장바 길이/마감 | 철재용하장바(SUS)3000 (코드: 00035) |

### 2.7 product_code 파싱 규칙

`FG-KSS02-벽면형-SUS` 패턴:

| 세그먼트 위치 | 의미 | 추출 규칙 | 예시값 |
|--------------|------|----------|--------|
| 0 | 접두사 | 무시 (항상 "FG") | FG |
| 1 | 제품 모델 | `productCode` | KSS02 |
| 2 | 가이드레일 타입 | `guideType` (벽면형/측면형/혼합형) | 벽면형 |
| 3 | 마감재 | `finishMaterial` → "SUS" → "SUS마감", "EGI" → "EGI마감" | SUS |

### 2.8 재질 매핑 (getMaterialMapping 기반)

```
Group 1 - SUS 전용 (KQTS01, KSS01, KSS02):
  guideRailFinish: "SUS 1.2T"
  bodyMaterial: "EGI 1.55T"
  bottomBarFinish: "SUS 1.5T"

Group 2 - KTE01 (마감유형 분기):
  SUS마감 → guideRailFinish: "EGI 1.55T" + extraFinish: "SUS 1.2T"
  EGI마감 → guideRailFinish: "EGI 1.55T" (extra 없음)

Group 3 - 기타 (KSE01, KWE01):
  SUS마감 → guideRailFinish: "EGI 1.55T" + extraFinish: "SUS 1.2T"
  EGI마감 → guideRailFinish: "EGI 1.55T" (extra 없음)
```

---

## 3. 대상 범위

### Phase 1: BendingInfoBuilder 서비스 (백엔드 핵심)

| # | 작업 항목 | 상태 | 비고 |
|---|----------|:----:|------|
| 1.1 | BendingInfoBuilder 서비스 클래스 생성 | ⏳ | `api/app/Services/Production/BendingInfoBuilder.php` |
| 1.2 | parseProductCode() 구현 | ⏳ | "FG-KSS02-벽면형-SUS" → productCode, guideType, finishMaterial |
| 1.3 | categorizeBomItem() 구현 | ⏳ | item_code 패턴 → 8개 카테고리 분류 |
| 1.4 | aggregateNodes() 구현 | ⏳ | 다중 노드 → 길이별 수량 합산, 셔터박스 집계 |
| 1.5 | build() 메인 메서드 구현 | ⏳ | 전체 조립 → BendingInfoExtended JSON 반환 |

### Phase 2: createProductionOrder 통합

| # | 작업 항목 | 상태 | 비고 |
|---|----------|:----:|------|
| 2.1 | OrderService (라인 1111) WorkOrder::create에 options 추가 | ⏳ | ⚠️ 컨펌 필요 |
| 2.2 | 절곡 공정 감지 로직 추가 | ⏳ | Process 모델 조회 → process_name === '절곡' |

### Phase 3: 검증 및 테스트

| # | 작업 항목 | 상태 | 비고 |
|---|----------|:----:|------|
| 3.1 | WO 74 데이터로 역검증 (order_id=43, 동일 입력 → 동일 출력) | ⏳ | |
| 3.2 | 프론트엔드 작업일지 정상 렌더링 확인 | ⏳ | BendingWorkLogContent |
| 3.3 | 비절곡 공정 WorkOrder에 bending_info 미생성 확인 | ⏳ | |

---

## 4. 작업 절차

### 4.1 단계별 절차

```
Phase 1: BendingInfoBuilder 서비스 생성
├── 1.1 파일 생성: api/app/Services/Production/BendingInfoBuilder.php
│   ├── 클래스: BendingInfoBuilder
│   └── 메서드: build(Order $order, int $processId): ?array
│
├── 1.2 product_code 파서 구현
│   ├── private parseProductCode(string $fullCode): array
│   ├── 입력: "FG-KSS02-벽면형-SUS"
│   └── 출력: ['productCode'=>'KSS02', 'guideType'=>'벽면형', 'finishMaterial'=>'SUS마감']
│
├── 1.3 BOM item_code 카테고리 분류기 구현
│   ├── private categorizeBomItem(array $bomItem): ?string
│   ├── 8개 패턴 매칭 (부록 A 참조)
│   └── 미매칭 → null 반환 (절곡 무관 품목)
│
├── 1.4 노드 집계 로직 구현
│   ├── private aggregateNodes(Collection $nodes): array
│   ├── height → 가이드레일 길이별 수량 (guideRailLengths)
│   ├── width → 셔터박스 길이별 수량 (shutterBoxLengths)
│   ├── BOM steel items → 카테고리별 수량 합산
│   └── 길이별 그룹핑 (동일 치수 노드는 수량 합산)
│
└── 1.5 build() 메인 메서드 조립
    ├── 절곡 공정 확인 → 아닌 경우 null 반환
    ├── parseProductCode → productCode, guideType, finishMaterial
    ├── aggregateNodes → 집계 데이터
    └── BendingInfoExtended 구조 JSON 조립 (부록 B 참조)

Phase 2: createProductionOrder 통합
├── 2.1 OrderService.php 수정 (라인 1111 부근)
│   ├── WorkOrder::create 호출 전 BendingInfoBuilder::build() 실행
│   ├── 절곡 공정인 경우에만 options 설정
│   └── 'options' => $bendingInfo ? ['bending_info' => $bendingInfo] : null
│
└── 2.2 Process 모델 사전 로드
    ├── 라인 1103 foreach 내에서 Process 조회
    └── 또는 $itemsByProcess에 process 정보 포함 (기존 로직 활용)

Phase 3: 검증
├── 3.1 order_id=43 (KSS02 벽면형 SUS 5개소 3560x4450) 데이터로 빌더 실행
│   ├── 기존 WO 74 bending_info와 구조 비교
│   └── productCode, guideRail, shutterBox, bottomBar, smokeBarrier 검증
│
├── 3.2 프론트엔드 렌더링 확인
│   ├── 새로 생성된 WorkOrder의 작업일지 열기
│   └── 4개 섹션 (가이드레일, 셔터박스, 하단마감재, 연기차단재) 정상 표시
│
└── 3.3 비절곡 공정 확인
    ├── 같은 수주에서 생성된 비절곡 WorkOrder의 options 확인
    └── bending_info가 없어야 함 (options: null 또는 bending_info 키 없음)
```

### 4.2 BendingInfoBuilder 서비스 설계

```php
// api/app/Services/Production/BendingInfoBuilder.php
namespace App\Services\Production;

use App\Models\Orders\Order;
use App\Models\Production\Process;
use Illuminate\Support\Collection;

class BendingInfoBuilder
{
    /**
     * 수주의 노드/BOM 데이터로 bending_info JSON 생성
     *
     * @param Order $order  수주 (rootNodes eager loaded)
     * @param int $processId  공정 ID (절곡 공정 확인용)
     * @return array|null  bending_info JSON 또는 null (절곡 아닌 경우)
     */
    public function build(Order $order, int $processId): ?array
    {
        // 1. 절곡 공정인지 확인
        $process = Process::find($processId);
        if (!$process || $process->process_name !== '절곡') {
            return null;
        }

        // 2. 루트 노드가 없으면 null
        $nodes = $order->rootNodes;
        if ($nodes->isEmpty()) {
            return null;
        }

        // 3. 첫 번째 루트 노드에서 product_code 추출
        $firstNode = $nodes->first();
        $productInfo = $this->parseProductCode(
            $firstNode->options['product_code'] ?? ''
        );

        // 4. product_code 파싱 실패 시 null
        if (empty($productInfo['productCode'])) {
            return null;
        }

        // 5. 모든 노드의 BOM items 수집 및 집계
        $aggregated = $this->aggregateNodes($nodes, $productInfo);

        // 6. bending_info 구조 조립 (부록 B 참조)
        return $this->assembleBendingInfo($productInfo, $aggregated, $nodes);
    }
}
```

### 4.3 product_code 파서

```php
/**
 * "FG-KSS02-벽면형-SUS" → ['productCode'=>'KSS02', 'guideType'=>'벽면형', 'finishMaterial'=>'SUS마감']
 */
private function parseProductCode(string $fullCode): array
{
    $parts = explode('-', $fullCode);

    // FG 접두사 제거
    if (($parts[0] ?? '') === 'FG') {
        array_shift($parts);
    }

    $finish = $parts[2] ?? 'EGI';

    return [
        'productCode' => $parts[0] ?? '',           // KSS02
        'guideType' => $parts[1] ?? '벽면형',        // 벽면형/측면형/혼합형
        'finishMaterial' => $finish === 'SUS' ? 'SUS마감' : 'EGI마감',
    ];
}
```

### 4.4 BOM item_code 카테고리 분류기

```php
/**
 * BOM 아이템을 카테고리별로 분류
 * 반환값: guideRail, shutterBox_case, shutterBox_finCover, bottomBar,
 *         smokeBarrier_rail, smokeBarrier_case, detail_lbar, detail_reinforce, null
 */
private function categorizeBomItem(array $bomItem): ?string
{
    $code = $bomItem['item_code'] ?? '';
    $name = $bomItem['item_name'] ?? '';

    if (str_starts_with($code, 'BD-가이드레일'))      return 'guideRail';
    if (str_starts_with($code, 'BD-케이스'))           return 'shutterBox_case';
    if (str_starts_with($code, 'BD-마구리'))           return 'shutterBox_finCover';
    if (str_contains($name, '하장바'))                 return 'bottomBar';
    if ($code === 'EST-SMOKE-레일용')                  return 'smokeBarrier_rail';
    if ($code === 'EST-SMOKE-케이스용')                return 'smokeBarrier_case';
    if (str_starts_with($code, 'BD-L-BAR'))           return 'detail_lbar';
    if (str_starts_with($code, 'BD-보강평철'))         return 'detail_reinforce';

    return null; // 절곡 무관 품목 (parts, motor 등)
}
```

### 4.5 createProductionOrder 변경 포인트

```php
// OrderService.php 라인 1103~1130 (수정 부분)

foreach ($itemsByProcess as $key => $group) {
    $processId = $group['processId'];
    $workOrderNo = $this->generateWorkOrderNo($tenantId, $order->id, $processId);

    // ★ 신규: 절곡 공정이면 bending_info 생성
    $options = null;
    if ($processId) {
        $bendingInfoBuilder = app(BendingInfoBuilder::class);
        $bendingInfo = $bendingInfoBuilder->build($order, $processId);
        if ($bendingInfo) {
            $options = ['bending_info' => $bendingInfo];
        }
    }

    $workOrder = WorkOrder::create([
        'tenant_id' => $tenantId,
        'work_order_no' => $workOrderNo,
        'sales_order_id' => $order->id,
        'project_name' => $order->order_no,
        'process_id' => $processId,
        'status' => WorkOrder::STATUS_PENDING,
        'assignee_id' => $data['assignee_id'] ?? null,
        'team_id' => $data['team_id'] ?? null,
        'scheduled_date' => $data['scheduled_date'] ?? null,
        'memo' => $data['memo'] ?? null,
        'options' => $options,                              // ★ 신규
        'is_active' => true,
        'created_by' => apiUserId(),
        'updated_by' => apiUserId(),
    ]);

    // ... 기존 work_order_items INSERT 로직 유지
}
```

---

## 5. 컨펌 대기 목록

| # | 항목 | 변경 내용 | 영향 범위 | 상태 |
|---|------|----------|----------|------|
| 1 | OrderService 수정 | createProductionOrder 라인 1111에 options 추가 | 생산지시 생성 전체 | ⚠️ 컨펌 필요 |
| 2 | item_code 패턴 매핑 | BD-*, EST-SMOKE-*, 하장바 패턴으로 카테고리 분류 | 절곡 BOM 품목 인식 | ⚠️ 컨펌 필요 |
| 3 | product_code 파싱 | FG-{code}-{type}-{finish} 4세그먼트 패턴 가정 | 모든 절곡 제품 | ⚠️ 컨펌 필요 |

---

## 6. 변경 이력

| 날짜 | 항목 | 변경 내용 | 파일 | 승인 |
|------|------|----------|------|------|
| 2026-02-19 | - | 문서 초안 작성 | - | - |
| 2026-02-20 | - | formula-engine-real-data-plan.md 형식으로 전면 개편 (현황 분석, 코드 위치, 부록 추가) | - | - |

---

## 7. 참고 문서

- **현재 bending_info 구조**: `react/src/components/production/WorkOrders/documents/bending/types.ts` (라인 32~68)
- **재질 매핑 로직**: `react/src/components/production/WorkOrders/documents/bending/utils.ts` (라인 77~108)
- **생산지시 서비스**: `api/app/Services/OrderService.php` (createProductionOrder, 라인 959~1214)
- **WorkOrder 서비스**: `api/app/Services/WorkOrderService.php` (store, 라인 238~323)
- **WorkOrder 모델**: `api/app/Models/Production/WorkOrder.php`
- **Order 모델**: `api/app/Models/Orders/Order.php` (rootNodes, 라인 172~178)
- **레거시 참고**: `5130/output/proc/viewBendingWork_slat.php`
- **WO 74 실데이터**: order_id=43, order_nodes id=116~125 (KSS02 벽면형 SUS, 3560x4450)

---

## 8. 관련 파일 및 코드 위치

### 8.1 API (api/) - 핵심 코드 위치

| 파일 | 메서드/요소 | 라인 | 역할 |
|------|------------|------|------|
| `Services/OrderService.php` | `createProductionOrder()` | 959 | 메인 엔트리 (수주→생산지시) |
| 같은 파일 | `Order::with(['items', 'rootNodes'])` | 966 | 수주 + 루트노드 로드 |
| 같은 파일 | `$itemsByProcess` 그룹핑 | 1035~1089 | 공정별 아이템 분류 (3단계 fallback) |
| 같은 파일 | `foreach ($itemsByProcess)` | 1103 | **공정별 WorkOrder 생성 루프** |
| 같은 파일 | `WorkOrder::create([...])` | 1111~1124 | **★ 변경 포인트: options 추가** |
| 같은 파일 | `$woItemOptions` 구성 | 1172~1181 | work_order_items.options 조립 |
| 같은 파일 | `'bending_info' => $nodeOptions['bending_info'] ?? null` | 1179 | items 레벨 bending_info (기존, 유지) |
| 같은 파일 | `DB::table('work_order_items')->insert()` | 1183~1197 | items INSERT |
| 같은 파일 | `$order->status_code = Order::STATUS_IN_PROGRESS` | 1204 | 수주 상태 변경 |
| 같은 파일 | `generateWorkOrderNo()` | 1270 | 작업지시 번호 생성 |
| `Services/WorkOrderService.php` | `store()` | 238 | 대체 생성 경로 (수동 생성용) |
| 같은 파일 | `'bending_info' => $nodeOptions['bending_info'] ?? null` | 279 | items 레벨 bending_info (유지) |
| 같은 파일 | `$workOrder->isBending()` | 306 | 절곡 공정 확인 |
| **신규** `Services/Production/BendingInfoBuilder.php` | `build()` | - | **Phase 1에서 생성** |
| `Models/Production/WorkOrder.php` | `$fillable` (options 포함) | 32~51 | options 필드 (라인 47) |
| 같은 파일 | `$casts` (options => json) | 53~60 | JSON 자동 변환 (라인 59) |
| 같은 파일 | `isBending()` | 342~345 | `process.process_name === '절곡'` |
| 같은 파일 | `process()` 관계 | 139~144 | `belongsTo(Process::class)` |
| 같은 파일 | `PROCESS_BENDING` (deprecated) | 80 | 상수 (미사용, FK 방식으로 전환됨) |
| `Models/Orders/Order.php` | `rootNodes()` | 172~178 | `hasMany(OrderNode)->whereNull('parent_id')` |

### 8.2 React (react/) - 프론트엔드 코드 위치

| 파일 | 요소 | 라인 | 역할 |
|------|------|------|------|
| `types.ts` (WorkOrders/) | `WorkOrderApi.options` | 343 | `options?: { bending_info?: Record<string, unknown> }` |
| 같은 파일 | `transformApiToFrontend()` | 495 | `bendingInfo: api.options?.bending_info \|\| undefined` |
| 같은 파일 | item 레벨 bendingInfo (deprecated) | 487 | `bendingInfo: undefined` (명시적 무시) |
| 같은 파일 | `WorkOrder.bendingInfo` | 210 | 프론트 모델 필드 정의 |
| `bending/types.ts` | `BendingInfoExtended` | 32~68 | **목표 JSON 스키마** |
| 같은 파일 | `GuideRailTypeData` | 5~13 | 가이드레일 타입 데이터 |
| 같은 파일 | `ShutterBoxData` | 15~22 | 셔터박스 데이터 |
| 같은 파일 | `LengthQuantity` | 24~27 | 길이-수량 쌍 |
| `bending/utils.ts` | `getMaterialMapping()` | 77~108 | productCode → 재질 매핑 |

### 8.3 DB 테이블

#### work_orders 테이블 (변경 대상)

| 컬럼 | 타입 | NULL | 설명 |
|------|------|------|------|
| id | bigint unsigned | NO | PK |
| tenant_id | bigint unsigned | NO | 테넌트 |
| work_order_no | varchar(50) | NO | 작업지시 번호 |
| sales_order_id | bigint unsigned | YES | 수주 FK |
| process_id | bigint unsigned | YES | 공정 FK |
| **options** | **json** | **YES** | **★ bending_info 저장 대상** |
| status | varchar(20) | NO | 상태 |
| ... | ... | ... | (기타 필드) |

#### order_nodes 테이블 (입력 소스)

| 컬럼 | 타입 | NULL | 설명 |
|------|------|------|------|
| id | bigint unsigned | NO | PK |
| order_id | bigint unsigned | NO | 수주 FK |
| parent_id | bigint unsigned | YES | 부모 노드 (root=NULL) |
| options | json | YES | **product_code, width, height, bom_result** |
| sort_order | int | NO | 정렬 |
| quantity | int | NO | 수량 (기본 1) |

#### processes 테이블 (공정 판별)

| 컬럼 | 타입 | NULL | 설명 |
|------|------|------|------|
| id | bigint unsigned | NO | PK |
| tenant_id | bigint unsigned | NO | 테넌트 |
| process_name | varchar(100) | NO | 공정명 ('절곡', '스크린', '슬랫' 등) |

---

## 9. 검증 결과

### 9.1 테스트 케이스

| 입력값 | 예상 결과 | 실제 결과 | 상태 |
|--------|----------|----------|------|
| order_id=43 (KSS02 벽면형 SUS 5개소 3560x4450) | productCode="KSS02", guideRail.wall 5개, shutterBox 1개 | - | ⏳ |
| 절곡 공정이 아닌 WorkOrder | bending_info = null, options = null | - | ⏳ |
| product_code 없는 노드 | graceful fallback (null 반환) | - | ⏳ |
| 혼합형 제품 (벽면+측면) | guideRail.wall + guideRail.side 둘 다 생성 | - | ⏳ |
| 동일 치수 복수 노드 | 수량 합산 (길이별 그룹핑) | - | ⏳ |
| BOM에 steel 외 category | 무시 (null → 스킵) | - | ⏳ |

### 9.2 성공 기준 달성 현황

| 기준 | 달성 | 비고 |
|------|------|------|
| 생산지시 시 절곡 WorkOrder에 bending_info 자동 생성 | ⏳ | |
| WO 74 수동 데이터와 동일 구조의 JSON 생성 | ⏳ | |
| 프론트엔드 BendingWorkLogContent에서 정상 렌더링 | ⏳ | |
| 비절곡 공정 WorkOrder에 bending_info 미생성 | ⏳ | |
| product_code 파싱 실패 시 graceful null 반환 | ⏳ | |

---

## 부록 A. BOM item_code → bending_info 카테고리 전체 매핑

### A.1 패턴 매칭 규칙 (우선순위 순)

| 순서 | 매칭 방식 | 패턴 | 카테고리 | bending_info 필드 |
|------|----------|------|---------|------------------|
| 1 | str_starts_with(code) | `BD-가이드레일-*` | guideRail | `guideRail.wall` 또는 `guideRail.side` |
| 2 | str_starts_with(code) | `BD-케이스-*` | shutterBox_case | `shutterBox[].size` |
| 3 | str_starts_with(code) | `BD-마구리-*` | shutterBox_finCover | `shutterBox[].finCoverQty` |
| 4 | str_contains(name) | `*하장바*` | bottomBar | `bottomBar.length3000Qty/length4000Qty` |
| 5 | exact match(code) | `EST-SMOKE-레일용` | smokeBarrier_rail | `smokeBarrier.w50[]` |
| 6 | exact match(code) | `EST-SMOKE-케이스용` | smokeBarrier_case | `smokeBarrier.w80Qty` |
| 7 | str_starts_with(code) | `BD-L-BAR-*` | detail_lbar | `detailParts[]` |
| 8 | str_starts_with(code) | `BD-보강평철-*` | detail_reinforce | `detailParts[]` |
| - | 미매칭 | (기타) | null | 무시 (절곡 무관) |

### A.2 가이드레일 item_code 파싱

`BD-가이드레일-KSS02-SUS-120*70` → 세그먼트 분리:

| 세그먼트 | 값 | 용도 |
|----------|-----|------|
| BD-가이드레일 | 접두사 | 카테고리 식별 |
| KSS02 | 모델코드 | (검증용) |
| SUS | 마감재 | (검증용) |
| 120*70 | baseSize | `guideRail.wall.baseSize` 또는 `guideRail.side.baseSize` |

### A.3 셔터박스 item_code 파싱

케이스: `BD-케이스-500*380` → `shutterBox[].size = "500*380"`
마구리: `BD-마구리-505*385` → `shutterBox[].finCoverQty += BOM quantity`

### A.4 하장바 item_name 파싱

`철재용하장바(SUS)3000` → item_name 마지막 4자리 숫자 추출 → 3000/4000 분류
- 3000 → `bottomBar.length3000Qty += BOM quantity × 노드수`
- 4000 → `bottomBar.length4000Qty += BOM quantity × 노드수`

---

## 부록 B. bending_info JSON 조립 상세

### B.1 목표 출력 구조 (WO 74 실데이터 기준)

```json
{
  "productCode": "KSS02",
  "finishMaterial": "SUS마감",
  "common": {
    "kind": "벽면형 120X70",
    "type": "벽면형(120*70)",
    "lengthQuantities": [
      { "length": 4450, "quantity": 5 }
    ]
  },
  "detailParts": [
    { "partName": "엘바", "material": "EGI 1.6T", "barcyInfo": "16 I 75" },
    { "partName": "보강평철", "material": "50T", "barcyInfo": "" }
  ],
  "guideRail": {
    "wall": {
      "baseSize": "120*70",
      "finish": "SUS 1.2T",
      "extraFinish": "",
      "lengthQuantities": [
        { "length": 4450, "quantity": 5 }
      ]
    },
    "side": null
  },
  "bottomBar": {
    "material": "SUS 1.5T",
    "extraFinish": "없음",
    "length3000Qty": 17,
    "length4000Qty": 0
  },
  "shutterBox": [
    {
      "direction": "양면",
      "size": "500*380",
      "finCoverQty": 5,
      "lengths": [
        { "length": 3560, "quantity": 5 }
      ]
    }
  ],
  "smokeBarrier": {
    "w50": [
      { "length": 4450, "quantity": 5 }
    ],
    "w80Qty": 5
  }
}
```

### B.2 조립 규칙 (필드별)

| 필드 | 소스 | 변환 규칙 |
|------|------|----------|
| `productCode` | parseProductCode(product_code)[0] | "KSS02" |
| `finishMaterial` | parseProductCode(product_code)[2] | "SUS" → "SUS마감" |
| `common.kind` | guideType + baseSize | "벽면형 120X70" |
| `common.type` | guideType + "(baseSize)" | "벽면형(120*70)" |
| `common.lengthQuantities` | 노드 height별 수량 집계 | [{length: 4450, quantity: 5}] |
| `guideRail.wall/side` | guideType으로 분기 + getMaterialMapping | baseSize, finish, lengthQuantities |
| `bottomBar.material` | getMaterialMapping.bottomBarFinish | "SUS 1.5T" |
| `bottomBar.extraFinish` | getMaterialMapping.bottomBarExtraFinish | "없음" |
| `bottomBar.length3000Qty` | 하장바 BOM item_name → 3000 수량 합산 | 17 (= 3.4 × 5) |
| `shutterBox[].direction` | 기본 "양면" (방향 정보 없음) | "양면" |
| `shutterBox[].size` | BD-케이스 item_code → 사이즈 추출 | "500*380" |
| `shutterBox[].finCoverQty` | BD-마구리 BOM quantity × 노드수 | 5 |
| `shutterBox[].lengths` | 노드 width별 수량 집계 | [{length: 3560, quantity: 5}] |
| `smokeBarrier.w50` | EST-SMOKE-레일용 수량 → height 기준 집계 | [{length: 4450, quantity: 5}] |
| `smokeBarrier.w80Qty` | EST-SMOKE-케이스용 수량 합산 → 노드수 | 5 |

### B.3 detailParts 매핑

| BOM item_code 패턴 | partName | material 결정 방식 | barcyInfo |
|--------------------|----------|-------------------|-----------|
| `BD-L-BAR-{model}-{W}*{H}` | "엘바" | "{H}T" 에서 추출 (e.g., 17*60 → "EGI 1.6T") | "{H/10} I {W}" (e.g., "16 I 75") |
| `BD-보강평철-{size}` | "보강평철" | "{size}T" (e.g., 50 → "50T") | "" |

> detailParts의 정확한 material/barcyInfo 계산은 레거시 코드 참조 필요.
> Phase 1 구현 시 WO 74 실데이터와 비교하여 확정.

---

## 부록 C. 코드 변경 포인트 상세

### C.1 OrderService.php 변경 (Phase 2.1)

**파일**: `api/app/Services/OrderService.php`
**위치**: 라인 1103~1130 (`foreach ($itemsByProcess)` 내부)

```php
// 변경 전 (라인 1111~1124):
$workOrder = WorkOrder::create([
    'tenant_id' => $tenantId,
    'work_order_no' => $workOrderNo,
    'sales_order_id' => $order->id,
    'project_name' => $order->order_no,
    'process_id' => $processId,
    'status' => WorkOrder::STATUS_PENDING,
    'assignee_id' => $data['assignee_id'] ?? null,
    'team_id' => $data['team_id'] ?? null,
    'scheduled_date' => $data['scheduled_date'] ?? null,
    'memo' => $data['memo'] ?? null,
    // ⚠️ 'options' 없음
    'is_active' => true,
    'created_by' => apiUserId(),
    'updated_by' => apiUserId(),
]);

// 변경 후:
// ★ 절곡 공정이면 bending_info 생성
$options = null;
if ($processId) {
    $bendingInfo = app(BendingInfoBuilder::class)->build($order, $processId);
    if ($bendingInfo) {
        $options = ['bending_info' => $bendingInfo];
    }
}

$workOrder = WorkOrder::create([
    'tenant_id' => $tenantId,
    'work_order_no' => $workOrderNo,
    'sales_order_id' => $order->id,
    'project_name' => $order->order_no,
    'process_id' => $processId,
    'status' => WorkOrder::STATUS_PENDING,
    'assignee_id' => $data['assignee_id'] ?? null,
    'team_id' => $data['team_id'] ?? null,
    'scheduled_date' => $data['scheduled_date'] ?? null,
    'memo' => $data['memo'] ?? null,
    'options' => $options,                              // ★ 신규
    'is_active' => true,
    'created_by' => apiUserId(),
    'updated_by' => apiUserId(),
]);
```

### C.2 BendingInfoBuilder 신규 생성 (Phase 1)

**파일**: `api/app/Services/Production/BendingInfoBuilder.php` (신규)
**예상 코드 라인 수**: 200~250줄

```
메서드 목록:
├── public build(Order $order, int $processId): ?array          (메인 엔트리)
├── private parseProductCode(string $fullCode): array           (product_code 파싱)
├── private categorizeBomItem(array $bomItem): ?string          (BOM 카테고리 분류)
├── private aggregateNodes(Collection $nodes, array $productInfo): array  (노드 집계)
├── private assembleBendingInfo(array $productInfo, array $aggregated, Collection $nodes): array  (JSON 조립)
├── private getMaterialMapping(string $productCode, string $finishMaterial): array  (재질 매핑)
├── private extractBaseSize(string $guideRailCode): string      (가이드레일 baseSize 추출)
└── private extractBottomBarLength(string $itemName): int       (하장바 길이 추출)
```

### C.3 use 문 추가 (OrderService.php)

**파일**: `api/app/Services/OrderService.php`
**위치**: 파일 상단 use 섹션

```php
use App\Services\Production\BendingInfoBuilder;
```

---

## 부록 D. 가이드레일 baseSize 규칙

### D.1 모델별 baseSize 매핑

| 모델 | guideType | BD 품목 코드 예시 | baseSize |
|------|-----------|-----------------|----------|
| KSS01 | 벽면형 | BD-가이드레일-KSS01-SUS-120*70 | 120*70 |
| KSS01 | 측면형 | BD-가이드레일-KSS01-SUS-120*120 | 120*120 |
| KSS02 | 벽면형 | BD-가이드레일-KSS02-SUS-120*70 | 120*70 |
| KSS02 | 측면형 | BD-가이드레일-KSS02-SUS-120*120 | 120*120 |
| KSE01 | 벽면형 | BD-가이드레일-KSE01-{SUS/EGI}-120*70 | 120*70 |
| KSE01 | 측면형 | BD-가이드레일-KSE01-{SUS/EGI}-120*120 | 120*120 |
| KWE01 | 벽면형 | BD-가이드레일-KWE01-{SUS/EGI}-120*70 | 120*70 |
| KWE01 | 측면형 | BD-가이드레일-KWE01-{SUS/EGI}-120*120 | 120*120 |
| KQTS01 | 벽면형 | BD-가이드레일-KQTS01-SUS-130*75 | 130*75 |
| KQTS01 | 측면형 | BD-가이드레일-KQTS01-SUS-130*125 | 130*125 |
| KTE01 | 벽면형 | BD-가이드레일-KTE01-{SUS/EGI}-130*75 | 130*75 |
| KTE01 | 측면형 | BD-가이드레일-KTE01-{SUS/EGI}-130*125 | 130*125 |
| KDSS01 | 벽면형 | BD-가이드레일-KDSS01-SUS-150*150 | 150*150 |
| KDSS01 | 측면형 | BD-가이드레일-KDSS01-SUS-150*212 | 150*212 |

### D.2 혼합형 처리

혼합형(guideType === '혼합형')인 경우:
- `guideRail.wall` = 해당 모델의 벽면형 baseSize
- `guideRail.side` = 해당 모델의 측면형 baseSize
- BOM에 두 종류 가이드레일이 모두 포함됨

> baseSize는 BOM의 `BD-가이드레일-*` item_code에서 마지막 세그먼트로 직접 추출 가능.
> 별도 매핑 테이블 불필요.

---

## 부록 E. 셔터박스/하단마감재/연기차단재 규칙

### E.1 셔터박스 방향 결정

| 조건 | direction 값 |
|------|-------------|
| 노드 1개 | "양면" (기본값) |
| 여러 노드 + 동일 치수 | "양면" (기본값) |
| 방향 정보 없음 (현재) | "양면" 기본값 사용 |

> 방향 정보는 현재 order_nodes.options에 저장되지 않음.
> Phase 1에서는 "양면" 기본값 사용. 추후 BOM 확장 시 방향 필드 추가 가능.

### E.2 하단마감재 길이 분류

| BOM item_name | 길이 추출 방법 | 분류 |
|---------------|--------------|------|
| 철재용하장바(SUS)3000 | 마지막 4자리 숫자 → 3000 | `bottomBar.length3000Qty` |
| 철재용하장바(SUS)4000 | 마지막 4자리 숫자 → 4000 | `bottomBar.length4000Qty` |
| 철재용하장바(EGI)3000 | 마지막 4자리 숫자 → 3000 | `bottomBar.length3000Qty` |

계산: `BOM quantity × 노드 수 = 총 수량` (예: 3.4 × 5개소 = 17)

### E.3 연기차단재 수량 계산

| BOM item_code | bending_info 필드 | 수량 계산 |
|---------------|------------------|----------|
| EST-SMOKE-레일용 | `smokeBarrier.w50[]` | height 기준 길이별 수량 집계 |
| EST-SMOKE-케이스용 | `smokeBarrier.w80Qty` | BOM quantity × 노드수 → 정수 변환 |

### E.4 재질 매핑 (getMaterialMapping 재현)

```php
private function getMaterialMapping(string $productCode, string $finishMaterial): array
{
    // Group 1: SUS 전용 (KQTS01, KSS01, KSS02)
    if (in_array($productCode, ['KQTS01', 'KSS01', 'KSS02'])) {
        return [
            'guideRailFinish' => 'SUS 1.2T',
            'bodyMaterial' => 'EGI 1.55T',
            'guideRailExtraFinish' => '',
            'bottomBarFinish' => 'SUS 1.5T',
            'bottomBarExtraFinish' => '없음',
        ];
    }

    // Group 2: KTE01 (마감유형 분기)
    if ($productCode === 'KTE01') {
        $isSUS = $finishMaterial === 'SUS마감';
        return [
            'guideRailFinish' => 'EGI 1.55T',
            'bodyMaterial' => 'EGI 1.55T',
            'guideRailExtraFinish' => $isSUS ? 'SUS 1.2T' : '',
            'bottomBarFinish' => 'EGI 1.55T',
            'bottomBarExtraFinish' => $isSUS ? 'SUS 1.2T' : '없음',
        ];
    }

    // Group 3: 기타 (KSE01, KWE01 등)
    $isSUS = str_contains($finishMaterial, 'SUS');
    return [
        'guideRailFinish' => 'EGI 1.55T',
        'bodyMaterial' => 'EGI 1.55T',
        'guideRailExtraFinish' => $isSUS ? 'SUS 1.2T' : '',
        'bottomBarFinish' => 'EGI 1.55T',
        'bottomBarExtraFinish' => $isSUS ? 'SUS 1.2T' : '없음',
    ];
}
```

---

## 부록 F. WO 74 역검증용 데이터

### F.1 입력 데이터 (order_id=43)

| 항목 | 값 |
|------|-----|
| 수주 ID | 43 |
| root_nodes | id=116~125 (10개, 5개소 × 2) |
| product_code | FG-KSS02-벽면형-SUS |
| width | 3560 |
| height | 4450 |
| 노드 수 | 5 (동일 치수) |

### F.2 기대 출력 (WO 74 기존 데이터와 일치해야 함)

| 필드 | 기대값 |
|------|--------|
| productCode | "KSS02" |
| finishMaterial | "SUS마감" |
| common.type | "벽면형(120*70)" |
| common.lengthQuantities | [{length: 4450, quantity: 5}] |
| guideRail.wall.baseSize | "120*70" |
| guideRail.wall.finish | "SUS 1.2T" |
| guideRail.wall.lengthQuantities | [{length: 4450, quantity: 5}] |
| guideRail.side | null |
| bottomBar.material | "SUS 1.5T" |
| bottomBar.length3000Qty | 17 (= 3.4 × 5) |
| bottomBar.length4000Qty | 0 |
| shutterBox[0].direction | "양면" |
| shutterBox[0].size | "500*380" |
| shutterBox[0].finCoverQty | 5 |
| shutterBox[0].lengths | [{length: 3560, quantity: 5}] |
| smokeBarrier.w50 | [{length: 4450, quantity: 5}] |
| smokeBarrier.w80Qty | 5 |

---

## 10. 자기완결성 점검 결과

### 10.1 체크리스트 검증

| # | 검증 항목 | 상태 | 비고 |
|---|----------|:----:|------|
| 1 | 작업 목적이 명확한가? | ✅ | 1.1 배경 |
| 2 | 성공 기준이 정의되어 있는가? | ✅ | 9.2 |
| 3 | 작업 범위가 구체적인가? | ✅ | 3 Phase + 부록 |
| 4 | 의존성이 명시되어 있는가? | ✅ | Phase 순서 = 의존성 |
| 5 | 참고 파일 경로 + 라인번호가 정확한가? | ✅ | 섹션 8 + 부록 C |
| 6 | 단계별 절차가 실행 가능한가? | ✅ | 4.1~4.5 (코드 포함) |
| 7 | 검증 방법이 명시되어 있는가? | ✅ | 섹션 9 + 부록 F |
| 8 | 모호한 표현이 없는가? | ✅ | 구체적 코드/건수/라인번호 |

### 10.2 새 세션 시뮬레이션 테스트

| 질문 | 답변 가능 | 참조 섹션 |
|------|:--------:|----------|
| Q1. 이 작업의 목적은 무엇인가? | ✅ | 1.1 배경 |
| Q2. 어디서부터 시작해야 하는가? | ✅ | 3 Phase 1, 4.1 단계별 절차 |
| Q3. OrderService의 어느 줄을 수정해야 하는가? | ✅ | 8.1 코드 위치 (라인 1111), 부록 C.1 |
| Q4. BOM item_code 매핑 규칙은? | ✅ | 2.6 + 부록 A |
| Q5. product_code 파싱 방법은? | ✅ | 2.7 + 4.3 (코드 포함) |
| Q6. 프론트엔드 목표 스키마는? | ✅ | 2.5 BendingInfoExtended + 부록 B |
| Q7. 재질 매핑 규칙은? | ✅ | 2.8 + 부록 E.4 (코드 포함) |
| Q8. 어떻게 검증하는가? | ✅ | 9.1 테스트 케이스 + 부록 F |
| Q9. 가이드레일 baseSize는 어떻게 결정하는가? | ✅ | 부록 D (모델별 전체 매핑) |
| Q10. 기존 코드에 미치는 영향은? | ✅ | 1.3 원칙 6번, 부록 C (변경 포인트 상세) |

**결과**: 10/10 통과 → ✅ 자기완결성 확보

### 10.3 보완 이력

| 날짜 | 항목 | 원본 | 보완 내용 |
|------|------|------|----------|
| 2026-02-20 | 전체 | 초안 (간략 구조) | formula-engine-real-data-plan.md 형식으로 전면 개편 |
| 2026-02-20 | 섹션 2 | 미존재 | 현황 분석 추가 (DB 데이터, 코드 분석, 스키마 상세) |
| 2026-02-20 | 섹션 8 | 간략 목록 | 관련 파일 및 코드 위치 (정확한 라인번호 포함) |
| 2026-02-20 | 부록 A~F | 일부만 존재 | 6개 부록 완비 (BOM 매핑, JSON 조립, 코드 변경, 가이드레일, 셔터박스/하단마감재, 역검증) |

---

*이 문서는 /sc:plan 스킬로 생성되었습니다.*