← Columbus Guide

운영자 메뉴얼

콜럼버스 가이드 v2 · 시즌 운영 가이드 · v0.5 (2026-05-17)

📌 이 메뉴얼은 시스템 변경 시 즉시 갱신됩니다.
신규 시트·메뉴·자동화가 추가되면 본 페이지가 먼저 업데이트됩니다. 챕터 옆 배지로 상태를 표시합니다 — 사용 가능은 즉시 따라하실 수 있는 작업, 진행중·준비 중은 시스템 구축 완료 후 본문이 채워집니다.
01. 시작하기 사용 가능

콜럼버스 가이드 운영에 사용하는 핵심 자산 3개를 책상 위 즐겨찾기에 두세요.

운영 DB콜럼버스_모든응답 kr
Google Sheets · 모든 데이터의 SOT
Drive 폴더운영 메인 폴더
1bHW8... · 카페별 폴더 154+개
운영 메일scentonehq@gmail.com
고객 응대·자동 발송 발신처
접속 계정: scentonehq@gmail.com 로그인 시 운영 DB·Drive 자동 접근. 다른 계정으로는 보이지 않습니다.

매일 시작할 때 (1분)

  1. 운영 DB → 📌 대시보드 탭 열기
  2. 오렌지 컬럼(운영자 마킹) 8개 훑어보기
  3. 붉은 표시(⚠️·🚫) 있으면 챕터 12 문제 해결로
02. 시즌 시작 전 준비 (12월~1월 초) P1 후 작성

매년 시즌(1.13~2.말) 시작 전 운영자가 확인해야 하는 항목.

체크리스트

  1. ⚙️ 시스템설정 시트의 current_season_year = 다음 시즌 연도로 변경 (예: 2026 → 2027)
  2. renewal_d30_enabled · renewal_d7_enabled 토글 확인
  3. 운영자 연락처 4종 변경 사항 있으면 갱신 (전화·카톡·이메일·회사)
  4. 신청 페이지 URL 동작 확인: scentone.imweb.me/apply
  5. 스마트스토어 상품 URL 살아있는지 확인
🚧 준비 중: ⚙️ 시스템설정 시트는 Plan P1 단계에서 신설 예정. 작성 완료 후 본 챕터 업데이트.
03. 신청 받기 (1.13~1.29) 사용 가능

신규 카페 신청을 받는 단계.

카페에 안내할 URL

신규 신청scentone.imweb.me/apply
약 5분 소요
인증 카페 둘러보기scentone.imweb.me/directory

운영자 일일 작업

  1. 운영 DB → 📋 신청내역 탭 열기
  2. 새 행(신청) 확인 — 처리 상태 = received
  3. 중복 검토 — 사업자번호·카페명 같은 카페 이미 있는지 ⌘+F
  4. 비정상 신청(테스트·장난) 발견 시 처리 상태 = rejected
🚧 준비 중: 신청내역 시트는 Phase A·D 진입 시 신설 예정. 현재는 기존 신청 폼 활용.
04. 원두 평가 (1.31~2.1) 사용 가능

도착한 원두를 평가하고 결과를 시스템에 기록.

운영자 직접 마킹 (1·2번 항목)

  1. 1. 원두 도착: 📌 대시보드 시트 → 해당 카페 행 → "1_원두도착" 컬럼 ☑ 체크박스
    → 체크 즉시 카페에 Step 2 자동 메일 발송 (onEdit 자동, 중복 발송 방지)
  2. 2. 평가 결과: 같은 행 → "커피 등급" 컬럼 → 드롭다운 선택 (통과 · 탈락 · 평가중)

드롭다운 선택 후 작업

  • 통과 → 챕터 5번 "✉️ 평가 통과 카페 승인 메일 발송" 메뉴로 일괄 발송
  • 탈락 → 별도 거절 메일 (수기 작성 또는 향후 자동화)
  • 평가중 → 아직 정해지지 않음 (기본값)
05. 승인 메일·결제 (2.2~2.3) 사용 가능

평가 통과한 카페에 승인 메일을 보내고 결제 대기.

승인 메일 일괄 발송 (운영자 작업)

  1. 📌 대시보드 → "커피 등급" 컬럼에 통과 드롭다운 입력 (여러 행 가능)
  2. 메뉴 🛠 운영 도구 → ✉️ 평가 통과 카페 승인 메일 발송 클릭
  3. "통과" + "승인 메일 발송"이 비어있는 카페만 자동 선별 → 일괄 발송

