mirror of https://github.com/DRYTRIX/TimeTracker.git synced 2026-05-17 01:49:35 -05:00

Files

T

Dries Peeters b0dde80ba9 feat(web): high-visibility support modal, prompts, and supporter UX

Add a support modal with usage stats, tier and license links, share control, and offline-safe outbound CTAs. Surface support from the header, sidebar, user menu, dashboard card, and settings "Support & Community" section without hiding entry points when a supporter license is active.

Introduce UsageStatsService and a persisted users.support_stats_reports_generated counter incremented on key report exports and custom report views. Add SupportPromptService for session-scoped soft toasts (after export, dashboard milestones, long session via POST /donate/request-soft-prompt).

Wire consent-aware track_event names support.* and mirror funnel rows in DonationInteraction; fix has_recent_donation_click to treat link_clicked as a recent click. Document events and SUPPORT_* / migration notes in docs.

Tests: tests/test_support_services.py for prompt and usage stats behavior.

2026-04-15 10:55:37 +02:00

2.3 KiB

Raw Blame History

Analytics and Monitoring

TimeTracker provides privacy-aware analytics and monitoring with Grafana Cloud OTLP as the telemetry sink.

Overview

Structured JSON Logging - Application event logs in logs/app.jsonl
Sentry Integration - Error monitoring and tracing (optional)
Prometheus Metrics - Runtime metrics at /metrics
Grafana OTLP Telemetry - Installation + product analytics telemetry

Telemetry Model

Base telemetry (anonymous, default behavior)

Installation-level telemetry (base_telemetry.first_seen, base_telemetry.heartbeat)
Includes install UUID, app version, platform, OS, architecture, locale, timezone
No direct PII fields

Detailed analytics (explicit opt-in only)

Product events such as timer.started, project.created, auth.login
Sent only when admins enable detailed analytics in the app
PII-filtered before export
Support UI funnel events (support.modal_opened, support.donation_clicked, etc.) are emitted the same way when opt-in is enabled; see all_tracked_events.md.

Configuration

# Grafana OTLP sink
GRAFANA_OTLP_ENDPOINT=https://otlp-gateway-.../otlp/v1/logs
GRAFANA_OTLP_TOKEN=your-token

# Detailed analytics consent switch (app-controlled per installation)
ENABLE_TELEMETRY=true

# Optional error monitoring
SENTRY_DSN=
SENTRY_TRACES_RATE=0.1

# Support / checkout links (optional; defaults in app/config.py)
SUPPORT_PURCHASE_URL=https://timetracker.drytrix.com/support.html
SUPPORT_PORTAL_BASE=https://timetracker.drytrix.com
# Optional one line shown in the support modal when set
SUPPORT_SOCIAL_PROOF_TEXT=
# Optional per-tier donate URLs (default to SUPPORT_PURCHASE_URL when unset)
SUPPORT_DONATE_EUR5_URL=
SUPPORT_DONATE_EUR10_URL=
SUPPORT_DONATE_EUR25_URL=
# Long-session soft prompt threshold in minutes (default 120)
SUPPORT_LONG_SESSION_MINUTES=120

Per-user report generation counts for the support modal are stored in users.support_stats_reports_generated (see migration 149_add_user_support_stats_reports_generated).

Troubleshooting

If no telemetry arrives, verify GRAFANA_OTLP_ENDPOINT and GRAFANA_OTLP_TOKEN
If detailed events are missing, confirm detailed analytics is enabled in admin settings
If only base events appear, consent is likely disabled (expected behavior)

2.3 KiB Raw Blame History