getRoutesForDashboard

suspend fun getRoutesForDashboard(page: Int, pageSize: Int, fromDate: String, toDate: String, sendPolyline: Boolean): GetDashboardRoutesResult

Get dashboard routes with intelligent cache-first strategy for single-date queries.

This method implements advanced offline-first caching for dashboard route views:

Cache Threshold: Up to 10 routes are cached for instant access
Cache Window: Single dates within a 7-day window (today ± 3 days) are cacheable
Background Sync: Cached data is returned immediately, with background refresh
Automatic Updates: Use observeDashboardChanges to receive real-time updates

Cacheable Criteria (all must be true):

Non-cacheable requests (multi-date, out-of-window, page 2+) use API-only path.

Sync States:

FULL: Complete dataset cached (≤10 routes) - returns cache immediately with background sync
PARTIAL: Incomplete dataset (>10 routes exist) - attempts API with timeout, falls back to cache
PENDING: No data cached yet - attempts API without timeout

GetDashboardRoutesResult with routes and isPartialData flag indicating cache vs API

page

Page number for pagination (1-based)

pageSize

Number of routes per page

fromDate

Start date in ISO format (YYYY-MM-DD)

toDate

End date in ISO format (YYYY-MM-DD)

sendPolyline

Optional flag to include polyline data (default: false for performance)