From 01d146b398f481a993dfabe0e6e630683901d651 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EA=B9=80=EB=B3=B4=EA=B3=A4?= Date: Wed, 18 Mar 2026 19:43:39 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20[bending]=20=EC=A0=88=EA=B3=A1=ED=92=88?= =?UTF-8?q?=20=ED=92=88=EB=AA=A9=20=EB=93=B1=EB=A1=9D=20=EA=B3=84=ED=9A=8D?= =?UTF-8?q?=20=EC=99=84=EB=A3=8C=20=EC=B2=98=EB=A6=AC?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- plans/bending-item-registration-plan.md | 169 ++++++++++++++++++++++++ 1 file changed, 169 insertions(+) create mode 100644 plans/bending-item-registration-plan.md diff --git a/plans/bending-item-registration-plan.md b/plans/bending-item-registration-plan.md new file mode 100644 index 0000000..d6b3223 --- /dev/null +++ b/plans/bending-item-registration-plan.md @@ -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