VOC_Monitor/collector_worker

VOC Collector Worker

별도 프로젝트로 분리되는 크롤링/업서트 워커입니다.

목적

• Humetro VOC를 수집
• Supabase voc_posts 테이블에 upsert
• 클라이언트 앱은 Supabase pull/realtime + 로컬 캐시를 사용

실행

python collector_worker/main.py
python collector_worker/main.py --once
python collector_worker/main.py --config collector_worker/config/settings.json --once

빌드 (실행파일)

python collector_worker/build_setup.py

산출물:

• collector_worker/dist/voc_collector_worker.exe
• collector_worker/dist/settings.example.json

Windows 백그라운드 실행

• 실행 배치: collector_worker/windows/run_worker.bat
• 작업 스케줄러 등록: collector_worker/windows/install_task.ps1

powershell -ExecutionPolicy Bypass -File collector_worker/windows/install_task.ps1

설정

• collector_worker/config/settings.json (운영)
• collector_worker/config/settings.example.json (샘플)

기본 예시 URL은 https://kong2.m1tcloud.cc 입니다.

Supabase 초기 스키마

• 파일:
  • collector_worker/sql/001_init_posts_schema.sql
  • collector_worker/sql/002_init_program_versions_schema.sql
  • collector_worker/sql/003_voc_posts_rls_policy.sql
• Supabase SQL Editor에서 실행하면 아래가 생성됩니다.
  • public.voc_posts, public.voc_posts_public
  • public.program_versions

주의

• 서비스키/anon key를 레포에 커밋하지 않습니다.
• 이 워커는 UI 없이 백그라운드 실행을 전제로 합니다.
• 실패 시 retry_backoff_seconds 후 자동 재시도합니다.
• 실행/디버그 로그는 기존 프로젝트 로거를 사용하며 app/logs/voc_monitor.log에 기록됩니다.