원료규격 관리
개요
이 화면은 무엇인가요? 원료규격서를 체계적으로 등록하고 관리하는 목록 화면입니다. 이 기록은 ISO 22716 (화장품 GMP) 요구사항을 충족합니다.
누가 사용하나요?
- 🔬 품질팀: 원료 규격·시험 데이터를 관리합니다
- 📦 구매팀: 입고 정보를 확인합니다
- 📊 QA팀: 시험 결과를 검토·승인합니다
언제 사용하나요?
- 원료 입고·시험·불출 시
- 규격서 등록 또는 개정 시
- 공급업체 관리 시
주요 기능
1. 원료규격서 등록 및 관리
무엇을 하나요?: 원료규격서 정보를 등록하고 상태를 관리합니다.
어떻게 사용하나요?:
- 화면에서 새로 만들기 버튼을 선택합니다
- 필수 항목을 입력합니다
- 관련 정보를 추가 입력합니다
- 저장 버튼을 클릭합니다
💡 팁: 필수 항목(✅ 표시)을 모두 입력해야 저장이 가능합니다.
업무 흐름에서의 위치
입력 항목 가이드
| 항목 | 의미 | 타입 | 필수 | 왜 필요한가 |
|---|---|---|---|---|
| 규격서코드 | spec_code | VARCHAR | ✅ | - |
| 원료명 | material_name | VARCHAR | ✅ | - |
| INCI명 | inci_name | VARCHAR | 국제화장품원료명명법 | |
| CAS번호 | cas_number | VARCHAR | - | |
| 원료분류 | material_category | 주원료 / 부원료 / 보존제 / 향료 / 색소 / 자외선차단제 / 기능성원료 / 포장자재 | ✅ | - |
| 규제유형 | restricted_type | 일반 / 사용제한 / 사용금지 / 기능성원료 | ✅ | - |
| 사용한도(%) | usage_limit | DECIMAL | - | |
| 사용한도비고 | usage_limit_note | VARCHAR | - | |
| 규격항목 | spec_items | JSONB | ✅ | [{item, unit, spec_lower, spec_upper, method}] |
| 외관규격 | appearance_spec | VARCHAR | - | |
| 미생물규격 | microbial_spec | JSONB | {total_aerobic, yeast_mold, ecoli, pseudomonas, staphylococcus} | |
| 중금속규격 | heavy_metal_spec | JSONB | {pb, as, hg, cd, sb} (ug/g) | |
| 보관조건 | storage_condition | 일반 / 냉장 / 차광 / 위험물 | ✅ | - |
| 보관온도하한 | storage_temp_min | DECIMAL | - | |
| 보관온도상한 | storage_temp_max | DECIMAL | - | |
| 유효기한(월) | shelf_life_months | INT | - | |
| 주공급업체 | supplier_name | VARCHAR | - | |
| 공급업체코드 | supplier_code | VARCHAR | - | |
| 공급업체ID | supplier_id | UUID | suppliers 테이블 참조 (supplier_name 표시) | |
| 알레르기정보 | allergen_info | TEXT | - | |
| MSDS보유 | msds_available | BOOLEAN | ✅ | - |
| MSDS파일 | msds_file_url | FILE | - | |
| 버전 | version | VARCHAR | ✅ | - |
| 상태 | status | 유효 / 개정중 / 폐기 | ✅ | - |
| 시행일 | effective_date | DATE | - | |
| 비고 | remark | TEXT | - |
자주 묻는 질문 (FAQ)
Q. 이 화면의 데이터는 어떤 인증 심사에서 활용되나요?
ISO 22716 (화장품 GMP) 인증 심사, KGMP 자체점검, 거래처 감사 시 이 화면의 데이터가 증적 자료로 활용됩니다. 감사 추적(Audit Trail) 기능이 활성화되어 있으므로 데이터 변경 이력도 함께 제출할 수 있습니다.
Q. 데이터를 수정하면 이력이 남나요?
네, 이 화면은 감사 추적(Audit Trail) 기능이 활성화되어 있어 모든 변경 이력이 자동으로 기록됩니다. 수정 전/후 값, 수정자, 수정일시가 기록되어 규정 준수를 위한 증적으로 활용됩니다.
실무 시나리오
시나리오: 원료규격 관리 신규 등록
원료규격 관리 업무를 수행하기 위해 새 데이터를 등록합니다.
- 원료규격 관리 화면에서 새로 만들기를 선택합니다
- 필수 항목을 입력합니다
- 관련 참조 데이터를 선택합니다
- 입력 내용을 확인하고 저장합니다
- 필요 시 상태를 변경하고 후속 프로세스를 진행합니다
📋 기술 참고 정보 (개발자/관리자용)
테이블 정보
raw_material_specs 테이블은 이 화면의 데이터를 저장합니다.
테이블 특성:
- 감사 추적 활성화
- CSV 가져오기 지원
- CSV 내보내기 지원
- 인쇄 기능 지원
입력 항목 상세
| 항목 | 의미 | 타입 | 필수 | 왜 필요한가 |
|---|---|---|---|---|
| 규격서코드 | spec_code | VARCHAR | ✅ | - |
| 원료명 | material_name | VARCHAR | ✅ | - |
| INCI명 | inci_name | VARCHAR | 국제화장품원료명명법 | |
| CAS번호 | cas_number | VARCHAR | - | |
| 원료분류 | material_category | 주원료 / 부원료 / 보존제 / 향료 / 색소 / 자외선차단제 / 기능성원료 / 포장자재 | ✅ | - |
| 규제유형 | restricted_type | 일반 / 사용제한 / 사용금지 / 기능성원료 | ✅ | - |
| 사용한도(%) | usage_limit | DECIMAL | - | |
| 사용한도비고 | usage_limit_note | VARCHAR | - | |
| 규격항목 | spec_items | JSONB | ✅ | [{item, unit, spec_lower, spec_upper, method}] |
| 외관규격 | appearance_spec | VARCHAR | - | |
| 미생물규격 | microbial_spec | JSONB | {total_aerobic, yeast_mold, ecoli, pseudomonas, staphylococcus} | |
| 중금속규격 | heavy_metal_spec | JSONB | {pb, as, hg, cd, sb} (ug/g) | |
| 보관조건 | storage_condition | 일반 / 냉장 / 차광 / 위험물 | ✅ | - |
| 보관온도하한 | storage_temp_min | DECIMAL | - | |
| 보관온도상한 | storage_temp_max | DECIMAL | - | |
| 유효기한(월) | shelf_life_months | INT | - | |
| 주공급업체 | supplier_name | VARCHAR | - | |
| 공급업체코드 | supplier_code | VARCHAR | - | |
| 공급업체ID | supplier_id | UUID | suppliers 테이블 참조 (supplier_name 표시) | |
| 알레르기정보 | allergen_info | TEXT | - | |
| MSDS보유 | msds_available | BOOLEAN | ✅ | - |
| MSDS파일 | msds_file_url | FILE | - | |
| 버전 | version | VARCHAR | ✅ | - |
| 상태 | status | 유효 / 개정중 / 폐기 | ✅ | - |
| 시행일 | effective_date | DATE | - | |
| 비고 | remark | TEXT | - |
데이터 관계
참조하는 테이블
- 원료관리 (1:N) 원료규격→원료관리
- 품질시험기록 (1:N) 원료규격→품질시험
화면 설정
목록 컬럼
| 컬럼 | 렌더링 | 고정 | 정렬 |
|---|---|---|---|
| 규격서코드 | link | - | ✅ |
| 원료명 | 기본 | - | ✅ |
| 원료분류 | tag | - | ✅ |
| INCI명 | 기본 | - | ✅ |
| CAS번호 | 기본 | - | ✅ |
| 규제유형 | tag | - | ✅ |
| 상태 | badge | - | ✅ |
필터 설정
| 필드 | 필터유형 |
|---|---|
| 규격서코드 | search |
| 원료분류 | select |
| 상태 | select |