mirror of https://github.com/DRYTRIX/TimeTracker.git synced 2026-05-24 23:30:28 -05:00

Files

T

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

13 KiB

Raw Blame History

📅 Calendar Quick Wins - Visual Guide

Before & After Comparison

🎯 What You'll See Now

┌─────────────────────────────────────────────────────────────────┐
│  Calendar Header                                                │
├─────────────────────────────────────────────────────────────────┤
│  🔹 [Today] [Day] [Week▼] [Month] [Agenda]                     │
│  🔹 [New Event] [Recurring] [Export▼]                           │
│                                                                  │
│  FILTERS:                                                        │
│  [All Projects▼] [All Tasks▼] [Filter by tags...]              │
│  [💰 Billable Only] [Clear]  📊 Total Hours: 32.5h  ← NEW!     │
└─────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────┐
│  Daily Capacity Bar (Day View Only)              ← NEW!         │
├─────────────────────────────────────────────────────────────────┤
│  Wednesday, December 11, 2024      6.5h / 8h (81%)              │
│  ████████████████████░░░░░░░  🟢 Under capacity                │
└─────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────┐
│  Calendar Grid                                                   │
│  (Events displayed here)                                         │
└─────────────────────────────────────────────────────────────────┘

🆕 New Features Showcase

1️⃣ Billable-Only Filter

Inactive State:

┌──────────────────┐
│ 💰 Billable Only │  ← Click to activate
└──────────────────┘

Active State:

┌──────────────────┐
│ 💰 Billable Only │  ← Now showing only billable
└──────────────────┘
(Green background when active)

2️⃣ Total Hours Display

Always Visible:

┌───────────────────────┐
│ Total Hours: 32.5h    │  ← Updates in real-time
└───────────────────────┘

Changes with filters:

All entries: 40.5h
Billable only: 32.5h
Project Alpha: 18.0h

3️⃣ Daily Capacity Bar

Healthy Capacity (< 90%):

Monday, Dec 9, 2024                    6.0h / 8h (75%)
████████████████░░░░░░░░░░░░░  🟢 Under capacity

At Capacity (90-100%):

Tuesday, Dec 10, 2024                  7.5h / 8h (94%)
██████████████████████████░░░  🟡 At limit

Over Capacity (> 100%):

Wednesday, Dec 11, 2024                10.0h / 8h (125%)
██████████████████████████████  🔴 OVER CAPACITY

4️⃣ Event Duplication

Event Detail Modal (Before):

┌─────────────────────────────────┐
│  Time Entry Details             │
├─────────────────────────────────┤
│  Project: Alpha                 │
│  Task: Homepage Design          │
│  ...                            │
├─────────────────────────────────┤
│  [Delete] [Close] [Edit]        │
└─────────────────────────────────┘

Event Detail Modal (After):

┌─────────────────────────────────┐
│  Time Entry Details             │
├─────────────────────────────────┤
│  Project: Alpha                 │
│  Task: Homepage Design          │
│  ...                            │
├─────────────────────────────────┤
│  [Delete] [Close] [📋 Duplicate] [Edit]  ← NEW!
└─────────────────────────────────┘

Duplication Flow:

1. Click entry → [Duplicate] button appears
2. Click [Duplicate]
3. Enter: "2024-12-12 14:00"
4. ✅ New entry created with same properties

5️⃣ Keyboard Shortcuts

Press ? to see:

┌────────────────────────────────────────────────────┐
│  Keyboard Shortcuts                                │
├────────────────────────────────────────────────────┤
│  NAVIGATION          VIEWS              ACTIONS    │
│  ───────────         ─────              ───────    │
│  [T] Today           [D] Day            [C] Create │
│  [N] Next            [W] Week           [F] Filter │
│  [P] Previous        [M] Month          [?] Help   │
│  [←][→] Navigate     [A] Agenda         [Esc] Close│
│                                                     │
│                      [Got it!]                      │
└────────────────────────────────────────────────────┘

⌨️ Keyboard Shortcut Cheat Sheet

Quick Reference Card

╔════════════════════════════════════════════╗
║        CALENDAR KEYBOARD SHORTCUTS         ║
╠════════════════════════════════════════════╣
║                                            ║
║  NAVIGATION                                ║
║  ───────────                               ║
║  T         Jump to Today                   ║
║  N         Next Week/Month                 ║
║  P         Previous Week/Month             ║
║  ← →       Navigate Days                   ║
║                                            ║
║  VIEWS                                     ║
║  ─────                                     ║
║  D         Day View                        ║
║  W         Week View                       ║
║  M         Month View                      ║
║  A         Agenda View                     ║
║                                            ║
║  ACTIONS                                   ║
║  ───────                                   ║
║  C         Create New Entry                ║
║  F         Focus Filter                    ║
║  Shift+C   Clear All Filters               ║
║  Esc       Close Modal                     ║
║                                            ║
║  HELP                                      ║
║  ────                                      ║
║  ?         Show This Help                  ║
║                                            ║
╚════════════════════════════════════════════╝

