Graceful Degradation to List View When Map is Unavailable
Norwegian coordinators frequently work in rural and remote areas where network connectivity is unreliable. The map provider requires an active connection for tile loading, but the underlying mentor data (names, locations, status) can be cached locally. When map tiles fail to load after a 5-second timeout, mentor-list-fallback automatically activates, presenting the same mentor dataset as a sorted, searchable list with distance estimates based on cached location data. The fallback must be visually distinct (clear offline indicator banner) but functionally complete — coordinators can still view profiles, check certification status, and initiate assignments from the list. Cached data is refreshed on next successful connection via contact-cache-sync-repository. The failure mode must never result in a blank or broken screen.
User Story
Acceptance Criteria
- Given the coordinator opens the map view with no internet connection, when the map fails to initialise after 5 seconds, then the mentor-list-fallback activates automatically with a clear offline status banner at the top of the screen
- Given the fallback list is showing, when the coordinator searches for a mentor by name, then the search filters the cached local dataset without requiring network access
- Given the device regains internet connectivity while the fallback list is visible, when connectivity is restored, then a non-intrusive snackbar offers to reload the map view without forcing navigation
- Given cached mentor data is more than 24 hours old when offline, when the fallback list renders, then a staleness warning is shown indicating when data was last refreshed
- Given the coordinator is on the map view and connectivity drops mid-session, when map tile loading fails, then the already-loaded portion of the map remains visible with a connectivity warning overlay rather than going blank
- Given the coordinator taps a mentor in the list fallback, when they navigate to the mentor profile, then all locally cached profile data is shown and an indicator clarifies which fields may be out of date
Business Value
The organisations using this platform operate across all of Norway including remote rural regions with poor mobile coverage. A map feature that fails silently or renders a broken screen when offline actively harms coordinators who depend on it during field work. Robust offline degradation ensures the tool is reliable in the environments where it is most needed, preventing situations where a coordinator cannot access mentor data during a time-sensitive assignment. This directly supports the principle of designing for the most challenging use cases rather than the average one.
Components
- Map View Screen ui
- Mentor List Fallback View ui
- Mentor Location Service service
- Mentor Location Repository data
- Map Provider Integration infrastructure
- Contact Cache Sync Repository data