FAVOR ONE · 페이버홀딩스 통합 운영 시스템

대시보드

👥 사용자 관리

가입 승인·직무 지정·활성/비활성

⏳ 승인 대기

대기 중인 사용자 없음

활성 사용자

👁 사용자별 UI 미리보기

각 사용자가 어떤 메뉴를 볼 수 있는지 확인 — 권한 디버깅용

💡 사용자가 "왜 메뉴가 안 보여요" 라고 할 때 여기서 확인하세요. 직무별 권한은 [🔐 권한 관리] 에서 변경.
🔒 admin role 은 직무 권한 무시하고 모든 메뉴 자동 표시.

🔐 권한 관리

직무별 메뉴 가시성 설정 — 변경 사항은 즉시 적용

💡 각 직무별로 사이드바에 보이는 메뉴를 체크/해제할 수 있습니다. 변경 후 [💾 저장] 클릭. 해당 직무 사용자는 다음 페이지 새로고침 시 반영.
🧭 8개 모듈 · 7개 직무 — 모듈 헤더의 All / None 버튼으로 모듈 단위 일괄 토글 가능. 그룹별로 들여쓰기 표시.
⚠️ 총괄 직무는 모든 메뉴에 접근 가능하도록 권장 (총괄을 제한하면 권한 관리 자체에 접근 못 할 위험).
⚠️ admin role 은 직무 권한과 무관하게 모든 메뉴 접근 가능.

📊 생산관리 대시보드

진행 중 PO · 잔금 만기 · 발주요청 · 한국도착 한 눈에

진행 중 PO

-

🚨 잔금 만기 D-7

-

📝 미처리 발주요청

-

⏰ ETA 지연

-

📦 상품생산 관리

단일상품 SKU 마스터 · 제조업체 연결 · 발주 통계 (모음상품 제외)

🏢 사업자 정보

자사 사업자 등록 정보 — 매입(PI) BUYER, 매출(견적·인보이스) SELLER 로 자동 사용

🏷️ 브랜드 DB

브랜드 마스터 · 상표 등록 정보 · 상품/재고 드롭다운 공급원

비활성 포함

🏭 제조업체 DB

제조업체/공급사 마스터 · 연결 상품 · 발주 이력 통계

🚚 포워더 DB

물류·통관 파트너 마스터 (중한 포워더 등)

🏬 쇼핑몰 정보

쿠팡·네이버·토스 판매 계정과 API 키를 한 곳에서 관리. 운영관리(CRM·반품/교환)와 판매분석이 이 정보를 공유합니다.

쿠팡 Wing 계정 · Vendor ID / Access Key / Secret Key / WING ID(쿠폰용)

네이버 스마트스토어 Commerce API · Client ID / Secret

토스쇼핑 OAuth · Access Key / Secret Key (환경: prod/dev)

📝 발주요청

재고담당이 발주가 필요한 SKU 를 요청 → 구매담당이 처리

📋 발주관리

발주서 (PO) · 5단계 진행 트래킹 · 결제/물류/통관/첨부

완료/취소 숨기기

📺 리뷰어 모집

쿠팡·스마트스토어 리뷰 캠페인 — 마케팅업체 발주 + 견적요청서 자동 생성

📢 견적요청·진행 중

-

📅 이번달 진행

-

✓ 이번달 완료

-

💰 이번달 집행

-

🏢 마케팅업체 DB

리뷰어 모집 · 바이럴 마케팅 협력업체 마스터 (연락처·계좌·기본단가)

🚀 바이럴 마케팅

바이럴/체험단/공동구매 캠페인 — 채널·예산·KPI 트래킹

📢 진행 중

-

📅 이번달 시작

-

✓ 이번달 완료

-

💸 이번달 집행

-

🎨 디자인 외주

상세페이지·썸네일·패키지·로고 — 외주 디자인 의뢰 관리

📝 준비

-

🎨 진행중

-

🔍 검수

-

⚠️ 마감 임박 (≤3일)

-

✓ 이번달 완료

-

