프로젝트 개요
MVP 이후 확장 범위로 본사 통합 관리자를 구현하는 프로젝트입니다. 비개발자 직원이 입력만으로 지사몰을 개설하는 자동화, 마스터 상품·이중 가격의 전 몰 동기화, 랜딩 유입 고객 Round-Robin 배분, 예치금 정산과 본사 대행 환불, 이카운트 ERP 연동 기반 월 마감 서류와 세금계산서 발행을 하나의 관리 화면군으로 설계합니다.
작업 범위
- 통합 관제 대시보드: 전 지사몰의 주문과 정산 현황을 좌측 몰 목록과 우측 상세 패널로 보고, 랜딩 유입 고객의 Round-Robin 배분 이력과 몰 공개 상태를 함께 확인합니다
- 지사몰 개설 마법사: 본사 직원이 몰 이름, 로고, 사업자 정보, 도메인, 템플릿, 포인트 컬러를 입력하면 마스터몰이 복제되어 지사몰이 개설되는 흐름을 단계별로 안내합니다
- 마스터 상품 가격 관리: 본사가 상품, 소비자가, 점주 공급가, 재고를 한 번 수정하면 전 지사몰에 동기화되는 중앙 카탈로그를 관리하고 몰별 동기화 상태를 확인합니다
- 예치금 정산 월 마감: 점주 예치금 원장과 본사 대행 환불을 관리하고, 월 마감 시 정산서와 거래명세서를 PDF로 발행하며 이카운트 ERP 연동 기반 세금계산서 발행 상태를 확인합니다
주요 업무
- 통합 관제 대시보드 화면: 역할별 권한이 분리된 본사 통합 관리자에서 몰 단위 상세를 인라인으로 제공합니다
- 지사몰 개설 마법사 화면: 개설 요청을 비동기 작업으로 실행하고 도메인 연결 상태를 단계별로 확인합니다
- 마스터 상품 가격 관리 화면: 상품 500종에서 2,000종까지 늘어도 일괄 반영이 유지되도록 배치 동기화와 변경 이력을 설계합니다
- 예치금 정산 월 마감 화면: 정산 정합성을 원장으로 보장하고 ERP 연동 호출은 어댑터와 동기화 로그로 분리합니다




프로젝트 핵심 과제
상품 2,000종과 몰 500개 조합의 가격 오버레이 갱신이 한꺼번에 발생하므로 배치 크기와 큐 동시성 설계가 필요하며
몰 단위 청크 분할로 대응합니다
본사 대행 환불 시 점주 PG 호출과 예치금 원장 반영 사이에 불일치가 생길 수 있어
보상 트랜잭션과 정합성 점검 작업으로 대응합니다
이카운트 API 키와 시험 환경 제공 시점에 따라 일정이 달라지므로
어댑터 인터페이스와 모의 응답으로 먼저 구현하고 실연동은 협조 후 검증합니다
세금계산서 API 발행 방식이 확정되지 않아 발행 요청 방식을 교체 가능한 구조로 설계하고 방식 확인 후 연결할 계획입니다
개설 중 도메인 연결이 지연되는 몰의 상태를 정확히 보여줘야 하며
단계별 상태 모델과 재시도 안내로 대응합니다
핵심 기능 상세
통합 관제 대시보드
전 지사몰의 주문과 정산 현황을 좌측 몰 목록과 우측 상세 패널로 보고, 랜딩 유입 고객의 Round-Robin 배분 이력과 몰 공개 상태를 함께 확인합니다.
- Redis 원자 카운터로 공개 몰 입점 순서대로 고객을 배분하는 라운드로빈 큐 구현
- 역할 기반 접근 제어를 라우트, API, UI 요소 3단계로 적용하는 권한 계층 설계
- 몰 목록 가상 스크롤과 서버 사이드 필터로 500개 규모 목록 탐색 구조 설계
몰 공개 상태를 반영하는 Round-Robin 배분 규칙과 배분 이력 원장을 함께 설계해 어떤 고객이 어느 몰에 배정됐는지 추적합니다.


