← 포트폴리오 목록

식품 분석 통합 운영 플랫폼

P1의 핵심 접수 흐름을 넘어, 분석 진행을 칸반 워크플로우 보드로 관제하고 식품규격·시험항목 마스터 관리, 정산·세금계산서 상태관리, 3단계 권한 및 감사이력 체계까지 통합하는 운영 플랫폼입니다.

드래그 상태 전환 낙관적 업데이트 구현dnd-kit 기반 칸반 드래그와 Bull Queue 비동기 상태 반영을 결합, 실패 시 자동 롤백 로직 구축
정산-전달 파생 상태 로직 설계입금확인·예외승인 결과로 성적서 전달 가능 여부를 자동 계산하는 파생 상태 엔진 구현
3단계 RBAC 및 변경이력 추적 체계 구축라우트·API·UI 3중 권한 검증과 변경 전후값을 기록하는 감사 로그 테이블 연동 설계
서비스 타입Web
업종플랫폼
기술 스택
ReactTypeScriptTailwind CSSNode.jsExpressPostgreSQLPrismaRedisBull Queue
주요 기능
  • 분석 진행 워크플로우 보드
  • 식품규격·시험항목 마스터 관리
  • 정산 및 세금계산서 상태관리
  • 권한 관리 및 감사이력
Overview

프로젝트 개요

범위: 개발, 디자인, 기획

P1의 핵심 접수 흐름을 넘어, 분석 진행을 칸반 워크플로우 보드로 관제하고 식품규격·시험항목 마스터 관리, 정산·세금계산서 상태관리, 3단계 권한 및 감사이력 체계까지 통합하는 운영 플랫폼입니다. Redis와 Bull Queue 기반 비동기 처리로 대량 상태 전환을 안정적으로 지원하는 구조로 설계합니다.

작업 범위

  • 분석 진행 워크플로우 보드: 분석담당자가 의뢰 건을 상태별 칸반 컬럼(접수·검토중·보완요청·분석중·분석완료)에서 드래그로 전환하고, 담당자·마감 태그가 카드에 표시됩니다
  • 식품규격·시험항목 마스터 관리: 관리자가 업무구분·식품군·식품유형·규격, 시험항목 코드·명·순서와 매핑 관계를 등록·수정하고 Excel로 일괄 등록합니다
  • 정산 및 세금계산서 상태관리: 입금확인, 세금계산서 발행요청·처리중·발행완료 상태관리와 사전 승인 거래처의 관리자 예외승인을 처리합니다
  • 권한 관리 및 감사이력: 전체관리자·분석담당자·경영지원 3개 역할별 개인 계정을 생성·정지하고, 로그인·상태변경·권한변경 등 중요 이력을 조회합니다

주요 업무

  • 분석 진행 워크플로우 보드 화면: 칸반 컬럼 전환 시 상태 변경 API를 호출하고, 우선순위 매트릭스 패널에서 마감 임박·보완 지연 건을 별도로 강조하는 구조를 구현합니다
  • 식품규격·시험항목 마스터 관리 화면: 의무 시험항목은 삭제가 차단되며, 사용중지 처리 시에도 기존 접수 건의 스냅샷에는 영향을 주지 않도록 마스터와 스냅샷을 분리 관리하는 구조를 구현합니다
  • 정산 및 세금계산서 상태관리 화면: 예외승인은 승인자·일시·사유를 기록하며, 정산 완료 여부에 따라 성적서 전달 가능 상태가 자동으로 갱신되는 파생 상태 구조를 구현합니다
  • 권한 관리 및 감사이력 화면: 역할별 접근 가능 화면·API를 매핑해 라우트·API·UI 3중으로 권한을 검증하며, 감사이력은 변경 전후값을 함께 기록하는 구조를 구현합니다
식품 분석 통합 운영 플랫폼
요구사항 정의

프로젝트 핵심 과제

프로젝트 진행 시 해결한 핵심 기술 과제입니다.

드래그 전환과 서버 상태 반영 사이의 지연을 낙관적 UI로 흡수하면서 실패 시 롤백을 안전하게 처리하는 설계

정산 상태와 성적서 전달 가능 여부를 파생 상태로 자동 연동하면서도 예외승인 케이스를 함께 수용하는 로직

3단계 역할 체계에서 동일 화면의 표시 데이터 범위를 역할별로 필터링하는 접근 제어 설계

Excel 일괄등록 시 대량 시험항목 데이터의 중복·매핑 오류를 사전에 검증하는 처리 구조

구현 내용

핵심 기능 상세

핵심 기능 1

분석 진행 워크플로우 보드

분석담당자가 의뢰 건을 상태별 칸반 컬럼(접수·검토중·보완요청·분석중·분석완료)에서 드래그로 전환하고, 담당자·마감 태그가 카드에 표시됩니다.

  • dnd-kit(드래그 앤 드롭 라이브러리) 기반으로 칸반 카드 상태 전환과 낙관적 UI 업데이트 구현
  • 컬럼별 카운트 배지와 우선순위 매트릭스(마감 임박×보완 지연)를 결합한 필터 패널 설계
  • 카드 메타(담당자 아바타·태그·마감일)를 재사용 가능한 컴포넌트로 추상화

드래그 전환과 서버 상태 동기화를 낙관적 업데이트로 결합하고, 우선순위 매트릭스로 마감 임박 건을 자동 강조하는 관제 구조를 설계합니다.