📅 마케팅 스케줄

리뷰어·바이럴·디자인 캠페인 진행상황을 캘린더로 한눈에

- 월

📺 리뷰어 0 🚀 바이럴 0 🎨 디자인 0

📺 리뷰어 🚀 바이럴 🎨 디자인

날짜	📷 포토	📝 텍스트	⭐ 별점	합계
📊 합계	0	0	0	0

상품 DB

옵션ID·바코드 관리 · 플레이오토 SKU 매칭

🚀 로켓그로스 관리

전체 노출상품 · 옵션별 수수료/입출고/배송/쿠폰 한 번에 보기

📦 재고 현황

창고별 실시간 재고 + 판매량 추이 + 발주/이동요청

📥 입고예정 포함 🔄 창고이동 반영

재고 위치

구역별 창고 지도

▲출입문

← A · B · C · D →

← 1 · 2 · 3 · 4 →

색상 = 보관 SKU 수

01-23-56+

구역에 마우스를 올리거나 클릭하세요

📥 입고 관리

한국도착 PO + 창고이동 도착 — 입고완료 처리 (재고담당)

📦 한국도착 대기 PO

-

🔄 창고이동 도착 대기

-

✓ 오늘 입고완료

-

⚠ 파스토 시스템 대기

-

📋 입고 이력 (개별 입고 기록)

출고 관리

출고요청 → 승인 → 완료 워크플로우

📤 출고요청 처리

대시보드에서 등록된 다중 SKU 출고요청을 승인 → 완료 처리

📅 요청일 ~

🏭 출발

🚚 도착

🟧 쿠팡 계정

재고 추이

상품 클릭 → 차트

📈

상품을 클릭하면 그래프 표시

📢 공지사항

시스템 변경 / 기능 추가 / 버그 수정 / 공지 — 일시별 변경 내역

변동 내역

입고·출고·수정·동기화 — 일시 + 변경자 자동 기록

~

🛒 쿠팡 재고 동기화

로켓그로스 API 자격증명 · 복수 계정 지원

🖥️ 에이전트 모드 — 회사 PC 에서 실행

쿠팡 OpenAPI 는 회사 IP 화이트리스트로 보호되어 Cloud Run 에서 직접 호출이 불가능합니다. 화이트리스트에 등록된 회사 사무실 PC 에서 에이전트 스크립트를 실행하세요. 스크립트는 쿠팡 API 를 호출해 결과를 ERP 로 자동 푸시합니다.

📦 Windows 설치 패키지 (ZIP) 📥 .py 단독

💡 회사 윈도우 PC 에서 ERP 접속 → [📦 Windows 설치 패키지 ZIP] 클릭. 메일/USB 옮길 필요 없음. 압축 풀고 SETUP_GUIDE.md 따라하면 끝.

⚠️ 아래 [+ 계정 추가] 로 등록한 정보는 이름·메모용으로만 사용됩니다 (Cloud Run 에서 직접 호출 시 백업 경로). 실제 키는 회사 PC 의 에이전트 스크립트에 직접 입력하시면 됩니다 — 시크릿이 클라우드를 거치지 않아 더 안전합니다.

🔍 SKU 매칭 진단

동기화 후 특정 상품의 재고가 안 변경된 것 같으면 여기서 확인 — 제품명/옵션ID/바코드 어느 것으로든 검색

🏢 본사재고 업로드

실재고를 박스당개수로 나눠 BOX/낱개 자동 분해

🏢

본사 재고입력 엑셀 업로드

재고입력_*.xlsx · 클릭 또는 드래그 · 바코드로 자동 매칭

📦 파스토 재고 업로드

상품바코드로 재고현황의 파스토재고 자동 동기화

⚡ API 자동 동기화 — 회사 PC 에이전트 모드

파스토 FMS Open API 는 회사 IP 화이트리스트(183.91.192.146) 로 보호됩니다. 화이트리스트에 등록된 회사 PC 에서 파스토 에이전트를 실행하면, 클라우드 스케줄러와 아래 [수동 실행] 버튼이 큐잉한 요청을 자동 픽업해서 재고/입고완료 데이터를 ERP 로 푸시합니다.