지사몰 개설 마법사
본사 직원이 몰 이름, 로고, 사업자 정보, 도메인, 템플릿, 포인트 컬러를 입력하면 마스터몰이 복제되어 지사몰이 개설되는 흐름을 단계별로 안내합니다.
- Bull Queue 작업으로 마스터몰 복제와 테넌트 시드 생성을 비동기 실행
- 템플릿 3종과 포인트 컬러를 CSS 변수 토큰으로 주입하는 몰별 테마 설정 구조
- 도메인 연결 상태를 DNS 확인 단계별 체크리스트로 보여주는 개설 상태 모델
개발 지식 없이 입력만으로 개설되는 마법사와 개설 작업 큐를 연결하고, 마스터몰 판매 차단 규칙을 개설 단계에 포함합니다.


마스터 상품 가격 관리
본사가 상품, 소비자가, 점주 공급가, 재고를 한 번 수정하면 전 지사몰에 동기화되는 중앙 카탈로그를 관리하고 몰별 동기화 상태를 확인합니다.
- 변경 이벤트를 Bull Queue 배치로 팬아웃해 몰별 가격 오버레이를 갱신하는 동기화 구조
- 소비자가와 점주 공급가를 상품 단위로 분리하고 가격 변경 이력을 버전 테이블에 기록
- Redis 캐시 무효화 키를 몰 단위로 분리해 변경 대상 몰만 갱신
이중 가격 변경을 이력과 함께 저장하고 전 몰 동기화 진행률을 확인할 수 있게 설계해 대량 상품 변경에도 추적 가능한 구조를 갖춥니다.


예치금 정산 월 마감
점주 예치금 원장과 본사 대행 환불을 관리하고, 월 마감 시 정산서와 거래명세서를 PDF로 발행하며 이카운트 ERP 연동 기반 세금계산서 발행 상태를 확인합니다.
- 본사 대행 환불을 점주 PG 설정으로 호출하고 환불 결과를 예치금 원장에 반영하는 보상 트랜잭션 설계
- jsPDF 템플릿으로 정산서, 입금증, 거래명세서, 판매 리포트, 이용료 명세를 점주별 일괄 생성
- 이카운트 ERP API 클라이언트 어댑터와 동기화 로그 테이블, 세금계산서 발행 실패 재처리 큐 설계
예치금 자동 차감과 본사 대행 환불을 하나의 원장으로 묶고, 월 마감 서류 자동 발행과 세금계산서 발행 요청을 스케줄 작업으로 연결합니다.


프로젝트 진행 단계
본사 권한 체계와 몰 관리 모델 설계 · 2026.10
역할별 권한 매트릭스, 지사몰 상태 모델, 배분 큐 스키마와 Redis 키 구조 정의
지사몰 개설 작업 큐와 템플릿 테마 구현 · 2026.10
Bull Queue 개설 작업, 마스터몰 복제 시드, 템플릿 3종 테마 토큰 구현
마스터 카탈로그와 예치금 정산 원장 구현 · 2026.10
상품·이중 가격 동기화 배치, 가상계좌 입금 반영, 자동 차감 원장, 본사 대행 환불 보상 트랜잭션 구현
월 마감 서류와 ERP 연동 어댑터 구현 · 2026.10
PDF 서류 5종 생성, 이카운트 API 어댑터, 세금계산서 발행 요청과 실패 재처리 큐 구현
개발 결과
기술적 주안점
- 몰 공개 상태를 반영하는 Round-Robin 배분 규칙과 배분 이력 원장을 함께 설계해 어떤 고객이 어느 몰에 배정됐는지 추적합니다
- 개발 지식 없이 입력만으로 개설되는 마법사와 개설 작업 큐를 연결하고, 마스터몰 판매 차단 규칙을 개설 단계에 포함합니다
- 이중 가격 변경을 이력과 함께 저장하고 전 몰 동기화 진행률을 확인할 수 있게 설계해 대량 상품 변경에도 추적 가능한 구조를 갖춥니다