식품 시료 분석 의뢰관리 시스템

관리자가 접수된 의뢰 목록을 좌측 리스트에서 검색·필터링하고, 우측 상세 패널에서 시료 정보·시험항목·첨부파일·상태 이력을 한 화면에서 확인합니다.

• React Query로 의뢰 목록·상세 데이터를 분리 캐싱하여 상세 패널 전환 시 재요청을 최소화하는 구조 구현
• PostgreSQL 인덱스 설계로 접수번호·기관명·상태·담당자 복합 검색 쿼리를 최적화
• 상태 변경 시 감사 로그 테이블에 변경 전후값을 함께 기록하는 트리거 구조 설계

리스트-상세 동기화 상태 관리와 상태 전이(state machine) 검증 로직을 함께 구현하여, 정의되지 않은 순서로의 상태 변경을 서버 단에서 차단하는 구조를 설계합니다.

고객이 의뢰기관·의뢰자 정보, 시료명·수량, 검사 업무구분, 식품규격·시험항목, 첨부파일(최대 20MB·5개)을 단계별 폼으로 입력하고 제출합니다.

• React Hook Form과 Zod로 단계별 유효성 검증 및 다중 파일 업로드(최대 20MB·5개) 처리 구현
• 식품규격 선택 시 시험항목 마스터를 자동 조회해 관련 항목만 노출하는 종속 셀렉트 구현
• 제출 시점의 규격·시험항목 스냅샷을 별도 테이블에 저장해 이후 마스터 변경과 분리하는 구조 설계

식품규격·시험항목 마스터를 참조하는 동적 폼 엔진을 구현하여, 항목 추가·변경 시 폼 코드 수정 없이 마스터 데이터만으로 화면이 갱신되는 구조를 설계합니다.

접수번호와 이메일로 본인확인 후, 분석·정산·전달 상태와 이메일 발송일시·우편 등기번호·방문수령 가능일을 조회합니다.

• 접수번호와 이메일 조합으로 일회용 인증번호(OTP)를 발급·검증하는 비회원 인증 플로우 구현
• 상태 이력을 타임라인 컴포넌트로 시각화하여 단계별 타임스탬프와 발송 채널을 표시
• 보완요청 상태 감지 시 보완자료 제출 화면으로 라우팅하는 조건부 네비게이션 구현

회원가입 없이도 접수번호와 이메일만으로 안전하게 본인확인을 처리하는 OTP 인증 플로우를 구현하여, 비회원 조회의 보안성과 편의성을 함께 확보하는 구조를 설계합니다.

관리자가 확정 성적서 PDF를 업로드하고 수신정보를 확인한 뒤 발송을 실행하면, 이메일 첨부 발송과 발송 이력이 자동 기록됩니다.

• PDF 업로드 후 관리자 확인 단계를 거치는 2단계 발송 워크플로우(업로드→확인→발송) 구현
• 이메일 발송 API 연동과 발송 이력 테이블(일시·주소·성공·거부·반송) 설계
• 발송 실패·반송 건을 사유별로 자동 분류해 재발송 큐에 노출하는 로직 구현

업로드 즉시 자동발송하지 않고 관리자 확인을 거치는 2단계 발송 구조와, 발송 실패 건을 자동 분류하는 재발송 큐를 함께 구현하여 오발송 리스크를 관리 가능한 구조로 설계합니다.