# 절곡품 품목 신규 등록 계획

> **작성일**: 2026-03-18
> **상태**: ✅ 완료 (2026-03-18 실행)
> **관련 문서**: `rules/bending-lot-numbering-policy.md`

---

## 1. 배경

2026-03 최신 LOT 채번 규칙에 신규 종류 코드(W, F, H)와 길이 코드(06, 17, 20, 45)가 추가되었다.
이에 따라 `items` 테이블에 해당 조합의 품목을 등록해야 재고생산에서 LOT 번호 부여와 품목 매핑이 정상 작동한다.

---

## 2. 현황 분석

### 2.1 전체 요약

| 구분 | 건수 |
|------|------|
| 기존 BD-XX-nn 품목 | 103건 |
| LOT 코드 기준 전체 가능 조합 | 292건 |
| **누락 품목 (최대)** | **189건** |

> **주의**: 189건은 모든 조합이 필요하다고 가정한 최대값. 실제 생산하지 않는 조합은 제외해야 한다.

### 2.2 신규 종류 코드 (★ 전체 신규 — 59건)

| 조합 | 품명 | 필요 품목 수 |
|------|------|:-----------:|
| **RW** | 가이드레일(벽면) 본체(L120) | 11건 |
| **RF** | 가이드레일(벽면) SUS마감재(L120) | 11건 |
| **SW** | 가이드레일(측면) 본체(L120) | 11건 |
| **SF** | 가이드레일(측면) SUS마감재(L120) | 11건 |
| **TE** | 하단마감재(철재) EGI | 11건 |
| **GH** | 연기차단재 화이바원단(W80) | 4건 |

### 2.3 신규 길이 코드로 인한 추가 (기존 조합 — 130건)

| 길이 | 코드 | 영향 조합 수 | 비고 |
|------|------|:-----------:|------|
| **610mm** | 06 | 26개 조합 전부 | 모든 조합에 없음 |
| **1750mm** | 17 | 26개 조합 전부 | 모든 조합에 없음 |
| **2000mm** | 20 | 26개 조합 전부 | 모든 조합에 없음 |
| **4500mm** | 45 | 26개 조합 전부 | 모든 조합에 없음 |
| **4150mm** | 41 | 가이드레일/하단마감재 등 | 케이스만 기존 보유 |

---

## 3. 확인 필요 사항 (사용자 결정)

> **아래 질문에 대한 답변을 받은 후 실제 등록 작업을 진행한다.**

### 3.1 신규 길이의 적용 범위

```
Q1. 610mm(06), 1750mm(17), 2000mm(20), 4500mm(45) 길이가
    모든 제품(가이드레일/케이스/하단마감재/L-Bar/연기차단재)에 다 필요한가?
    아니면 특정 제품에만 적용되는가?

Q2. 기존 4200mm(42) 품목이 7건 있는데, 최신 코드에서 제거됨.
    기존 42 품목은 비활성화(is_active=false)하는가, 유지하는가?
```

### 3.2 신규 종류의 길이 범위

```
Q3. 본체(L120) (W코드) — 어떤 길이가 필요한가?
    예: 기존 본체(M)와 동일한 길이 범위? 아니면 특정 길이만?

Q4. SUS마감재(L120) (F코드) — 어떤 길이가 필요한가?

Q5. 화이바원단(W80) (H코드) — W50과 동일하게 53/54/83/84 연기차단재 길이만?
    아니면 일반 길이도 포함?
```

### 3.3 기존 빈약한 조합

```
Q6. 아래 조합은 현재 1~2건만 등록됨. 나머지 길이도 추가하는가?
    - RT (벽면 본체철재): 30, 43만 있음
    - ST (측면 본체철재): 43만 있음
    - BE (스크린 EGI): 30, 40만 있음
    - TS (철재 SUS): 40, 43만 있음
    - LA (L-Bar): 30, 40만 있음
```

---

## 4. 등록 작업 계획 (확인 후 실행)

### 4.1 품목 코드 규칙

```
BD-{제품코드}{종류코드}-{길이코드}
```

| 예시 | 의미 |
|------|------|
| `BD-RW-24` | 가이드레일(벽면) 본체(L120) 2438mm |
| `BD-SF-30` | 가이드레일(측면) SUS마감재(L120) 3000mm |
| `BD-GH-83` | 연기차단재 화이바원단(W80) W80×3000 |
| `BD-RM-06` | 가이드레일(벽면) 본체 610mm |

### 4.2 품목 공통 속성

```php
[
    'tenant_id' => 1,          // 경동기업
    'item_type' => 'PT',       // 부품
    'item_category' => 'BENDING',
    'unit' => 'EA',
    'is_active' => true,
    'options' => [
        'item_bending' => '가이드레일',  // 제품별 분류명
        'material' => 'EGI 1.55T',      // MATERIAL_MAP 기반
    ],
]
```

### 4.3 실행 방식

| 방식 | 장점 | 단점 |
|------|------|------|
| **A. API 일괄 등록 스크립트** | 빠름, 정확 | 코드 작성 필요 |
| **B. MNG 품목관리 수동 등록** | 검증 용이 | 건수 많으면 비효율 |
| **C. artisan command** | 재실행 가능, 안전 | 커맨드 개발 필요 |

> **권장**: A 또는 C 방식 — 사용자 확인 후 스크립트로 일괄 등록

### 4.4 bending_item_mappings 동시 등록

품목 등록과 함께 `bending_item_mappings` 테이블에도 매핑 데이터를 동시 등록한다.

```
BD-RM-24 등록 → bending_item_mappings에
  prod_code='R', spec_code='M', length_code='24', item_id={새품목ID}
자동 등록
```

---

## 5. 작업 순서

```
1단계: 사용자 확인 (3절의 Q1~Q6 답변)
   ↓
2단계: 확정된 조합 목록 기반 등록 스크립트 작성
   ↓
3단계: 로컬에서 실행 → 개발서버 DB에 즉시 반영 (SSH 터널)
   ↓
4단계: MNG 품목관리에서 등록 결과 확인
   ↓
5단계: bending_item_mappings 동시 등록
   ↓
6단계: 재고생산관리에서 품목 선택 테스트
```

---

## 관련 문서

- `rules/bending-lot-numbering-policy.md` — LOT 채번 규칙
- `dev/dev_plans/bending-management/README.md` — 절곡품 관리 전체 계획

---

**최종 업데이트**: 2026-03-18
