소모품 발주·거래처 통합관제 시스템

오늘의 주문·출고·재고부족 현황을 상단 상태바로 즉시 확인하고, 진행 중인 주문 타임라인과 우선 대응이 필요한 항목 큐를 한 화면에서 살펴볼 수 있는 관제 홈입니다.

• React Query로 상태바·타임라인·우선큐 3개 위젯의 서버 상태를 독립 캐싱, staleTime 30초로 실시간감 유지
• PostgreSQL 집계 쿼리를 Materialized View로 미리 계산하여 상태바 인라인 지표 조회 구조 설계
• 우선순위 레일은 재고 임계치·발송 마감일 기준 정렬 알고리즘을 서버 사이드 정렬 API로 구현

카드 행 나열 대신 상태바·타임라인·우선순위 레일 3단 레이아웃으로 재구성해 운영자가 스크롤 없이 오늘 처리할 항목을 즉시 파악할 수 있는 관제 UX를 구현합니다.

거래처 정보를 등록·검색하고, 소모품 품목별 단가를 버전 관리하여 거래처마다 다른 단가 정책을 적용할 수 있습니다.

• Prisma 스키마에 품목-단가 이력 테이블을 별도 설계해 시점별 단가 조회를 지원
• 거래처 검색은 Debounced input + 서버 사이드 페이지네이션으로 대량 거래처 목록 처리
• 품목 카탈로그는 카테고리 트리 구조로 설계해 소모품 분류 체계를 반영

단가를 고정값이 아닌 이력(effective_date) 구조로 설계하여 거래처별 협상 단가 변경 시에도 과거 문서의 단가 정합성을 보장하는 구조를 구현합니다.

전화·문자로 접수한 주문을 폼에 기록하고, 접수부터 출고 완료까지 상태를 추적하며 실시간 재고 수량과 연동해 재고 부족 주문을 자동 식별합니다.

• 주문 접수 폼은 React Hook Form + Zod 스키마 검증으로 필수값·품목 조합 유효성 확보
• 출고 처리는 PostgreSQL 트랜잭션으로 재고 차감과 주문 상태 변경을 원자적으로 묶어 처리
• 재고 부족 임계치 이하 품목은 백그라운드 배치로 감지해 우선순위 레일에 자동 노출

출고 처리와 재고 차감을 하나의 DB 트랜잭션으로 묶어, 여러 주문이 동시에 같은 품목을 출고 처리해도 재고 수량이 음수로 떨어지지 않는 동시성 제어 구조를 구현합니다.

주문·품목 데이터를 기반으로 견적서와 거래명세서를 PDF 템플릿으로 즉시 생성하고, 거래처 이메일 또는 문자로 자동 발송하며 발송 이력을 관리합니다.

• PDFKit 기반 견적서/거래명세서 템플릿 엔진 구현, 품목 테이블 행 수에 따라 자동 페이지 분할
• Nodemailer로 이메일 발송, 문자 발송은 별도 API 모듈로 추상화해 발송 채널 확장 가능하게 설계
• 문서 발송 이력 테이블에 발송 상태(성공/실패/대기)를 기록해 재발송 UI에서 참조

견적서·거래명세서 생성부터 이메일·문자 발송까지를 하나의 발행 플로우로 묶고, 발송 실패 건은 자동 재시도 큐에 적재하는 문서 발행 자동화 구조를 구현합니다.