← 포트폴리오 목록

공조 시공 파트너스 정산·백오피스 통합 플랫폼

MVP 이후 확장으로 파트너스 시공 완료 처리와 에스크로 정산, 입점 승인, AI 연동 로그와 예외 상태 추적, 메인 배너·공지 관리를 하나의 관리 콘솔로 통합하는 확장 프로젝트입니다.

프로젝트 납품 요약

아래 프로젝트 개요와 핵심 기능에서 구현 화면을 확인할 수 있습니다.

서비스 타입Web
업종AI 서비스
기술 스택
ReactTypeScriptTailwind CSSNode.jsExpressPostgreSQLPrismaRedisBull Queue
주요 기능
  • 정산 관리
  • 입점 승인
  • AI 연동 로그
  • 배너·공지

프로젝트 개요

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

MVP 이후 확장으로 파트너스 시공 완료 처리와 에스크로 정산, 입점 승인, AI 연동 로그와 예외 상태 추적, 메인 배너·공지 관리를 하나의 관리 콘솔로 통합하는 확장 프로젝트입니다. P1과 동일한 Node.js + Prisma 기반에 Redis와 Bull Queue를 더해 정산과 로그 집계를 비동기로 구성합니다.

작업 범위

  • 정산 관리: 정산 건 목록에서 항목을 선택하면 에스크로 보관금, 수수료 차감, 지급 예정 금액과 시공 완료 이력이 우측 상세 패널에 표시됩니다
  • 입점 승인: 파트너스 입점 신청 목록에서 사업자 인증 서류와 프로필을 확인하고 승인·반려·정지를 처리합니다
  • AI 연동 로그: AI 모듈 호출의 요청·응답·오류를 시간순으로 조회하고, 타임아웃과 파싱 실패 같은 예외 상태를 분류해 확인합니다
  • 배너·공지: 메인 배너의 노출 순서와 기간, 공지사항의 작성·수정·삭제를 관리하고 미리보기로 확인합니다

주요 업무

  • 정산 관리 화면: 리스트-상세 구조에서 정산 상태별 필터와 수수료 계산 내역, 지급 이력을 인라인으로 확인하는 화면을 구현합니다
  • 입점 승인 화면: 신청 리스트와 서류 뷰어, 체크리스트, 승인 이력을 한 화면에서 처리하는 심사 화면을 구현합니다
  • AI 연동 로그 화면: 호출 로그 테이블, 예외 유형별 필터, 요청·응답 원문 인스펙터로 구성된 연동 모니터링 화면을 구현합니다
  • 배너·공지 화면: 배너 순서 조정과 노출 기간 설정, 공지 편집기와 게시 상태 관리를 구현합니다
공조 시공 파트너스 정산·백오피스 통합 플랫폼
요구사항 정의

프로젝트 핵심 과제

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

에스크로 보관금과 수수료 차감

지급 시점이 어긋나지 않도록 정산 원장의 불변 이력 구조와 정합성 검증 설계 필요

AI 연동 로그가 빠르게 쌓이므로 기간·예외 유형 조회를 위한 인덱스와 보관 정책 설계

입점 서류에 포함된 사업자 정보의 접근 범위를 제한하는 presigned URL 만료와 열람 이력 기록

배너 노출 기간 자동 게시·종료 시 서버 재시작 상황에서도 작업이 중복되지 않는 스케줄 설계

구현 내용

핵심 기능 상세

핵심 기능 1

정산 관리

정산 건 목록에서 항목을 선택하면 에스크로 보관금, 수수료 차감, 지급 예정 금액과 시공 완료 이력이 우측 상세 패널에 표시됩니다.

  • Strategy 패턴으로 수수료율 정책을 분리하여 정산 금액 계산 로직 확장 구조 설계
  • Bull Queue로 시공 완료 후 정산 산출과 지급 요청을 비동기 작업으로 분리
  • 정산 원장 테이블에 append-only 이력을 기록하여 차감 내역 추적

수수료 정책 Strategy와 Bull Queue 작업을 결합해 시공 완료 이벤트가 정산 산출과 지급 이력으로 이어지는 정산 파이프라인을 설계합니다.

정산 관리
정산 관리 실제 화면
핵심 기능 2

입점 승인

