검체등록 관리
개요
이 화면은 무엇인가요? 검체등록를 체계적으로 등록하고 관리하는 목록 화면입니다. 이 기록은 ISO 17025 (시험·교정기관 적격성) 요구사항을 충족합니다.
누가 사용하나요?
- 🧪 시료관리자: 검체를 접수하고 이력을 관리합니다
- 🔬 시험분석자: 검체를 확인하고 시험을 수행합니다
- 📊 QC관리자: 검체 상태를 모니터링합니다
언제 사용하나요?
- 시료 접수 및 등록 시
- 검체 이관·보관·폐기 시
- 시험의뢰와 연계하여 검체를 확인할 때
주요 기능
1. 검체등록 등록 및 관리
무엇을 하나요?: 검체등록 정보를 등록하고 상태를 관리합니다.
어떻게 사용하나요?:
- 화면에서 새로 만들기 버튼을 선택합니다
- 필수 항목을 입력합니다
- 관련 정보를 추가 입력합니다
- 저장 버튼을 클릭합니다
💡 팁: 필수 항목(✅ 표시) 을 모두 입력해야 저장이 가능합니다.
업무 흐름에서의 위치
입력 항목 가이드
| 항목 | 의미 | 타입 | 필수 | 왜 필요한가 |
|---|---|---|---|---|
| 검체코드 | sample_code | VARCHAR | ✅ | - |
| 검체명 | sample_name | VARCHAR | ✅ | - |
| 검체유형 | sample_type | 원료 / 제품 / 환경 / 공정 / 안정성 | ✅ | - |
| 검체출처 | source | VARCHAR | - | |
| LOT번호 | lot_number | VARCHAR | - | |
| 우선순위 | priority | 긴급 / 높음 / 보통 / 낮음 | ✅ | - |
| 상태 | status | 접수 / 전처리 / 시험중 / 완료 / 보류 / 폐기 | ✅ | - |
| 접수일 | received_date | DATE | ✅ | - |
| 접수자ID | received_by_id | UUID | 시스템 users 테이블 참조 | |
| 의뢰부서ID | department_id | UUID | 시스템 departments 테이블 참조 | |
| 보관조건 | storage_condition | 실온 / 냉장 / 냉동 / 암소 | - | |
| 검체수량 | quantity | DECIMAL | - | |
| 단위 | unit | VARCHAR | - | |
| 비고 | remark | TEXT | - | |
| 품목ID | product_id | UUID | items 테이블 참조 (item_name 표시) | |
| 작업지시ID | wo_id | UUID | work_orders 테이블 참조 (wo_number 표시) | |
| 시료사진 | sample_photos | FILE | 시료 수령 상태 사진 |
자주 묻는 질문 (FAQ)
Q. 이 화면의 데이터는 어떤 인증 심사에서 활용되나요?
ISO 17025 인증 심사, GLP/GMP 실사, KOLAS 심사 시 이 화면의 데이터가 증적 자료로 활용됩니다. ALCOA+ 원칙에 따른 데이터 무결성이 보장됩니다.
Q. 데이터를 수정하면 이력이 남나요?
네, 이 화면은 감사 추적(Audit Trail) 기능이 활성화되어 있어 모든 변경 이력이 자동으로 기록됩니다. 수정 전/후 값, 수정자, 수정일시가 기록되어 규정 준수를 위한 증적으로 활용됩니다.
실무 시나리오
시나리오: 검체등록 관리 신규 등록
검체등록 관리 업무를 수행하기 위해 새 데이터를 등록합니다.
- 검체등록 관리 화면에서 새로 만들기를 선택합니다
- 필수 항목을 입력합니다
- 관련 참조 데이터를 선택합니다
- 입력 내용을 확인하고 저장합니다
- 필요 시 상태를 변경하고 후속 프로세스를 진행합니다
📋 기술 참고 정보 (개발자/관리자용)
테이블 정보
lims_sample_registry 테이블은 이 화면의 데이터를 저장합니다.
테이블 특성:
- 사용자 연결 (created_by, updated_by 자동 생성)
- 감사 추적 활성화
- 인쇄 기능 지원
입력 항목 상세
| 항목 | 의미 | 타입 | 필수 | 왜 필요한가 |
|---|---|---|---|---|
| 검체코드 | sample_code | VARCHAR | ✅ | - |
| 검체명 | sample_name | VARCHAR | ✅ | - |
| 검체유형 | sample_type | 원료 / 제품 / 환경 / 공정 / 안정성 | ✅ | - |
| 검체출처 | source | VARCHAR | - | |
| LOT번호 | lot_number | VARCHAR | - | |
| 우선순위 | priority | 긴급 / 높음 / 보통 / 낮음 | ✅ | - |
| 상태 | status | 접수 / 전처리 / 시험중 / 완료 / 보류 / 폐기 | ✅ | - |
| 접수일 | received_date | DATE | ✅ | - |
| 접수자ID | received_by_id | UUID | 시스템 users 테이블 참조 | |
| 의뢰부서ID | department_id | UUID | 시스템 departments 테이블 참조 | |
| 보관조건 | storage_condition | 실온 / 냉장 / 냉동 / 암소 | - | |
| 검체수량 | quantity | DECIMAL | - | |
| 단위 | unit | VARCHAR | - | |
| 비고 | remark | TEXT | - | |
| 품목ID | product_id | UUID | items 테이블 참조 (item_name 표시) | |
| 작업지시ID | wo_id | UUID | work_orders 테이블 참조 (wo_number 표시) | |
| 시료사진 | sample_photos | FILE | 시료 수령 상태 사진 |
데이터 관계
참조하는 테이블
- 검체이력추적 (1:N) 검체→이력추적
- 시험의뢰 (1:N) 검체→시험의뢰
- QC배치 (1:N) 검체→QC배치
- 기기 원시데이터 (1:N) 검체→기기원시데이터
- 전자실험노트 (1:N) 검체→전자실험노트
참조받는 테이블
- 직원 (1:N) 직원→검체등록(접수자)
- 부서 (1:N) 부서→검체등록(의뢰부서)
화면 설정
목록 컬럼
| 컬럼 | 렌더링 | 고정 | 정렬 |
|---|---|---|---|
| 검체코드 | link | - | ✅ |
| 검체명 | 기본 | - | ✅ |
| 검체유형 | tag | - | ✅ |
| LOT번호 | 기본 | - | ✅ |
| 우선순위 | badge | - | ✅ |
| 상태 | badge | - | ✅ |
| 접수일 | date | - | ✅ |
| 접수자ID | 기본 | - | ✅ |
필터 설정
| 필드 | 필터유형 |
|---|---|
| 검체코드 | search |
| 검체유형 | select |
| 상태 | select |
| 접수일 | dateRange |
폼 구성
검체정보
| 필드 | 필수 | 읽기전용 | 비고 |
|---|---|---|---|
| 검체코드 | ✅ | ||
| 검체명 | ✅ | ||
| 검체유형 | ✅ | ||
| 검체출처 | |||
| LOT번호 | |||
| 우선순위 |
접수정보
| 필드 | 필수 | 읽기전용 | 비고 |
|---|---|---|---|
| 접수일 | ✅ | ||
| 접수자ID | |||
| 의뢰부서ID | |||
| 상태 |
보관정보
| 필드 | 필수 | 읽기전용 | 비고 |
|---|---|---|---|
| 보관조건 | |||
| 검체수량 | |||
| 단위 |
비고
| 필드 | 필수 | 읽기전용 | 비고 |
|---|---|---|---|
| 비고 |
첨부파일
| 필드 | 필수 | 읽기전용 | 비고 |
|---|---|---|---|
| 시료사진 |
폼 구성
검체정보
| 필드 | 필수 | 읽기전용 | 비고 |
|---|---|---|---|
| 검체코드 | ✅ | ||
| 검체명 | ✅ | ||
| 검체유형 | ✅ | ||
| 검체출처 | |||
| LOT번호 | |||
| 우선순위 |
접수정보
| 필드 | 필수 | 읽기전용 | 비고 |
|---|---|---|---|
| 접수일 | ✅ | ||
| 접수자ID | |||
| 의뢰부서ID | |||
| 상태 |
보관정보
| 필드 | 필수 | 읽기전용 | 비고 |
|---|---|---|---|
| 보관조건 | |||
| 검체수량 | |||
| 단위 |
비고
| 필드 | 필수 | 읽기전용 | 비고 |
|---|---|---|---|
| 비고 |
첨부파일
| 필드 | 필수 | 읽기전용 | 비고 |
|---|---|---|---|
| 시료사진 |