📊 Library Analytics — Global KPI Matrix (MVP + Priority)

KPI / Metric Short description Library Overview Exploration Data Quality Priority Notes
Library size Total number of tracks ✅ ❌ ❌ P1 Core volume indicator
Unique artists Number of distinct artists ✅ ❌ ❌ P1 Library diversity
Unique albums Number of distinct albums ✅ ❌ ❌ P1 Library structure
Top artists Artists with most tracks ✅ ❌ ❌ P1 Snapshot of preferences
Genre distribution (Top 10 + Other) High-level genre breakdown ✅ ❌ ❌ P1 Macro taste profile
Popularity bands % of tracks by popularity range ❌ ❌ ❌ P2 Insight enrichment
Release year distribution Tracks by release year ❌ ❌ ❌ P2 Temporal context
Filterable track table Track / artist / album / year / genre ❌ ✅ ❌ P1 Core exploration feature
Drill-through to artist Artist-level drill-down ❌ ✅ ❌ P1 Natural exploration path
Drill-through to album Album-level drill-down ❌ ✅ ❌ P1 Complements artist view
Top sub-genres Granular genre exploration ❌ ✅ ❌ P2 Added nuance
Tracks per artist Avg / median concentration ❌ ❌ ❌ P2 Depth analysis
Has genre metadata % of tracks enriched with genres ❌ ❌ ✅ P1 Enrichment completeness
Has thumbnail % of tracks with artwork ❌ ❌ ✅ P1 Metadata quality
Missing critical fields Missing artist / title / album ❌ ❌ ✅ P1 Data reliability
Duplicate tracks Same title + artist detected ❌ ❌ ✅ P1 Deduplication check
Last refresh timestamp Date of last data refresh ❌ ❌ ✅ P1 Trust & freshness indicator
Spotify match rate % of tracks enriched via Spotify ❌ ❌ ❌ Later Pipeline-dependent
Quality trend over time Quality metrics by refresh date ❌ ❌ ❌ Later Requires historical tracking

📊 Listening History — KPI × Pages Matrix

KPI / Metric Short description Listening Overview Trends Time Patterns Deep Dive Priority Notes
Total listens Total number of listening events ✅ ❌ ❌ ❌ P1 Core usage metric
Active days Days with at least one listen ✅ ❌ ❌ ❌ P2 Engagement proxy
Unique tracks listened Distinct tracks played ✅ ❌ ❌ ❌ P1 Discovery vs repetition
Top tracks by listens Most replayed tracks ✅ ❌ ❌ ❌ P1 Personal favorites
Top artists by listens Most listened artists ✅ ❌ ❌ ❌ P1 Taste profile
Genre share by listens % listens per main_genre ✅ ❌ ❌ ❌ P2 Consumption-based genres
Total listening time Sum of listening duration ✅ ❌ ❌ ❌ P1 Requires duration quality
Avg listens per day Average listening frequency ✅ ❌ ❌ ❌ P1 Normalisation
Listens over time (Daily/Weekly) Listening evolution over time ❌ ✅ ❌ ❌ P1 Core trend
Rolling average Smoothed listening trend ❌ ✅ ❌ ❌ P1–P2 Readability
Seasonality (month) Listening by month ❌ ✅ ❌ ❌ P2 Pattern detection
Seasonality (weekday) Listening by weekday ❌ ✅ ❌ ❌ P2 Habit insight
Growth / decline trend Direction over time ❌ ✅ ❌ ❌ Later Needs interpretation
Hour × weekday heatmap Listening intensity matrix ❌ ❌ ✅ ❌ P1 Strong visual insight
Peak listening hour Hour with most listens ❌ ❌ ✅ ❌ P1 Simple summary
Peak listening day Most active weekday ❌ ❌ ✅ ❌ P1 Habit signal
Off-peak listening share % listens outside peak hours ❌ ❌ ✅ ❌ P2 Behavior nuance
Track listening timeline Plays over time for a track ❌ ❌ ❌ ✅ P1 Drill-down
Artist listening trend Artist listens over time ❌ ❌ ❌ ✅ P1 Evolution of taste
Top periods per track Peak listening periods ❌ ❌ ❌ ✅ P2 Narrative
Associated genres Genres linked to listens ❌ ❌ ❌ ✅ P2 Context