Label Resolution Service
Component Detail
Service Layer
medium complexity
Shared Component
mobile
1
Dependencies
0
Dependents
1
Entities
0
Integrations
Description
Flutter-side singleton service that resolves display labels for the authenticated user's organization by reading from the local Drift cache and falling back to hardcoded platform defaults for any key not explicitly overridden. All UI widgets query this service rather than using hardcoded strings, ensuring organization-specific terminology is applied consistently across the entire app.
label-resolution-service
Responsibilities
- Resolve label text for a given key using organization overrides with platform default fallback
- Populate the local Drift cache from the label map received in the session bootstrap payload
- Provide reactive label streams so widgets rebuild automatically if labels are refreshed
- Support fully offline resolution with no network dependency after bootstrap
Interfaces
resolve(key: String): String
resolveAll(): Map<String, String>
cacheBootstrapLabels(labelMap: Map<String, String>): Future<void>
watchLabel(key: String): Stream<String>
clearCache(): Future<void>