docs: [bending] 절곡품 품목 등록 계획 완료 처리
This commit is contained in:
김보곤
169
plans/bending-item-registration-plan.md
Normal file
169
plans/bending-item-registration-plan.md
Normal file
@@ -0,0 +1,169 @@
|
||||
# 절곡품 품목 신규 등록 계획
|
||||
|
||||
> **작성일**: 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
|
||||
Reference in New Issue
Block a user