Terminology Admin Preview Screen - Likepersonsapp

Description

An administrative UI screen that displays the full terminology map for the selected organization, allowing admins to inspect current label keys and their resolved values. Surfaces any missing keys or untranslated entries for quality control. Read-only in the mobile app; edits happen via the admin portal or directly in Supabase.

Feature: Dynamic Terminology & Labels System

terminology-admin-preview-screen

Summaries

The Terminology Admin Preview Screen gives administrators direct visibility into how the app will display language and labels for their organization, without requiring a support request or development intervention. Admins can quickly verify that custom terminology has been configured correctly, identify missing or blank label entries before they reach end users, and confirm that recent terminology updates have taken effect. This self-service capability reduces support overhead, accelerates onboarding of new organizations, and builds client confidence in the platform's configurability — reinforcing the premium, white-label positioning of the product.

This is a low-complexity, read-only admin screen with a narrow scope: it lists, filters, and highlights terminology map entries for the active organization. Development effort is straightforward, and it has no write operations that could affect production data. Dependencies are OrganizationLabelsNotifier and TerminologyRepository, both of which should already exist by the time this screen is built. Key delivery consideration: agree with stakeholders early on what 'missing key' means — is it a null value, an empty string, or a key absent from the map entirely?

Each case may need separate highlighting logic. Testing should include search/filter behavior, correct highlighting of missing entries, and display of the last-updated timestamp.

TerminologyPreviewScreen(organizationId) fetches the full terminology map from TerminologyRepository and renders it via OrganizationLabelsNotifier state. buildLabelKeyList(terminologyMap) converts the Map into a sorted ListView of key-value rows. filterBySearchQuery(query) applies a case-insensitive substring match against both keys and resolved values, updating the displayed list reactively. highlightMissingKeys() applies a visual indicator (e.g., amber background or warning icon) to rows where the value is null or empty string.

The last-updated timestamp should be fetched alongside the map from the repository. This screen is read-only in the mobile context — no edit affordances should be present, and all write paths should be disabled or absent to prevent confusion about where terminology edits are made.

Responsibilities

List all label keys with their resolved values for the active organization
Highlight missing or empty terminology entries
Allow searching and filtering by key or resolved value
Show last-updated timestamp for the terminology map

Interfaces

TerminologyPreviewScreen(organizationId)

buildLabelKeyList(terminologyMap)

filterBySearchQuery(query)

highlightMissingKeys()

Relationships

Dependencies (2)

Components this component depends on

data Terminology Repository service Organization Labels Notifier Shared