← 포트폴리오 목록

가맹 지사몰 본사 통합 관리 플랫폼

MVP 이후 확장 범위로 본사 통합 관리자를 구현하는 프로젝트입니다.

프로젝트 납품 요약

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

서비스 타입Web
업종모니터링
기술 스택
ReactTypeScriptTailwind CSSNode.jsExpressPostgreSQLPrismaRedisBull Queue
주요 기능
  • 통합 관제 대시보드
  • 지사몰 개설 마법사
  • 마스터 상품 가격 관리
  • 예치금 정산 월 마감

프로젝트 개요

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

MVP 이후 확장 범위로 본사 통합 관리자를 구현하는 프로젝트입니다. 비개발자 직원이 입력만으로 지사몰을 개설하는 자동화, 마스터 상품·이중 가격의 전 몰 동기화, 랜딩 유입 고객 Round-Robin 배분, 예치금 정산과 본사 대행 환불, 이카운트 ERP 연동 기반 월 마감 서류와 세금계산서 발행을 하나의 관리 화면군으로 설계합니다.

작업 범위

  • 통합 관제 대시보드: 전 지사몰의 주문과 정산 현황을 좌측 몰 목록과 우측 상세 패널로 보고, 랜딩 유입 고객의 Round-Robin 배분 이력과 몰 공개 상태를 함께 확인합니다
  • 지사몰 개설 마법사: 본사 직원이 몰 이름, 로고, 사업자 정보, 도메인, 템플릿, 포인트 컬러를 입력하면 마스터몰이 복제되어 지사몰이 개설되는 흐름을 단계별로 안내합니다
  • 마스터 상품 가격 관리: 본사가 상품, 소비자가, 점주 공급가, 재고를 한 번 수정하면 전 지사몰에 동기화되는 중앙 카탈로그를 관리하고 몰별 동기화 상태를 확인합니다
  • 예치금 정산 월 마감: 점주 예치금 원장과 본사 대행 환불을 관리하고, 월 마감 시 정산서와 거래명세서를 PDF로 발행하며 이카운트 ERP 연동 기반 세금계산서 발행 상태를 확인합니다

주요 업무

  • 통합 관제 대시보드 화면: 역할별 권한이 분리된 본사 통합 관리자에서 몰 단위 상세를 인라인으로 제공합니다
  • 지사몰 개설 마법사 화면: 개설 요청을 비동기 작업으로 실행하고 도메인 연결 상태를 단계별로 확인합니다
  • 마스터 상품 가격 관리 화면: 상품 500종에서 2,000종까지 늘어도 일괄 반영이 유지되도록 배치 동기화와 변경 이력을 설계합니다
  • 예치금 정산 월 마감 화면: 정산 정합성을 원장으로 보장하고 ERP 연동 호출은 어댑터와 동기화 로그로 분리합니다
가맹 지사몰 본사 통합 관리 플랫폼
요구사항 정의

프로젝트 핵심 과제

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

상품 2,000종과 몰 500개 조합의 가격 오버레이 갱신이 한꺼번에 발생하므로 배치 크기와 큐 동시성 설계가 필요하며

몰 단위 청크 분할로 대응합니다

본사 대행 환불 시 점주 PG 호출과 예치금 원장 반영 사이에 불일치가 생길 수 있어

보상 트랜잭션과 정합성 점검 작업으로 대응합니다

이카운트 API 키와 시험 환경 제공 시점에 따라 일정이 달라지므로

어댑터 인터페이스와 모의 응답으로 먼저 구현하고 실연동은 협조 후 검증합니다

세금계산서 API 발행 방식이 확정되지 않아 발행 요청 방식을 교체 가능한 구조로 설계하고 방식 확인 후 연결할 계획입니다

개설 중 도메인 연결이 지연되는 몰의 상태를 정확히 보여줘야 하며

단계별 상태 모델과 재시도 안내로 대응합니다

구현 내용

핵심 기능 상세

핵심 기능 1

통합 관제 대시보드

전 지사몰의 주문과 정산 현황을 좌측 몰 목록과 우측 상세 패널로 보고, 랜딩 유입 고객의 Round-Robin 배분 이력과 몰 공개 상태를 함께 확인합니다.

  • Redis 원자 카운터로 공개 몰 입점 순서대로 고객을 배분하는 라운드로빈 큐 구현
  • 역할 기반 접근 제어를 라우트, API, UI 요소 3단계로 적용하는 권한 계층 설계
  • 몰 목록 가상 스크롤과 서버 사이드 필터로 500개 규모 목록 탐색 구조 설계

몰 공개 상태를 반영하는 Round-Robin 배분 규칙과 배분 이력 원장을 함께 설계해 어떤 고객이 어느 몰에 배정됐는지 추적합니다.

통합 관제 대시보드
통합 관제 대시보드 실제 화면
핵심 기능 2

지사몰 개설 마법사

