B2B 주문 운영 관리 플랫폼
P1의 가격·견적·주문 흐름 위에 거래처 가입 승인과 등급 관리, 주문·송장·반품·환불 운영 콘솔, 매출 통계와 엑셀 일괄 처리, 세금계산서 정보와 감사 로그를 통합한 운영 관리 플랫폼을 React + Node.js 기반으로 확장 설계·구현합니다.
프로젝트 개요
P1의 가격·견적·주문 흐름 위에 거래처 가입 승인과 등급 관리, 주문·송장·반품·환불 운영 콘솔, 매출 통계와 엑셀 일괄 처리, 세금계산서 정보와 감사 로그를 통합한 운영 관리 플랫폼을 React + Node.js 기반으로 확장 설계·구현합니다.
작업 범위
- 운영 현황 허브·거래처 승인: 승인 대기 거래처, 미입금 주문, 반품 요청, 견적 대기를 타일로 모아 보고 사업자등록증 확인 후 가입 승인·반려와 등급 지정을 처리하는 허브 화면입니다
- 주문·송장·반품·환불 콘솔: 전체 주문을 거래처별로 필터링하고 상태 변경, 송장번호 등록, 취소·반품 요청 처리, 카드 취소와 무통장 환불 현황을 관리하는 운영 콘솔입니다
- 매출 통계·엑셀 일괄 처리: 기간별 매출과 주문 현황, 거래처별 구매 내역을 차트로 조회하고 상품·주문 데이터를 엑셀로 일괄 등록하거나 내려받는 화면입니다
- 세금계산서 정보·감사 로그: 거래처별 세금계산서 발행 정보와 발행 이력을 관리하고, 주문·결제·취소·반품 등 모든 거래 기록을 감사 로그로 조회하는 화면입니다
주요 업무
- 운영 현황 허브·거래처 승인 화면: 타일별 집계를 PostgreSQL 집계 쿼리로 제공하고, 등급별 기능 접근 권한을 RBAC 정책 테이블로 관리합니다
- 주문·송장·반품·환불 콘솔 화면: 주문 상태 전이 규칙을 서버에서 강제하고, 다건 선택 후 송장 일괄 등록과 상태 일괄 변경을 트랜잭션으로 처리합니다
- 매출 통계·엑셀 일괄 처리 화면: 집계용 Materialized View를 설계하고, 엑셀 업로드는 행 단위 검증 결과를 미리보기로 보여준 뒤 확정 시 배치로 반영합니다
- 세금계산서 정보·감사 로그 화면: 감사 로그는 append-only 테이블로 설계하고 변경 전후 값을 함께 기록하며, 세금계산서 정보는 거래처 단위 이력으로 버전 관리합니다
프로젝트 핵심 과제
카드 결제와 무통장 입금 주문이 섞인 상태에서 부분 취소·반품 시 환불 금액과 경로를 결제 수단별로 정확히 나누는 처리 설계가 필요합니다
수천 행 규모의 엑셀 일괄 등록에서 일부 행 오류가 있어도 정상 행만 안전하게 반영하고 실패 행을 추적하는 배치 설계가 필요합니다
거래처 등급별로 노출 상품과 기능이 달라지는 환경에서 통계 집계가 권한 범위를 벗어나지 않
조회 범위 제한 설계가 필요합니다
가격·상태 변경 이력을 불변 로그로 남기면서 로그 조회 화면의 필터 성능을 유지하는 인덱싱 전략 설계가 필요합니다
핵심 기능 상세
운영 현황 허브·거래처 승인
승인 대기 거래처, 미입금 주문, 반품 요청, 견적 대기를 타일로 모아 보고 사업자등록증 확인 후 가입 승인·반려와 등급 지정을 처리하는 허브 화면입니다.
- 사업자등록증 첨부 가입 신청을 승인·반려 상태 머신으로 관리하고 사유를 이메일로 안내
- 거래처 등급별 기능 접근 정책을 RBAC 정책 테이블로 정의하고 라우트·API·UI 3중 검증 적용
- 타일별 집계를 Prisma raw 쿼리와 Redis 단기 캐시로 제공하는 구조 설계
승인 대기·미입금·반품 요청을 한 화면의 타일로 모으고 클릭 한 번으로 하단 목록에서 처리하는 드릴다운 구조를 구현합니다.
주문·송장·반품·환불 콘솔
전체 주문을 거래처별로 필터링하고 상태 변경, 송장번호 등록, 취소·반품 요청 처리, 카드 취소와 무통장 환불 현황을 관리하는 운영 콘솔입니다.
- 주문 상태(확인·배송·완료·취소·반품) 전이 규칙을 서버 정책으로 강제해 잘못된 전이 차단
- 다건 선택 송장 일괄 등록과 택배사 배송 조회 링크 연동 구조 구현
- 반품·환불 요청 처리를 PG 카드 취소 API 호출과 무통장 환불 대기 목록으로 분기 설계
취소·반품·환불 경로를 결제 수단별로 분기하면서 주문 이력에 단계별 처리 기록을 남기는 운영 콘솔을 구현합니다.
매출 통계·엑셀 일괄 처리
기간별 매출과 주문 현황, 거래처별 구매 내역을 차트로 조회하고 상품·주문 데이터를 엑셀로 일괄 등록하거나 내려받는 화면입니다.
- PostgreSQL Materialized View로 일별·월별 매출과 거래처별 구매 집계를 구성하고 갱신 잡 설계
- 엑셀 업로드 행 단위 검증과 오류 행 리포트 다운로드를 Bull Queue 배치로 처리
- Recharts로 기간 비교·거래처 순위 차트를 구현하고 필터 상태를 URL과 동기화
엑셀 업로드를 검증 미리보기와 확정 반영의 2단계로 나눠, 일부 오류 행이 있어도 정상 행만 안전하게 반영하는 구조를 구현합니다.
세금계산서 정보·감사 로그
거래처별 세금계산서 발행 정보와 발행 이력을 관리하고, 주문·결제·취소·반품 등 모든 거래 기록을 감사 로그로 조회하는 화면입니다.
- 주문·결제·취소·반품 이벤트를 append-only 감사 로그 테이블에 변경 전후 값과 함께 기록
- 거래처별 세금계산서 발행 정보를 버전 이력으로 관리하고 발행 이력과 연결
- Redis 기반 세션과 관리자 역할별 로그 조회 범위 제한 구조 설계
모든 거래 이벤트를 불변 로그로 남기고 유형·기간·거래처로 좁혀 추적할 수 있는 감사 체계를 구현합니다.
프로젝트 진행 단계
운영 업무 분석 및 권한·이력 모델 설계 · 2026.09
가입 승인·주문·반품 운영 흐름 분석, 등급별 RBAC 정책과 append-only 감사 로그 스키마 설계
주문 운영·환불 처리 API 개발 · 2026.09
주문 상태 전이 정책, 송장 일괄 등록, 카드 취소·무통장 환불 분기 처리 API 구현
집계·엑셀 배치 파이프라인 구축 · 2026.09
Materialized View 집계, 엑셀 업로드 검증·반영 Bull Queue 배치와 다운로드 내보내기 구현
인사이트 보드 UI 및 통합 검증 · 2026.09
타일 드릴다운 보드와 Recharts 차트 화면 구현, 권한별 화면 노출과 감사 로그 통합 테스트
개발 결과
기술적 주안점
- 승인 대기·미입금·반품 요청을 한 화면의 타일로 모으고 클릭 한 번으로 하단 목록에서 처리하는 드릴다운 구조를 구현합니다
- 취소·반품·환불 경로를 결제 수단별로 분기하면서 주문 이력에 단계별 처리 기록을 남기는 운영 콘솔을 구현합니다
- 엑셀 업로드를 검증 미리보기와 확정 반영의 2단계로 나눠, 일부 오류 행이 있어도 정상 행만 안전하게 반영하는 구조를 구현합니다
