← 포트폴리오 목록

미술품 마켓플레이스 관리자·정산 통합 플랫폼

MVP 이후 운영 단계에서 필요한 작가·작품 승인 워크플로우, 주문·매출 관리, 정산 규칙 엔진, 통합 분석까지 아우르는 관리자 확장 데모를 PHP(Laravel) + React 18 기반으로 구현합니다.

드래그 전환 상태 머신 검증 구조 설계칸반 드래그 전환 시 서버에서 상태 전이 유효성을 재검증해 잘못된 승인 처리를 차단하는 구조를 구현합니다
규칙 기반 정산 계산 엔진 구축작가별 수수료율·정산주기를 데이터 규칙으로 관리해 정책 변경에 유연하게 대응하는 계산 엔진을 설계합니다
비동기 정산 배치 큐 아키텍처 구현Laravel Horizon 기반 큐로 정산 배치를 비동기 처리해 대량 처리 시에도 안정적인 구조를 설계합니다
서비스 타입Web
업종이커머스
기술 스택
React 18TypeScriptTailwind CSSPHPLaravelPostgreSQLRedisAWS S3Laravel Horizon
주요 기능
  • 작가·작품 승인 워크플로우
  • 주문·매출 통합 관리
  • 정산 규칙 엔진 UI
  • 통합 관리자 KPI 분석
Overview

프로젝트 개요

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

MVP 이후 운영 단계에서 필요한 작가·작품 승인 워크플로우, 주문·매출 관리, 정산 규칙 엔진, 통합 분석까지 아우르는 관리자 확장 데모를 PHP(Laravel) + React 18 기반으로 구현합니다. 승인 대기 건이 늘어날수록 필요한 칸반형 워크플로우와 데이터 기반 의사결정을 지원하는 디자인으로 설계합니다.

작업 범위

  • 작가·작품 승인 워크플로우: 관리자가 작가 가입 신청과 작품 등록 신청을 칸반 보드에서 대기→검토중→승인/반려로 관리합니다
  • 주문·매출 통합 관리: 관리자가 전체 주문/결제 현황을 통합 조회하고 환불·예외 처리를 관리합니다
  • 정산 규칙 엔진 UI: 관리자가 작가별 수수료율과 정산 주기를 규칙으로 설정하고, 규칙에 따라 계산된 정산 예정 금액과 처리 현황을 조회합니다
  • 통합 관리자 KPI 분석: 매출 추이, 작가별 판매 순위, 카테고리별 인기도를 시각화된 차트로 분석합니다

주요 업무

  • 작가·작품 승인 워크플로우 화면: 칸반 보드 드래그 전환 + 우선순위/카테고리 필터 매트릭스 패널로 구현
  • 주문·매출 통합 관리 화면: 주문 상태별 테이블 + 상세 트랜잭션 로그 + 환불 처리 액션으로 구성
  • 정산 규칙 엔진 UI 화면: 규칙 기반 정산 계산 엔진 UI + 정산 배치 상태(준비/확정/완료) 대시보드로 구현
  • 통합 관리자 KPI 분석 화면: Recharts 기반 다중 차트 대시보드로 구현
미술품 마켓플레이스 관리자·정산 통합 플랫폼
요구사항 정의

프로젝트 핵심 과제

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

작가 등급별로 상이한 수수료율과 정산 주기를 유연하게 표현하는 정산 규칙 데이터 모델 설계

칸반 드래그 전환 시 여러 관리자가 같은 카드를 동시에 조작하는 동시성 제어 설계

정산 배치 처리 중 일부 건이 실패했을 때 부분 실패를 감지하고 재처리하는 큐 설계

대량 주문·정산 데이터를 기간별로 집계해 분석 차트에 지연 없이 반영하는 쿼리 설계

구현 내용

핵심 기능 상세

핵심 기능 1

작가·작품 승인 워크플로우

관리자가 작가 가입 신청과 작품 등록 신청을 칸반 보드에서 대기→검토중→승인/반려로 관리합니다. 칸반 보드 드래그 전환 + 우선순위/카테고리 필터 매트릭스 패널로 구현.

  • 드래그 앤 드롭 기반 칸반 보드 상태 전환 UI 구현(dnd-kit 활용)
  • 상태 전이 규칙을 서버 상태 머신으로 검증해 잘못된 드래그 전환을 차단
  • 작가 등급·작품 카테고리 기준 우선순위 매트릭스 필터 패널 구현

드래그 전환 시 서버에서 상태 전이 유효성을 재검증해 잘못된 승인 상태 변경을 원천 차단하는 구조를 설계합니다