📦 Windows 설치 패키지 (ZIP) 📥 .py 단독 |

💡 회사 윈도우 PC 에서 ERP 접속 → [📦 Windows 설치 패키지 ZIP] 클릭. 메일/USB 옮길 필요 없음. 압축 풀고 fassto-install-autostart.bat 우클릭 → 관리자 권한으로 실행하면 끝.

🚚 파스토 입고 슬립 로그

불러오는 중...

⬇ 아래는 엑셀 파일 수동 업로드 (백업 경로 — API 동기화가 비정상일 때 사용)

📦

파스토 상품별재고현황 업로드

상품별재고현황_*.xlsx · 클릭 또는 드래그

기준 수량:

📊 인사 대시보드

이번 달 급여 / 근무 / 직원 현황

💰 급여 계산기

근무기록 업로드 · 자동 계산 · 명세서 발행

📂

근무기록 .xlsx 파일을 클릭하여 업로드

🧑‍💼 직원 명부

시급·계좌·입사일·직무 영구 보관

비활성 포함

📜 재직증명서

직원 선택 → 발급용도·기간 입력 → PDF 다운로드 / 인쇄 / 이메일

📝 발급 정보

발급 회사 *

대상 직원 *

주민등록번호 (앞 6자리만 노출)

📌 뒷자리는 마스킹 권장 — 본인 동의 없이 사용 금지

직위/직급

부서

입사일

현재까지 (재직 중)

발급 용도

발급일자

제출처 (선택)

메모 (이력 저장용 · 인쇄 안 됨)

왼쪽에서 발급 회사 + 직원을 선택하면
여기에 재직증명서가 미리 보입니다.

📊 재무 대시보드

오늘 처리할 입금 · 매입 세금계산서 · 세무 일정

🚨 오늘 처리 (-) + 연체

-

⚠️ 임박 (1~3일 내)

📅 이번 주 (D−4~D−7)

📂 출처별 대기 분포

🧾 영수증 종류별 (외주 용역)

📄 매입 세금계산서 미수령 — 입금완료 후 거래처로부터 세금계산서 받았는지 확인 필요

📆 세무 신고·납부 일정 (오늘 ~ 60일)

💼 이번달 인건비

💸 입금요청 처리

발주 · 마케팅 · 급여 입금요청 — 송금 후 [입금완료] 처리

📅 결제 캘린더

월별 결제 일정 — 입금요청 · 잔금 만기 · 고정비

입금요청·대기 입금완료 잔금만기 고정비

🏭 거래처별 잔액 (AP)

제조업체별 결제예정 / 입금완료 / 미지급 (KRW 환산)

📈 월별 손익 (P&L)

매출 - 변동비(원가/광고/수수료/배송/쿠폰) - 고정비 = 영업이익

🔁 고정비 등록

월급·임대료·SaaS·창고료 등 매월/분기/연 발생 비용

💬 고객문의 관리 (CRM)

네이버 · 쿠팡 고객문의를 한 곳에서 확인하고 AI 초안으로 답변합니다

ℹ 안내
· 네이버·쿠팡 모두 IP 화이트리스트 때문에 사무실 PC 에이전트(coupang-agent.py --daemon)를 통해 처리됩니다 — 동기화·전송에 최대 30초 소요.
· 네이버는 고객문의 + 상품문의(Q&A) 두 종류를 모두 수집합니다.
· 쿠팡 답변에는 계정별 WING 로그인 ID가 필요합니다 (⚙ 설정에서 등록).
· AI 초안은 자동 전송되지 않습니다 — 검토 후 [전송] 버튼을 눌러야 고객에게 전달됩니다.

↩️ 반품/교환 신청 관리

네이버 · 쿠팡의 반품 · 취소 · 교환 신청을 한 곳에서 확인하고 승인/거부 처리합니다

