feat: Refactor login screen - fix compilation error

2025-10-02 13:11:49 +03:00
parent 8816377361
commit eccc7ee970
21 changed files with 494 additions and 174 deletions
--- a/app/src/main/java/com/homebox/lens/navigation/NavGraph.kt
+++ b/app/src/main/java/com/homebox/lens/navigation/NavGraph.kt
@@ -25,11 +25,14 @@ import com.homebox.lens.ui.screen.locationedit.LocationEditScreen
 import com.homebox.lens.ui.screen.locationslist.LocationsListScreen
 import com.homebox.lens.ui.screen.search.SearchScreen
 import com.homebox.lens.ui.screen.setup.SetupScreen
+import com.homebox.lens.ui.screen.settings.SettingsScreen
+import com.homebox.lens.ui.screen.splash.SplashScreen
 // [END_IMPORTS]

 // [ENTITY: Function('NavGraph')]
 // [RELATION: Function('NavGraph')] -> [DEPENDS_ON] -> [Framework('NavHostController')]
 // [RELATION: Function('NavGraph')] -> [CREATES_INSTANCE_OF] -> [Class('NavigationActions')]
+// [RELATION: Function('NavGraph')] -> [USES] -> [Screen('SplashScreen')]
 /**
 * @summary Определяет граф навигации для всего приложения с использованием Jetpack Compose Navigation.
 * @param navController Контроллер навигации.
@@ -47,11 +50,13 @@ fun NavGraph(
    val navigationActions = remember(navController) {
        NavigationActions(navController)
    }
-
    NavHost(
        navController = navController,
-        startDestination = Screen.Setup.route
+        startDestination = Screen.Splash.route
    ) {
+        composable(route = Screen.Splash.route) {
+            SplashScreen(navController = navController)
+        }
        composable(route = Screen.Setup.route) {
            SetupScreen(onSetupComplete = {
                navController.navigate(Screen.Dashboard.route) {
@@ -137,6 +142,12 @@ fun NavGraph(
                navigationActions = navigationActions
            )
        }
+        composable(route = Screen.Settings.route) {
+            SettingsScreen(
+                currentRoute = currentRoute,
+                navigationActions = navigationActions
+            )
+        }
    }
 }
 // [END_ENTITY: Function('NavGraph')]
--- a/app/src/main/java/com/homebox/lens/navigation/Screen.kt
+++ b/app/src/main/java/com/homebox/lens/navigation/Screen.kt
@@ -10,6 +10,10 @@ package com.homebox.lens.navigation
 * @param route Строковый идентификатор маршрута.
 */
 sealed class Screen(val route: String) {
+    // [ENTITY: Object('Splash')]
+    data object Splash : Screen("splash_screen")
+    // [END_ENTITY: Object('Splash')]
+
    // [ENTITY: Object('Setup')]
    data object Setup : Screen("setup_screen")
    // [END_ENTITY: Object('Setup')]
@@ -118,6 +122,10 @@ sealed class Screen(val route: String) {
    // [ENTITY: Object('Search')]
    data object Search : Screen("search_screen")
    // [END_ENTITY: Object('Search')]
+
+    // [ENTITY: Object('Settings')]
+    data object Settings : Screen("settings_screen")
+    // [END_ENTITY: Object('Settings')]
 }
 // [END_ENTITY: SealedClass('Screen')]
 // [END_FILE_Screen.kt]
--- a/app/src/main/java/com/homebox/lens/ui/screen/dashboard/DashboardScreen.kt
+++ b/app/src/main/java/com/homebox/lens/ui/screen/dashboard/DashboardScreen.kt
@@ -310,10 +310,10 @@ fun DashboardContentSuccessPreview() {
            LocationOutCount(id="5",name="Basement", color = "#00FFFF", isArchived = false, itemCount = 3, createdAt = "", updatedAt = "")
        ),
        labels = listOf(
-            LabelOut(id="1", name="electronics", color = "#FF0000", isArchived = false, createdAt = "", updatedAt = ""),
-            LabelOut(id="2", name="important", color = "#00FF00", isArchived = false, createdAt = "", updatedAt = ""),
-            LabelOut(id="3", name="seasonal", color = "#0000FF", isArchived = false, createdAt = "", updatedAt = ""),
-            LabelOut(id="4", name="hobby", color = "#FFFF00", isArchived = false, createdAt = "", updatedAt = "")
+            LabelOut(id="1", name="electronics", description = null, color = "#FF0000", isArchived = false, createdAt = "", updatedAt = ""),
+            LabelOut(id="2", name="important", description = null, color = "#00FF00", isArchived = false, createdAt = "", updatedAt = ""),
+            LabelOut(id="3", name="seasonal", description = null, color = "#0000FF", isArchived = false, createdAt = "", updatedAt = ""),
+            LabelOut(id="4", name="hobby", description = null, color = "#FFFF00", isArchived = false, createdAt = "", updatedAt = "")
        ),
        recentlyAddedItems = emptyList()
    )