자동 메일 내용 (Phase B v0.6)

  • 📧 헤더: 콜럼버스 가이드 가로 로고
  • 📊 10단계 stepper — 현재 4단계(승인) 표시
  • 🎉 축하 인사 + 신규등록 token URL (7일 만료, 1회 사용)
  • 💳 결제 채널 안내 (스마트스토어 권장)
  • 📡 tracking pixel — 카페가 메일 열면 "3_승인 메일 열람" 컬럼 자동 갱신

자동 발송되는 6가지 단계 메일

Step 1 신청 접수신청 폼 제출 직후 자동
Step 2 원두 도착📌 대시보드 "1_원두도착" ☑ 시 자동
Step 4 평가 통과승인 메일 메뉴 클릭 시
Step 6 결제 확인결제 매칭 시 (Phase A 후)
Step 7 인증서 발급업로드 완료 시 (Phase E 후)
Step 9 발송 완료송장 입력 시 (Phase E 후)

테스트 발송

메뉴 🛠 운영 도구 → 📧 Stepper 메일 6단계 테스트 발송 → 본인(scentonehq@gmail.com) 메일로 6개 단계 메일 한 번에 발송. 메일 클라이언트(Gmail·Outlook·네이버)별 렌더 확인용.

운영자 확인

  1. 📌 대시보드 → "3_승인 메일 발송" timestamp 확인
  2. "3_승인 메일 열람" — 카페가 메일 열어봤는지 (tracking pixel)
  3. ⚙️ 로그 시트 → event_type=email_sent / email_open 로그
06. 결제 매칭 (5채널) Phase A 진행중

결제는 5개 채널로 들어옵니다. 채널별로 raw 데이터를 시트에 붙여넣으면 시스템이 자동 매칭.

5개 채널

스마트스토어구매자명 + 결제일
매칭 정확도 70%
세금계산서사업자번호
매칭 정확도 95%+
현금영수증(토스)핸드폰 + 사업자번호
매칭 정확도 95%+
기업은행입금자명 fuzzy + 학습 사전
매칭 정확도 40~90%
하나은행기업은행과 동일 함수
매칭 정확도 40~90%

raw 데이터 붙여넣기

  1. 해당 채널 사이트에서 결제 내역 export (CSV·엑셀)
  2. 운영 DB → 해당 채널 탭 열기 (예: 💳 스마트스토어)
  3. 마지막 행 다음에 붙여넣기 — 헤더는 빼고
  4. onEdit 자동 매칭 결과 확인 (matched_cafe_id 컬럼)

매칭 실패 시

  1. 운영 DB → ⚠️ 결제미매칭 탭 열기
  2. 후보 cafe_id 3개 중 선택 (학습 사전 기반)
  3. "학습사전 등록" 체크박스 ☑ → 다음 매칭 시 자동 적용
🚧 준비 중: 5채널 매칭 함수·학습 사전 시트는 Plan Phase A 진입 후 구현.
07. 인증서 발급·업로드 Phase E 후

인증서 디자인은 운영자가 직접 만들어 Drive 폴더에 업로드합니다(시스템 자동 생성 X).

발급 단계

  1. 결제 매칭 확인 후 📌 대시보드 → "인증서 폴더 링크" 클릭
  2. 해당 카페의 Drive 폴더 열림
  3. 인증서 3종을 폴더 직속에 업로드:
    • 2026_인증서디지털국문_콜럼버스카페강남점_C0001.png
    • 2026_인증서디지털영문_콜럼버스카페강남점_C0001.png
    • 2026_인증서종이국문_콜럼버스카페강남점_C0001.pdf
  4. 📌 대시보드 → 메뉴 "🔁 폴더 상태 재계산" 클릭 → "폴더 상태" 컬럼 ✅로 변경 확인

파일명 규칙 (엄수)

{연도}_{출력물}_{상호}_{cafe_id}.{확장자} — 연도 4자리, 상호는 공백·특수문자 제거

재등록 시 백업

재등록 결제 완료 시 시스템이 자동으로 이전 연도 인증서를 99_백업/ 폴더로 이동합니다. 운영자는 새 연도 인증서만 업로드.

🚧 준비 중: 인증서 lifecycle(D-046) — 폴더 자동 ensure, 백업 자동 이동 함수 Phase E 진입 후 구현.
08. 종이 인증서 인쇄 Phase E 후

