feat: Add test tags for UI automation

This commit introduces `TestTag` objects across various feature modules (`common-feature`, `dashboard-feature`, `issuance-feature`, `ui-logic`) to provide unique identifiers for UI components. These tags are crucial for enabling robust UI automation and testing.

The changes include:
- Creating centralized `TestTag.kt` files in each relevant module to define test tags for different screens and components.
- Applying these tags to various Composables such as buttons, text fields, list items, and screen content headers.
- Adding an `optionalTestTag` modifier extension to conditionally apply test tags.
- Updating UI models and interactors to include necessary identifiers (`configurationId`) for creating unique test tags.

Author: gstamatop

common-feature/src/main/java/eu/europa/ec/commonfeature/ui/biometric/BiometricScreen.kt

@@ -34,6 +34,7 @@ import androidx.compose.runtime.getValue
 import androidx.compose.ui.Alignment
 import androidx.compose.ui.Modifier
 import androidx.compose.ui.platform.LocalContext
+import androidx.compose.ui.platform.testTag
 import androidx.compose.ui.res.stringResource
 import androidx.compose.ui.text.input.PasswordVisualTransformation
 import androidx.compose.ui.unit.dp
@@ -42,6 +43,7 @@ import androidx.navigation.NavController
 import eu.europa.ec.commonfeature.config.BiometricMode
 import eu.europa.ec.commonfeature.config.BiometricUiConfig
 import eu.europa.ec.commonfeature.config.OnBackNavigationConfig
+import eu.europa.ec.commonfeature.util.TestTag
 import eu.europa.ec.resourceslogic.R
 import eu.europa.ec.uilogic.component.AppIconAndText
 import eu.europa.ec.uilogic.component.AppIconAndTextDataUi