ℹ 안내
· 네이버·쿠팡 모두 IP 화이트리스트 때문에 사무실 PC 에이전트(coupang-agent.py --daemon)를 통해 처리됩니다 — 동기화·승인/거부에 최대 30초 소요.
· 쿠팡은 반품·취소(returnRequests) + 교환(exchangeRequests), 네이버는 취소·반품·교환 클레임을 수집합니다.
· 승인/거부는 실제 마켓에 반영됩니다 — 신중히 확인 후 진행하세요. (쿠팡 반품 거부·교환 승인은 마켓 정책상 API 미지원 → 안내 메시지 표시)

🎟️ 쿠팡 쿠폰 자동화

주기마다 즉시할인 쿠폰을 자동 생성·교체합니다 · 생성 → 1시간 10분 후 → 기존 쿠폰 삭제 + 상품 추가

⚙ 작동 방식
① 주기가 도래하면 시스템이 자동으로 신규 쿠폰을 생성합니다. (즉시할인 / 다운로드 쿠폰 선택)
② 쿠팡 정책상 쿠폰은 생성 후 약 1시간 10분 후부터 활성화됩니다. 그 시점까지 대기.
③ 활성화 시점 도래 시 신규 쿠폰에 대상 옵션(vendorItemId) 들을 일괄 추가하고, 동시에 직전 사이클 쿠폰을 삭제합니다.
④ 다음 주기는 마지막 사이클 시작 시각으로부터 [주기]일 후로 자동 예약됩니다.

⚠ 실제 API 호출은 IP 화이트리스트가 등록된 사무실 PC 에이전트 (coupang-agent.py --daemon) 에서 실행됩니다. 에이전트가 켜져 있어야 사이클이 동작합니다.

📜 실행 이력

📊 통합 대시보드

기간: 최근 30일 · 전체 채널

💰 매출

-

일평균 -

📦 주문 · 수량

-

객단가 -

💎 공헌이익

-

이익률 -

🎯 광고비 · ROAS

-

ROAS -

채널별 요약

일자별 추이 — 매출 · 공헌이익 · 광고비 (주말 분홍, 공휴일 빨강)

🎯 광고 상세 분석 — 클릭하여 펼치기 (캠페인 TOP / 키워드 효율 / 일자별 ROAS)

📊 광고비 / 광고매출 / ROAS 일자별

🏆 캠페인 TOP 5

💡 효율 키워드 TOP 5

📈 일자별 매출

매출 · 공헌이익 · 비용 분해

📂 상품별 매출 분석

상품 단위로 묶고, 펼치면 옵션별 매출/공헌이익

🔢 옵션ID 기준 (플랫) →

🎯 상품 360 분석

상품 단위 — 채널별 매트릭스 · 일자별 추이 · 옵션 드릴다운 · 운영 인사이트

📦 상품 목록

👈

좌측에서 상품을 선택하세요

상품을 클릭하면 채널별 매트릭스, 일자별 추이, 옵션 드릴다운, 운영 인사이트를 한 화면에서 볼 수 있습니다.

🏆 SKU 순위표

옵션별 매출/공헌이익

🏷️ 브랜드/카테고리 집계

그룹별 매출 비중

📅 월별 요약

연간 매출/공헌이익 트렌드

📆 요일·시간 분석

최근 N주 윈도우 — 각 요일이 동일한 데이터 개수로 공평하게 비교됩니다

📊 요일별 매출 (총합 / 일평균)

🏷 평일 / 주말 / 공휴일

🔥 시간 × 요일 히트맵 — 색상 진할수록 매출 큼. 셀 호버 시 상세

🛒 쿠팡 매출분석

매출 · 차원별 분석

💰 매출

-

일평균 -

📦 주문 · 수량

-

객단가 -

💎 공헌이익

-

이익률 -

🎯 광고비 · ROAS

-

ROAS -

로딩 중...

📊 쿠팡 공헌이익

상품·SKU별 매출 - 변동비 = 공헌이익 / 매출이익률 분석

🚧

쿠팡 공헌이익 분석 — 준비 중

