TimeTracker/docs/all_tracked_events.md

All Tracked Events in TimeTracker

This document lists events tracked via PostHog and JSON logging.

Two layers:

• Base telemetry (always on when PostHog configured): base_telemetry.first_seen, base_telemetry.heartbeat — minimal install footprint, no PII.
• Detailed analytics (opt-in only): All events below are sent only when the user has enabled detailed analytics in Admin → Privacy & Analytics (or Telemetry dashboard). See Telemetry Architecture.

Base Telemetry Events (Always-On Layer)

Event Name	Description	Properties
base_telemetry.first_seen	First time this install is seen	install_id, app_version, platform, os_version, architecture, locale, timezone, first_seen_at, last_seen_at, heartbeat_at, release_channel, deployment_type
base_telemetry.heartbeat	Periodic heartbeat (e.g. daily)	Same as above; last_seen_at / heartbeat_at updated

Authentication Events (Opt-In Layer)

Event Name	Description	Properties
auth.login	User successfully logs in	user_id, username
auth.login_failed	Login attempt fails	reason, username (if provided)
auth.logout	User logs out	user_id

Timer Events

Event Name	Description	Properties
timer.started	Timer starts for a time entry	user_id, entry_id, project_id, task_id (optional)
timer.stopped	Timer stops for a time entry	user_id, entry_id, duration_seconds

Project Events

Event Name	Description	Properties
project.created	New project is created	user_id, project_id, client_id (optional)
project.updated	Project details are updated	user_id, project_id
project.archived	Project is archived	user_id, project_id
project.deleted	Project is deleted	user_id, project_id

Task Events

Event Name	Description	Properties
task.created	New task is created	user_id, task_id, project_id, priority
task.updated	Task details are updated	user_id, task_id, project_id
task.status_changed	Task status changes	user_id, task_id, old_status, new_status
task.deleted	Task is deleted	user_id, task_id, project_id

Client Events

Event Name	Description	Properties
client.created	New client is created	user_id, client_id
client.updated	Client details are updated	user_id, client_id
client.archived	Client is archived	user_id, client_id
client.deleted	Client is deleted	user_id, client_id

Invoice Events

Event Name	Description	Properties
invoice.created	New invoice is created	user_id, invoice_id, project_id, total_amount
invoice.updated	Invoice details are updated	user_id, invoice_id, project_id
invoice.sent	Invoice is sent to client	user_id, invoice_id
invoice.paid	Invoice is marked as paid	user_id, invoice_id
invoice.deleted	Invoice is deleted	user_id, invoice_id

Report Events

Event Name	Description	Properties
report.viewed	User views a report	user_id, report_type, date_range
export.csv	User exports data to CSV	user_id, export_type, row_count
export.pdf	User exports data to PDF	user_id, export_type

Comment Events

Event Name	Description	Properties
comment.created	New comment is created	user_id, comment_id, target_type (project/task)
comment.updated	Comment is edited	user_id, comment_id
comment.deleted	Comment is deleted	user_id, comment_id

Admin Events

Event Name	Description	Properties
admin.user_created	Admin creates a new user	user_id, new_user_id
admin.user_updated	Admin updates user details	user_id, target_user_id
admin.user_deleted	Admin deletes a user	user_id, deleted_user_id
admin.settings_updated	Admin updates system settings	user_id
admin.telemetry_dashboard_viewed	Admin views telemetry dashboard	user_id
admin.telemetry_toggled	Admin toggles telemetry on/off	user_id, enabled

Setup Events

Event Name	Description	Properties
setup.completed	Initial setup is completed	telemetry_enabled

Privacy Note

All events listed above are tracked only when:

1. Telemetry is explicitly enabled by the user during setup or in admin settings
2. PostHog API key is configured

No personally identifiable information (PII) is ever collected:

• ❌ No email addresses, usernames, or real names
• ❌ No project names, descriptions, or client data
• ❌ No time entry notes or descriptions
• ❌ No IP addresses or server information
• ✅ Only internal numeric IDs and event types

For more information, see Privacy Policy and Analytics Documentation.