@@ -267,6 +269,7 @@ private fun MainContent(
             ) {
                 Text(
                     modifier = Modifier
+                        .testTag(TestTag.BiometricScreen.PIN_TEXT)
                         .fillMaxWidth()
                         .padding(vertical = SPACING_SMALL.dp),
                     text = mode.textAbovePin,
@@ -301,6 +304,7 @@ private fun MainContent(
             ) {
                 Text(
                     text = mode.title,
+                    modifier = Modifier.testTag(TestTag.BiometricScreen.PIN_TITLE),
                     style = MaterialTheme.typography.headlineMedium.copy(
                         color = MaterialTheme.colorScheme.onSurface
                     )

common-feature/src/main/java/eu/europa/ec/commonfeature/ui/document_success/DocumentSuccessScreen.kt

@@ -32,10 +32,12 @@ import androidx.compose.runtime.LaunchedEffect
 import androidx.compose.runtime.getValue
 import androidx.compose.ui.Modifier
 import androidx.compose.ui.platform.LocalContext
+import androidx.compose.ui.platform.testTag
 import androidx.compose.ui.res.stringResource
 import androidx.compose.ui.unit.dp
 import androidx.lifecycle.compose.collectAsStateWithLifecycle
 import androidx.navigation.NavController
+import eu.europa.ec.commonfeature.util.TestTag
 import eu.europa.ec.resourceslogic.R
 import eu.europa.ec.uilogic.component.content.ContentHeader
 import eu.europa.ec.uilogic.component.content.ContentScreen
@@ -67,6 +69,7 @@ fun DocumentSuccessScreen(
         stickyBottom = { paddingValues ->
             WrapStickyBottomContent(
                 modifier = Modifier
+                    .testTag(TestTag.DocumentSuccessScreen.BUTTON)
                     .fillMaxWidth()
                     .padding(paddingValues),
                 stickyBottomConfig = StickyBottomConfig(
@@ -146,6 +149,7 @@ private fun Content(
         ContentHeader(
             modifier = Modifier.fillMaxWidth(),
             config = state.headerConfig,
+            descriptionTestTag = TestTag.DocumentSuccessScreen.CONTENT_HEADER_DESCRIPTION,
         )
 
         Column(

common-feature/src/main/java/eu/europa/ec/commonfeature/ui/pin/PinScreen.kt

@@ -37,12 +37,14 @@ import androidx.compose.runtime.rememberCoroutineScope
 import androidx.compose.ui.Alignment
 import androidx.compose.ui.Modifier
 import androidx.compose.ui.platform.LocalContext
+import androidx.compose.ui.platform.testTag
 import androidx.compose.ui.res.stringResource
 import androidx.compose.ui.text.input.PasswordVisualTransformation
 import androidx.compose.ui.unit.dp
 import androidx.lifecycle.compose.collectAsStateWithLifecycle
 import androidx.navigation.NavController
 import eu.europa.ec.commonfeature.model.PinFlow
+import eu.europa.ec.commonfeature.util.TestTag
 import eu.europa.ec.resourceslogic.R
 import eu.europa.ec.uilogic.component.AppIconAndText
 import eu.europa.ec.uilogic.component.AppIconAndTextDataUi
@@ -94,6 +96,7 @@ fun PinScreen(
         stickyBottom = { paddingValues ->
             WrapStickyBottomContent(
                 modifier = Modifier
+                    .testTag(TestTag.PinScreen.BUTTON)
                     .fillMaxWidth()
                     .padding(paddingValues),
                 stickyBottomConfig = StickyBottomConfig(
@@ -202,6 +205,7 @@ private fun Content(
         ) {
             Text(
                 text = state.title,
+                modifier = Modifier.testTag(TestTag.PinScreen.TITLE),
                 style = MaterialTheme.typography.headlineMedium.copy(
                     color = MaterialTheme.colorScheme.onSurface
                 )

common-feature/src/main/java/eu/europa/ec/commonfeature/ui/request/RequestScreen.kt

@@ -34,13 +34,15 @@ import androidx.compose.runtime.LaunchedEffect
 import androidx.compose.runtime.getValue
 import androidx.compose.runtime.rememberCoroutineScope
 import androidx.compose.ui.Modifier
+import androidx.compose.ui.platform.testTag
 import androidx.compose.ui.res.stringResource
 import androidx.compose.ui.unit.dp
 import androidx.lifecycle.compose.collectAsStateWithLifecycle
 import androidx.navigation.NavController
 import eu.europa.ec.commonfeature.ui.request.model.DocumentPayloadDomain
 import eu.europa.ec.commonfeature.ui.request.model.DomainDocumentFormat
 import eu.europa.ec.commonfeature.ui.request.model.RequestDocumentItemUi
+import eu.europa.ec.commonfeature.util.TestTag
 import eu.europa.ec.corelogic.model.ClaimDomain
 import eu.europa.ec.corelogic.model.ClaimPathDomain
 import eu.europa.ec.resourceslogic.R
@@ -102,6 +104,7 @@ fun RequestScreen(
         stickyBottom = { paddingValues ->
             WrapStickyBottomContent(
                 modifier = Modifier
+                    .testTag(TestTag.RequestScreen.BUTTON)
                     .fillMaxWidth()
                     .padding(paddingValues),
                 stickyBottomConfig = StickyBottomConfig(
@@ -196,6 +199,7 @@ private fun Content(
         ContentHeader(
             modifier = Modifier.fillMaxWidth(),
             config = state.headerConfig,
+            descriptionTestTag = TestTag.RequestScreen.CONTENT_HEADER_DESCRIPTION,
         )
 
         // Screen Main Content.
@@ -252,9 +256,11 @@ private fun DisplayRequestItems(
                 modifier = Modifier.fillMaxSize(),
                 verticalArrangement = Arrangement.spacedBy(SPACING_MEDIUM.dp)
             ) {
-                requestDocuments.forEach { requestDocument ->
+                requestDocuments.forEachIndexed { index, requestDocument ->
                     WrapExpandableListItem(
-                        modifier = Modifier.fillMaxWidth(),
+                        modifier = Modifier
+                            .testTag(TestTag.RequestScreen.requestedDocument(index = index))
+                            .fillMaxWidth(),
                         header = requestDocument.headerUi.header,
                         data = requestDocument.headerUi.nestedItems,
                         onItemClick = { item ->

common-feature/src/main/java/eu/europa/ec/commonfeature/ui/success/SuccessScreen.kt

@@ -33,12 +33,14 @@ import androidx.compose.ui.Modifier
 import androidx.compose.ui.graphics.ColorFilter
 import androidx.compose.ui.layout.ContentScale
 import androidx.compose.ui.platform.LocalContext
+import androidx.compose.ui.platform.testTag
 import androidx.compose.ui.res.stringResource
 import androidx.compose.ui.text.style.TextAlign
 import androidx.compose.ui.unit.dp
 import androidx.lifecycle.compose.collectAsStateWithLifecycle
 import androidx.navigation.NavController
 import eu.europa.ec.commonfeature.config.SuccessUIConfig
+import eu.europa.ec.commonfeature.util.TestTag
 import eu.europa.ec.resourceslogic.R
 import eu.europa.ec.resourceslogic.theme.values.ThemeColors
 import eu.europa.ec.resourceslogic.theme.values.success
@@ -220,7 +222,9 @@ private fun Button(
                     type = ButtonType.PRIMARY,
                     onClick = { onEventSent(Event.ButtonClicked(config)) },
                 ),
-                modifier = Modifier.fillMaxWidth(),
+                modifier = Modifier
+                    .testTag(TestTag.SuccessScreen.PRIMARY_BUTTON)
+                    .fillMaxWidth(),
             ) {
                 ButtonRow(text = config.text)
             }
@@ -232,7 +236,9 @@ private fun Button(
                     type = ButtonType.SECONDARY,
                     onClick = { onEventSent(Event.ButtonClicked(config)) },
                 ),
-                modifier = Modifier.fillMaxWidth()
+                modifier = Modifier
+                    .testTag(TestTag.SuccessScreen.SECONDARY_BUTTON)
+                    .fillMaxWidth(),
             ) {
                 ButtonRow(text = config.text)
             }

common-feature/src/main/java/eu/europa/ec/commonfeature/util/TestTag.kt

@@ -0,0 +1,47 @@
+/*
+ * Copyright (c) 2025 European Commission
+ *
+ * Licensed under the EUPL, Version 1.2 or - as soon they will be approved by the European
+ * Commission - subsequent versions of the EUPL (the "Licence"); You may not use this work
+ * except in compliance with the Licence.
+ *
+ * You may obtain a copy of the Licence at:
+ * https://joinup.ec.europa.eu/software/page/eupl
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the Licence is distributed on an "AS IS" basis, WITHOUT WARRANTIES OR CONDITIONS OF
+ * ANY KIND, either express or implied. See the Licence for the specific language
+ * governing permissions and limitations under the Licence.
+ */
+
+package eu.europa.ec.commonfeature.util
+
+object TestTag {
+
+    object PinScreen {
+        const val TITLE = "pin_screen_title"
+        const val BUTTON = "pin_screen_button"
+    }
+
+    object SuccessScreen {
+        const val PRIMARY_BUTTON = "success_screen_primary_button"
+        const val SECONDARY_BUTTON = "success_screen_secondary_button"
+    }
+
+    object DocumentSuccessScreen {
+        const val CONTENT_HEADER_DESCRIPTION = "document_success_screen_content_header_description"
+        const val BUTTON = "document_success_screen_button"
+    }
+
+    object RequestScreen {
+        const val CONTENT_HEADER_DESCRIPTION = "request_screen_content_header_description"
+        const val BUTTON = "request_screen_button"
+
+        fun requestedDocument(index: Int) = "request_screen_requested_document_$index"
+    }
+
+    object BiometricScreen {
+        const val PIN_TEXT = "biometric_screen_pin_text"
+        const val PIN_TITLE = "biometric_screen_title"
+    }
+}

dashboard-feature/src/main/java/eu/europa/ec/dashboardfeature/ui/component/BottomNavigation.kt

@@ -24,12 +24,15 @@ import androidx.compose.material3.NavigationBarItemDefaults
 import androidx.compose.material3.Text
 import androidx.compose.runtime.Composable
 import androidx.compose.runtime.getValue
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.platform.testTag
 import androidx.compose.ui.res.stringResource
 import androidx.navigation.NavController
 import androidx.navigation.NavDestination.Companion.hierarchy
 import androidx.navigation.NavGraph.Companion.findStartDestination
 import androidx.navigation.compose.currentBackStackEntryAsState
 import androidx.navigation.compose.rememberNavController
+import eu.europa.ec.dashboardfeature.util.TestTag
 import eu.europa.ec.resourceslogic.R
 import eu.europa.ec.uilogic.component.AppIcons
 import eu.europa.ec.uilogic.component.IconDataUi
@@ -77,6 +80,11 @@ fun BottomNavigationBar(navController: NavController) {
     ) {
         navItems.forEach { screen ->
             NavigationBarItem(
+                modifier = Modifier.testTag(
+                    TestTag.DashboardScreen.bottomNavigationItem(
+                        navItem = screen.route.lowercase()
+                    )
+                ),
                 icon = {
                     WrapIcon(
                         iconData = screen.icon,

dashboard-feature/src/main/java/eu/europa/ec/dashboardfeature/ui/documents/detail/DocumentDetailsScreen.kt

@@ -49,6 +49,7 @@ import androidx.compose.runtime.rememberCoroutineScope
 import androidx.compose.ui.Alignment
 import androidx.compose.ui.Modifier
 import androidx.compose.ui.graphics.Color
+import androidx.compose.ui.platform.testTag
 import androidx.compose.ui.res.stringResource
 import androidx.compose.ui.text.style.TextDecoration
 import androidx.compose.ui.unit.dp
@@ -61,6 +62,7 @@ import eu.europa.ec.corelogic.util.CoreActions
 import eu.europa.ec.dashboardfeature.ui.documents.detail.model.DocumentDetailsUi
 import eu.europa.ec.dashboardfeature.ui.documents.detail.model.DocumentIssuanceStateUi
 import eu.europa.ec.dashboardfeature.ui.documents.model.DocumentCredentialsInfoUi
+import eu.europa.ec.dashboardfeature.util.TestTag
 import eu.europa.ec.resourceslogic.R
 import eu.europa.ec.resourceslogic.theme.values.success
 import eu.europa.ec.resourceslogic.theme.values.warning
@@ -377,7 +379,9 @@ private fun SheetContent(
                 leadingIcon = AppIcons.Delete,
                 leadingIconTint = MaterialTheme.colorScheme.error,
                 onPositiveClick = { onEventSent(Event.BottomSheet.Delete.PrimaryButtonPressed) },
-                onNegativeClick = { onEventSent(Event.BottomSheet.Delete.SecondaryButtonPressed) }
+                positiveButtonTestTag = TestTag.DocumentDetailsScreen.BOTTOM_SHEET_DELETE_DOCUMENT_POSITIVE_BUTTON,
+                onNegativeClick = { onEventSent(Event.BottomSheet.Delete.SecondaryButtonPressed) },
+                negativeButtonTestTag = TestTag.DocumentDetailsScreen.BOTTOM_SHEET_DELETE_DOCUMENT_NEGATIVE_BUTTON,
             )
 
         is DocumentDetailsBottomSheetContent.BookmarkStoredInfo -> {
@@ -649,7 +653,9 @@ private fun ButtonsSection(onEventSend: (Event) -> Unit) {
             .navigationBarsPadding()
     ) {
         WrapButton(
-            modifier = Modifier.fillMaxWidth(),
+            modifier = Modifier
+                .testTag(TestTag.DocumentDetailsScreen.DELETE_BUTTON)
+                .fillMaxWidth(),
             buttonConfig = ButtonConfig(
                 type = ButtonType.SECONDARY,
                 onClick = { onEventSend(Event.SecondaryButtonPressed) },

dashboard-feature/src/main/java/eu/europa/ec/dashboardfeature/ui/documents/list/DocumentsScreen.kt

@@ -49,6 +49,7 @@ import androidx.compose.ui.Modifier
 import androidx.compose.ui.layout.onGloballyPositioned
 import androidx.compose.ui.platform.LocalContext
 import androidx.compose.ui.platform.LocalDensity
+import androidx.compose.ui.platform.testTag
 import androidx.compose.ui.res.stringResource
 import androidx.compose.ui.text.style.TextAlign
 import androidx.compose.ui.unit.dp
@@ -60,8 +61,10 @@ import eu.europa.ec.corelogic.model.DocumentCategory
 import eu.europa.ec.corelogic.model.DocumentIdentifier
 import eu.europa.ec.corelogic.util.CoreActions
 import eu.europa.ec.dashboardfeature.model.SearchItemUi
+import eu.europa.ec.dashboardfeature.ui.component.BottomNavigationItem
 import eu.europa.ec.dashboardfeature.ui.documents.detail.model.DocumentIssuanceStateUi
 import eu.europa.ec.dashboardfeature.ui.documents.list.model.DocumentUi
+import eu.europa.ec.dashboardfeature.util.TestTag
 import eu.europa.ec.resourceslogic.R
 import eu.europa.ec.resourceslogic.theme.values.warning
 import eu.europa.ec.uilogic.component.AppIcons
@@ -229,7 +232,9 @@ private fun TopBar(
         )
 
         WrapIconButton(
-            modifier = Modifier.align(Alignment.CenterEnd),
+            modifier = Modifier
+                .testTag(TestTag.DocumentsScreen.PLUS_BUTTON)
+                .align(Alignment.CenterEnd),
             iconData = AppIcons.Add,
             customTint = MaterialTheme.colorScheme.onSurfaceVariant,
         ) {
@@ -525,7 +530,8 @@ private fun DocumentsSheetContent(
                         event = Event.BottomSheet.AddDocument.ScanQr,
                     )
                 ),
-                onEventSent = onEventSent
+                onEventSent = onEventSent,
+                hostTab = BottomNavigationItem.Documents.route.lowercase(),
             )
         }
 

dashboard-feature/src/main/java/eu/europa/ec/dashboardfeature/util/TestTag.kt

@@ -0,0 +1,37 @@
+/*
+ * Copyright (c) 2025 European Commission
+ *
+ * Licensed under the EUPL, Version 1.2 or - as soon they will be approved by the European
+ * Commission - subsequent versions of the EUPL (the "Licence"); You may not use this work
+ * except in compliance with the Licence.
+ *
+ * You may obtain a copy of the Licence at:
+ * https://joinup.ec.europa.eu/software/page/eupl
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the Licence is distributed on an "AS IS" basis, WITHOUT WARRANTIES OR CONDITIONS OF
+ * ANY KIND, either express or implied. See the Licence for the specific language
+ * governing permissions and limitations under the Licence.
+ */
+
+package eu.europa.ec.dashboardfeature.util
+
+object TestTag {
+
+    object DashboardScreen {
+        fun bottomNavigationItem(navItem: String) =
+            "dashboard_screen_bottom_navigation_item_$navItem"
+    }
+
+    object DocumentsScreen {
+        const val PLUS_BUTTON = "documents_screen_plus_button"
+    }
+
+    object DocumentDetailsScreen {
+        const val DELETE_BUTTON = "document_details_screen_delete_button"
+        const val BOTTOM_SHEET_DELETE_DOCUMENT_POSITIVE_BUTTON =
+            "document_details_screen_dialogue_delete_document_positive_button"
+        const val BOTTOM_SHEET_DELETE_DOCUMENT_NEGATIVE_BUTTON =
+            "document_details_screen_dialogue_delete_document_negative_button"
+    }
+}