비철금속 B2B 거래 운영 플랫폼

비철금속 거래마켓 MVP 이후, 운영자가 신규문의부터 정산완료까지 12단계 거래 상태와 물류·계근·검수·정산을 반자동으로 처리하는 백오피스 확장 플랫폼을 React + Node.js 기반으로 설계·구현합니다.

12단계 상태 머신 및 변경이력 설계순차 전이만 허용하는 Enum 상태 머신 구현, 변경자·시간·이전상태 기록 테이블 별도 설계

정산 자동 계산 로직 구현계근중량×확정단가 계산식을 서버 단일 소스로 관리, 입금·지급 상태 분리 추적 구조 설계

증빙자료 업로드 검증 파이프라인 구축S3 Presigned URL 업로드 구현, 단계별 필수 증빙 누락 시 상태 전환을 차단하는 서버 검증 적용

서비스 타입Web

업종물류 시스템

기술 스택

ReactTypeScriptTailwind CSSNode.jsExpressPostgreSQLPrismaRedisRecharts

주요 기능

운영자 통합 현황판
12단계 거래 상태 관리
물류·계근·검수 관리
정산 관리 및 자동 계산

Overview

프로젝트 개요

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

비철금속 거래마켓 MVP 이후, 운영자가 신규문의부터 정산완료까지 12단계 거래 상태와 물류·계근·검수·정산을 반자동으로 처리하는 백오피스 확장 플랫폼을 React + Node.js 기반으로 설계·구현합니다. 칸반 보드형 상태 관리와 정산 자동 계산을 핵심으로 합니다.

요구사항 정의

프로젝트 핵심 과제

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

12단계 상태 전이 중 일부 단계를 건너뛰거나 되돌리려는 예외 상황을 서버에서 방지하는 상태 머신 검증

계근·검수 수치 오입력이 최종금액 계산에 그대로 반영되지 않

이중 확인 절차 설계 필요

구매자 입금확인과 판매자 지급완료 사이 시차가 발생할 때 정산 상태 불일치를 막는 트랜잭션 격리 수준 설계

8~12주차 실사용자 시험운영 지원 시점에 발생할 수 있는 대량 문의와 오조작에 대비한 운영자 알림·롤백 체계 설계

구현 내용

핵심 기능 상세

핵심 기능 1

운영자 통합 현황판

신규문의부터 정산대기까지 전체 거래 현황과 각 거래별 다음 조치사항을 한 화면에서 확인하는 운영자 대시보드

핵심 기능 2

12단계 거래 상태 관리

거래확정부터 거래완료까지 12단계를 칸반 보드 컬럼으로 표시하고 운영자가 각 거래의 상태를 다음 단계로 전환하는 화면

핵심 기능 3

물류·계근·검수 관리

배차·상차·운송·계근·검수 정보를 입력하고 계근표·검수자료·증빙사진을 첨부하는 화면. 단계별 필수 증빙자료를 첨부해야 다음 단계로 전환 가능하도록 강제하는 검증 구조로 구현합니다

핵심 기능 4

정산 관리 및 자동 계산

계근·검수 결과를 기반으로 최종금액을 자동 계산하고 구매자 입금확인, 판매자 지급완료까지 정산 상태를 관리하는 화면

구현 과정

프로젝트 진행 단계

STEP 1

12단계 거래 상태 머신 및 정산 스키마 설계

거래확정~거래완료 12단계 상태 전이 규칙 정의, 정산·변경이력 테이블 8개 추가 설계

STEP 2

칸반 보드 및 상태 전환 API 개발

Express 기반 상태 전환 API 구현, 순차 전이 검증과 변경이력 자동 기록 로직 적용

STEP 3

물류·계근·검수 증빙 업로드 기능 개발

AWS S3 Presigned URL 업로드 구현, 단계별 필수 증빙자료 검증 로직 적용

STEP 4

정산 자동 계산 및 운영지표 대시보드 개발

계근중량×단가 자동 계산 로직 구현, Recharts 기반 운영지표 차트 6종 적용

STEP 5

통합 테스트 및 시험운영 대응 체계 점검

12단계 전체 흐름 통합 테스트, 알림·롤백 체계 점검 및 크로스 브라우저 검증

프로젝트 성과

주요 성과