이 페이지는 곧 다음 항목들로 완성됩니다:

📅 기간별 공헌이익 추이 — 일·주·월 단위, 일자별 라인차트
🏷️ SKU/옵션별 공헌이익률 랭킹 — 한국도착원가 기반 cogs 계산
💸 변동비 분해 — 매출 · 한국도착원가 · 수수료 · 배송비 · 쿠폰 · 광고비
⚠ 적자/저수익 SKU 자동 식별 — 공헌이익률 임계치 미달 알림
📊 광고 효율 vs 공헌이익 매트릭스 — 광고비 대비 진짜 남는 SKU

💡 현재 임시: 통합 대시보드 의 일자별 표에서 채널별 공헌이익 합계 확인 가능

📊 네이버 공헌이익

스마트스토어 옵션 매핑 기반 수익성 분석 — 주문 기준 / 정산 기준

주문 기준 | 매출 − 원가 − 수수료(추정 5.85%) − 광고비 = 공헌이익 . 광고비는 검색광고 분배 (광고소재→상품→계정). 수수료율 조정: %

🔗 매핑 커버리지: - (매출), - (수량)

🟢 매출 / 정산

-

📦 원가 (COGS)

-

매핑된 옵션 한정

💸 수수료(추정)

-

📣 광고비

-

광고비율 -

📊 공헌이익

-

🎯 공헌이익률

-

공헌이익 ÷ 매출

📈 일자별 매출 · 원가 · 공헌이익

🏆 일자별 공헌이익률

📅 일자별 상세

📊 쿠팡 윙 셀러 인사이트

옵션별 메트릭 (취소 제외 순매출 + 방문자/전환율)

쿠팡 윙 → 판매분석 → 옵션별 메트릭 → Excel 다운로드 → 여기에 업로드.
파일에 날짜 컬럼이 없어 다운로드 시 선택한 기간을 직접 입력해야 합니다 (매일 1일치 추천).

📦 재고 기반 매출

쿠팡 재고 감소량 기반 실제 출고수량 — 취소·반품 자동 반영

공식: 판매수량 = 전일 재고 + 당일 입고 - 당일 재고
쿠팡 재고가 줄어든 만큼이 실제 출고. 취소된 주문은 재고가 빠지지 않으니 자동 제외, 반품은 재고가 늘어나니 음수 sold = 자동 차감.
한계: 일자 단위 분석만 가능 (스냅샷이 매일 23:59 기준). 시간대별은 기존 주문 데이터 사용.

📅 일자별 판매수량 (스톡 델타)

🏆 옵션별 누계 (TOP 50)

🎯 광고 분석 (Phase 1: 데이터 수집)

쿠팡 윙 → 광고관리 → 보고서 → "일별 키워드 보고서" 다운로드 후 업로드

📤 광고 보고서 업로드 (Excel)

쿠팡 윙 → 광고관리 → 보고서 → 일별 키워드 보고서 다운로드
계정별로 윙에서 받아 같은 계정으로 업로드. 같은 (계정·일자) 재업로드 시 덮어쓰기.

계정:

📅 업로드된 (계정·일자)

📈 일자별 광고비/매출/ROAS 추이

기간 데이터 로딩...

📍 지면별 성과

로딩 중...

📋 전체 주문 내역

쿠팡 + 네이버 + 토스 통합. 토스는 일별 집계 가상 행으로 표시

채널

🟢 네이버 매출분석

스마트스토어 커머스 API — 일자별 매출·정산·상품 TOP

🟢 매출 (실결제)

-

전기 대비

💳 정산예정액

-

수수료 차감 후

📦 수량 / 주문

-

주문 -

💵 평균 주문금액

-

매출 ÷ 주문건수

📉 평균 수수료율

-

할인율 -

📈 일자별 매출 추이

🏆 상품 TOP 20

📅 일자별 상세 결제일 기준

📋 네이버 주문내역

스마트스토어 결제완료 주문 — 결제일 기준

미매핑만

🟢 네이버 광고분석