파트너스 입점 신청 목록에서 사업자 인증 서류와 프로필을 확인하고 승인·반려·정지를 처리합니다. 신청 리스트와 서류 뷰어, 체크리스트, 승인 이력을 한 화면에서 처리하는 심사 화면을 구현합니다.

  • S3 presigned URL 기반 서류 미리보기와 접근 만료 시간 설정
  • 승인 상태 전이(대기·승인·반려·정지)를 Prisma 트랜잭션과 감사 로그로 기록
  • Redis 캐시로 심사 대기 건수 집계를 갱신하여 사이드바 배지에 반영

서류 미리보기와 체크리스트, 상태 전이 감사 로그를 한 패널에 결합해 심사 판단 근거가 이력으로 남는 승인 구조를 구현합니다.

입점 승인
입점 승인 실제 화면
핵심 기능 3

AI 연동 로그

AI 모듈 호출의 요청·응답·오류를 시간순으로 조회하고, 타임아웃과 파싱 실패 같은 예외 상태를 분류해 확인합니다.

  • 요청·응답·오류를 구조화 로그 테이블에 기록하고 예외 유형 코드로 분류
  • Bull Queue 기반 재시도 정책과 지수 백오프 설정
  • 원문 인스펙터에서 민감 필드를 마스킹하여 표시

예외 유형 코드와 재시도 이력을 로그 스키마에 함께 기록해 어떤 호출이 왜 폴백으로 전환됐는지 추적할 수 있는 연동 로그 구조를 설계합니다.

AI 연동 로그
AI 연동 로그 실제 화면
핵심 기능 4

배너·공지

메인 배너의 노출 순서와 기간, 공지사항의 작성·수정·삭제를 관리하고 미리보기로 확인합니다. 배너 순서 조정과 노출 기간 설정, 공지 편집기와 게시 상태 관리를 구현합니다.

  • dnd-kit 드래그 정렬로 배너 노출 순서를 변경하고 서버 정렬 값에 반영
  • 노출 기간 스케줄을 Cron 작업으로 자동 게시·종료 처리
  • 공지 본문 저장 시 서버 측 HTML sanitize 적용

드래그 정렬과 기간 스케줄 자동 게시를 결합해 배너 순서·노출 상태가 코드 배포 없이 관리 콘솔에서 반영되는 콘텐츠 관리를 구현합니다.

배너·공지
배너·공지 실제 화면
구현 과정

프로젝트 진행 단계

STEP 1

정산 원장 및 수수료 정책 모델링 · 2026.09

에스크로 보관·수수료 차감·지급 이력 원장 테이블과 정책 Strategy 설계

STEP 2

Bull Queue 정산·재시도 작업 구현 · 2026.09

시공 완료 이벤트 기반 정산 산출과 AI 호출 재시도 작업 구현

STEP 3

입점 심사 및 서류 뷰어 개발 · 2026.09

S3 서류 미리보기, 승인 상태 전이, 감사 로그 화면 구현

STEP 4

AI 연동 로그 및 콘텐츠 관리 화면 개발 · 2026.09

예외 유형별 로그 조회, 배너 정렬, 공지 편집기 구현

개발 결과

수수료 정책 Strategy 기반 정산 엔진 설계수수료율 정책을 Strategy로 분리하고 append-only 정산 원장에 차감 내역을 기록하는 구조 구현
Bull Queue 비동기 정산 파이프라인 구축시공 완료 이벤트에서 정산 산출·지급 요청까지 이어지는 큐 작업과 실패 재처리 대상 분류 구현
AI 연동 예외 분류 로그 스키마 설계타임아웃·파싱 실패 등 예외 유형 코드와 재시도 이력을 함께 기록하는 로그 테이블과 조회 화면 구현
입점 심사 상태 전이 감사 구조 구축대기·승인·반려·정지 상태 전이를 트랜잭션과 감사 로그로 기록하고 서류 미리보기와 결합

기술적 주안점

  • 수수료 정책 Strategy와 Bull Queue 작업을 결합해 시공 완료 이벤트가 정산 산출과 지급 이력으로 이어지는 정산 파이프라인을 설계합니다
  • 서류 미리보기와 체크리스트, 상태 전이 감사 로그를 한 패널에 결합해 심사 판단 근거가 이력으로 남는 승인 구조를 구현합니다
  • 예외 유형 코드와 재시도 이력을 로그 스키마에 함께 기록해 어떤 호출이 왜 폴백으로 전환됐는지 추적할 수 있는 연동 로그 구조를 설계합니다

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

필요한 기능과 일정을 알려주시면 개발 범위를 함께 정리하겠습니다.

프로젝트 문의