매년 154+개 종이 인증서를 일괄 인쇄합니다.

일괄 인쇄 (운영자 70% 시간 절약)

  1. 운영 DB → 메뉴 📄 종이 인증서 인쇄미인쇄 일괄 인쇄 클릭
  2. 시스템이 printed_count = 0 카페의 PDF를 모두 합쳐 1개 merged PDF로 다운로드
  3. 다운로드한 PDF를 프린터에 보내기
  4. 인쇄 직후 메뉴 인쇄 카운트 +1 클릭 → 인쇄 횟수 자동 갱신

특정 카페만 인쇄

  1. 📌 대시보드 → "인쇄 선택" 컬럼 ☑ 체크 (배치 선택)
  2. 메뉴 선택한 행 인쇄 → merged PDF 다운로드

인쇄 이력

운영 DB → ⚠️ 인쇄이력 탭 — 누구·언제·몇 장 인쇄했는지 자동 기록.

🚧 준비 중: 인쇄 시스템(D-048) — Plan 8월 이후 구현.
09. 지도 등재·발송 (2.9~2월말) P1 후

인증 카페를 네이버·구글 지도에 등재하고 종이 인증서·스티커를 발송.

지도 등재 (수기 입력)

  1. 📌 대시보드 → "11_마케팅 약속" 컬럼 TRUE 카페만
  2. 운영자가 직접 지도에 콜럼버스 가이드 정보 입력
  3. 📌 대시보드 → "지도 등재일" 컬럼 날짜 입력

송장 입력

  1. 06_발송 시트에 송장번호 붙여넣기
  2. onEditShipment 자동 트리거 → 카페에 발송 완료 메일 자동 발송
10. 재등록 캠페인 10월 진입 후

인증 만료 D-30, D-7에 자동 메일 발송. 카페가 시스템에 들어와 결제만 하면 재등록 완료.

운영자가 설정하는 토글 (⚙️ 시스템설정 시트)

  • renewal_d30_enabled = TRUE/FALSE
  • renewal_d30_days = 30 (변경 가능, 21·14·7 등)
  • renewal_d7_enabled = TRUE/FALSE
  • renewal_expired_action = manual / auto

발송 결과 확인

📌 대시보드 → "재등록 캠페인 발송" 컬럼 — none / d30 / d7 / expired 중 하나로 갱신.

11. 고객 응대 (Web App 4페이지) 사용 가능

카페에 안내할 4개 페이지가 이미 동작합니다.

Hub (입구)scentone.org/CBG
모든 안내의 시작점
신규 신청scentone.imweb.me/apply
1.13~1.29 시즌
인증 카페 둘러보기scentone.imweb.me/directory
마케팅 자산
진행 상황 조회scentone.imweb.me/progress
카페 self-check

자주 받는 질문 응대

  • "신청했는데 어디서 확인하나요?" → 진행 상황 조회 페이지 안내
  • "우리 카페가 인증 카페 목록에 안 보여요" → Directory는 인증 완료 카페만. 발급 절차 진행 중인지 확인
  • "인증서 다운로드 어디서?" → Phase F 진입 후 진행 상황 페이지에서 다운로드 가능 (현재 준비 중)
12. 문제 해결 사용 가능

자주 발생하는 문제

🔴 신청 페이지가 안 열려요

  1. scentone.imweb.me 자체가 안 열리면 호스팅 점검 (Imweb)
  2. 페이지는 열리는데 폼이 안 보이면 → Apps Script 배포 만료 가능. Daniel에게 알림

🔴 결제 매칭이 자꾸 실패해요

  1. 매칭 실패 시트의 후보 cafe_id 확인 후 1대1 매칭 (주 1회)
  2. 학습사전 등록 체크박스 ☑ → 다음에는 자동 매칭
  3. 3주 이상 시스템이 못 잡는 카페가 있으면 데이터 형식 점검 (사업자번호·전화 정규화)

🔴 카페가 메일을 못 받았다고 해요

  1. ⚙️ 로그 시트에서 해당 cafe_id로 검색 → email_sent 행 확인
  2. 발송 timestamp 있으면 카페에 스팸함 확인 요청
  3. 없으면 운영자 메뉴 "📧 메일 재발송" 클릭
긴급 지원 (시스템 차원 문제):
Daniel(개발) · scentone.imweb.me 또는 시트 자체가 작동 안 할 때만
시간대 외 응답은 다음 영업일 가능