← 포트폴리오 목록
비철금속 B2B 거래 운영 플랫폼
비철금속 거래마켓 MVP 이후, 운영자가 신규문의부터 정산완료까지 12단계 거래 상태와 물류·계근·검수·정산을 반자동으로 처리하는 백오피스 확장 플랫폼을 React + Node.js 기반으로 설계·구현합니다.
프로젝트 개요
비철금속 거래마켓 MVP 이후, 운영자가 신규문의부터 정산완료까지 12단계 거래 상태와 물류·계근·검수·정산을 반자동으로 처리하는 백오피스 확장 플랫폼을 React + Node.js 기반으로 설계·구현합니다. 칸반 보드형 상태 관리와 정산 자동 계산을 핵심으로 합니다.
요구사항 정의
프로젝트 핵심 과제
프로젝트 진행 시 해결한 핵심 기술 과제입니다.
12단계 상태 전이 중 일부 단계를 건너뛰거나 되돌리려는 예외 상황을 서버에서 방지하는 상태 머신 검증
계근·검수 수치 오입력이 최종금액 계산에 그대로 반영되지 않
이중 확인 절차 설계 필요
구매자 입금확인과 판매자 지급완료 사이 시차가 발생할 때 정산 상태 불일치를 막는 트랜잭션 격리 수준 설계
8~12주차 실사용자 시험운영 지원 시점에 발생할 수 있는 대량 문의와 오조작에 대비한 운영자 알림·롤백 체계 설계
구현 내용
핵심 기능 상세
핵심 기능 1
운영자 통합 현황판
신규문의부터 정산대기까지 전체 거래 현황과 각 거래별 다음 조치사항을 한 화면에서 확인하는 운영자 대시보드
핵심 기능 2
12단계 거래 상태 관리
거래확정부터 거래완료까지 12단계를 칸반 보드 컬럼으로 표시하고 운영자가 각 거래의 상태를 다음 단계로 전환하는 화면
핵심 기능 3
물류·계근·검수 관리
배차·상차·운송·계근·검수 정보를 입력하고 계근표·검수자료·증빙사진을 첨부하는 화면. 단계별 필수 증빙자료를 첨부해야 다음 단계로 전환 가능하도록 강제하는 검증 구조로 구현합니다
핵심 기능 4
정산 관리 및 자동 계산
계근·검수 결과를 기반으로 최종금액을 자동 계산하고 구매자 입금확인, 판매자 지급완료까지 정산 상태를 관리하는 화면
구현 과정
프로젝트 진행 단계
STEP 1
12단계 거래 상태 머신 및 정산 스키마 설계
거래확정~거래완료 12단계 상태 전이 규칙 정의, 정산·변경이력 테이블 8개 추가 설계
STEP 2
칸반 보드 및 상태 전환 API 개발 / 물류·계근·검수 증빙 업로드 기능 개발
Express 기반 상태 전환 API 구현, 순차 전이 검증과 변경이력 자동 기록 로직 적용 AWS S3 Presigned URL 업로드 구현, 단계별 필수 증빙자료 검증 로직 적용
STEP 3
정산 자동 계산 및 운영지표 대시보드 개발
계근중량×단가 자동 계산 로직 구현, Recharts 기반 운영지표 차트 6종 적용
STEP 4
통합 테스트 및 시험운영 대응 체계 점검
12단계 전체 흐름 통합 테스트, 알림·롤백 체계 점검 및 크로스 브라우저 검증
개발 결과
12단계 상태 머신 및 변경이력 설계순차 전이만 허용하는 Enum 상태 머신 구현, 변경자·시간·이전상태 기록 테이블 별도 설계
정산 자동 계산 로직 구현계근중량×확정단가 계산식을 서버 단일 소스로 관리, 입금·지급 상태 분리 추적 구조 설계
증빙자료 업로드 검증 파이프라인 구축S3 Presigned URL 업로드 구현, 단계별 필수 증빙 누락 시 상태 전환을 차단하는 서버 검증 적용
운영지표 집계 파이프라인 설계Materialized View 기반 단계별 거래 건수 집계, Redis 캐시로 현황판 조회 응답 구조 최적화
기술적 주안점
- 12단계 거래 상태별 건수를 집계하고 조치가 필요한 거래를 우선순위 큐로 분리해, 운영자가 반자동으로 다음 조치를 판단할 수 있는 현황판을 구현합니다
- 12단계 거래 상태를 칸반 보드로 시각화하고, 순차 전이만 허용하는 상태 머신과 변경이력 기록을 결합해 오조작을 방지하는 구조를 구현합니다
- 단계별 필수 증빙자료 첨부를 서버에서 강제 검증해, 계근표·검수자료 누락 없이 다음 단계로 전환되는 물류 관리 구조를 구현합니다
