🎯 Invendory 란?
자판기 재고·매출·순이익을 한 곳에서 자동 관리하는 앱이에요. VMMS 판매 데이터와 쿠팡 구매 내역을 자동 수집해서 정확한 이익까지 계산해줘요.
🚀 처음 시작하기
1️⃣ 구글 로그인 + 첫 설정
1. 구글 계정으로 로그인
2. 첫 접속 시 온보딩 화면에서 입력:
• 이름 (필수)
• 연락처 (선택)
• 보안 PIN 4자리 이상 (정보 수정 / 회원 탈퇴 시 사용)
3. 완료 → 메인 화면 진입
2️⃣ 위치·자판기 등록
1. 설정 > 🏪 자판기 > 📋 자판기 관리 > ➕ 위치(구역) 추가
2. 위치명 입력 (예: "○○고등학교")
3. 단말기 번호 + 자판기 종류 + 모델 + 계약 기간 입력
4. 같은 위치에 여러 대 있으면 + 자판기 로 추가
💡 헤더 위치 드롭다운으로 자판기 위치를 빠르게 전환할 수 있어요.
💡 단말기 번호는 VMMS와 동일해야 자동 매칭됩니다.
3️⃣ VMMS 계정 등록 (판매 자동 수집)
1. 설정 > 🔒 개인/보안 > 🔗 VMMS 계정 > VMMS 계정 등록
2. VMMS 아이디·비밀번호 입력 후 저장
3. 자판기 탭 > 자판기 현황 > 📦 VMMS 실시간 수집 1회 실행 → 컬럼·제품 자동 매칭
4. 이후 매일 12시·19시에 자동으로 판매 데이터 수집
⚠️ 계정 정보는 암호화돼서 저장돼요.
4️⃣ 쿠팡 구매 자동 수집 (Gmail 직접 가져오기)
쿠팡 주문 메일이 본인 Gmail로 와있으면 앱이 직접 검색해서 입고 후보로 띄워줘요. 별도 설정 없이 바로 사용 가능합니다.
1. 재고 탭 > 재고현황 > 📥 쿠팡 데이터 가져오기
2. 📧 Gmail에서 직접 가져오기 클릭
3. 첫 사용 시 Google 계정 권한 승인 (Gmail 읽기 전용)
4. 최근 90일의 쿠팡 주문 메일을 자동으로 검색·표시
5. 미입고 항목에서 제품 매칭 후 입고 처리
🔒 권한은 쿠팡 주문 메일 검색에만 사용되고, 메일 본문은 서버에 저장되지 않아요.
🏪 자판기 · 제품 관리
자판기 현황 (컬럼 배치 보기)
자판기 탭 > 자판기 현황:
• 자판기 컬럼별 제품 그리드 표시
• 자판기가 여러 대면 ‹ › 로 전환
• 컬럼 카드 클릭 → 제품 상세 (재고 / 판매가 / 입고·차감 이력)
• 📐 2칸 제품 설정 → 한 제품이 두 컬럼을 차지하는 경우 묶음 처리
제품 관리 (판매가 등록·수정)
자판기 탭 > 제품 관리:
• VMMS에서 수집된 제품 자동 표시
• 제품 클릭 → 판매가 수정
• 정렬: 제품명 / 컬럼번호
• 편집 버튼 → 다중 선택 후 일괄 삭제 / 판매중단
📦 재고 관리
쿠팡 데이터 가져오기 (자동 입고)
1. 재고 탭 > 재고현황 > 📥 쿠팡 데이터 가져오기
2. 📧 Gmail에서 직접 가져오기 → 최근 90일 쿠팡 주문 자동 검색
3. 미입고 구매 내역이 화면에 표시됨
4. 각 제품 옆 제품 매칭 → 앱 제품과 매핑 (박스당 낱개수 입력)
5. 입고 처리 → 재고 자동 추가 + 원가 자동 계산
💡 박스당 낱개수: 칸쵸 32개들이 2박스 → 박스당 32 입력 → 64개 입고
수기 재고 입력
쿠팡 외에 직접 구매한 재고는 수기로 입력해요.
1. 재고 탭 > ➕ 수기 재고 입력
2. 단품 입력 / CSV 일괄 입력 선택
3. 제품 선택 > 박스당 수량 > 구매 수량(박스) > 구매 총액 입력
4. 자동으로 입고 수량 + 개당 원가 계산해서 표시
5. 입고 확인 → 재고 반영
제품 상세 보기 (입고/차감 이력)
재고 탭 / 자판기 탭에서 제품 클릭하면:
• 현재 재고 수량
• 전체 입고 내역 (날짜 / 수량 / 개당 원가 / 판매중·소진 / 쿠팡·수기)
• 차감 내역 (판매 / 수기)
• 제품별 수기 입고 / 차감 가능
재고 부족 기준 (자동 알림)
설정 > 🏪 자판기 > ⚙️ 자판기 설정:
• 고정 수량 기준: 지정한 수량(예: 5개) 이하면 부족 표시 — 기본값
• 평균 판매량 기준: 하루 평균 판매량 × 설정 일수 이하면 부족 표시 (예: 3일분)
⚠️ 홈 화면 상단 + 재고 탭에 부족 제품이 자동 표시됩니다.
💡 재고 탭 > 제품구매 → 부족 제품을 한 번에 쿠팡에서 검색
📊 판매 & 이익 분석
판매 데이터 확인
판매내역 탭에서:
• 기간 선택 (오늘 / 어제 / 1주일 / 한달 / 직접 입력)
• 총 판매량 · 총 매출
• 제품 판매 순위
• 시간대별 / 금액대별 분포
• 건별 판매 내역 (삭제 / 복구 가능)
VMMS 연동 시 매일 12시·19시 자동 수집. 수동으로:
• 🔄 오늘 판매 데이터 수집
• ⚡ 선택 날짜 데이터 수집
• 📤 직접 업로드 (CSV)
순이익 확인 (중요!)
이익을 계산하려면 입고 → 차감 순서가 중요해요.
1. 쿠팡/수기로 재고 입고 (개당 원가 등록됨)
2. VMMS 판매 데이터 수집
3. 판매내역 탭 > 📦 이 기간 재고 차감 클릭
4. 자동으로 FIFO 차감 + 원가 기록
5. 총 원가 / 순이익 / 이익률 + 제품별 이익 표시
💡 FIFO: 오래된 입고분부터 차감해서 정확한 원가 계산
💡 차감 후 입고를 나중에 했다면 💰 원가 보정으로 재계산
🔒 내 정보 · 보안
정보 수정 (이메일·연락처·PIN)
1. 설정 상단 내 정보 카드 > 관리 > 정보 수정
2. PIN 인증 통과 → 수정 폼 표시
3. 이메일 / 연락처 변경, 또는 PIN 비밀번호 변경 (숫자 4자리 이상)
4. 저장
공지사항 확인
• 홈 화면 상단 📢 공지사항 버튼 → 전체 목록
• 제목으로 검색 / 페이지 넘김 (10개씩)
• 관리자가 팝업 공지로 등록한 글은 첫 화면에 자동으로 떠요
• 팝업이 여러 개면 좌우로 넘겨서 볼 수 있어요
• 오늘은 그만 보기 / 닫기 로 제어
⚠️ 회원 탈퇴
설정 맨 아래 ⚠️ 회원 탈퇴
삭제되는 데이터:
• 위치 / 자판기 / 단말기
• 제품 · 재고 · 판매 내역
• VMMS · 쿠팡 연동
• 프로필 (이름·연락처·PIN)
• 구글 계정 연결 해제
⏳ 탈퇴 후 30일 동안은 같은 구글 계정으로 재가입 불가능합니다.
🔒 PIN 인증 + "회원탈퇴" 입력 필요. 복구 불가능.
⚠️ 데이터 초기화
초기화 종류
설정 > ⚠️ 초기화:
• 📦 재고 초기화 — 모든 재고 + 입고/차감 기록 삭제
• 🏷️ 제품 초기화 — 제품·컬럼 매칭 삭제 (VMMS 재수집 가능)
• 📊 판매 내역 초기화 — 판매 데이터 전부 삭제
• 🛒 쿠팡 입고 데이터 초기화 — 쿠팡 주문·구매·매핑 삭제 (메일 연동은 유지)
• 🗑️ 전체 초기화 — 위 항목 + 자판기까지 한꺼번에 (내 정보는 유지)
⚠️ 복구 불가. PIN 인증 필요.
과거 쿠팡 주문 가져오기
쿠팡 데이터 가져오기는 Gmail 기준 최근 90일까지 자동 검색돼요.
90일보다 오래된 주문은 수기 재고 입력 으로 직접 등록해주세요.
(재고 탭 > ➕ 수기 재고 입력)
💬 문의
가이드대로 안 될 때는 운영자에게 연락 주세요.
버그 / 기능 제안도 환영입니다.