About this project

Risulta is an open-source web analytics solution designed for privacy and simplicity. It allows users to track multiple websites from a single login and process. The system is distributed as a single executable compiled with Bun and utilizes SQLite for data storage, with a separate database for each tracked website to ensure isolation. Key features include: - **Privacy-First Tracking**: No cookies are used. Unique visitors are tracked using daily salted hashes of IP addresses and User-Agents, ensuring visitors cannot be linked across different days. - **Multi-site Management**: A central dashboard allows administrators to manage multiple sites and create viewer accounts with restricted access. - **Comprehensive Metrics**: Tracks unique visitors, visitor-days, visits, and current active visitors. It supports acquisition attribution via UTM parameters and referrers. - **Custom Events**: Provides a JavaScript API (`window.risulta.track`) for tracking custom events with optional numeric values. - **Reporting & API**: Offers detailed reports for pages, sources, mediums, campaigns, and events, with CSV export and a JSON API for external data access. - **Operational Tools**: Includes built-in backup and verification commands for SQLite databases and a `/metrics` endpoint for runtime diagnostics. The system is designed for easy deployment on Linux VPS (specifically Debian/Ubuntu) and can be integrated with Caddy for HTTPS termination.