분석 진행 워크플로우 보드
분석 진행 워크플로우 보드 실제 화면
핵심 기능 2

식품규격·시험항목 마스터 관리

관리자가 업무구분·식품군·식품유형·규격, 시험항목 코드·명·순서와 매핑 관계를 등록·수정하고 Excel로 일괄 등록합니다.

  • Excel 업로드 파싱 후 마스터 데이터 일괄 등록 및 사전 검증(중복·누락 항목) 로직 구현
  • 의무 시험항목 삭제 방지 제약과 사용중지(soft-delete) 처리를 분리한 마스터 관리 구조 설계
  • 식품군-식품유형-규격-시험항목 4단계 매핑 관계를 트리 구조 UI로 표현

마스터 데이터의 등록·수정·사용중지를 접수 건 스냅샷과 완전히 분리해, 마스터 변경이 기존 접수에 영향을 주지 않는 구조를 구현합니다.

식품규격·시험항목 마스터 관리
식품규격·시험항목 마스터 관리 실제 화면
핵심 기능 3

정산 및 세금계산서 상태관리

입금확인, 세금계산서 발행요청·처리중·발행완료 상태관리와 사전 승인 거래처의 관리자 예외승인을 처리합니다.

  • 입금확인·세금계산서 상태(발행요청/처리중/발행완료)를 상태 머신으로 관리하는 정산 모듈 구현
  • 사전 승인 거래처 목록 기반 관리자 예외승인 처리, 승인자·일시·사유 감사 로그 연동
  • 정산 완료 여부에 따라 성적서 전달 가능 플래그를 자동 계산하는 파생 상태 로직 구현

정산 상태와 성적서 전달 가능 여부를 파생 상태로 연동해, 미정산 건의 성적서 오전달을 구조적으로 방지하는 로직을 구현합니다.

정산 및 세금계산서 상태관리
정산 및 세금계산서 상태관리 실제 화면
핵심 기능 4

권한 관리 및 감사이력

전체관리자·분석담당자·경영지원 3개 역할별 개인 계정을 생성·정지하고, 로그인·상태변경·권한변경 등 중요 이력을 조회합니다.

  • 역할 기반 접근 제어(RBAC) 미들웨어로 라우트·API·UI 요소 3중 권한 검증 구현
  • 감사 로그 테이블에 액션 유형·변경 전후값·수행자·일시를 함께 기록하는 구조 설계
  • 역할별 대시보드 뷰 필터링으로 동일 화면에서도 표시 데이터 범위를 제한

3단계 역할 체계와 변경 전후값을 함께 남기는 감사 로그 구조를 결합해, 누가 언제 무엇을 바꿨는지 추적 가능한 운영 체계를 구현합니다.

권한 관리 및 감사이력
권한 관리 및 감사이력 실제 화면
구현 과정

프로젝트 진행 단계

STEP 1

운영 데이터 모델 확장 및 마스터 스키마 설계 · 2026.09

식품규격·시험항목 매핑 테이블, 정산·감사로그 스키마 확장 설계

STEP 2

칸반 워크플로우 및 상태 전환 API 개발 · 2026.09

Bull Queue 기반 상태 전이 이벤트 처리, 드래그 전환 API 12개 구현

STEP 3

마스터·정산 관리자 UI 개발 · 2026.09

Excel 일괄등록, 정산 승인, 감사이력 조회 화면 6개 구현

STEP 4

RBAC 권한 체계 및 감사 로그 통합 · 2026.09

3단계 역할 미들웨어, 변경 전후값 감사 로그 테이블 연동

STEP 5

운영 부하 테스트 및 큐 안정화 · 2026.09

Redis 캐시·Bull Queue 재시도 정책 점검, 동시 상태변경 부하 테스트

프로젝트 성과

주요 성과

드래그 상태 전환 낙관적 업데이트 구현dnd-kit 기반 칸반 드래그와 Bull Queue 비동기 상태 반영을 결합, 실패 시 자동 롤백 로직 구축
정산-전달 파생 상태 로직 설계입금확인·예외승인 결과로 성적서 전달 가능 여부를 자동 계산하는 파생 상태 엔진 구현
3단계 RBAC 및 변경이력 추적 체계 구축라우트·API·UI 3중 권한 검증과 변경 전후값을 기록하는 감사 로그 테이블 연동 설계
마스터-스냅샷 분리 아키텍처 확장Excel 일괄등록·사용중지 처리를 포함한 마스터 관리와 접수 스냅샷을 완전히 분리하는 구조 확장
Highlights

기술적 주안점

  • 드래그 전환과 서버 상태 동기화를 낙관적 업데이트로 결합하고, 우선순위 매트릭스로 마감 임박 건을 자동 강조하는 관제 구조를 설계합니다
  • 마스터 데이터의 등록·수정·사용중지를 접수 건 스냅샷과 완전히 분리해, 마스터 변경이 기존 접수에 영향을 주지 않는 구조를 구현합니다
  • 정산 상태와 성적서 전달 가능 여부를 파생 상태로 연동해, 미정산 건의 성적서 오전달을 구조적으로 방지하는 로직을 구현합니다

유사한 프로젝트를 기획하고 계신가요?

FIRSTPIP이 개발 범위와 로드맵을 함께 정리해드립니다

무료 상담 시작하기