게임 로열티 정산 자동화 시스템

산출완료·검토중·예외조정·확정 4단계로 구성된 칸반 보드에서 분기별 정산 대상 게임의 진행 상태를 한눈에 파악하고, 카드를 드래그해 담당자가 직접 상태를 전환합니다.

• PostgreSQL enum 컬럼 + 상태 전이 검증 미들웨어로 산출완료→검토중→예외조정→확정 전이만 허용하는 상태 머신 구현
• dnd-kit 기반 칸반 드래그 인터랙션과 Optimistic UI로 카드 이동 시 체감 지연을 최소화하는 구조 적용
• 우선순위 필터 패널에서 마감 임박순·미확정 게임 수 기준 정렬 쿼리 구현

정산 상태 전이를 코드 레벨 상태 머신으로 강제해 잘못된 순서로 확정되는 것을 구조적으로 방지합니다.

5~6개 판매 채널의 로우 데이터를 엑셀·CSV·이미지 형식 그대로 업로드하면 시스템이 형식을 자동 인식해 파싱하고, 이미지 전용 채널은 Vision OCR로 판매 데이터를 추출합니다.

• xlsx/csv-parse 라이브러리로 채널별 원본 파일을 파싱하고 파일 형식 자동 감지 로직 구현
• Vision API(OCR)로 이미지 전용 채널의 판매 표를 추출, 신뢰도 임계값 미만 항목은 수기 보정 큐로 자동 분기
• 업로드 이력·파싱 실패 로그를 별도 테이블로 관리해 재처리 가능한 구조 설계

형식이 제각각인 원본 데이터를 표준 파이프라인 하나로 흡수해 신규 채널 추가 시에도 파서 확장만으로 대응 가능한 구조를 구현합니다.

채널마다 다른 컬럼 헤더와 항목명을 시스템 표준 항목(게임명·판매수량·매출액·통화 등)으로 변환하는 매핑 규칙을 화면에서 직접 등록·수정합니다.

• 채널별 매핑 규칙을 JSON 스키마로 저장하고 버전 관리하는 규칙 엔진 테이블 설계
• 매핑 미리보기 화면에서 원본 컬럼과 표준 항목을 실시간으로 매칭 검증
• 규칙 미매칭 컬럼은 자동으로 미매핑 목록에 노출해 누락 방지

채널 형식 변경에도 코드 배포 없이 매핑 규칙만 갱신하면 되는 설정 기반 구조를 구현합니다.

정산 확정 데이터를 기반으로 게임·국가·회사별 맞춤 양식의 로열티 보고서를 자동 생성하고 엑셀·PDF로 내보냅니다.

• jsPDF와 엑셀 생성 라이브러리로 확정 정산 데이터를 보고서 템플릿에 자동 바인딩
• 정산 대상(게임/국가/회사)별 보고서 양식을 템플릿 테이블로 관리해 재사용
• 보고서 생성 이력과 재생성 시 이전 버전 보관 로직 구현

확정된 정산 데이터에서 보고서까지 이어지는 파이프라인을 자동화해 수기 취합 없이 즉시 산출 가능한 구조를 구현합니다.