본사 직원이 몰 이름, 로고, 사업자 정보, 도메인, 템플릿, 포인트 컬러를 입력하면 마스터몰이 복제되어 지사몰이 개설되는 흐름을 단계별로 안내합니다.

  • Bull Queue 작업으로 마스터몰 복제와 테넌트 시드 생성을 비동기 실행
  • 템플릿 3종과 포인트 컬러를 CSS 변수 토큰으로 주입하는 몰별 테마 설정 구조
  • 도메인 연결 상태를 DNS 확인 단계별 체크리스트로 보여주는 개설 상태 모델

개발 지식 없이 입력만으로 개설되는 마법사와 개설 작업 큐를 연결하고, 마스터몰 판매 차단 규칙을 개설 단계에 포함합니다.

지사몰 개설 마법사
지사몰 개설 마법사 실제 화면
핵심 기능 3

마스터 상품 가격 관리

본사가 상품, 소비자가, 점주 공급가, 재고를 한 번 수정하면 전 지사몰에 동기화되는 중앙 카탈로그를 관리하고 몰별 동기화 상태를 확인합니다.

  • 변경 이벤트를 Bull Queue 배치로 팬아웃해 몰별 가격 오버레이를 갱신하는 동기화 구조
  • 소비자가와 점주 공급가를 상품 단위로 분리하고 가격 변경 이력을 버전 테이블에 기록
  • Redis 캐시 무효화 키를 몰 단위로 분리해 변경 대상 몰만 갱신

이중 가격 변경을 이력과 함께 저장하고 전 몰 동기화 진행률을 확인할 수 있게 설계해 대량 상품 변경에도 추적 가능한 구조를 갖춥니다.

마스터 상품 가격 관리
마스터 상품 가격 관리 실제 화면
핵심 기능 4

예치금 정산 월 마감

점주 예치금 원장과 본사 대행 환불을 관리하고, 월 마감 시 정산서와 거래명세서를 PDF로 발행하며 이카운트 ERP 연동 기반 세금계산서 발행 상태를 확인합니다.

  • 본사 대행 환불을 점주 PG 설정으로 호출하고 환불 결과를 예치금 원장에 반영하는 보상 트랜잭션 설계
  • jsPDF 템플릿으로 정산서, 입금증, 거래명세서, 판매 리포트, 이용료 명세를 점주별 일괄 생성
  • 이카운트 ERP API 클라이언트 어댑터와 동기화 로그 테이블, 세금계산서 발행 실패 재처리 큐 설계

예치금 자동 차감과 본사 대행 환불을 하나의 원장으로 묶고, 월 마감 서류 자동 발행과 세금계산서 발행 요청을 스케줄 작업으로 연결합니다.

예치금 정산 월 마감
예치금 정산 월 마감 실제 화면
구현 과정

프로젝트 진행 단계

STEP 1

본사 권한 체계와 몰 관리 모델 설계 · 2026.10

역할별 권한 매트릭스, 지사몰 상태 모델, 배분 큐 스키마와 Redis 키 구조 정의

STEP 2

지사몰 개설 작업 큐와 템플릿 테마 구현 · 2026.10

Bull Queue 개설 작업, 마스터몰 복제 시드, 템플릿 3종 테마 토큰 구현

STEP 3

마스터 카탈로그와 예치금 정산 원장 구현 · 2026.10

상품·이중 가격 동기화 배치, 가상계좌 입금 반영, 자동 차감 원장, 본사 대행 환불 보상 트랜잭션 구현

STEP 4

월 마감 서류와 ERP 연동 어댑터 구현 · 2026.10

PDF 서류 5종 생성, 이카운트 API 어댑터, 세금계산서 발행 요청과 실패 재처리 큐 구현

개발 결과

라운드로빈 고객 배분 큐 구현Redis 원자 카운터와 몰 공개 상태 필터로 입점 순서 배분을 구현하고 배분 이력 원장을 설계
지사몰 개설 비동기 파이프라인 구축입력 검증, 마스터몰 복제, 테마 주입, 도메인 확인을 Bull Queue 단계 작업으로 분리해 구축
전 몰 가격 동기화 팬아웃 설계변경 이벤트를 몰 단위 작업으로 분배하고 몰별 캐시 키만 무효화하는 동기화 구조 설계
정산 원장·월 마감 서류 자동 발행 구현환불 보상 트랜잭션과 멱등 키로 중복 환불을 막고, 점주별 서류 5종을 jsPDF 템플릿으로 일괄 생성하는 작업 구현

기술적 주안점

  • 몰 공개 상태를 반영하는 Round-Robin 배분 규칙과 배분 이력 원장을 함께 설계해 어떤 고객이 어느 몰에 배정됐는지 추적합니다
  • 개발 지식 없이 입력만으로 개설되는 마법사와 개설 작업 큐를 연결하고, 마스터몰 판매 차단 규칙을 개설 단계에 포함합니다
  • 이중 가격 변경을 이력과 함께 저장하고 전 몰 동기화 진행률을 확인할 수 있게 설계해 대량 상품 변경에도 추적 가능한 구조를 갖춥니다

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

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

프로젝트 문의