🎬 Usage Scenarios

Scenario A: Monday Morning Planning

1. Open calendar (shows this week)
   Total Hours: 0h
   
2. Press [D] for Day view
   Capacity: 0h / 8h (0%) 🟢
   
3. Create entries for the day
   
4. End result:
   Capacity: 7.5h / 8h (94%) 🟡
   Perfect! Room for one more task

Scenario B: Invoicing Prep

1. Navigate to billing period
   Press [P] [P] [P] to go back 3 weeks
   
2. Click [💰 Billable Only]
   Total Hours: 32.5h → Only billable shown
   
3. Press [M] for Month view
   See all billable work at a glance
   
4. Export for invoice
   Click [Export] → CSV Format

Scenario C: Duplicate Weekly Meeting

1. Find last week's meeting entry
   Press [P] to go back one week
   
2. Click the meeting entry
   Modal opens with details
   
3. Click [Duplicate]
   Enter: "2024-12-11 10:00"
   
4. ✅ Meeting added to this week
   All notes and properties copied!

Scenario D: Quick Capacity Check

Day View:
┌────────────────────────────────────────┐
│  Thursday, Dec 12, 2024                │
│  8.5h / 8h (106%) 🔴 OVER CAPACITY     │
│  █████████████████████████████         │
└────────────────────────────────────────┘

Action: Need to reschedule something!

📱 Mobile View

Touch-Friendly Design Maintained

Mobile Header (Collapsed):
┌────────────────────────┐
│ ☰ Calendar        [+]  │
├────────────────────────┤
│ < Dec 11, 2025 >      │
├────────────────────────┤
│ Total: 6.5h           │
│ ██████░░░░  6.5h/8h   │
├────────────────────────┤
│ [💰 Billable] [Clear] │
└────────────────────────┘

(All features work on mobile!)

🎨 Color Coding Guide

Capacity Bar Colors

🟢 GREEN (0-89%)
   ████████████░░░░░░░░░░░░
   Healthy capacity, room for more

🟡 YELLOW (90-99%)
   ████████████████████░░░░
   At capacity, careful adding more

🔴 RED (100%+)
   ████████████████████████
   OVER capacity, consider reducing

💡 Pro Tips

Press [T] → Always returns to today
Press [N] three times → 3 weeks ahead
Press [P] [P] → 2 weeks back

Tip 2: Quick Billable Summary

1. Press [M] for Month view
2. Click [💰 Billable Only]
3. Check Total Hours
4. Export if needed

Tip 3: Keyboard Flow

[T] → [D] → Check capacity → [C] → Create entry
(Today → Day view → Check → Create)

Tip 4: Learn Shortcuts

1. Press [?] to open help
2. Keep it open while working
3. Practice each shortcut
4. After 1 week, you'll be a pro!

🎯 Key Metrics to Watch

Your Dashboard

┌─────────────────────────────────┐
│  THIS WEEK                      │
│  ─────────                      │
│  Total Hours:     32.5h         │
│  Billable:        24.5h (75%)   │
│  Capacity Used:   81%  🟢       │
│  Days Over:       0  ✅         │
└─────────────────────────────────┘

(All visible at a glance!)

🚀 Getting Started

First 5 Minutes

Open calendar → See new total hours display
Press [?] → Learn keyboard shortcuts
Press [D] → See capacity bar
Click any entry → See duplicate button
Click [💰 Billable Only] → Filter billable work

That's it! You're ready to go! 🎉

📞 Quick Help

Common Questions

Q: Where's the capacity bar?
A: Press D for Day view - only shows there

Q: How to use shortcuts?
A: Press ? to see full list

Q: Total hours wrong?
A: Check active filters - only shows visible events

Q: Can't duplicate?
A: Use format: YYYY-MM-DD HH:MM (e.g., 2024-12-11 14:30)

Q: Shortcuts not working?
A: Click away from input fields first

🎉 You're All Set!

All Quick Wins are now live and ready to use. Enjoy your improved calendar experience!

Remember: Press ? anytime to see keyboard shortcuts! ⌨️

Happy Time Tracking! ⏱️

13 KiB Raw Blame History