검색광고 API 자동 동기화 — 광고그룹·키워드별 효율 분석

📁 캠페인 → 광고그룹 → 광고소재

📦 상품별 광고 효율 (productId 단위)

📜 광고 변경 이력 (수정 시점이 성과에 미친 영향 추적용)

📅 일자별 합계 (변경 이력 마커 포함)

🔗 네이버 매핑 관리

미매핑 productId × 옵션 조합 — ERP 옵션과 연결

💙 토스쇼핑 매출분석

Toss Shopping Open API — 회사 서버 IP 화이트리스트 기반 동기화

🔑 동기화 방식 | 토스쇼핑은 등록 IP(183.91.192.146)만 API 호출이 허용됩니다. Cloud Run에서는 직접 호출이 불가하므로, 회사 서버에 설치된 에이전트가 매 6시간마다 자동으로 최근 7일치를 동기화합니다 (취소·환불도 자동 반영). 사용자가 누를 버튼은 없어요. 데이터가 안 보이면 오른쪽 위 📡 동기화 현황으로 에이전트 상태를 확인하세요. 최초 설치는 📦 회사 서버 설치 파일 다운로드로 받은 ZIP의 가이드를 따라가시면 됩니다.

💙 매출

-

전기 대비

📦 수량

-

전기 대비

🧾 주문 건수

-

전기 대비

💳 평균 주문금액

-

매출 ÷ 주문건수

📈 일자별 매출 추이

🏆 상품별 TOP 10

📅 일자별 상세 취소·환불 제외 순매출 기준

💙 토스쇼핑 광고분석 준비 중

광고 비용·노출·클릭·매출 추이 — 회사 서버 동기화

⏳ 광고 API 연동 준비 중 | 토스쇼핑 광고 API 스펙이 확정되면 회사 서버 에이전트가 자동으로 데이터를 보내드릴 수 있도록 골격만 먼저 준비해두었습니다. 현재는 toss_ads_daily 컬렉션에 데이터가 들어오는 즉시 차트와 KPI가 채워집니다.

💸 광고비

-

기간 합계

👁 노출

-

Impressions

🖱 클릭 / CTR

-

CTR -

💰 광고 매출 / ROAS

-

ROAS -

📊 CPC

-

광고비 ÷ 클릭

📈 일자별 광고비 vs 매출

🎯 캠페인별 효율

광고 데이터가 도착하면 캠페인별 효율이 자동으로 채워집니다.

📅 일자별 상세

📊 토스쇼핑 공헌이익

매핑된 옵션 한정 — 한국도착원가 기반 수익성 분석

주문 기준 | 매출 - 원가 - 수수료(추정 10%) = 공헌이익 . 발생 즉시 반영. 취소/환불은 매출에서 제외. 수수료율 조정: %

🔗 매핑 커버리지: - (매출 기준), - (수량 기준) 매핑 안 된 옵션은 원가가 0으로 잡혀 공헌이익이 과대평가됩니다.

💙 매출 / 정산

-

📦 원가 (COGS)

-

매핑된 옵션 한정

💸 수수료(추정)

-

매출 × 수수료율

📊 공헌이익

-

🎯 공헌이익률

-

공헌이익 ÷ 매출

📈 일자별 매출 · 원가 · 공헌이익

🏆 일자별 공헌이익률

📅 일자별 상세

🔗 토스 매핑 관리

미매핑 토스 옵션을 우리 ERP 재고(SKU)와 연결 — 원가 계산을 위한 사전 작업

매칭 우선순위: ① productItemManagementCode(옵션관리코드) → ② productManagementCode(상품관리코드) → ③ 상품명+옵션명 정규화 일치. 토스에 새 상품 등록 시 productManagementCode에 우리 ERP 의 상품ID 또는 옵션 바코드를 넣으면 자동 매칭됩니다.
💡 매핑했는데 공헌이익에서 원가가 0 으로 잡힌다면 우측 위 🩺 원가 진단 클릭 — 원인별 분류 결과가 나옵니다.