--- a/app/src/main/java/com/homebox/lens/ui/screen/itemedit/ItemEditViewModel.kt
+++ b/app/src/main/java/com/homebox/lens/ui/screen/itemedit/ItemEditViewModel.kt
@@ -7,8 +7,14 @@ package com.homebox.lens.ui.screen.itemedit
 // [IMPORTS]
 import androidx.lifecycle.ViewModel
 import androidx.lifecycle.viewModelScope
-import com.homebox.lens.domain.model.*
+import com.homebox.lens.domain.model.Item
+import com.homebox.lens.domain.model.ItemCreate
+import com.homebox.lens.domain.model.ItemUpdate
+import com.homebox.lens.domain.model.Location
+import com.homebox.lens.domain.model.Label
 import com.homebox.lens.domain.usecase.CreateItemUseCase
+import com.homebox.lens.domain.usecase.GetAllLabelsUseCase
+import com.homebox.lens.domain.usecase.GetAllLocationsUseCase
 import com.homebox.lens.domain.usecase.GetItemDetailsUseCase
 import com.homebox.lens.domain.usecase.UpdateItemUseCase
 import com.homebox.lens.ui.mapper.ItemMapper
@@ -30,11 +36,15 @@ import javax.inject.Inject
 * @param item The item being edited, or null if creating a new item.
 * @param isLoading Whether data is currently being loaded or saved.
 * @param error An error message if an operation failed.
+ * @param allLocations A list of all available locations.
+ * @param allLabels A list of all available labels.
 */
 data class ItemEditUiState(
    val item: Item? = null,
    val isLoading: Boolean = false,
-    val error: String? = null
+    val error: String? = null,
+    val allLocations: List<Location> = emptyList(),
+    val allLabels: List<Label> = emptyList()
 )
 // [END_ENTITY: DataClass('ItemEditUiState')]

@@ -56,6 +66,8 @@ class ItemEditViewModel @Inject constructor(
    private val createItemUseCase: CreateItemUseCase,
    private val updateItemUseCase: UpdateItemUseCase,
    private val getItemDetailsUseCase: GetItemDetailsUseCase,
+    private val getAllLocationsUseCase: GetAllLocationsUseCase,
+    private val getAllLabelsUseCase: GetAllLabelsUseCase,
    private val itemMapper: ItemMapper
 ) : ViewModel() {

@@ -123,10 +135,47 @@ class ItemEditViewModel @Inject constructor(
                    _uiState.value = _uiState.value.copy(isLoading = false, error = e.localizedMessage)
                }
            }
+
+            // Load all locations and labels
+            try {
+                Timber.i("[INFO][ACTION][fetching_all_locations] Fetching all locations.")
+                val allLocations = getAllLocationsUseCase().map { Location(it.id, it.name) }
+                Timber.i("[INFO][ACTION][fetching_all_labels] Fetching all labels.")
+                val allLabels = getAllLabelsUseCase().map { Label(it.id, it.name) }
+                _uiState.value = _uiState.value.copy(allLocations = allLocations, allLabels = allLabels)
+                Timber.i("[INFO][ACTION][all_locations_labels_fetched] Successfully fetched all locations and labels.")
+            } catch (e: Exception) {
+                Timber.e(e, "[ERROR][FALLBACK][locations_labels_load_failed] Failed to load locations or labels.")
+                _uiState.value = _uiState.value.copy(error = e.localizedMessage)
+            }
        }
    }
    // [END_ENTITY: Function('loadItem')]