작가·작품 승인 워크플로우
작가·작품 승인 워크플로우 실제 화면
핵심 기능 2

주문·매출 통합 관리

관리자가 전체 주문/결제 현황을 통합 조회하고 환불·예외 처리를 관리합니다. 주문 상태별 테이블 + 상세 트랜잭션 로그 + 환불 처리 액션으로 구성.

  • 주문/결제 데이터를 상태별로 집계하는 쿼리 빌더 구현
  • 환불 요청 시 PG 환불 API 연동 상태를 추적하는 로그 테이블 설계
  • 다중 선택 후 일괄 상태 변경 시 트랜잭션 원자성 보장

다중 선택 일괄 처리를 DB 트랜잭션으로 감싸 부분 실패 없이 원자적으로 처리하는 구조를 설계합니다

주문·매출 통합 관리
주문·매출 통합 관리 실제 화면
핵심 기능 3

정산 규칙 엔진 UI

관리자가 작가별 수수료율과 정산 주기를 규칙으로 설정하고, 규칙에 따라 계산된 정산 예정 금액과 처리 현황을 조회합니다. 규칙 기반 정산 계산 엔진 UI + 정산 배치 상태(준비/확정/완료) 대시보드로 구현.

  • 작가별 수수료율·정산주기를 규칙 테이블로 관리하는 설정 UI 구현
  • 규칙에 따른 정산 예정 금액 계산 로직을 배치 단위로 미리보기하는 화면 설계
  • 정산 배치 상태(준비/확정/완료)를 추적하는 상태 관리 구조 구현

정산 규칙을 데이터로 관리해 정책 변경 시 코드 수정 없이 규칙만 갱신하는 구조를 설계합니다

정산 규칙 엔진 UI
정산 규칙 엔진 UI 실제 화면
핵심 기능 4

통합 관리자 KPI 분석

매출 추이, 작가별 판매 순위, 카테고리별 인기도를 시각화된 차트로 분석합니다. Recharts 기반 다중 차트 대시보드로 구현.

  • Recharts로 매출 추이·카테고리별 판매 비중 등 복수 차트 타입 구현
  • 기간별(일/주/월) 데이터 집계를 위한 쿼리 구조 설계
  • 작가별 판매 순위 테이블과 차트를 연동한 드릴다운 UI 구현

기간 필터와 차트, 순위 테이블을 하나의 상태로 연동해 일관된 분석 흐름을 설계합니다

통합 관리자 KPI 분석
통합 관리자 KPI 분석 실제 화면
구현 과정

프로젝트 진행 단계

STEP 1

승인 워크플로우 및 정산 규칙 데이터 모델링 · 2026.09

작가·작품 상태 전이 모델과 정산 규칙 테이블 설계, PostgreSQL 스키마 확장

STEP 2

칸반 승인 API 및 정산 계산 엔진 개발 · 2026.09

Laravel 기반 상태 전이 API, 규칙 기반 정산 계산 배치 로직 구현

STEP 3

관리자 대시보드 UI 및 분석 차트 개발 · 2026.09

칸반 보드·정산 대시보드·Recharts 분석 화면 등 10~14개 화면 구현

STEP 4

비동기 정산 큐 및 통합 테스트 · 2026.09

Laravel Horizon 기반 정산 배치 큐 처리, 관리자 API 통합 검증

프로젝트 성과

주요 성과

드래그 전환 상태 머신 검증 구조 설계칸반 드래그 전환 시 서버에서 상태 전이 유효성을 재검증해 잘못된 승인 처리를 차단하는 구조를 구현합니다
규칙 기반 정산 계산 엔진 구축작가별 수수료율·정산주기를 데이터 규칙으로 관리해 정책 변경에 유연하게 대응하는 계산 엔진을 설계합니다
비동기 정산 배치 큐 아키텍처 구현Laravel Horizon 기반 큐로 정산 배치를 비동기 처리해 대량 처리 시에도 안정적인 구조를 설계합니다
다중 차트 연동 분석 대시보드 설계기간 필터·순위 테이블·차트를 하나의 상태로 연동한 드릴다운 분석 구조를 구현합니다
Highlights

기술적 주안점

  • 드래그 전환 시 서버에서 상태 전이 유효성을 재검증해 잘못된 승인 상태 변경을 원천 차단하는 구조를 설계합니다
  • 다중 선택 일괄 처리를 DB 트랜잭션으로 감싸 부분 실패 없이 원자적으로 처리하는 구조를 설계합니다
  • 정산 규칙을 데이터로 관리해 정책 변경 시 코드 수정 없이 규칙만 갱신하는 구조를 설계합니다

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

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

무료 상담 시작하기