Configure Organisation-Specific Terminology and Labels
Each organisation uses different terms for the same roles and concepts. The terminology admin preview screen allows admins to view all configurable label keys, set organisation-specific overrides, and preview the result before saving. The organisation labels notifier propagates changes in real time to all connected clients via Supabase Realtime. The WCAG semantics label resolver ensures that any custom label override is also applied to screen reader accessibility labels, maintaining full WCAG 2.2 AA compliance even with customised terminology.
User Story
Acceptance Criteria
- Given I open the terminology settings screen, when I view the label list, then I can see all overridable keys with their default values and any existing org overrides highlighted
- Given I type a custom label for 'peer_mentor_singular', when I tap 'Preview', then the terminology-aware text widget shows the change applied across sample screens in real time
- Given I save a terminology change, when peer mentors and coordinators reload the app, then the updated labels appear within 60 seconds via Riverpod state propagation
- Given I set a custom label for an activity type, when the label key appears in screen reader announcements via VoiceOver, then the custom term is used in the semantic label rather than the system default
- Given I clear a custom label override, when the app reloads, then it reverts to the system default label for that key
- Given I attempt to set an empty string as a label value, then the form validator rejects the input with a clear error message
Business Value
NHF, HLF, and Blindeforbundet all use different terminology for the same roles — a shared app with rigid labels creates confusion and perceived lack of fit, reducing adoption rates. Custom terminology makes the app feel purpose-built for each organisation without requiring separate builds, directly reducing development and maintenance cost. It also ensures screen reader users hear terminology consistent with their organisation's culture, which is especially important for Blindeforbundet's accessibility-first user base.
Components
- Terminology-Aware Text Widget ui
- Terminology Admin Preview Screen ui
- Organization Labels Notifier service
- Label Key Resolver Service service
- Terminology Sync Service service
- Terminology Repository data
- Terminology Local Cache Adapter data
- Label Key Registry infrastructure
- Terminology Riverpod Providers infrastructure
- WCAG Semantics Label Resolver infrastructure