============================================
  RankFinder Collector v1.1.0
  네이버 쇼핑 순위 + 노출 형태 자동 수집기
============================================


[ 이 프로그램이 하는 일 ]

매일 12시 / 16시 / 20시 (KST)에 자동으로:
 1. 네이버 플러스스토어(/ns/search) 키워드별 순위 수집
 2. ★NEW★ 각 상품의 노출 형태(단독/가격비교/카탈로그) 자동 감지
 3. 어제와 비교해서 변경 감지 → 사이트에 빨간 알림 카드
 4. 모든 결과를 https://rankfinder.pages.dev 에 저장

수집은 백그라운드에서 5~10분 정도 조용히 진행됩니다.
화면에 창이 뜨지 않습니다. 일상 작업에 방해 0.


[ 처음 사용 시 (1회만) ]

★ 사전 작업 — Supabase SQL Editor에서 1번만 실행:

  ALTER TABLE products
    ADD COLUMN IF NOT EXISTS listing_type TEXT,
    ADD COLUMN IF NOT EXISTS listing_type_checked_at TIMESTAMPTZ;

  CREATE TABLE IF NOT EXISTS listing_type_changes (
    id BIGSERIAL PRIMARY KEY,
    product_id UUID NOT NULL REFERENCES products(id) ON DELETE CASCADE,
    from_type TEXT,
    to_type TEXT NOT NULL,
    detected_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
    notified BOOLEAN NOT NULL DEFAULT FALSE
  );

(SQL 안 돌려도 키워드 수집은 계속 작동하지만,
 노출 형태 감지·변경 알림은 작동 안 함)

★ 노트북에서:
1. setup.bat 더블클릭
2. 자동으로 Node.js / Playwright / 작업 스케줄러 설정
3. "셋업 완료" 메시지가 뜨면 끝
4. (선택) 테스트 실행으로 첫 데이터 수집 확인


[ Node.js 설치 안내 ]

setup.bat이 Node.js를 찾을 수 없다면:
 - https://nodejs.org/ko/ 접속
 - "LTS" 버전 다운로드 (왼쪽 초록 버튼)
 - 다운받은 .msi 더블클릭 → "Next" 계속 → "Install"
 - 설치 완료 후 setup.bat 다시 실행


[ 노트북 운영 ]

 - 노트북은 매일 12시, 16시, 20시에 켜져 있어야 합니다.
 - 절전 모드는 OK (자동으로 깨어남)
 - 노트북 종료 시 그 시간 데이터는 수집 안 됩니다.
 - 사무실 인터넷이 살아있어야 합니다.


[ 수동 실행 ]

언제든지 run.bat 을 더블클릭하면 즉시 1회 수집됩니다.
즉시 검증·디버깅용으로 유용.


[ 노출 형태 감지 로직 (v1.1.0 신기능) ]

각 상품 페이지를 방문해 우측 라벨을 검출:
 - "브랜드 카탈로그"    →  🎁 brand_catalog
 - "쇼핑몰별 최저가"    →  📦 lowest_compare (외부몰 포함)
 - "가격비교" 박스만   →  💰 compare (일반 가격비교)
 - "브랜드스토어"       →  🏷️ brand (브랜드 단독)
 - 라벨 없음           →  🔓 standalone (스마트스토어 단독)

어제와 다르면 DB의 listing_type_changes 에 INSERT →
사이트 상단에 "🚨 가격비교 묶임 감지" 빨간 카드 자동 표시.


[ 로그 확인 ]

logs/plus-collect-YYYY-MM-DD.log 파일에 자세한 결과.
문제가 있으면 가장 최근 로그 파일을 열어보세요.


[ 제거 ]

uninstall.bat 더블클릭 → 작업 스케줄러 제거
그 다음 이 폴더를 통째로 삭제하면 완전 제거됩니다.


[ 도움 ]

문제가 생기면 logs 폴더의 로그 파일과 함께
도야마케팅 담당자에게 문의하세요.

============================================
