그누보드7 방문 분석 모듈 - Glitter Analytics

개요

glitter-analytics는 그누보드7(G7) 환경을 위한 개인정보 보호 중심(Privacy-first)의 방문 분석(Analytics) 모듈입니다.

관리자는 방문 현황과 통계를 확인하고 CSV로 내보낼 수 있으며, 개인정보 수집을 최소화하도록 설계되었습니다.

주요 기능

Dashboard

• 방문 통계 대시보드
• 일별 방문 현황
• 핵심 통계 요약

Visit Analytics

• 방문 기록 조회
• 기간별 검색
• 다양한 조건 필터링
• 페이지별 방문 분석

CSV Export

• 대용량 스트리밍 CSV
• UTF-8 BOM 지원
• Excel 호환 출력
• Formula Injection 방어

Privacy

• IP Hash 처리
• Query String 제거
• Referrer Host 정규화
• 민감 정보 저장 방지
• Do Not Track(DNT) 지원
• Bot 트래픽 필터링

Administration

• 관리자 권한 기반 접근 제어
• Analytics 설정 관리
• 데이터 보존 기간 관리

활용 사례

• 커뮤니티 방문 분석
• 기업 웹사이트 통계
• 쇼핑몰 방문 현황
• 서비스 운영 모니터링
• 개인정보 보호 중심 Analytics 구축

기술 스택

• PHP 8.3+
• Laravel 12.x
• MySQL
• Laravel Sanctum
• TypeScript
• Vite

관리자 페이지에서 설치

1. GitHub 저장소에서 설치 (권장)

관리자 → 모듈 관리 → 수동 설치 → GitHub

다음 저장소 URL을 입력합니다.

https://github.com/glitter-node/glitter-analytics

설치가 완료되면 모듈을 활성화합니다.

2. ZIP 패키지 설치

Release에서 번들 패키지를 다운로드한 후
관리자 → 모듈 관리 → 수동 설치 → 파일 업로드를 통해 설치할 수도 있습니다.

3. 설치 후 생성된 페이지의 로드 에러 발생 시

관리자 → 환경설정 → 고급 → 캐시 모두 삭제

저장소

GitHub

https://github.com/glitter-node/glitter-analytics

Release

https://github.com/glitter-node/glitter-analytics/releases/tag/v0.7.1

개발 상태

v0.7.1 — Open Beta

실제 운영 환경에서 사용할 수 있는 수준으로 개발되었으며, 1.0 Stable 릴리스를 목표로 자동 회귀 테스트와 기능 안정화를 지속적으로 진행하고 있습니다.

라이선스

MIT License.

최적의 설치

이 버전은 ZIP 설치보다 GitHub 저장소 설치를 하도록 구성했습니다. 현재 GnuBoard7 관리자에서 GitHub 저장소 URL만으로 설치가 정상 동작하는 것이 확인되었습니다. 이 방식이 가장 권장되는 설치 방법입니다.