4개 메인 탭

• 프로모션 캘린더 — 달력 형태로 할인 이벤트를 확인합니다. 기본 탭.
• 채널 비교 — 선택한 날짜의 채널별 가격을 바 차트로 비교합니다. 상단 ◂ ▸ 버튼으로 날짜를 이동할 수 있습니다.
• 판매가 추이 — 상품 하나를 선택하면 채널별 가격 변동을 시계열 라인 차트로 보여줍니다. 판매가가 없는 날짜는 상시가(점선)로 대체 표시됩니다.
• 가격 일괄 변경 — 여러 채널·상품의 가격을 한꺼번에 수정합니다.

필터 사용법

채널 칩 (상단): 클릭하면 해당 채널이 토글됩니다. "전체"를 누르면 모든 채널을 한 번에 선택/해제합니다. 각 채널에는 아이콘이 표시됩니다.

상품 리스트 (왼쪽 사이드바): 체크하면 해당 상품이 화면에 표시됩니다. "전체 선택"으로 모든 상품을 한 번에 선택할 수 있습니다.

기간 설정

상단의 📅 기간 선택 버튼을 누르면 달력 모달이 열립니다. 시작일과 종료일을 클릭하고 "적용하기"를 누르면 해당 기간의 데이터만 표시됩니다.

가격 일괄 변경 방법

날짜 자동 생성

입력한 기간에 DB에 아직 없는 날짜가 포함되면, "자동 생성 후 저장할까요?" 팝업이 뜹니다. 확인하면 선택한 채널×상품 조합의 빈 행만 생성한 뒤 저장합니다.

실수 방지

• 0원, 음수, 9,999,999원 초과 가격은 입력할 수 없습니다.
• 저장 전 "N개 채널 × N개 상품, 총 N건" 확인 팝업이 표시됩니다.
• 실수로 잘못 저장했다면 구조 관리 → 되돌리기에서 마지막 저장을 원복할 수 있습니다.

저장 결과

저장 완료/실패 여부는 화면 하단 토스트 알림으로 표시됩니다. 저장 후 대시보드가 자동으로 갱신되며, 기존 채널/상품 선택 상태는 유지됩니다.

프로모션 캘린더 보는 법

달력에는 할인 혜택이 적용된 항목만 색상 바로 표시됩니다. 각 바에는 채널 아이콘, 상품명, 원래가(취소선), 할인가, 할인율이 표시됩니다.

할인 판정 기준

상품의 현재 가격이 _CONFIG에 등록된 상시가(nPrice)보다 낮으면 "할인 중"으로 표시됩니다.

이벤트 바 동작

• 연속된 날짜에 같은 가격이면 하나의 긴 바로 합쳐집니다.
• 바를 클릭하면 "가격 일괄 변경" 탭으로 이동하여 해당 기간 가격을 수정할 수 있습니다.

전체 단가표

상단의 📊 전체 단가표 버튼을 누르면 _CONFIG에 등록된 상시가/프로모션가/엔딩가가 플로팅 윈도우로 표시됩니다. 드래그로 위치 이동, 투명도 슬라이더로 뒤쪽 화면과 비교할 수 있습니다.

순위 패널

오른쪽 사이드바에 현재 선택된 날짜 기준으로 채널별 가격을 저렴한 순으로 정렬합니다. 🏆 순위 패널 열기/닫기 버튼으로 토글합니다.

판매가 추이 차트

상단 드롭다운에서 상품을 선택하면 채널별 가격 변동이 라인 차트로 표시됩니다. 실선은 실제 판매가, 점선(속이 빈 원)은 판매가가 없어 상시가로 대체한 구간입니다.

초기 설정 관리자

최초 배포 시 Apps Script 편집기에서 setup() 함수를 1회 실행합니다.

• _AUDIT_LOG 시트 생성 — 모든 가격 변경 이력이 자동 기록됩니다.
• 트리거 3종 등록 — 편집 감지, AUDIT_LOG 주간 아카이빙(일요일 03시), DB 야간 정렬(매일 02시).

구조 관리 모달 관리자

상단의 ⚙️ 구조 관리 버튼을 누르면 모달 창이 열립니다. 5개 탭에서 다음 작업을 수행할 수 있습니다:

• 상품 추가: 상품명, 상시가/프로모션가/엔딩가를 입력하여 _CONFIG와 DB에 동시 등록.
• 채널 추가: 채널명을 입력하여 등록.
• 날짜 추가: 쉼표로 구분된 날짜를 입력하여 전체 채널×상품의 빈 행을 DB에 생성.
• 운영 전환: 채널/상품별 운영↔미운영 상태를 버튼 클릭으로 전환.
• 되돌리기(Undo): 마지막 저장 배치의 미리보기를 확인하고 원복.

동기화 관리자

상단의 🔄 동기화 버튼은 DB와 _CONFIG 사이의 불일치를 감지합니다.

• DB에만 있는 상품/채널 → _CONFIG에 자동 등록 제안
• _CONFIG에만 있는 상품/채널(DB에 없음) → 알림 표시

자동 관리 관리자

• AUDIT_LOG 아카이빙: 매주 일요일 90일 이상 된 기록을 _AUDIT_LOG_ARCHIVE로 자동 이동. 보존기간은 변경 가능.
• DB 야간 정렬: 매일 새벽 2시에 날짜→채널→상품 순으로 자동 정렬. 스프레드시트를 직접 열 때 가독성 유지.

두 작업 모두 스프레드시트 메뉴 → "운영가 대시보드"에서 수동 실행할 수도 있습니다.

자주 묻는 문제

Q. "시트 로딩 중..."에서 멈춰요

시트 이름에 "운영가"가 포함되어 있는지 확인하세요. 권한 문제일 수도 있으니 스프레드시트에 접근 가능한 계정인지 확인하세요.

Q. DB에 데이터가 없는데 화면이 비어요

_CONFIG에 상품과 채널이 등록되어 있으면 채널 칩과 상품 리스트는 표시됩니다. 가격 일괄 변경 탭에서 가격을 입력하면 자동으로 DB 행이 생성됩니다.

Q. "다른 사용자가 저장 중입니다"라고 떠요

동시에 여러 사용자가 저장하면 순서대로 처리됩니다. 30초 정도 기다린 후 다시 시도하세요.

Q. 잘못된 가격을 저장했어요

⚙️ 구조 관리 → 되돌리기 탭에서 마지막 저장을 원복할 수 있습니다. 미리보기로 대상 건수를 확인한 뒤 실행하세요.

Q. 시트에서 직접 고친 게 웹앱에 안 보여요

시트 드롭다운에서 같은 시트를 다시 선택하거나 새로고침하면 반영됩니다.

Q. 로딩이 오래 걸려요

최초 로딩 시 전체 데이터를 파싱하므로 시간이 걸릴 수 있습니다. 이후 접속은 캐시 덕분에 빨라집니다. 계속 느리면 스프레드시트 메뉴 → "전체 캐시 무효화"를 실행하세요.

Q. 가격 변경 이력을 확인하고 싶어요

스프레드시트의 _AUDIT_LOG 시트에서 시간·사용자·이전값·새값을 확인할 수 있습니다. 90일 이상 된 기록은 _AUDIT_LOG_ARCHIVE에 자동 보관됩니다.

긴급 조치