프로젝트 소개

pvuv.ai는 Cloudflare Workers에서 실행되며 D1을 저장소 백엔드로 사용하는 경량 엣지 배포 분석 솔루션을 제공합니다. 클래식한 페이지 뷰 및 순 방문자 수 외에도 전체 UTM 파라미터, 추천인, 이탈률, 체류 시간, 수익이 포함된 맞춤 이벤트 및 교차 기기 세션 기여도를 캡처합니다. 핵심 차별점은 3단계 무효 트래픽 탐지 시스템입니다. 클라이언트 측 신호(헤드리스 특성, WebGL 핑거프린트, 허니팟), 세션 동작(타이밍, 탐색 패턴), 인구 통계(IP 세그먼트 클러스터링, 분포 테스트)를 평가합니다. 각 이벤트는 0~100점의 인증 점수와 판정 결과(clean, suspect, bot, crawler), 그리고 어떤 신호가 트리거되었는지를 나타내는 플래그를 부여받습니다. 광고 보호는 선택 사항입니다. 빠른 판정 결과를 바탕으로 플랫폼이 광고 코드 삽입 여부를 결정하여 무효 트래픽으로 인한 수익 손실 및 패널티로부터 수익을 보호합니다. 임계값은 사이트별로 설정 가능하며, 섀도 모드를 통해 운영자가 적용 전 영향을 미리 확인할 수 있습니다. 아키텍처: - 브라우저가 소형 스크립트(f.js)를 로드하여 수집 Worker(in.pvuv.ai/in)로 히트를 전송합니다. - 수집 Worker가 이벤트를 검증, 보강 및 점수화한 후 Cloudflare Queue로 전달합니다. - 컨슈머 Worker가 D1에 배치 쓰기를 수행하고 세션 및 프로필을 업데이트합니다. - 시간별 및 일별 Cron Worker가 롤업 및 인구 분석을 수행하고 KV를 통해 차단 목록을 피드백합니다. - API Worker(api.pvuv.ai/v1)가 대시보드 쿼리를 처리하며, 콘솔(pvuv.ai)은 시각적 보고서와 AI 생성 인사이트를 제공합니다. 배포는 Cloudflare의 서버리스 스택인 Workers, D1 (SQLite), Queues, KV, Cron Triggers, 그리고 선택적으로 아카이브 저장소를 위한 R2를 통해 이루어집니다. 외부 서버나 데이터베이스는 필요하지 않습니다. 빠른 시작 단계로는 저장소 클론, Wrangler를 이용한 D1, KV, Queue 리소스 생성, 비밀 키(HMAC_KEY, 선택적 AI_API_KEY) 설정, 스키마 적용 및 Worker 배포가 포함됩니다. 배포 후 콘솔에서 사이트를 등록하여 site_id를 얻고, 적절한 데이터 속성과 함께 https://js.pvuv.ai/f.js를 가리키는 스크립트 태그를 삽입하면 됩니다. 개인정보 보호 고려 사항이 내장되어 있습니다. IP 주소는 절단된 해시 형태로만 저장되며, 기기 핑거프린트는 해싱 처리되고 센서 데이터는 단순 불리언 값으로 제한됩니다. 배포자는 특히 핑거프린팅 동의와 관련하여 GDPR/ePrivacy 규정 준수를 보장해야 합니다. 이 프로젝트는 초기 개발 단계이며, 4가지 마일스톤으로 구성된 로드맵을 가지고 있습니다: M1(기본 SDK, 수집, 빠른 판정, 최소 콘솔), M2(세션 지표, 롤업, 차단 목록 루프), M3(맞춤 이벤트, 수익, 퍼널 기여도), M4(AI 보고서, 고급 부정 방지, 인간 검토 UI). 기여는 언제나 환영하며, 보안 문제는 비공개로 보고해야 합니다. 코드는 GNU AGPL-3.0 라이선스 하에 제공되어 무료 셀프 호스팅 및 수정이 가능하지만, 네트워크 서비스 제공 시 소스 공개가 필요합니다.