← 포트폴리오 목록
게임 로열티 정산 자동화 시스템
콘솔 게임 유통사의 5~6개 판매 채널에서 흩어진 매출 데이터를 다양한 형식(엑셀·CSV·이미지)으로 받아 표준 스키마로 자동 파싱·매핑하고, 게임별 분기 단위 로열티 정산 산출부터 검토·확정까지 이어지는 워크플로우와 보고서 자동 생성을 React + Node.js 기반으로 설계·구현합니다.
채널별 양식 매핑 규칙 엔진 설계컬럼 헤더가 상이한 5~6개 채널 원본을 표준 스키마로 변환하는 설정 가능한 매핑 규칙 테이블 설계, 신규 채널 추가 시 코드 수정 없이 규칙만 등록 가능한 구조
분기 정산 계산 엔진 구현게임별 정산 대상·통화·산정 기준을 반영한 정산 계산 로직 구현, 환율 시점 기준 원화 환산과 예외 수기 조정을 원자적 트랜잭션으로 처리
이미지 채널 데이터 Vision OCR 파이프라인 구축이미지로만 제공되는 판매 데이터를 Vision API로 추출 후 수기 보정 UI와 연결하는 파이프라인 설계, 신뢰도 낮은 항목 자동 플래그 처리
Overview
프로젝트 개요
콘솔 게임 유통사의 5~6개 판매 채널에서 흩어진 매출 데이터를 다양한 형식(엑셀·CSV·이미지)으로 받아 표준 스키마로 자동 파싱·매핑하고, 게임별 분기 단위 로열티 정산 산출부터 검토·확정까지 이어지는 워크플로우와 보고서 자동 생성을 React + Node.js 기반으로 설계·구현합니다.
요구사항 정의
프로젝트 핵심 과제
프로젝트 진행 시 해결한 핵심 기술 과제입니다.
채널마다 열 구성과 항목명이 제각각이라 매핑 규칙을 코드 변경 없이 설정 가능한 구조로 설계해야 하는 과제가 있으며
규칙 버전 관리로 대응합니다
이미지 전용 채널의 OCR 추출 정확도가 항상 보장되지는 않는 리스크
신뢰도 임계값 미만 항목을 수기 보정 큐로 자동 전달해 대응합니다
게임별로 정산 대상·산정 기준이 상이해 규칙화 가능 범위와 예외 처리 경계를 설계해야 하는 과제가 있으며
설정 가능한 조건 빌더로 유연하게 대응합니다
분기 정산 확정 이후 데이터 수정 이력을 감사 추적 가능하게 남겨야 하는 요구가 있으며
변경 전/후 스냅샷을 별도 감사 테이블에 기록해 대응합니다
구현 내용
핵심 기능 상세
핵심 기능 1
분기 정산 워크플로우 보드
산출완료·검토중·예외조정·확정 4단계로 구성된 칸반 보드에서 분기별 정산 대상 게임의 진행 상태를 한눈에 파악하고, 카드를 드래그해 담당자가 직접 상태를 전환합니다
핵심 기능 2
판매 데이터 업로드 및 자동 파싱
5~6개 판매 채널의 로우 데이터를 엑셀·CSV·이미지 형식 그대로 업로드하면 시스템이 형식을 자동 인식해 파싱하고, 이미지 전용 채널은 Vision OCR로 판매 데이터를 추출합니다
핵심 기능 3
채널별 양식 매핑 설정
채널마다 다른 컬럼 헤더와 항목명을 시스템 표준 항목(게임명·판매수량·매출액·통화 등)으로 변환하는 매핑 규칙을 화면에서 직접 등록·수정합니다
핵심 기능 4
로열티 보고서 자동 생성
정산 확정 데이터를 기반으로 게임·국가·회사별 맞춤 양식의 로열티 보고서를 자동 생성하고 엑셀·PDF로 내보냅니다
구현 과정
프로젝트 진행 단계
STEP 1
업무 프로세스 분석 및 정산 데이터 모델 설계
채널·게임·정산 조건 ERD 설계, 매핑 규칙·예외 조정 이력 테이블 정의
STEP 2
파일 파싱 및 매핑 엔진 개발
엑셀/CSV 파서, Vision OCR 연동, 채널별 매핑 규칙 엔진 API 구현
STEP 3
정산 계산 및 워크플로우 API 개발
환율 환산·정산 산출 로직, 산출→검토→확정 상태 전이 API 구현
STEP 4
칸반 워크플로우 UI 및 보고서 생성 개발
React 기반 칸반 보드·업로드·매핑 화면 구현, PDF/엑셀 보고서 생성 모듈 적용
STEP 5
통합 테스트 및 감사 로그 검증
정산 계산 케이스 테스트, 감사 추적 로그 정합성 검증, 권한별 접근 테스트
프로젝트 성과
주요 성과
채널별 양식 매핑 규칙 엔진 설계컬럼 헤더가 상이한 5~6개 채널 원본을 표준 스키마로 변환하는 설정 가능한 매핑 규칙 테이블 설계, 신규 채널 추가 시 코드 수정 없이 규칙만 등록 가능한 구조
분기 정산 계산 엔진 구현게임별 정산 대상·통화·산정 기준을 반영한 정산 계산 로직 구현, 환율 시점 기준 원화 환산과 예외 수기 조정을 원자적 트랜잭션으로 처리
이미지 채널 데이터 Vision OCR 파이프라인 구축이미지로만 제공되는 판매 데이터를 Vision API로 추출 후 수기 보정 UI와 연결하는 파이프라인 설계, 신뢰도 낮은 항목 자동 플래그 처리
정산 워크플로우 상태 머신 설계산출완료→검토중→예외조정→확정 4단계 상태 전이를 관리하는 상태 머신 구현, 각 전이 시점의 변경 이력을 감사 로그로 기록
Review
기술적 주안점
- 정산 상태 전이를 코드 레벨 상태 머신으로 강제해 잘못된 순서로 확정되는 것을 구조적으로 방지합니다
- 형식이 제각각인 원본 데이터를 표준 파이프라인 하나로 흡수해 신규 채널 추가 시에도 파서 확장만으로 대응 가능한 구조를 구현합니다
- 채널 형식 변경에도 코드 배포 없이 매핑 규칙만 갱신하면 되는 설정 기반 구조를 구현합니다
