포장관리
개요
이 화면은 무엇인가요? 포장관리를 체계적으로 등록하고 관리하는 목록 화면입니다. 이 기록은 ISO 22716 제11장(완제품) 및 화장품법 시행규칙 제19조(표시기준) 요구사항을 충족합니다.
누가 사용하나요?
- 📦 포장팀: 포장 품질을 검사하고 기록합니다
- 🏷️ QA팀: 표시사항 적합성을 검증합니다
- 📊 품질팀: 포장재 규격을 관리합니다
언제 사용하나요?
- 포장 공정 완료 후 품질 검사 시
- 표시사항(전성분, 기능성) 검증 시
- 포장재 규격 등록·개정 시
주요 기능
1. 포장관리 등록 및 관리
무엇을 하나요?: 포장관리 정보를 등록하고 상태를 관리합니다.
어떻게 사용하나요?:
- 화면에서 새로 만들기 버튼을 선택합니다
- 필수 항목을 입력합니다
- 관련 정보를 추가 입력합니다
- 저장 버튼을 클릭합니다
💡 팁: 필수 항목(✅ 표시)을 모두 입력해야 저장이 가능합니다.
업무 흐름에서의 위치
입력 항목 가이드
| 항목 | 의미 | 타입 | 필수 | 왜 필요한가 |
|---|---|---|---|---|
| 포장관리코드 | packaging_code | VARCHAR | ✅ | - |
| BMR | bmr_id | UUID | ✅ | batch_manufacturing_records 테이블 참조 (bmr_code 표시) |
| 제품명 | product_name | VARCHAR | ✅ | - |
| 제품코드 | product_code | VARCHAR | - | |
| 배치번호 | batch_number | VARCHAR | ✅ | - |
| 포장일자 | packaging_date | DATE | ✅ | - |
| 포장유형 | packaging_type | 1차포장 / 2차포장 | ✅ | - |
| 용기유형 | container_type | 병 / 튜브 / 파우치 / 에어리스 / 앰플 / 단상자 | ✅ | - |
| 목표내용량 | fill_volume_target | DECIMAL | ✅ | - |
| 실측내용량 | fill_volume_actual | DECIMAL | ✅ | - |
| 내용량단위 | fill_volume_unit | VARCHAR | ✅ | - |
| 내용량판정 | fill_volume_check | 적합 / 부적합 | ✅ | - |
| 기밀성판정 | seal_integrity | 적합 / 부적합 | ✅ | - |
| 기밀시험방법 | seal_test_method | VARCHAR | - | |
| 이물판정 | foreign_matter | 적합 / 부적합 | ✅ | - |
| 외관판정 | appearance_check | 적합 / 부적합 | ✅ | - |
| 캡토크판정 | cap_torque_check | 적합 / 부적합 / 해당없음 | ✅ | - |
| 캡토크측정값 | cap_torque_value | DECIMAL | - | |
| 시료크기 | sample_size | INT | ✅ | - |
| 불량수 | defect_count | INT | ✅ | - |
| 불량률(%) | defect_rate | DECIMAL | ✅ | 자동 계산: defect_count / sample_size * 100 |
| 불량상세 | defect_detail | JSONB | [{type, count, description}] | |
| 종합판정 | overall_judgment | 적합 / 부적합 / 조건부적합 | ✅ | - |
| 작업자 | operator_id | UUID | ✅ | 시스템 users 테이블 참조 |
| QA검토자 | qa_reviewer_id | UUID | 시스템 users 테이블 참조 | |
| 검토일 | review_date | DATE | - | |
| 포장라인 | line_id | VARCHAR | - | |
| 비고 | remark | TEXT | - | |
| 첨부파일 | attachment | FILE | - | |
| 상태 | status | 점검중 / 완료 / 반려 | ✅ | - |
| 메타데이터 | metadata | JSONB | - |
자주 묻는 질문 (FAQ)
Q. 이 화면의 데이터는 어떤 인증 심사에서 활용되나요?
ISO 22716 (화장품 GMP) 인증 심사, KGMP 자체점검, 거래처 감사 시 이 화면의 데이터가 증적 자료로 활용됩니다. 감사 추적(Audit Trail) 기능이 활성화되어 있으므로 데이터 변경 이력도 함께 제출할 수 있습니다.
Q. 데이터를 수정하면 이력이 남나요?
네, 이 화면은 감사 추적(Audit Trail) 기능이 활성화되어 있어 모든 변경 이력이 자동으로 기록됩니다. 수정 전/후 값, 수정자, 수정일시가 기록되어 규정 준수를 위한 증적으로 활용됩니다.
실무 시나리오
시나리오: 포장관리 신규 등록
포장관리 업무를 수행하기 위해 새 데이터를 등록합니다.
- 포장관리 화면에서 새로 만들기를 선택합니다
- 필수 항목을 입력합니다
- 관련 참조 데이터를 선택합니다
- 입력 내용을 확인하고 저장합니다
- 필요 시 상태를 변경하고 후속 프로세스를 진행합니다
📋 기술 참고 정보 (개발자/관리자용)
테이블 정보
packaging_controls 테이블은 이 화면의 데이터를 저장합니다.
테이블 특성:
- 사용자 연결 (created_by, updated_by 자동 생성)
- 감사 추적 활성화
- CSV 가져오기 지원
- CSV 내보내기 지원
- 인쇄 기능 지원
입력 항목 상세
| 항목 | 의미 | 타입 | 필수 | 왜 필요한가 |
|---|---|---|---|---|
| 포장관리코드 | packaging_code | VARCHAR | ✅ | - |
| BMR | bmr_id | UUID | ✅ | batch_manufacturing_records 테이블 참조 (bmr_code 표시) |
| 제품명 | product_name | VARCHAR | ✅ | - |
| 제품코드 | product_code | VARCHAR | - | |
| 배치번호 | batch_number | VARCHAR | ✅ | - |
| 포장일자 | packaging_date | DATE | ✅ | - |
| 포장유형 | packaging_type | 1차포장 / 2차포장 | ✅ | - |
| 용기유형 | container_type | 병 / 튜브 / 파우치 / 에어리스 / 앰플 / 단상자 | ✅ | - |
| 목표내용량 | fill_volume_target | DECIMAL | ✅ | - |
| 실측내용량 | fill_volume_actual | DECIMAL | ✅ | - |
| 내용량단위 | fill_volume_unit | VARCHAR | ✅ | - |
| 내용량판정 | fill_volume_check | 적합 / 부적합 | ✅ | - |
| 기밀성판정 | seal_integrity | 적합 / 부적합 | ✅ | - |
| 기밀시험방법 | seal_test_method | VARCHAR | - | |
| 이물판정 | foreign_matter | 적합 / 부적합 | ✅ | - |
| 외관판정 | appearance_check | 적합 / 부적합 | ✅ | - |
| 캡토크판정 | cap_torque_check | 적합 / 부적합 / 해당없음 | ✅ | - |
| 캡토크측정값 | cap_torque_value | DECIMAL | - | |
| 시료크기 | sample_size | INT | ✅ | - |
| 불량수 | defect_count | INT | ✅ | - |
| 불량률(%) | defect_rate | DECIMAL | ✅ | 자동 계산: defect_count / sample_size * 100 |
| 불량상세 | defect_detail | JSONB | [{type, count, description}] | |
| 종합판정 | overall_judgment | 적합 / 부적합 / 조건부적합 | ✅ | - |
| 작업자 | operator_id | UUID | ✅ | 시스템 users 테이블 참조 |
| QA검토자 | qa_reviewer_id | UUID | 시스템 users 테이블 참조 | |
| 검토일 | review_date | DATE | - | |
| 포장라인 | line_id | VARCHAR | - | |
| 비고 | remark | TEXT | - | |
| 첨부파일 | attachment | FILE | - | |
| 상태 | status | 점검중 / 완료 / 반려 | ✅ | - |
| 메타데이터 | metadata | JSONB | - |
데이터 관계
참조받는 테이블
- 제조지시/기록서(BMR) (1:N) BMR→포장관리
- 직원 (1:N) 직원→포장관리
- 포장재 규격서 (1:N) 포장재규격→포장관리
화면 설정
목록 컬럼
| 컬럼 | 렌더링 | 고정 | 정렬 |
|---|---|---|---|
| 포장관리코드 | link | - | ✅ |
| 제품명 | 기본 | - | ✅ |
| 배치번호 | 기본 | - | ✅ |
| 포장유형 | tag | - | ✅ |
| 포장일자 | date | - | ✅ |
| 종합판정 | badge | - | ✅ |
| 상태 | tag | - | ✅ |
필터 설정
| 필드 | 필터유형 |
|---|---|
| 포장관리코드 | search |
| 포장유형 | select |
| 종합판정 | select |
| 포장일자 | dateRange |