원료입고 POP

개요

이 화면은 무엇인가요? 원료관리를 체계적으로 등록하고 관리하는 목록 화면입니다. 이 기록은 ISO 22716 (화장품 GMP) 요구사항을 충족합니다.

누가 사용하나요?

• 🔬 QA 담당자: 데이터를 등록하고 관리합니다
• 👨‍💼 QA 매니저: 결과를 검토합니다

언제 사용하나요?

• 관련 업무 수행 시
• 정기 검토 시

---

주요 기능

1. 원료관리 등록 및 관리

무엇을 하나요?: 원료관리 정보를 등록하고 상태를 관리합니다.

어떻게 사용하나요?:

1. 화면에서 새로 만들기 버튼을 선택합니다
2. 필수 항목을 입력합니다
3. 관련 정보를 추가 입력합니다
4. 저장 버튼을 클릭합니다

💡 팁: 필수 항목(✅ 표시)을 모두 입력해야 저장이 가능합니다.

---

업무 흐름에서의 위치

---

입력 항목 가이드

항목	의미	타입	필수	왜 필요한가
관리코드	control_code	VARCHAR	✅	-
원료규격	spec_id	UUID	✅	raw_material_specs 테이블 참조 (spec_code 표시)
원료명	material_name	VARCHAR	✅	-
INCI명	inci_name	VARCHAR		-
LOT번호	lot_number	VARCHAR	✅	-
공급업체명	supplier_name	VARCHAR	✅	-
공급업체ID	supplier_id	UUID		suppliers 테이블 참조 (supplier_name 표시)
ERP거래처ID	partner_id	UUID		partners 테이블 참조 (partner_name 표시)
공급업체성적서번호	supplier_coa_number	VARCHAR		-
입고일	received_date	DATE	✅	-
유효기한	expiry_date	DATE		-
입고수량	received_qty	DECIMAL	✅	-
단위	unit	VARCHAR	✅	-
잔여수량	remaining_qty	DECIMAL	✅	자동 계산: received_qty - dispensed_qty
시험상태	test_status	대기 / 시험중 / 적합 / 부적합 / 재시험 / 보류	✅	-
시험일	test_date	DATE		-
시험결과요약	test_result_summary	JSONB		[{item, value, spec, judgment}]
보관조건	storage_condition	일반 / 냉장 / 차광 / 위험물	✅	-
보관위치	storage_location	VARCHAR		-
보관상태	storage_status	입고 / 시험대기 / 적합보관 / 부적합격리 / 불출중 / 소진 / 반품 / 폐기	✅	-
누적불출수량	dispensed_qty	DECIMAL	✅	-
최종불출일	dispensed_date	DATE		-
입고담당자	receiver_id	UUID	✅	시스템 users 테이블 참조
시험자	tester_id	UUID		시스템 users 테이블 참조
부적합사유	rejection_reason	TEXT		-
처리결정	disposition	반품 / 폐기 / 재시험 / 특채		-
입고검수	receiving_inspection	JSONB		{appearance, quantity, packaging, coa_check}
성적서파일	coa_file_url	FILE		-
비고	remark	TEXT		-

---

자주 묻는 질문 (FAQ)

Q. 이 화면의 데이터는 어떤 인증 심사에서 활용되나요?

ISO 22716 (화장품 GMP) 인증 심사, KGMP 자체점검, 거래처 감사 시 이 화면의 데이터가 증적 자료로 활용됩니다. 감사 추적(Audit Trail) 기능이 활성화되어 있으므로 데이터 변경 이력도 함께 제출할 수 있습니다.

Q. 데이터를 수정하면 이력이 남나요?

네, 이 화면은 감사 추적(Audit Trail) 기능이 활성화되어 있어 모든 변경 이력이 자동으로 기록됩니다. 수정 전/후 값, 수정자, 수정일시가 기록되어 규정 준수를 위한 증적으로 활용됩니다.

---

실무 시나리오

시나리오: 원료입고 POP 신규 등록

원료입고 POP 업무를 수행하기 위해 새 데이터를 등록합니다.

1. 원료입고 POP 화면에서 새로 만들기를 선택합니다
2. 필수 항목을 입력합니다
3. 관련 참조 데이터를 선택합니다
4. 입력 내용을 확인하고 저장합니다
5. 필요 시 상태를 변경하고 후속 프로세스를 진행합니다

---

📋 기술 참고 정보 (개발자/관리자용)

테이블 정보

raw_material_controls 테이블은 이 화면의 데이터를 저장합니다.

테이블 특성:

• 사용자 연결 (created_by, updated_by 자동 생성)
• 감사 추적 활성화
• CSV 가져오기 지원
• CSV 내보내기 지원
• 인쇄 기능 지원

입력 항목 상세

항목	의미	타입	필수	왜 필요한가
관리코드	control_code	VARCHAR	✅	-
원료규격	spec_id	UUID	✅	raw_material_specs 테이블 참조 (spec_code 표시)
원료명	material_name	VARCHAR	✅	-
INCI명	inci_name	VARCHAR		-
LOT번호	lot_number	VARCHAR	✅	-
공급업체명	supplier_name	VARCHAR	✅	-
공급업체ID	supplier_id	UUID		suppliers 테이블 참조 (supplier_name 표시)
ERP거래처ID	partner_id	UUID		partners 테이블 참조 (partner_name 표시)
공급업체성적서번호	supplier_coa_number	VARCHAR		-
입고일	received_date	DATE	✅	-
유효기한	expiry_date	DATE		-
입고수량	received_qty	DECIMAL	✅	-
단위	unit	VARCHAR	✅	-
잔여수량	remaining_qty	DECIMAL	✅	자동 계산: received_qty - dispensed_qty
시험상태	test_status	대기 / 시험중 / 적합 / 부적합 / 재시험 / 보류	✅	-
시험일	test_date	DATE		-
시험결과요약	test_result_summary	JSONB		[{item, value, spec, judgment}]
보관조건	storage_condition	일반 / 냉장 / 차광 / 위험물	✅	-
보관위치	storage_location	VARCHAR		-
보관상태	storage_status	입고 / 시험대기 / 적합보관 / 부적합격리 / 불출중 / 소진 / 반품 / 폐기	✅	-
누적불출수량	dispensed_qty	DECIMAL	✅	-
최종불출일	dispensed_date	DATE		-
입고담당자	receiver_id	UUID	✅	시스템 users 테이블 참조
시험자	tester_id	UUID		시스템 users 테이블 참조
부적합사유	rejection_reason	TEXT		-
처리결정	disposition	반품 / 폐기 / 재시험 / 특채		-
입고검수	receiving_inspection	JSONB		{appearance, quantity, packaging, coa_check}
성적서파일	coa_file_url	FILE		-
비고	remark	TEXT		-

데이터 관계

참조하는 테이블

• 보관검체 (1:N) 원료관리→보관검체

참조받는 테이블

• 원료규격서 (1:N) 원료규격→원료관리
• 직원 (1:N) 직원→원료관리