품목 관리
개요
이 화면은 무엇인가요? 이 화면에서는 품목 데이터를 조회, 등록, 수정, 삭제합니다.
누가 사용하나요?
- 🏢 기준정보관리자: 품목 등록, 조회, 수정 업무 수행
- 🏢 설계팀: 품목 등록, 조회, 수정 업무 수행
언제 사용하나요?
- 새로운 품목을 등록할 때
- 품목 정보를 수정하거나 조회할 때
- 품목 코드를 검색할 때
주요 기능
1. 품목 등록/조회
무엇을 하나요?: 이 화면에서는 품목 데이터를 조회, 등록, 수정, 삭제합니다.
어떻게 사용하나요?:
- 화면에 접속합니다
- 신규 버튼을 클릭합니다
- 필수 항목을 입력합니다
- 저장 버튼을 클릭합니다
- 등록 완료를 확인합니다
💡 팁: 자주 사용하는 검색 조건은 필터에 저장해두면 편리합니다.
입력 항목 가이드
| 항목 | 설명 | 입력 방법 | 예시 |
|---|---|---|---|
| 품목코드 (필수) | item_code | 직접 입력 | - |
| 품목명 (필수) | item_name | 직접 입력 | - |
| 품목유형 (필수) | item_type | 목록에서 선택 | - |
| 단위 (필수) | uom | 직접 입력 | - |
| 규격 | spec | 직접 입력 | - |
| 모델명 | model | 직접 입력 | - |
| 품목분류ID | category_id | 검색 선택 | - |
| 안전재고 | safety_stock | 숫자 입력 | 100 |
| 발주점 | reorder_point | 숫자 입력 | 100 |
| 리드타임(일) | lead_time_days | 숫자 입력 | 100 |
| 표준원가 | standard_cost | 숫자 입력 | 100 |
| 재고평가방법 (필수) | valuation_method | 목록에서 선택 | - |
| 판매단가 | selling_price | 숫자 입력 | 100 |
| 매입단가 | purchase_price | 숫자 입력 | 100 |
| 중량(kg) | weight_kg | 숫자 입력 | 100 |
| 도면번호 | drawing_no | 직접 입력 | - |
| HS코드 | hs_code | 직접 입력 | - |
| LOT추적여부 | is_lot_tracked | 체크박스 선택 | - |
| S/N추적여부 | is_serial_tracked | 체크박스 선택 | - |
| 유통기한(일) | shelf_life_days | 숫자 입력 | 100 |
| 보관조건 | storage_condition | 직접 입력 | - |
| 품목담당자 | manager_id | 검색 선택 | - |
| 사용여부 | is_active | 체크박스 선택 | - |
| 품목수명상태 | lifecycle_status | 목록에서 선택 | - |
| 자동채번접두사 | auto_numbering_prefix | 직접 입력 | - |
| 자동채번순번 | auto_numbering_sequence | 숫자 입력 | 100 |
| 제품이미지 | product_image | 파일 첨부 | - |
| 기술도면 | drawing_file | 파일 첨부 | - |
| 사양서 | specification_file | 파일 첨부 | - |
| 현재재고수량 | current_stock_qty | 숫자 입력 | 100 |
| 누적불량수량 | total_defect_qty | 숫자 입력 | 100 |
| 누적소비수량 | total_consumed_qty | 숫자 입력 | 100 |
업무 흐름에서의 위치
| 연결 화면 | 관계 | 설명 |
|---|---|---|
| BOM (자재 명세서) | 연관 | 품목→BOM(모품목) |
| BOM (자재명세서) | 연관 | 품목→BOM(자품목) |
| BOM (자재명세서) | 연관 | 품목→BOM(대체품목) |
| 공정경로 | 연관 | 품목→공정경로 |
| 생산오더 | 연관 | 품목→생산오더 |
| 구매요청항목 | 연관 | 품목→구매요청항목 |
| 구매발주항목 | 연관 | 품목→구매발주항목 |
| 입고항목 | 연관 | 품목→입고항목 |
자주 묻는 질문 (FAQ)
Q. 데이터를 일괄로 등록할 수 있나요?
A. CSV 파일을 통한 일괄 가져오기(Import) 기능을 지원합니다. 화면 상단의 가져오기 버튼을 사용하세요.
Q. 삭제한 데이터를 복구할 수 있나요?
A. 감사 추적(Audit Trail)이 활성화되어 있어 변경 이력을 확인할 수 있습니다. 삭제된 데이터는 관리자에게 문의하세요.
실무 시나리오
시나리오: 품목 관리 등록
새로운 품목 정보를 시스템에 등록해야 합니다.
- 화면에 접속합니다
- 신규 버튼을 클릭합니다
- 필수 항목을 입력합니다
- 저장 버튼을 클릭합니다
- 등록 완료를 확인합니다
참고: 데이터 구조
📋 기술 참고 정보 (개발자/관리자용)
테이블명: items
테이블 특성:
- 사용자 연결 (created_by, updated_by 자동 생성)
- 부서 연결 (department_id 자동 생성)
- 감사 추적 활성화
- CSV 가져오기 지원
- CSV 내보내기 지원
- 인쇄 기능 지원
입력 항목 원본
| 항목 | 의미 | 타입 | 필수 | 왜 필요한가 |
|---|---|---|---|---|
| 품목코드 | item_code | VARCHAR | ✅ | - |
| 품목명 | item_name | VARCHAR | ✅ | - |
| 품목유형 | item_type | 원자재 / 반제품 / 완제품 / 부자재 / MRO | ✅ | - |
| 단위 | uom | VARCHAR | ✅ | EA, KG, M, L 등 |
| 규격 | spec | VARCHAR | - | |
| 모델명 | model | VARCHAR | - | |
| 품목분류ID | category_id | UUID | item_categories 테이블 참조 (category_name 표시) | |
| 안전재고 | safety_stock | DECIMAL | - | |
| 발주점 | reorder_point | DECIMAL | - | |
| 리드타임(일) | lead_time_days | INT | - | |
| 표준원가 | standard_cost | DECIMAL | - | |
| 재고평가방법 | valuation_method | 이동평균법 / 선입선출법 / 총평균법 / 개별법 / 표준원가법 | ✅ | SAP MBEW 대응 - 품목별 재고평가 방법 |
| 판매단가 | selling_price | DECIMAL | - | |
| 매입단가 | purchase_price | DECIMAL | - | |
| 중량(kg) | weight_kg | DECIMAL | - | |
| 도면번호 | drawing_no | VARCHAR | - | |
| HS코드 | hs_code | VARCHAR | - | |
| LOT추적여부 | is_lot_tracked | BOOLEAN | - | |
| S/N추적여부 | is_serial_tracked | BOOLEAN | - | |
| 유통기한(일) | shelf_life_days | INT | - | |
| 보관조건 | storage_condition | VARCHAR | - | |
| 품목담당자 | manager_id | UUID | 시스템 users 테이블 참조 | |
| 사용여부 | is_active | BOOLEAN | - | |
| 품목수명상태 | lifecycle_status | 개발 / 시작양산 / 양산 / 단종예정 / 단종 / 폐기 | 품목 라이프사이클 단계 관리 | |
| 자동채번접두사 | auto_numbering_prefix | VARCHAR | 품목코드 자동 채번 접두사 (예: RM-, FG-, WIP-) | |
| 자동채번순번 | auto_numbering_sequence | INT | 품목코드 자동 채번 현재 순번 | |
| 제품이미지 | product_image | FILE | 제품 사진 및 외관 이미지 | |
| 기술도면 | drawing_file | FILE | 제품 설계도면 (PDF, DWG 등) | |
| 사양서 | specification_file | FILE | - | |
| 현재재고수량 | current_stock_qty | DECIMAL | 집계: stock.quantity SUM | |
| 누적불량수량 | total_defect_qty | DECIMAL | 집계: nonconformances.quantity SUM | |
| 누적소비수량 | total_consumed_qty | DECIMAL | 집계: material_consumption.actual_qty SUM |