John O'Keefe
ce366b1604
The /stats page gains a second tab (Reading | Library) implementing the
Audiobookshelf-style library dashboard (HANDOFF item 9): media_items
INVENTORY aggregates — items, hours/pages, distinct authors, size,
distinct narrators, Top Genres / Top Authors bars, Longest / Largest
items — for one library or the All-libraries aggregate.
- GET /api/stats/library-usage?library_id=<uuid|omit>; family lens
enforced: a library_id outside the requester's visible set is a 403,
never a silent pass (AGENTS.md standing rule; 431fec0 history)
- six sqlc queries with the visibility pattern + healthy-item filter
(archived_at IS NULL AND missing_scan_count = 0); hours_mode lets the
client swap the Hours/Pages card and the Longest ranking per scope
- Reading tab unit audit (HANDOFF item 3, settled 2026-10-16): minutes
are the merged currency everywhere honest; only the PAGES unit splits
— Pages card goes mode-aware (Pages · text / Listening Time in an
audio-only pool) and the charts row gains Listening per Day (hrs)
when audio minutes exist in the range; summary daily buckets gain
audio_minutes split by the item's library type
- tab state in the URL (?tab=library&library_id=…); selector fed by the
existing /api/libraries/visibility endpoint; main.js?v=4
- integration tests: family-lens 403 pin, hidden-library exclusion
(differential), seeded text+audio aggregate correctness, auth gate
- docs/developer/api/stats/get_library_usage.md
Known-remaining suite failures are environmental: TestConflictList_Empty
+ TestWebSocketPingPong collide with the concurrently-running app session
(live emulator pushes + scans on the shared dev DB), and
TestAdminCreateUser's timezone expectation drifted from live system
settings — all three fail on the clean tree too.
29 lines
1.1 KiB
Go
29 lines
1.1 KiB
Go
package router
|
|
|
|
func registerAnalyticsRoutes(cfg *Config) {
|
|
e := cfg.Echo
|
|
|
|
// JWT middleware for protected routes
|
|
jwtMiddleware := createJWTMiddleware(cfg)
|
|
|
|
protected := e.Group("/api", jwtMiddleware)
|
|
|
|
// Analytics routes (legacy shape; kept for existing API consumers —
|
|
// the web UI moved to /stats)
|
|
analytics := protected.Group("/analytics")
|
|
analytics.GET("/reading-stats", cfg.AnalyticsHandler.GetReadingStats)
|
|
analytics.GET("/device-usage", cfg.AnalyticsHandler.GetDeviceUsage)
|
|
analytics.GET("/popular-books", cfg.AnalyticsHandler.GetPopularBooks)
|
|
|
|
// Reading-statistics API (/stats page + dashboard widget + per-book
|
|
// card). Same session seed, service-backed aggregates, user-timezone
|
|
// bucketing. The legacy /analytics page redirects to /stats.
|
|
stats := protected.Group("/stats")
|
|
stats.GET("/summary", cfg.StatsHandler.Summary)
|
|
stats.GET("/this-week", cfg.StatsHandler.ThisWeek)
|
|
stats.GET("/books/:id", cfg.StatsHandler.BookStats)
|
|
// Library tab: media_items inventory aggregates (what's in the
|
|
// library), scoped per request; reading_history is never touched here.
|
|
stats.GET("/library-usage", cfg.StatsHandler.LibraryUsage)
|
|
}
|