기준정보
이 기능은 무엇인가요?
품목, 거래처, BOM, 공정경로, 창고 등 ERP 전체 업무의 기초가 되는 마스터 데이터를 관리합니다.
정확한 기준정보는 모든 ERP 업무의 출발점입니다. 한 번 올바르게 등록하면 구매/생산/영업/재무 전 영역에서 일관된 데이터를 사용할 수 있습니다.
업무 프로세스 개요
포함된 화면
| 화면 | 용도 | 주 사용자 |
|---|---|---|
| 품목분류 관리 | 목록 | 기준정보 관리자, 설계팀, 구매팀, 생산기술팀 |
| 품목 관리 | 목록 | 기준정보 관리자, 설계팀, 구매팀, 생산기술팀 |
| 거래처 관리 | 목록 | 기준정보 관리자, 설계팀, 구매팀, 생산기술팀 |
| 거래처담당자 관리 | 목록 | 기준정보 관리자, 설계팀, 구매팀, 생산기술팀 |
| BOM 관리 | 목록 | 기준정보 관리자, 설계팀, 구매팀, 생산기술팀 |
| 공정경로 관리 | 목록 | 기준정보 관리자, 설계팀, 구매팀, 생산기술팀 |
| 작 업장 관리 | 목록 | 기준정보 관리자, 설계팀, 구매팀, 생산기술팀 |
| 창고 관리 | 목록 | 기준정보 관리자, 설계팀, 구매팀, 생산기술팀 |
| BOM 버전 관리 | 목록 | 기준정보 관리자, 설계팀, 구매팀, 생산기술팀 |
| 대체단위 관리 | 목록 | 기준정보 관리자, 설계팀, 구매팀, 생산기술팀 |
| 공급업체 평가 | 목록 | 기준정보 관리자, 설계팀, 구매팀, 생산기술팀 |
| 배치/LOT 관리 | 목록 | 기준정보 관리자, 설계팀, 구매팀, 생산기술팀 |
| 마스터 변경요청 | 목록 | 기준정보 관리자, 설계팀, 구매팀, 생산기술팀 |
| 품목 보관조건 설정 | 목록 | 기준정보 관리자, 설계팀, 구매팀, 생산기술팀 |
| 거래처주소 | 목록 | 기준정보 관리자, 설계팀, 구매팀, 생산기술팀 |
| 세금코드 관리 | 목록 | 기준정보 관리자, 설계팀, 구매팀, 생산기술팀 |
관련 솔루션 연계
| 솔루션 | 연계 내용 | 데이터 흐름 |
|---|---|---|
| 생산관리 | BOM/공정 연계 | BOM → 생산오더 |
| 구매관리 | 거래처/품목 연계 | 거래처 → 구매발주 |
| 원가관리 | 원가계산 기준 | BOM+공정 → 원가계산 |
| MES | 생산실행 연계 | 공정경로 → MES 작업지시 |
시작하기
- 처음 사용하시면 → 품목분류 관리에서 시작하세요
- 각 화면의 상세 사용법은 개별 화면 문서를 참고하세요
- 궁금한 점은 FAQ를 확인하거나 시스템 관리자에게 문의하세요
참고: 데이터 구조
📋 기술 참고 정보 (개발자/관리자용)
관련 워크플로우
- 신용 확인 (autoTask): 고객의 여신한도 및 미수금을 자동 확인
- MRP 전개 (autoTask): BOM 기반 자재소요량을 자동 전개합니다
- BOM 전개 (autoTask): BOM 기반 자재소요량을 전개하고 가용재고를 대비
- BOM 기반 사급자재 조회 (dataFilter): BOM에서 사급자재 목록을 조회
- BOM 신규버전 생성 (autoTask): 승인된 ECO 기반으로 BOM 신규 버전을 자동 생성. 기존 BOM 스냅샷을 보존하고 변경사항을 적용 [Transaction: REQUIRES_NEW, Idempotency: {eco_number}_{bom_id}]
데이터 관계도
테이블 요약
품목분류 (item_categories)
| 컬럼명 | 한글명 | 타입 | 설명 |
|---|---|---|---|
category_code | 분류코드 | VARCHAR *필수 *고유 | - |
category_name | 분류명 | VARCHAR *필수 | - |
parent_id | 상위분류ID | UUID (FK) | item_categories 참조 (자기참조) |
level | 레벨 | INT | - |
sort_order | 정렬순서 | INT | - |
manager_id | 분류관리자 | UUID (시스템참조) | - |
is_active | 사용여부 | BOOLEAN | - |
품목마스터 (items)
| 컬럼명 | 한글명 | 타입 | 설명 |
|---|---|---|---|
item_code | 품목코드 | VARCHAR *필수 *고유 | - |
item_name | 품목명 | VARCHAR *필수 | - |
item_type | 품목유형 | ENUM(원자재, 반제품, 완제품, 부자재, MRO) *필수 | - |
uom | 단위 | VARCHAR *필수 | EA, KG, M, L 등 |
spec | 규격 | VARCHAR | - |
model | 모델명 | VARCHAR | - |
category_id | 품목분류ID | UUID (FK) | item_categories 참조 |
safety_stock | 안전재고 | DECIMAL | - |
reorder_point | 발주점 | DECIMAL | - |
lead_time_days | 리드타임(일) | INT | - |
standard_cost | 표준원가 | DECIMAL | - |
valuation_method | 재고평가방법 | ENUM(이동평균법, 선입선출법, 총평균법, 개별법, 표준원가법) *필수 | SAP MBEW 대응 - 품목별 재고평가 방법 |
selling_price | 판매단가 | DECIMAL | - |
purchase_price | 매입단가 | DECIMAL | - |
weight_kg | 중량(kg) | DECIMAL | - |
drawing_no | 도면번호 | VARCHAR | - |
hs_code | HS코드 | VARCHAR | - |
is_lot_tracked | LOT추적여부 | BOOLEAN | - |
is_serial_tracked | S/N추적여부 | BOOLEAN | - |
shelf_life_days | 유통기한(일) | INT | - |
storage_condition | 보관조건 | VARCHAR | - |
manager_id | 품목담당자 | UUID (시스템참조) | - |
is_active | 사용여부 | BOOLEAN | - |
lifecycle_status | 품목수명상태 | ENUM(개발, 시작양산, 양산, 단종예정, 단종, 폐기) | 품목 라이프사이클 단계 관리 |
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 (계산) | WMS stock 테이블 재고합계 (양방향 연계) |
total_defect_qty | 누적불량수량 | DECIMAL (계산) | QMS nonconformances 불량수량합계 (양방향 연계) |
total_consumed_qty | 누적소비수량 | DECIMAL (계산) | MES material_consumption 실제소비합계 (양방향 연계) |
거래처 (partners)
| 컬럼명 | 한글명 | 타입 | 설명 |
|---|---|---|---|
partner_code | 거래처코드 | VARCHAR *필수 *고유 | - |
partner_name | 거래처명 | VARCHAR *필수 | - |
partner_type | 거래처유형 | ENUM(고객, 공급업체, 고객+공급업체) *필수 | - |
business_number | 사업자번호 | VARCHAR *고유 | - |
ceo_name | 대표자명 | VARCHAR | - |
business_type | 업태 | VARCHAR | - |
address | 주소 | TEXT | - |
phone | 전화번호 | VARCHAR | - |
email | 이메일 | VARCHAR | - |
contact_person | 담당자 | VARCHAR | - |
sales_person_id | 영업담당자 | UUID (시스템참조) | - |
payment_terms | 결제조건 | ENUM(현금, 30일, 60일, 90일, 어음) | - |
credit_limit | 여신한도 | DECIMAL | - |
bank_name | 은행명 | VARCHAR | - |
bank_account | 계좌번호 | VARCHAR | - |
tax_type | 과세유형 | VARCHAR | - |
currency | 기준통화 | ENUM(KRW, USD, EUR, JPY, CNY) *필수 | - |
is_active | 사용여부 | BOOLEAN | - |
credit_status | 신용상태 | ENUM(정상, 주의, 정지, 해지) | 거래처 신용 상태 관리 |
evaluation_grade | 평가등급 | ENUM(S, A, B, C, D) | 공급업체 종합 평가등급 |
last_evaluation_date | 최종평가일 | DATE | 가장 최근 공급업체 평가 실시일 |
business_license | 사업자등록증 | FILE | 거래처 사업자등록증 사본 |
avg_supplier_score | 평균공급업체점수 | DECIMAL (계산) | supplier_evaluations 종합점수 평균 (양방향 연계) |
evaluation_count | 평가횟수 | INT (계산) | supplier_evaluations 평가건수 (양방향 연계) |
거래처담당자 (partner_contacts)
| 컬럼명 | 한글명 | 타입 | 설명 |
|---|---|---|---|
partner_id | 거래처ID | UUID (FK) *필수 | - |
contact_name | 담당자명 | VARCHAR *필수 | - |
position | 직위 | VARCHAR | - |
department | 부서 | VARCHAR | - |
phone | 전화번호 | VARCHAR | - |
mobile | 휴대폰 | VARCHAR | - |
email | 이메일 | VARCHAR | - |
is_primary | 주담당여부 | BOOLEAN | - |
BOM (자재명세서) (bom)
| 컬럼명 | 한글명 | 타입 | 설명 |
|---|---|---|---|
bom_code | BOM코드 | VARCHAR *필수 *고유 | - |
parent_item_id | 모품목ID | UUID (FK) *필수 | - |
child_item_id | 자품목ID | UUID (FK) *필수 | - |
bom_type | BOM유형 | ENUM(E-BOM, M-BOM) *필수 | - |
bom_level | BOM레벨 | INT *필수 | - |
quantity | 소요량 | DECIMAL *필수 | - |
unit | 단위 | VARCHAR *필수 | - |
loss_rate | 로스율(%) | DECIMAL | - |
required_quantity_with_loss | 로스반영소요량 | DECIMAL (계산) | - |
effective_from | 유효시작일 | DATE *필수 | - |
effective_to | 유효종료일 | DATE | - |
process_code | 공정코드 | VARCHAR | - |
alternative_item_id | 대체품목ID | UUID (FK) | items 참조 - 대체 가능 품목 |
manager_id | BOM담당자 | UUID (시스템참조) | - |
is_active | 사용여부 | BOOLEAN | - |
공정경로 (routings)
| 컬럼명 | 한글명 | 타입 | 설명 |
|---|---|---|---|
routing_code | 공정코드 | VARCHAR *필수 *고유 | - |
item_id | 품목ID | UUID (FK) *필수 | - |
process_seq | 공정순서 | INT *필수 | - |
process_name | 공정명 | VARCHAR *필수 | - |
work_center_id | 작업장ID | UUID (FK) *필수 | - |
setup_time | 셋업시간(분) | DECIMAL | - |
run_time_per_unit | 단위당가공시간(분) | DECIMAL | - |
total_time_per_unit | 총소요시간(분) | DECIMAL (계산) | - |
cycle_time | 사이클타임(초) | DECIMAL | - |
labor_count | 투입인원 | INT | - |
manager_id | 공정담당자 | UUID (시스템참조) | - |
from_operation_id | 이전공정ID | UUID (FK) | 이전 공정 (NULL=시작) |
to_operation_id | 다음공정ID | UUID (FK) | 다음 공정 (NULL=종료) |
operation_type | 공정유형 | ENUM(standard, alternative, rework, outsource, inspection) *필수 | - |
branch_condition | 분기조건식 | VARCHAR | 분기 조건식 |
routing_priority | 라우팅우선순위 | INT | - |
routing_version | 라우팅버전 | INT | - |
effective_from | 유효시작일 | DATE | - |
effective_to | 유효종료일 | DATE | - |
is_optional | 선택공정여부 | BOOLEAN | - |
작업장 (work_centers)
| 컬럼명 | 한글명 | 타입 | 설명 |
|---|---|---|---|
wc_code | 작업장코 드 | VARCHAR *필수 *고유 | - |
wc_name | 작업장명 | VARCHAR *필수 | - |
wc_type | 작업장유형 | ENUM(가공, 조립, 검사, 포장, 절단, 기계가공, 열처리) *필수 | - |
department_id | 부서ID | UUID (시스템참조) | - |
capacity_per_day | 일일생산능력 | DECIMAL | - |
cost_per_hour | 시간당원가 | DECIMAL | - |
calendar_id | 캘린더ID | VARCHAR | - |
manager_id | 작업장관리자 | UUID (시스템참조) | - |
is_active | 사용여부 | BOOLEAN | - |
창고 (warehouses)
| 컬럼명 | 한글명 | 타입 | 설명 |
|---|---|---|---|
warehouse_code | 창고코드 | VARCHAR *필수 *고유 | - |
warehouse_name | 창고명 | VARCHAR *필수 | - |
warehouse_type | 창고유형 | ENUM(원자재, 반제품, 완제품, 부자재, MRO, 반품, 통합) *필수 | - |
location | 위치 | VARCHAR | - |
manager_id | 창고관리자ID | UUID (시스템참조) | - |
department_id | 소속부서ID | UUID (시스템참조) | - |
plant_id | 소속사업장ID | UUID (FK) | plants 참조 (소속 사업장) |
capacity | 수용능력 | DECIMAL | - |
is_active | 사용여부 | BOOLEAN | - |
BOM 버전 (bom_versions)
| 컬럼명 | 한글명 | 타입 | 설명 |
|---|---|---|---|
version_number | 버전번호 | VARCHAR *필수 *고유 | BOM-VER-001 형태 |
bom_id | BOM_ID | UUID (FK) *필수 | - |
version_no | 버전순번 | INT *필수 | 동일 BOM 내 순차 버전 번호 |
version_status | 버전상태 | ENUM(작성중, 검토중, 승인대기, 승인, 폐기) *필수 | - |
change_reason | 변경사유 | TEXT | 버전 변경 이유 |
change_type | 변경유형 | ENUM(신규등록, 설계변경, 원가변경, 공정변경, 대체자재) *필수 | - |
effective_from | 유효시작일 | DATE *필수 | - |
effective_to | 유효종료일 | DATE | - |
eco_id | ECO_ID | UUID (FK) | engineering_change_orders 참조 (ECO 연계) |
previous_version_id | 이전버전ID | UUID (FK) | bom_versions 참조 (자기참조: 이전 버전) |
approved_date | 승인일 | DATE | - |
released_date | 양산릴리스일 | DATE | - |
bom_snapshot | BOM스냅샷 | TEXT | JSON: 해당 버전의 BOM 구성 스냅샷 |
created_by | 작성자ID | UUID (시스템참조) | - |
approved_by | 승인자ID | UUID (시스템참조) | - |
released_by | 릴리스담당자ID | UUID (시스템참조) | - |
remarks | 비고 | TEXT | - |
대체단위변환 (unit_conversions)
| 컬럼명 | 한글명 | 타입 | 설명 |
|---|---|---|---|
item_id | 품목ID | UUID (FK) *필수 | - |
from_unit | 원본단위 | VARCHAR *필수 | EA, KG, M, L 등 |
to_unit | 변환단위 | VARCHAR *필수 | - |
conversion_factor | 변환계수 | DECIMAL *필수 | 원본단위 × 변환계수 = 변환단위 |
usage_type | 용도구분 | ENUM(구매, 생산, 판매, 재고, 전체) *필수 | - |
is_default | 기본변환여부 | BOOLEAN | - |
is_active | 사용여부 | BOOLEAN | - |
created_by | 등 록자ID | UUID (시스템참조) | - |
remarks | 비고 | TEXT | - |
공급업체평가 (supplier_evaluations)
| 컬럼명 | 한글명 | 타입 | 설명 |
|---|---|---|---|
evaluation_number | 평가번호 | VARCHAR *필수 *고유 | - |
partner_id | 거래처ID | UUID (FK) *필수 | partners 참조 (공급업체 유형) |
evaluation_type | 평가유형 | ENUM(정기, 수시, 신규, 재평가) *필수 | - |
evaluation_period | 평가기간 | VARCHAR *필수 | YYYY-QN 또는 YYYY-MM 형식 |
evaluation_date | 평가일 | DATE *필수 | - |
status | 상태 | ENUM(작성중, 검토중, 승인, 반려) *필수 | - |
quality_score | 품질점수 | DECIMAL | 0~100점 |
quality_weight | 품질가중치 | DECIMAL | 가중치 비율(%) |
delivery_score | 납기점수 | DECIMAL | 0~100점 |
delivery_weight | 납기가중치 | DECIMAL | 가중치 비율(%) |
price_score | 가격점수 | DECIMAL | 0~100점 |
price_weight | 가격가중치 | DECIMAL | 가중치 비율(%) |
service_score | 서비스점수 | DECIMAL | 0~100점 |
service_weight | 서비스가중치 | DECIMAL | 가중치 비율(%) |
total_score | 종합점수 | DECIMAL (계산) | 가중평균 점수 |
overall_grade | 종합등급 | ENUM(S, A, B, C, D) | S(90↑), A(80↑), B(70↑), C(60↑), D(60↓) |
evaluator_id | 평가자ID | UUID (시스템참조) | public.users 참조 |
approved_by | 승인자ID | UUID (시스템참조) | public.users 참조 |
evaluator_comment | 평가소견 | TEXT | - |
improvement_required | 개선필요사항 | TEXT | 개선이 필요한 항목 및 조치사항 |
evaluation_attachment | 평가첨부문서 | FILE | 평가 관련 증빙자료 |
배치마스터 (batch_master)
| 컬럼명 | 한글명 | 타입 | 설명 |
|---|---|---|---|
batch_number | 배치번호 | VARCHAR *필수 *고유 | - |
item_id | 품목ID | UUID (FK) *필수 | items 참조 |
production_date | 생산일 자 | DATE | - |
expiry_date | 유효기한 | DATE | - |
batch_quantity | 배치수량 | DECIMAL *필수 | - |
remaining_quantity | 잔여수량 | DECIMAL | - |
consumed_quantity | 소진수량 | DECIMAL (계산) | - |
consumption_rate | 소진율(%) | DECIMAL (계산) | - |
uom | 단위 | VARCHAR *필수 | EA, KG, M, L 등 |
batch_status | 배치상태 | ENUM(생산중, 검사중, 합격, 불합격, 보류, 출하가능, 소진, 폐기) *필수 | - |
production_order_id | 생산지시ID | UUID (FK) | production_orders 참조 |
purchase_order_id | 구매발주ID | UUID (FK) | purchase_orders 참조 (외부 입고 배치) |
warehouse_id | 보관창고ID | UUID (FK) | warehouses 참조 |
inspection_id | 품질검사ID | UUID (FK) | quality_inspections 참조 |
supplier_batch_number | 공급업체배치번호 | VARCHAR | 공급업체 원래 배치/LOT 번호 |
manufacturing_site | 제조장소 | VARCHAR | - |
storage_location | 보관위치 | VARCHAR | 창고 내 세부 보관 위치 |
temperature_condition | 온도조건 | VARCHAR | 보관 온도 조건 (예: -20~5°C) |
batch_attributes | 배치속성 | JSON | 품목별 추가 배치 속성 (성분분석, 물성값 등) |
traceability_code | 추적코드 | VARCHAR | 바코드/QR코드 연계용 추적 코드 |
remarks | 비고 | TEXT | - |
registered_by | 등록자ID | UUID (시스템참조) | - |
마스터데이터변경요청 (master_change_requests)
| 컬럼명 | 한글명 | 타입 | 설명 |
|---|---|---|---|
request_number | 요청번호 | VARCHAR *필수 *고유 | - |
target_table | 대상테이블 | ENUM(items, partners, bom, routings, work_centers, warehouses, item_categories) *필수 | 변경 대상 마스터 테이블 |
target_record_id | 대상레코드ID | UUID | 수정 대상 레코드 ID (신규는 NULL) |
change_type | 변경유형 | ENUM(신규등록, 수정, 비활성화, 삭제, 일괄변경) *필수 | - |
change_reason | 변경사유 | TEXT *필수 | - |
change_fields | 변경필드 | JSON *필수 | 변경 전후 필드값 JSON (before/after 구조) |
impact_analysis | 영향분석 | TEXT | 변경으로 인한 영향 범위 분석 결과 |
priority | 긴급도 | ENUM(긴급, 높음, 보통, 낮음) *필수 | - |
status | 상태 | ENUM(작성중, 검토요청, 검토중, 승인, 반려, 적용완료, 취소) *필수 | - |
review_comment | 검토의견 | TEXT | - |
approval_comment | 승인의견 | TEXT | - |
applied_date | 적용일시 | TIMESTAMP | 실제 마스터 데이터 반영 일시 |
requested_by | 요청자ID | UUID (시스템참조) | - |
reviewed_by | 검토자ID | UUID (시스템참조) | - |
approved_by | 승인자ID | UUID (시스템참조) | - |
change_attachment | 변경첨부파일 | FILE | 변경 근거 문서 첨부 |
세금코드마스터 (tax_codes)
| 컬럼명 | 한글명 | 타입 | 설명 |
|---|---|---|---|
tax_code | 세금코드 | VARCHAR *필수 *고유 | 예: V10, A11 |
tax_name | 세금명 | VARCHAR *필수 | 부가세10%, 면세 등 |
tax_type | 세금유형 | ENUM(매출세, 매입세, 원천세, 지방소득세, 면세) *필수 | - |
tax_rate | 세율(%) | DECIMAL *필수 | - |
tax_account_id | 세금계정 | UUID (FK) | - |
is_deductible | 공제여부 | ENUM(공 제, 불공제) | - |
effective_from | 시행일 | DATE *필수 | - |
effective_to | 만료일 | DATE | - |
country_code | 국가코드 | VARCHAR *필수 | - |
is_active | 사용여부 | ENUM(Y, N) *필수 | - |
description | 설명 | TEXT | - |
거래처주소 (partner_addresses)
| 컬럼명 | 한글명 | 타입 | 설명 |
|---|---|---|---|
partner_id | 거래처 | UUID (FK) *필수 | - |
address_code | 주소코드 | VARCHAR *필수 | 거래처 내 식별코드 |
address_name | 주소명 | VARCHAR *필수 | 안산공장, 평택물류센터 등 |
address_type | 주소유형 | ENUM(본사, 납품처, 청구처, 공장, 물류센터) *필수 | - |
postal_code | 우편번호 | VARCHAR | - |
address_line1 | 주소(도로명) | VARCHAR *필수 | - |
address_line2 | 상세주소 | VARCHAR | - |
city | 시/군/구 | VARCHAR | - |
region | 도/시 | VARCHAR | - |
country | 국가코드 | VARCHAR *필수 | ISO 3166-1 |
contact_name | 현장담당자 | VARCHAR | - |
contact_phone | 현장연락처 | VARCHAR | - |
delivery_instruction | 배송특이사항 | TEXT | 입고시간, 하차방법 등 |
is_default | 기본주소 | BOOLEAN | - |
is_active | 사용여부 | BOOLEAN | - |