+    // [ENTITY: Function('updateLocation')]
+    /**
+     * @summary Updates the location of the item in the UI state.
+     * @param location The new location for the item.
+     * @sideeffect Updates the `item` in `_uiState`.
+     */
+    fun updateLocation(location: Location) {
+        Timber.d("[DEBUG][ACTION][updating_item_location] Updating item location to: %s", location.name)
+        _uiState.value = _uiState.value.copy(item = _uiState.value.item?.copy(location = location))
+    }
+    // [END_ENTITY: Function('updateLocation')]
+
+    // [ENTITY: Function('updateLabels')]
+    /**
+     * @summary Updates the labels of the item in the UI state.
+     * @param labels The new list of labels for the item.
+     * @sideeffect Updates the `item` in `_uiState`.
+     */
+    fun updateLabels(labels: List<Label>) {
+        Timber.d("[DEBUG][ACTION][updating_item_labels] Updating item labels to: %s", labels.map { it.name }.joinToString())
+        _uiState.value = _uiState.value.copy(item = _uiState.value.item?.copy(labels = labels))
+    }
+    // [END_ENTITY: Function('updateLabels')]
+
    // [ENTITY: Function('saveItem')]
    /**
     * @summary Saves the current item, either creating a new one or updating an existing one.
--- a/app/src/main/java/com/homebox/lens/ui/screen/labeledit/LabelEditScreen.kt
+++ b/app/src/main/java/com/homebox/lens/ui/screen/labeledit/LabelEditScreen.kt
@@ -97,6 +97,13 @@ fun LabelEditScreen(
                modifier = Modifier.fillMaxWidth()
            )
            Spacer(modifier = Modifier.height(16.dp))
+            OutlinedTextField(
+                value = uiState.description.orEmpty(),
+                onValueChange = viewModel::onDescriptionChange,
+                label = { Text(stringResource(R.string.label_description)) },
+                modifier = Modifier.fillMaxWidth()
+            )
+            Spacer(modifier = Modifier.height(16.dp))
            ColorPicker(
                selectedColor = uiState.color,
                onColorSelected = viewModel::onColorChange,
--- a/app/src/main/java/com/homebox/lens/ui/screen/labeledit/LabelEditViewModel.kt
+++ b/app/src/main/java/com/homebox/lens/ui/screen/labeledit/LabelEditViewModel.kt
@@ -50,6 +50,10 @@ class LabelEditViewModel @Inject constructor(
        uiState = uiState.copy(name = newName, nameError = null)
    }

+    fun onDescriptionChange(newDescription: String) {
+        uiState = uiState.copy(description = newDescription)
+    }
+
    fun onColorChange(newColor: String) {
        uiState = uiState.copy(color = newColor)
    }
@@ -63,35 +67,41 @@ class LabelEditViewModel @Inject constructor(

            uiState = uiState.copy(isLoading = true, error = null)
            try {
-                if (labelId == null) {
-                    // Create new label
-                    val newLabel = LabelCreate(name = uiState.name, color = uiState.color, description = null)
+                val result = if (labelId == null) {
+                    // [LOG_EVENT] [EVENT_TYPE: LabelCreationAttempt] [DATA: { "labelName": "${uiState.name}" }]
+                    val newLabel = LabelCreate(name = uiState.name, color = uiState.color, description = uiState.description)
                    createLabelUseCase(newLabel)
                } else {
-                    // Update existing label
-                    val updatedLabel = LabelUpdate(name = uiState.name, color = uiState.color, description = null)
+                    // [LOG_EVENT] [EVENT_TYPE: LabelUpdateAttempt] [DATA: { "labelId": "$labelId", "labelName": "${uiState.name}" }]
+                    val updatedLabel = LabelUpdate(name = uiState.name, color = uiState.color, description = uiState.description)
                    updateLabelUseCase(labelId, updatedLabel)
                }
+                // [LOG_EVENT] [EVENT_TYPE: LabelSaveSuccess] [DATA: { "labelName": "${uiState.name}", "isNew": ${labelId == null} }]
                uiState = uiState.copy(isSaved = true)
            } catch (e: Exception) {
+                // [LOG_EVENT] [EVENT_TYPE: LabelSaveFailure] [ERROR: "${e.message}"] [DATA: { "labelName": "${uiState.name}", "isNew": ${labelId == null} }]
                uiState = uiState.copy(error = e.message, isLoading = false)
            } finally {
                uiState = uiState.copy(isLoading = false)
            }
        }
    }
-
    private fun loadLabelDetails(id: String) {
        viewModelScope.launch {
            uiState = uiState.copy(isLoading = true, error = null)
            try {
+                // [LOG_EVENT] [EVENT_TYPE: LabelDetailsFetchAttempt] [DATA: { "labelId": "$id" }]
                val label = getLabelDetailsUseCase(id)
+                // [LOG_EVENT] [EVENT_TYPE: LabelDetailsFetchSuccess] [DATA: { "labelId": "$id", "labelName": "${label.name}" }]
                uiState = uiState.copy(
                    name = label.name,
                    color = label.color,
-                    isLoading = false
+                    description = label.description,
+                    isLoading = false,
+                    originalLabel = label
                )
            } catch (e: Exception) {
+                // [LOG_EVENT] [EVENT_TYPE: LabelDetailsFetchFailure] [ERROR: "${e.message}"] [DATA: { "labelId": "$id" }]
                uiState = uiState.copy(error = e.message, isLoading = false)
            }
        }
@@ -104,6 +114,7 @@ class LabelEditViewModel @Inject constructor(
 */
 data class LabelEditUiState(
    val name: String = "",
+    val description: String? = null,
    val color: String = "#FFFFFF", // Default color
    val nameError: String? = null,
    val isLoading: Boolean = false,
--- a/app/src/main/java/com/homebox/lens/ui/screen/labelslist/LabelsListScreen.kt
+++ b/app/src/main/java/com/homebox/lens/ui/screen/labelslist/LabelsListScreen.kt
@@ -17,24 +17,18 @@ import androidx.compose.material.icons.Icons
 import androidx.compose.material.icons.automirrored.filled.ArrowBack
 import androidx.compose.material.icons.automirrored.filled.Label
 import androidx.compose.material.icons.filled.Add
-import androidx.compose.material3.AlertDialog
 import androidx.compose.material3.CircularProgressIndicator
 import androidx.compose.material3.ExperimentalMaterial3Api
 import androidx.compose.material3.FloatingActionButton
 import androidx.compose.material3.Icon
 import androidx.compose.material3.IconButton
 import androidx.compose.material3.ListItem
-import androidx.compose.material3.OutlinedTextField
 import androidx.compose.material3.Scaffold
 import androidx.compose.material3.Text
-import androidx.compose.material3.TextButton
 import androidx.compose.material3.TopAppBar
 import androidx.compose.runtime.Composable
 import androidx.compose.runtime.collectAsState
 import androidx.compose.runtime.getValue
-import androidx.compose.runtime.mutableStateOf
-import androidx.compose.runtime.remember
-import androidx.compose.runtime.setValue
 import androidx.compose.ui.Alignment
 import androidx.compose.ui.Modifier
 import androidx.compose.ui.res.stringResource
@@ -53,9 +47,11 @@ import timber.log.Timber
 // [RELATION: Function('LabelsListScreen')] -> [DEPENDS_ON] -> [Framework('NavController')]
 /**
 * @summary Отображает экран со списком всех меток.
- * @param navController Контроллер навигации для перемещения между экранами.
+ * @param currentRoute Текущий маршрут навигации.
+ * @param navigationActions Объект, содержащий действия по навигации.
 * @param viewModel ViewModel, предоставляющая состояние UI для экрана меток.
 */
+@OptIn(ExperimentalMaterial3Api::class)
@Composable
 fun LabelsListScreen(
    currentRoute: String?,
@@ -90,19 +86,19 @@ fun LabelsListScreen(
                .padding(innerPaddingValues), // Use innerPaddingValues here
            contentAlignment = Alignment.Center
        ) {
-            when (currentState) {
+            when (val state = uiState) {
                is LabelsListUiState.Loading -> {
                    CircularProgressIndicator()
                }
                is LabelsListUiState.Error -> {
-                    Text(text = currentState.message)
+                    Text(text = state.message)
                }
                is LabelsListUiState.Success -> {
-                    if (currentState.labels.isEmpty()) {
+                    if (state.labels.isEmpty()) {
                        Text(text = stringResource(id = R.string.no_labels_found))
                    } else {
                        LabelsList(
-                            labels = currentState.labels,
+                            labels = state.labels,
                            onLabelClick = { label ->
                                Timber.i("[INFO][ACTION][navigate_to_label_edit] Label clicked: ${label.id}. Navigating to label edit screen.")
                                navigationActions.navigateToLabelEdit(label.id)
--- a/app/src/main/java/com/homebox/lens/ui/screen/settings/SettingsScreen.kt
+++ b/app/src/main/java/com/homebox/lens/ui/screen/settings/SettingsScreen.kt
@@ -0,0 +1,53 @@
+// [PACKAGE] com.homebox.lens.ui.screen.settings
+// [FILE] SettingsScreen.kt
+// [SEMANTICS] ui, screen, settings
+
+package com.homebox.lens.ui.screen.settings
+
+// [IMPORTS]
+import androidx.compose.foundation.layout.Box
+import androidx.compose.foundation.layout.fillMaxSize
+import androidx.compose.foundation.layout.padding
+import androidx.compose.material3.ExperimentalMaterial3Api
+import androidx.compose.material3.Scaffold
+import androidx.compose.material3.Text
+import androidx.compose.material3.TopAppBar
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.Alignment
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.res.stringResource
+import com.homebox.lens.R
+import com.homebox.lens.navigation.NavigationActions
+import com.homebox.lens.ui.common.MainScaffold
+// [END_IMPORTS]
+
+// [ENTITY: Function('SettingsScreen')]
+// [RELATION: Function('SettingsScreen')] -> [DEPENDS_ON] -> [Class('NavigationActions')]
+/**
+ * @summary Composable-функция для экрана настроек.
+ * @param currentRoute Текущий маршрут навигации.
+ * @param navigationActions Объект, содержащий действия по навигации.
+ */
+@OptIn(ExperimentalMaterial3Api::class)
+@Composable
+fun SettingsScreen(
+    currentRoute: String?,
+    navigationActions: NavigationActions
+) {
+    MainScaffold(
+        topBarTitle = stringResource(id = R.string.screen_title_settings),
+        currentRoute = currentRoute,
+        navigationActions = navigationActions
+    ) { paddingValues ->
+        Box(
+            modifier = Modifier
+                .fillMaxSize()
+                .padding(paddingValues),
+            contentAlignment = Alignment.Center
+        ) {
+            Text(text = "Settings Screen (Under Construction)")
+        }
+    }
+}
+// [END_ENTITY: Function('SettingsScreen')]
+// [END_FILE_SettingsScreen.kt]
--- a/app/src/main/java/com/homebox/lens/ui/screen/setup/SetupScreen.kt
+++ b/app/src/main/java/com/homebox/lens/ui/screen/setup/SetupScreen.kt
@@ -7,17 +7,22 @@
 package com.homebox.lens.ui.screen.setup

 // [IMPORTS]
+import androidx.compose.foundation.Image
 import androidx.compose.foundation.layout.*
+import androidx.compose.material.icons.Icons
+import androidx.compose.material.icons.filled.Lock
 import androidx.compose.material3.*
 import androidx.compose.runtime.Composable
 import androidx.compose.runtime.collectAsState
 import androidx.compose.runtime.getValue
 import androidx.compose.ui.Alignment
 import androidx.compose.ui.Modifier
+import androidx.compose.ui.res.painterResource
 import androidx.compose.ui.res.stringResource
 import androidx.compose.ui.text.input.PasswordVisualTransformation
 import androidx.compose.ui.tooling.preview.Preview
 import androidx.compose.ui.unit.dp
+import androidx.compose.ui.unit.sp
 import androidx.hilt.navigation.compose.hiltViewModel
 import com.homebox.lens.R
 // [END_IMPORTS]
@@ -83,42 +88,74 @@ private fun SetupScreenContent(
            verticalArrangement = Arrangement.Center,
            horizontalAlignment = Alignment.CenterHorizontally
        ) {
-            OutlinedTextField(
-                value = uiState.serverUrl,
-                onValueChange = onServerUrlChange,
-                label = { Text(stringResource(id = R.string.setup_server_url_label)) },
-                modifier = Modifier.fillMaxWidth()
-            )
-            Spacer(modifier = Modifier.height(8.dp))
-            OutlinedTextField(
-                value = uiState.username,
-                onValueChange = onUsernameChange,
-                label = { Text(stringResource(id = R.string.setup_username_label)) },
-                modifier = Modifier.fillMaxWidth()
-            )
-            Spacer(modifier = Modifier.height(8.dp))
-            OutlinedTextField(
-                value = uiState.password,
-                onValueChange = onPasswordChange,
-                label = { Text(stringResource(id = R.string.setup_password_label)) },
-                visualTransformation = PasswordVisualTransformation(),
-                modifier = Modifier.fillMaxWidth()
+            Image(
+                imageVector = Icons.Default.Lock,
+                contentDescription = stringResource(id = R.string.app_name),
+                modifier = Modifier.size(128.dp)
            )
            Spacer(modifier = Modifier.height(16.dp))
+            Text(
+                text = stringResource(id = R.string.setup_title),
+                style = MaterialTheme.typography.headlineLarge,
+                fontSize = 28.sp // Adjust font size as needed
+            )
+            Spacer(modifier = Modifier.height(24.dp))
+
+            Card(
+                modifier = Modifier.fillMaxWidth(),
+                elevation = CardDefaults.cardElevation(defaultElevation = 4.dp)
+            ) {
+                Column(
+                    modifier = Modifier.padding(16.dp),
+                    horizontalAlignment = Alignment.CenterHorizontally
+                ) {
+                    OutlinedTextField(
+                        value = uiState.serverUrl,
+                        onValueChange = onServerUrlChange,
+                        label = { Text(stringResource(id = R.string.setup_server_url_label)) },
+                        modifier = Modifier.fillMaxWidth()
+                    )
+                    Spacer(modifier = Modifier.height(12.dp))
+                    OutlinedTextField(
+                        value = uiState.username,
+                        onValueChange = onUsernameChange,
+                        label = { Text(stringResource(id = R.string.setup_username_label)) },
+                        modifier = Modifier.fillMaxWidth()
+                    )
+                    Spacer(modifier = Modifier.height(12.dp))
+                    OutlinedTextField(
+                        value = uiState.password,
+                        onValueChange = onPasswordChange,
+                        label = { Text(stringResource(id = R.string.setup_password_label)) },
+                        visualTransformation = PasswordVisualTransformation(),
+                        modifier = Modifier.fillMaxWidth()
+                    )
+                }
+            }
+            Spacer(modifier = Modifier.height(24.dp))
            Button(
                onClick = onConnectClick,
                enabled = !uiState.isLoading,
-                modifier = Modifier.fillMaxWidth()
+                modifier = Modifier
+                    .fillMaxWidth()
+                    .height(56.dp) // Make button more prominent
            ) {
                if (uiState.isLoading) {
-                    CircularProgressIndicator(modifier = Modifier.size(24.dp))
+                    CircularProgressIndicator(
+                        modifier = Modifier.size(24.dp),
+                        color = MaterialTheme.colorScheme.onPrimary
+                    )
                } else {
-                    Text(stringResource(id = R.string.setup_connect_button))
+                    Text(stringResource(id = R.string.setup_connect_button), fontSize = 18.sp)
                }
            }
            uiState.error?.let {
-                Spacer(modifier = Modifier.height(8.dp))
-                Text(text = it, color = MaterialTheme.colorScheme.error)
+                Spacer(modifier = Modifier.height(12.dp))
+                Text(
+                    text = it,
+                    color = MaterialTheme.colorScheme.error,
+                    style = MaterialTheme.typography.bodyMedium
+                )
            }
        }
    }
--- a/app/src/main/java/com/homebox/lens/ui/screen/setup/SetupViewModel.kt
+++ b/app/src/main/java/com/homebox/lens/ui/screen/setup/SetupViewModel.kt
@@ -74,40 +74,61 @@ class SetupViewModel @Inject constructor(
    // [END_ENTITY: Function('onUsernameChange')]

    // [ENTITY: Function('onPasswordChange')]
+    /**
+     * @summary Updates the password in the UI state.
+     * @param newPassword The new password.
+     * @sideeffect Updates the `password` in `_uiState`.
+     */
    fun onPasswordChange(newPassword: String) {
        _uiState.update { it.copy(password = newPassword) }
    }
    // [END_ENTITY: Function('onPasswordChange')]

-    // [ENTITY: Function('connect')]
-    fun connect() {
-        Timber.d("[DEBUG][ENTRYPOINT][connecting] Starting connection process.")
-        viewModelScope.launch {
-            _uiState.update { it.copy(isLoading = true, error = null) }
+   // [ENTITY: Function('areCredentialsSaved')]
+   /**
+    * @summary Checks synchronously if credentials are saved.
+    * @return true if credentials are saved, false otherwise.
+    * @sideeffect None.
+    */
+   fun areCredentialsSaved(): Boolean {
+       Timber.d("[DEBUG][ENTRYPOINT][checking_credentials_saved] Checking if credentials are saved.")
+       return credentialsRepository.areCredentialsSavedSync()
+   }
+   // [END_ENTITY: Function('areCredentialsSaved')]

-            val credentials = Credentials(
-                serverUrl = _uiState.value.serverUrl.trim(),
-                username = _uiState.value.username.trim(),
-                password = _uiState.value.password
-            )
+   // [ENTITY: Function('connect')]
+   /**
+    * @summary Initiates the connection process, saving credentials and attempting to log in.
+    * @sideeffect Updates `_uiState` with loading, error, and completion states.
+    */
+   fun connect() {
+       Timber.d("[DEBUG][ENTRYPOINT][connecting] Starting connection process.")
+       viewModelScope.launch {
+           _uiState.update { it.copy(isLoading = true, error = null) }

-            Timber.d("[DEBUG][ACTION][saving_credentials] Saving credentials.")
-            credentialsRepository.saveCredentials(credentials)
+           val credentials = Credentials(
+               serverUrl = _uiState.value.serverUrl.trim(),
+               username = _uiState.value.username.trim(),
+               password = _uiState.value.password
+           )

-            Timber.d("[DEBUG][ACTION][executing_login] Executing login use case.")
-            loginUseCase(credentials).fold(
-                onSuccess = {
-                    Timber.d("[DEBUG][SUCCESS][login_successful] Login successful.")
-                    _uiState.update { it.copy(isLoading = false, isSetupComplete = true) }
-                },
-                onFailure = { exception ->
-                    Timber.e(exception, "[ERROR][EXCEPTION][login_failed] Login failed.")
-                    _uiState.update { it.copy(isLoading = false, error = exception.message ?: "Login failed") }
-                }
-            )
-        }
-    }
-    // [END_ENTITY: Function('connect')]
+           Timber.d("[DEBUG][ACTION][saving_credentials] Saving credentials.")
+           credentialsRepository.saveCredentials(credentials)
+
+           Timber.d("[DEBUG][ACTION][executing_login] Executing login use case.")
+           loginUseCase(credentials).fold(
+               onSuccess = {
+                   Timber.d("[DEBUG][SUCCESS][login_successful] Login successful.")
+                   _uiState.update { it.copy(isLoading = false, isSetupComplete = true) }
+               },
+               onFailure = { exception ->
+                   Timber.e(exception, "[ERROR][EXCEPTION][login_failed] Login failed.")
+                   _uiState.update { it.copy(isLoading = false, error = exception.message ?: "Login failed") }
+               }
+           )
+       }
+   }
+   // [END_ENTITY: Function('connect')]
 }
 // [END_ENTITY: ViewModel('SetupViewModel')]
 // [END_FILE_SetupViewModel.kt]
--- a/app/src/main/java/com/homebox/lens/ui/screen/splash/SplashScreen.kt
+++ b/app/src/main/java/com/homebox/lens/ui/screen/splash/SplashScreen.kt
@@ -0,0 +1,57 @@
+// [PACKAGE] com.homebox.lens.ui.screen.splash
+// [FILE] SplashScreen.kt
+// [SEMANTICS] ui, screen, splash, navigation, authentication_flow
+
+package com.homebox.lens.ui.screen.splash
+
+import androidx.compose.foundation.layout.Box
+import androidx.compose.foundation.layout.fillMaxSize
+import androidx.compose.material3.CircularProgressIndicator
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.LaunchedEffect
+import androidx.compose.ui.Alignment
+import androidx.compose.ui.Modifier
+import androidx.hilt.navigation.compose.hiltViewModel
+import androidx.navigation.NavController
+import com.homebox.lens.navigation.Screen
+import com.homebox.lens.ui.screen.setup.SetupViewModel
+import timber.log.Timber
+
+// [ENTITY: Function('SplashScreen')]
+/**
+ * @summary Displays a splash screen while checking if credentials are saved.
+ * @param navController The NavController for navigation.
+ * @param viewModel The SetupViewModel to check credential status.
+ * @sideeffect Navigates to either SetupScreen or DashboardScreen based on credential status.
+ */
+@Composable
+fun SplashScreen(
+    navController: NavController,
+    viewModel: SetupViewModel = hiltViewModel()
+) {
+    Timber.d("[DEBUG][ENTRYPOINT][splash_screen_composable] SplashScreen entered.")
+
+    LaunchedEffect(key1 = true) {
+        Timber.i("[INFO][ACTION][checking_credentials_on_launch] Checking if credentials are saved on launch.")
+        val credentialsSaved = viewModel.areCredentialsSaved()
+        if (credentialsSaved) {
+            Timber.i("[INFO][ACTION][credentials_found_navigating_dashboard] Credentials found, navigating to Dashboard.")
+            navController.navigate(Screen.Dashboard.route) {
+                popUpTo(Screen.Splash.route) { inclusive = true }
+            }
+        } else {
+            Timber.i("[INFO][ACTION][no_credentials_found_navigating_setup] No credentials found, navigating to Setup.")
+            navController.navigate(Screen.Setup.route) {
+                popUpTo(Screen.Splash.route) { inclusive = true }
+            }
+        }
+    }
+
+    Box(
+        modifier = Modifier.fillMaxSize(),
+        contentAlignment = Alignment.Center
+    ) {
+        CircularProgressIndicator()
+    }
+}
+// [END_ENTITY: Function('SplashScreen')]
--- a/app/src/main/res/values/strings.xml
+++ b/app/src/main/res/values/strings.xml
@@ -35,7 +35,6 @@
    <string name="item_edit_title_create">Создать элемент</string>
    <string name="content_desc_save_item">Сохранить элемент</string>
    <string name="label_name">Название</string>
-    <string name="label_description">Описание</string>

    <!-- Search Screen -->
    <string name="placeholder_search_items">Поиск элементов...</string>
@@ -120,6 +119,8 @@

    <!-- Labels List Screen -->
    <string name="screen_title_labels">Метки</string>
+    <!-- Settings Screen -->
+    <string name="screen_title_settings">Настройки</string>
    <string name="content_desc_navigate_back" translatable="false">Вернуться назад</string>
    <string name="content_desc_create_label">Создать новую метку</string>
    <string name="content_desc_label_icon">Иконка метки</string>
@@ -133,6 +134,7 @@
    <string name="label_edit_title_create">Создать метку</string>
    <string name="label_edit_title_edit">Редактировать метку</string>
    <string name="label_name_edit">Название метки</string>
+    <string name="label_description">Описание</string>

    <!-- Common Actions -->
    <string name="back">Назад</string>