Files
sam-docs/plans/bending-item-registration-plan.md

5.1 KiB
Raw Blame History

절곡품 품목 신규 등록 계획

작성일: 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 품목 공통 속성

[
    '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