프로젝트 소개

Clubdesk Analytics는 Clubdesk에서 운영되는 웹사이트를 위해 특별히 설계된 자체 호스팅 방문자 분석 솔루션입니다. 쿠키 배너 없이 개인정보 보호 준수 통계를 제공하며, 스위스 데이터 보호법(DSG)과 EU GDPR 요구 사항을 모두 충족합니다. 기술 스택: PHP 8.1+, MariaDB 10.4+, 또는 MySQL 8+. 추적 코드는 약 100줄 정도의 가벼운 바닐라 JavaScript 스니펫으로, defer 속성을 통해 비동기적으로 로드됩니다. IP 주소는 평문으로 저장되지 않으며 하루에 한 번 해시 처리되어 다중일 지문 채취가 불가능합니다. 설정: 서브도메인과 데이터베이스를 만든 후, 설정 과정에서는 솔트, 설치 토큰, 비밀번호 해시를 구성합니다. 트래커는 Clubdesk 웹사이트 모듈의 Code Fragments → End of BODY 영역에 직접 삽입됩니다. ?edit= 매개변수를 통해 편집자 세션을 자동으로 감지하고 해당 방문에 대한 데이터 전송을 차단하여 관리자 페이지 조회가 집계되지 않도록 합니다. 선택 기능으로는 크론을 통한 주기적인 사이트맵 모니터링(30분 간격)을 이용한 콘텐츠 변경 감지와, GitHub Actions를 사용한 FTPS 기반 자동 배포가 있습니다. 보안 조치: config.php는 문서 루트 외부에 위치하며 .htaccess로 보호됩니다. HSTS 및 X-Frame-Options 같은 보안 헤더가 사전 구성되어 있으며, CORS는 명시적으로 허용된 출처만 허용됩니다.