mirror of https://github.com/DRYTRIX/TimeTracker.git synced 2026-01-05 19:20:21 -06:00

Files

Dries Peeters e4789cc26e feat: Add telemetry and analytics infrastructure with observability stack

Implement comprehensive analytics and monitoring system with PostHog integration,
complete observability stack (Prometheus, Grafana, Loki, Promtail), and CI/CD
workflows for automated builds.

Features:
- Add PostHog telemetry integration with privacy-focused event tracking
- Implement installation flow for opt-in telemetry configuration
- Add telemetry management UI in admin panel with detailed transparency
- Track key user events across all major features (projects, tasks, timer, etc.)

Infrastructure:
- Set up Prometheus for metrics collection
- Configure Grafana for visualization dashboards
- Integrate Loki and Promtail for log aggregation
- Add separate analytics docker-compose configuration

CI/CD:
- Add GitHub Actions workflows for building and publishing Docker images
- Implement separate dev and production build pipelines
- Configure automated image publishing to registry

Documentation:
- Restructure documentation into organized docs/ directory
- Add comprehensive guides for telemetry, analytics, and local development
- Create transparency documentation for tracked events
- Add CI/CD and build configuration guides

Code improvements:
- Integrate telemetry hooks across all route handlers
- Add feature flags and configuration management
- Refactor test suite for analytics functionality
- Clean up root directory by moving docs and removing test artifacts

Breaking changes:
- Requires new environment variables for PostHog configuration
- Docker compose setup now supports analytics stack

Changes: 73 files changed, 955 insertions(+), 14126 deletions(-)

2025-10-20 14:38:57 +02:00

6.1 KiB

Raw Blame History

Keyboard Shortcuts & Notifications Fix 🔧

Issues Fixed

1. JavaScript Error in smart-notifications.js ✅

Error: Uncaught TypeError: right-hand side of 'in' should be an object, got undefined

Root Cause: The code was checking 'sync' in window.registration, but window.registration doesn't exist.

Fix: Updated the startBackgroundTasks() method to properly check for service worker sync support:

startBackgroundTasks() {
    if ('serviceWorker' in navigator) {
        navigator.serviceWorker.ready.then(registration => {
            if (registration && registration.sync) {
                registration.sync.register('sync-notifications').catch(() => {
                    // Sync not supported, ignore
                });
            }
        }).catch(() => {
            // Service worker not ready, ignore
        });
    }
}

2. Notification Permission Error ✅

Error: "De notificatietoestemming mag alleen vanuit een kortwerkende door de gebruiker gegenereerde gebeurtenis-handler worden opgevraagd."

Root Cause: Browser security policy prevents requesting notification permissions on page load. Permissions can only be requested in response to a user action (like clicking a button).

Fix:

Changed init() to call checkPermissionStatus() instead of requestPermission()
checkPermissionStatus() only checks the current permission state without requesting
requestPermission() can now be called from user interactions (like clicking the "Enable" button)
Added an "Enable Notifications" banner in the notification center panel

3. Ctrl+/ Not Working ✅

Root Cause: The isTyping() method had conflicting logic that would first allow Ctrl+/ but then immediately block it again.

Fix: Rewrote the isTyping() method with clearer logic:

isTyping(e) {
    const target = e.target;
    const tagName = target.tagName.toLowerCase();
    const isInput = tagName === 'input' || tagName === 'textarea' || target.isContentEditable;
    
    // Don't block anything if not in an input
    if (!isInput) {
        return false;
    }
    
    // Allow Escape in search inputs
    if (target.type === 'search' && e.key === 'Escape') {
        return false;
    }
    
    // Allow Ctrl+/ and Cmd+/ even in inputs for search
    if (e.key === '/' && (e.ctrlKey || e.metaKey)) {
        return false;
    }
    
    // Allow Ctrl+K and Cmd+K even in inputs for command palette
    if (e.key === 'k' && (e.ctrlKey || e.metaKey)) {
        return false;
    }
    
    // Allow Shift+? for shortcuts panel
    if (e.key === '?' && e.shiftKey) {
        return false;
    }
    
    // Block all other keys when typing
    return true;
}

What Now Works