← 포트폴리오 목록
글드림 어드민 정산 콘솔
플랫폼 관리자가 전체 회원·작가를 관리하고 콘텐츠를 승인하며 결제·환불을 조회하고 작가별 수수료율을 적용해 정산 지급까지 처리할 수 있는 어드민 콘솔을 Spring Boot 백엔드와 React 기반 데이터 대시보드로 구현합니다.
역할 기반 관리자 권한 계층 설계슈퍼관리자·운영자·정산담당 3단계 권한을 Spring Security로 구현하고 API·UI 이중 권한 검증을 적용합니다.
콘텐츠 승인 상태 머신 구현대기·승인·반려·재검토 4단계 상태 전이를 트랜잭션으로 관리하는 콘텐츠 승인 워크플로우를 설계합니다.
작가별 수수료율 엔진 및 정산 배치 구현작가별 수수료율 테이블과 매출 집계를 연동해 월별 정산 금액을 산출하는 배치 로직을 구현합니다.
Overview
프로젝트 개요
플랫폼 관리자가 전체 회원·작가를 관리하고 콘텐츠를 승인하며 결제·환불을 조회하고 작가별 수수료율을 적용해 정산 지급까지 처리할 수 있는 어드민 콘솔을 Spring Boot 백엔드와 React 기반 데이터 대시보드로 구현합니다.
요구사항 정의
프로젝트 핵심 과제
프로젝트 진행 시 해결한 핵심 기술 과제입니다.
작가별로 상이한 수수료율과 프로모션 할인율이 동시 적용될 때 정산 금액 계산 우선순위를 명확히 설계할 필요가 있습니다
결제 취소·부분 환불이 이미 지급 처리된 정산 금액에 미치는 영향을 역산해 재정산하는 로직 설계가 필요합니다
콘텐츠 승인·반려 처리량이 증가할 때 관리자별 검토 대기열이 몰리지 않
큐잉 전략이 필요합니다
Spring Data JPA 대량 정산 배치 쿼리 실행 시 MariaDB 인덱스 전략과 잠금 범위를 최소화하는 설계가 필요합니다
핵심 기능 1
회원·작가 통합 관리 및 권한 제어
관리자가 전체 회원과 작가를 검색·필터링하고 등급·정지·작가 승인 권한을 제어하는 관리 콘솔을 구현합니다. 역할 기반 접근 제어(RBAC)로 슈퍼관리자·운영자·정산담당 권한을 분리해 화면·API 접근을 통제합니다
핵심 기능 2
콘텐츠 모니터링 및 승인·반려
관리자가 신규 등록 콘텐츠를 모니터링하고 승인 또는 반려 사유와 함께 처리할 수 있는 화면을 구현합니다. 대기·승인·반려·재검토 4단계 상태 전이를 트랜잭션으로 관리하는 콘텐츠 승인 워크플로우를 설계합니다
핵심 기능 3
결제 내역 조회 및 환불·취소 처리
관리자가 전체 결제 내역을 조회하고 환불·취소 요청을 검토해 처리할 수 있는 콘솔을 구현합니다. PG 결제·취소·환불 이력을 하나의 타임라인 뷰로 통합 조회하는 데이터 테이블과 처리 액션을 설계합니다
핵심 기능 4
작가별 수수료율 설정 및 정산 지급 처리
관리자가 작가별 수수료율을 설정하고 매출 데이터를 기반으로 산출된 정산 금액의 지급 상태를 관리하는 콘솔을 구현합니다
구현 과정
프로젝트 진행 단계
STEP 1
관리자 권한 체계 및 회원 데이터 모델 설계
슈퍼관리자·운영자·정산담당 권한 계층을 정의하고 회원·작가 통합 데이터 모델을 설계합니다
STEP 2
콘텐츠 승인 워크플로우 API 개발
Spring Boot 기반 콘텐츠 상태 전이 API를 구현하고 반려 알림 연동 로직을 완성합니다
STEP 3
결제·환불 조회 콘솔 UI 개발
React 기반 결제 타임라인 뷰와 환불 처리 화면을 구현하고 정산 데이터 연동을 검증합니다
STEP 4
수수료율·정산 지급 처리 로직 및 통합 테스트
작가별 수수료율 엔진과 정산 지급 처리 로직을 구현하고 전체 콘솔 흐름을 통합 테스트합니다
프로젝트 성과
역할 기반 관리자 권한 계층 설계슈퍼관리자·운영자·정산담당 3단계 권한을 Spring Security로 구현하고 API·UI 이중 권한 검증을 적용합니다.
콘텐츠 승인 상태 머신 구현대기·승인·반려·재검토 4단계 상태 전이를 트랜잭션으로 관리하는 콘텐츠 승인 워크플로우를 설계합니다.
작가별 수수료율 엔진 및 정산 배치 구현작가별 수수료율 테이블과 매출 집계를 연동해 월별 정산 금액을 산출하는 배치 로직을 구현합니다.
결제·환불 통합 조회 콘솔 구현PG 결제·취소·환불 이력을 하나의 타임라인 뷰로 통합해 조회하는 어드민 콘솔을 구현합니다.
Review
기술적 주안점
- 3단계 권한 계층을 기반으로 회원·작가 데이터를 통합 조회하고, 상태 변경 이력을 자동 기록하는 관리 콘솔을 구현합니다
- 콘텐츠 상태 전이를 트랜잭션으로 보장하고 반려 사유를 작가 알림과 자동 연동하는 승인 워크플로우를 구현합니다
- 결제·취소·환불 이력을 단일 타임라인으로 통합하고, 환불 처리 결과가 정산 데이터에 자동 반영되는 연동 구조를 구현합니다
