adr

Documentation for adr

• 2025 09 22 Server Computed Analytics

  Status: Proposed Date: 2025-09-22 Owners: Frontend + Backend teams Context The frontend currently derives several analytics at runtime from weekly snapshots and project lists (e.g., Starts/Finishes, Throughput, Active Ratio helpers, moving averages, week-over-week deltas, and month bucketing). This duplication creates: Inconsistent definitions across clients and time (ordering, timezone, rounding). Fragile logic (e.g., most-recent-first vs ascending sort, partial-week shading heuristics). Extra client CPU and multiple requests for basic dashboard KPIs. Recent live OpenAPI additions already provide avg_wip, max_wip, and sample_count in weekly rollups. We propose extending server output to cover the remaining derived metrics and offer summary endpoints to simplify the frontend.