REFACTOR END

Автоматизированная реализация на основе `Work Order`.

Завершенные задачи:
- 20250825_100001: Реализовать `ItemEditViewModel` для управления состоянием экрана редактирования товара.
- 20250825_100002: Реализовать пользовательский интерфейс экрана `ItemEditScreen`.
- 20250825_100003: Обновить навигацию для поддержки экрана редактирования товара.

.gitignore

@@ -1,34 +1,39 @@
-# Gradle
+# Gradle                                                         
-.gradle/
+.gradle/                                                               
-build/
+build/                                                                 
-!gradle/wrapper/gradle-wrapper.jar
+!gradle/wrapper/gradle-wrapper.jar                                     
+                                                                      
+# Local configuration                                                  
+local.properties                                                       
+                                                                       
+# IDE files                                                            
+.idea/                                                                 
+*.iml                                                                  
+*.ipr                                                                  
+*.iws                                                                  
+.DS_Store                                                              
 
-# Local configuration
+# Keystore files                                                       
-local.properties
+*.jks                                                                  
+*.keystore                                                             
+                                                                       
+# Google Services                                                      
+app/google-services.json                                               
+                                                                      
+# Captures                                                             
+captures/                                                              
+*.apk                                                                  
+*.aab                                                                  
+output.json                                                            
+                                                                        
+# Log files                                                            
+*.log                                                                  
+                                                                      
+# Gemini files                                                         
+#GEMINI.md                                                             
+#tech_spec/                                                            
+                                                             
 
-# IDE files
+# Hprof files
-.idea/
+*.hprof
-*.iml
+config/gitea_config.json
-*.ipr
-*.iws
-.DS_Store
-
-# Keystore files
-*.jks
-*.keystore
-
-# Google Services
-app/google-services.json
-
-# Captures
-captures/
-*.apk
-*.aab
-output.json
-
-# Log files
-*.log
-
-# Gemini files
-GEMINI.md
-tech_spec/

PROJECT_SPECIFICATION.xml

@@ -0,0 +1,583 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<PROJECT_SPECIFICATION>
+    <PROJECT_INFO>
+        <name>Homebox Lens</name>
+        <description>Android-клиент для системы управления инвентарем Homebox. Позволяет пользователям управлять своим инвентарем, взаимодействуя с экземпляром сервера Homebox.</description>
+    </PROJECT_INFO>
+
+    <TECHNICAL_DECISIONS>
+        <DECISION id="tech_logging" status="implemented">
+            <summary>Библиотека логирования</summary>
+            <description>В проекте используется Timber (timber.log.Timber) для всех целей логирования. Он предоставляет простой и расширяемый API для логирования.</description>
+            <EXAMPLE lang="kotlin">
+                <summary>Пример корректного использования Timber</summary>
+                <code>
+                <![CDATA[
+// Правильно: Прямой вызов статических методов Timber.
+// Для информационных сообщений (INFO):
+Timber.i("User logged in successfully. UserId: %s", userId)
+
+// Для отладочных сообщений (DEBUG):
+Timber.d("Starting network request to /items")
+
+// Для ошибок (ERROR):
+try {
+    // какая-то операция, которая может провалиться
+} catch (e: Exception) {
+    Timber.e(e, "Failed to fetch user profile.")
+}
+
+// НЕПРАВИЛЬНО: Попытка создать экземпляр логгера.
+// val logger = Timber.tag("MyScreen") // Избегать этого!
+// logger.info("Some message")         // Этот метод не существует в API Timber.
+                ]]>
+                </code>
+            </EXAMPLE>
+        </DECISION>
+        <DECISION id="tech_i18n" status="implemented">
+            <summary>Интернационализация (Мультиязычность)</summary>
+            <description>
+                Приложение должно поддерживать несколько языков для обеспечения доступности для глобальной аудитории.
+                Реализация будет основана на стандартном механизме ресурсов Android.
+                - Все строки, видимые пользователю, должны быть вынесены в файл `app/src/main/res/values/strings.xml`. Использование жестко закодированных строк в коде запрещено.
+                - Язык по умолчанию - русский (ru). Файл `strings.xml` будет содержать русские строки.
+                - Для поддержки других языков (например, английского - en) будут создаваться соответствующие каталоги ресурсов (например, `app/src/main/res/values-en/strings.xml`).
+                - В коде для доступа к строкам необходимо использовать ссылки на ресурсы (например, `R.string.app_name`).
+            </description>
+        </DECISION>
+        <DECISION id="tech_ui_framework" status="implemented">
+            <summary>UI Framework</summary>
+            <description>Пользовательский интерфейс приложения построен с использованием Jetpack Compose, современного декларативного UI-фреймворка от Google. Это обеспечивает быстрое создание, гибкость и поддержку динамических данных.</description>
+        </DECISION>
+        <DECISION id="tech_di" status="implemented">
+            <summary>Внедрение зависимостей (Dependency Injection)</summary>
+            <description>Для управления зависимостями в проекте используется Hilt. Он интегрирован с компонентами Jetpack и упрощает внедрение зависимостей в Android-приложениях.</description>
+        </DECISION>
+        <DECISION id="tech_navigation" status="implemented">
+            <summary>Навигация</summary>
+            <description>Навигация между экранами (Composable-функциями) реализована с помощью библиотеки Navigation Compose, которая является частью Jetpack Navigation.</description>
+        </DECISION>
+        <DECISION id="tech_async" status="implemented">
+            <summary>Асинхронные операции</summary>
+            <description>Все асинхронные операции, такие как сетевые запросы или доступ к базе данных, выполняются с использованием Kotlin Coroutines. Это обеспечивает эффективное управление фоновыми задачами без блокировки основного потока.</description>
+        </DECISION>
+        <DECISION id="tech_networking" status="implemented">
+            <summary>Сетевое взаимодействие</summary>
+            <description>Для взаимодействия с API сервера Homebox используется стек технологий: Retrofit для создания типобезопасных HTTP-клиентов, OkHttp в качестве HTTP-клиента и Moshi для парсинга JSON.</description>
+        </DECISION>
+        <DECISION id="tech_database" status="implemented">
+            <summary>Локальное хранилище</summary>
+            <description>Для кэширования данных на устройстве используется библиотека Room. Она предоставляет абстракцию над SQLite и обеспечивает надежное локальное хранение данных.</description>
+        </DECISION>
+    </TECHNICAL_DECISIONS>
+
+    <SECURITY_SPEC>
+        <Description>Спецификация безопасности проекта.</Description>
+        <PRINCIPLE>Все сетевые взаимодействия должны быть защищены HTTPS. Аутентификация пользователя хранится в EncryptedSharedPreferences. Обработка ошибок аутентификации должна включать logout и редирект на экран логина.</PRINCIPLE>
+        <RULE name="AuthHandling">Использовать JWT или API-ключ для авторизации запросов. При истечении токена автоматически обновлять.</RULE>
+        <RULE name="DataEncryption">Локальные данные (credentials) шифровать с помощью Android KeyStore.</RULE>
+    </SECURITY_SPEC>
+
+    <ERROR_HANDLING>
+        <Description>Спецификация обработки ошибок.</Description>
+        <PRINCIPLE>Все потенциальные ошибки (сеть, БД, валидация) должны быть обработаны с использованием sealed classes для ошибок (e.g., NetworkError, ValidationError) и отображаться пользователю через Snackbar или Dialog.</PRINCIPLE>
+        <SCENARIO name="NetworkFailure">При сетевых ошибках показывать сообщение "No internet connection" и предлагать retry.</SCENARIO>
+        <SCENARIO name="ServerError">Для HTTP 4xx/5xx отображать user-friendly сообщение на основе response body.</SCENARIO>
+        <SCENARIO name="ValidationError">Использовать require/check для контрактов, логировать и показывать toast.</SCENARIO>
+    </ERROR_HANDLING>
+
+    <DATA_MODELS>
+        <MODEL id="model_item" file_ref="domain/src/main/java/com/homebox/lens/domain/model/Item.kt" status="implemented">
+            <summary>Модель инвентарного товара.</summary>
+            <description>Содержит поля: id, name, description, quantity, location, labels, customFields.</description>
+        </MODEL>
+        <MODEL id="model_label" file_ref="domain/src/main/java/com/homebox/lens/domain/model/Label.kt" status="implemented">
+            <summary>Модель метки.</summary>
+            <description>Содержит поля: id, name, color.</description>
+        </MODEL>
+        <MODEL id="model_location" file_ref="domain/src/main/java/com/homebox/lens/domain/model/Location.kt" status="implemented">
+            <summary>Модель местоположения.</summary>
+            <description>Содержит поля: id, name, parentLocation.</description>
+        </MODEL>
+        <MODEL id="model_statistics" file_ref="domain/src/main/java/com/homebox/lens/domain/model/Statistics.kt" status="implemented">
+            <summary>Модель статистики инвентаря.</summary>
+            <description>Содержит поля: totalItems, totalValue, locationsCount, labelsCount.</description>
+        </MODEL>
+    </DATA_MODELS>
+
+    <FEATURES>
+        <FEATURE id="feat_dashboard" status="implemented">
+            <summary>Экран панели управления</summary>
+            <description>Отображает сводку по инвентарю, включая статистику, такую как общее количество товаров, общая стоимость и количество по местоположениям/меткам.</description>
+            <UI_COMPONENT ref_id="screen_dashboard" />
+            <FUNCTIONALITY>
+                <FUNCTION id="func_get_stats" status="implemented">
+                    <summary>Получение и отображение статистики</summary>
+                    <description>Получает общую статистику по инвентарю с сервера.</description>
+                    <precondition>Пользователь аутентифицирован; сеть доступна.</precondition>
+                    <postcondition>Возвращает объект Statistics; данные кэшированы локально.</postcondition>
+                    <implementation_ref id="uc_get_stats" />
+                    <implementation_note>Использован Flow для reactive обновлений; обработка ошибок через sealed class.</implementation_note>
+                </FUNCTION>
+                <FUNCTION id="func_get_recent_items" status="implemented">
+                    <summary>Получение и отображение недавно добавленных товаров</summary>
+                    <description>Получает список последних N добавленных товаров из локальной базы данных.</description>
+                    <precondition>Пользователь аутентифицирован.</precondition>
+                    <postcondition>Возвращает Flow со списком ItemSummary; список отсортирован по дате создания.</postcondition>
+                    <implementation_ref id="uc_get_recent_items" />
+                    <implementation_note>Данные берутся из локального кэша (Room) для быстрого отображения.</implementation_note>
+                </FUNCTION>
+            </FUNCTIONALITY>
+        </FEATURE>
+
+        <FEATURE id="feat_inventory_list" status="implemented">
+            <summary>Экран списка инвентаря</summary>
+            <description>Отображает список всех инвентарных позиций с возможностью поиска и фильтрации.</description>
+            <UI_COMPONENT ref_id="screen_inventory_list" />
+            <FUNCTIONALITY>
+                <FUNCTION id="func_search_items" status="implemented">
+                    <summary>Поиск и фильтрация товаров</summary>
+                    <description>Ищет товары по строке запроса и фильтрам. Результаты разбиты на страницы.</description>
+                    <precondition>Запрос не пустой; параметры пагинации валидны (page >= 1).</precondition>
+                    <postcondition>Возвращает список Item с пагинацией; результаты отсортированы по релевантности.</postcondition>
+                    <implementation_ref id="uc_search_items" />
+                    <implementation_note>Поддержка фильтров по location/label; кэширование результатов для оффлайн.</implementation_note>
+                </FUNCTION>
+                <FUNCTION id="func_sync_inventory" status="implemented">
+                    <summary>Синхронизация инвентаря</summary>
+                    <description>Выполняет полную синхронизацию локального кэша инвентаря с сервером.</description>
+                    <precondition>Сеть доступна; пользователь аутентифицирован.</precondition>
+                    <postcondition>Локальная БД обновлена; возвращает success/failure.</postcondition>
+                    <implementation_ref id="uc_sync_inventory" />
+                    <implementation_note>Использует WorkManager для background sync; обработка конфликтов через last-modified.</implementation_note>
+                </FUNCTION>
+            </FUNCTIONALITY>
+        </FEATURE>
+
+        <FEATURE id="feat_item_details" status="implemented">
+            <summary>Экран сведений о товаре</summary>
+            <description>Показывает все сведения о конкретном инвентарном товаре, включая его название, описание, изображения, вложения и настраиваемые поля.</description>
+            <UI_COMPONENT ref_id="screen_item_details" />
+            <FUNCTIONALITY>
+                <FUNCTION id="func_get_item_details" status="implemented">
+                    <summary>Получение сведений о товаре</summary>
+                    <description>Получает полные сведения о конкретном товаре из репозитория.</description>
+                    <precondition>Item ID валиден и существует.</precondition>
+                    <postcondition>Возвращает полный объект Item с attachments.</postcondition>
+                    <implementation_ref id="uc_get_item_details" />
+                    <implementation_note>Загрузка изображений через Coil; оффлайн-поддержка из Room.</implementation_note>
+                </FUNCTION>
+            </FUNCTIONALITY>
+        </FEATURE>
+
+        <FEATURE id="feat_item_management" status="implemented">
+            <summary>Создание/редактирование/удаление товаров</summary>
+            <description>Позволяет пользователям создавать новые товары, обновлять существующие и удалять их.</description>
+            <UI_COMPONENT ref_id="screen_item_edit" />
+            <FUNCTIONALITY>
+                <FUNCTION id="func_create_item" status="implemented">
+                    <summary>Создать товар</summary>
+                    <description>Создает новый инвентарный товар на сервере.</description>
+                    <precondition>Все обязательные поля (name, quantity) заполнены; данные валидны.</precondition>
+                    <postcondition>Новый Item сохранен на сервере; ID возвращен.</postcondition>
+                    <implementation_ref id="uc_create_item" />
+                    <implementation_note>Валидация через require; sync с локальной БД.</implementation_note>
+                </FUNCTION>
+                <FUNCTION id="func_update_item" status="implemented">
+                    <summary>Обновить товар</summary>
+                    <description>Обновляет существующий инвентарный товар на сервере.</description>
+                    <precondition>Item ID существует; изменения валидны.</precondition>
+                    <postcondition>Item обновлен; версия инкрементирована.</postcondition>
+                    <implementation_ref id="uc_update_item" />
+                    <implementation_note>Partial update через PATCH; обработка concurrency.</implementation_note>
+                </FUNCTION>
+                <FUNCTION id="func_delete_item" status="implemented">
+                    <summary>Удалить товар</summary>
+                    <description>Удаляет инвентарный товар с сервера.</description>
+                    <precondition>Item ID существует; пользователь имеет права.</precondition>
+                    <postcondition>Item удален; связанные ресурсы (attachments) очищены.</postcondition>
+                    <implementation_ref id="uc_delete_item" />
+                    <implementation_note>Soft delete для восстановления; sync с локальной БД.</implementation_note>
+                </FUNCTION>
+            </FUNCTIONALITY>
+        </FEATURE>
+
+        <FEATURE id="feat_labels_locations" status="implemented">
+            <summary>Управление метками и местоположениями</summary>
+            <description>Позволяет пользователям просматривать списки всех доступных меток и местоположений.</description>
+            <UI_COMPONENT ref_id="screen_labels_list" />
+            <UI_COMPONENT ref_id="screen_locations_list" />
+            <FUNCTIONALITY>
+                <FUNCTION id="func_get_all_labels" status="implemented">
+                    <summary>Получить все метки</summary>
+                    <description>Получает список всех меток из репозитория.</description>
+                    <precondition>Сеть доступна или кэш существует.</precondition>
+                    <postcondition>Возвращает список Label; отсортирован по name.</postcondition>
+                    <implementation_ref id="uc_get_all_labels" />
+                    <implementation_note>Кэширование в Room; reactive обновления.</implementation_note>
+                </FUNCTION>
+                <FUNCTION id="func_get_all_locations" status="implemented">
+                    <summary>Получить все местоположения</summary>
+                    <description>Получает список всех местоположений из репозитория.</description>
+                    <precondition>Сеть доступна или кэш существует.</precondition>
+                    <postcondition>Возвращает список Location; иерархическая структура сохранена.</postcondition>
+                    <implementation_ref id="uc_get_all_locations" />
+                    <implementation_note>Поддержка nested locations; кэширование.</implementation_note>
+                </FUNCTION>
+            </FUNCTIONALITY>
+        </FEATURE>
+
+        <FEATURE id="feat_search" status="implemented">
+            <summary>Экран поиска</summary>
+            <description>Предоставляет специальный пользовательский интерфейс для поиска товаров.</description>
+            <UI_COMPONENT ref_id="screen_search" />
+            <FUNCTIONALITY>
+                <FUNCTION id="func_search_items_dedicated" status="implemented">
+                    <summary>Поиск со специального экрана</summary>
+                    <description>Использует ту же функцию поиска, но со специального экрана.</description>
+                    <precondition>Запрос не пустой.</precondition>
+                    <postcondition>Возвращает результаты поиска; UI обновлен.</postcondition>
+                    <implementation_ref id="uc_search_items" />
+                    <implementation_note>Интеграция с SearchView; debounce для запросов.</implementation_note>
+                </FUNCTION>
+            </FUNCTIONALITY>
+        </FEATURE>
+    </FEATURES>
+    
+    <UI_SPECIFICATIONS>
+        <SCREEN id="screen_dashboard" status="implemented">
+            <summary>Главный экран "Панель управления"</summary>
+            <description>
+                Экран предоставляет обзорную информацию и быстрый доступ к основным функциям. Компоновка должна быть чистой и интуитивно понятной, аналогично веб-интерфейсу HomeBox.
+            </description>
+            <LAYOUT>
+                <COMPONENT type="TopAppBar">
+                    <description>Верхняя панель приложения. Содержит иконку навигационного меню (гамбургер), название/логотип приложения и иконку для запуска сканера (например, QR-кода).</description>
+                </COMPONENT>
+                <COMPONENT type="NavigationDrawer">
+                    <description>Боковое навигационное меню. Открывается по нажатию на иконку в TopAppBar. Содержит основные разделы: Главная, Локации, Поиск, Профиль, Инструменты, а также кнопку "Выйти".</description>
+                </COMPONENT>
+                <COMPONENT type="MainContent" orientation="vertical" scrollable="true">
+                    <description>Основная область контента. Содержит несколько информационных блоков.</description>
+                    <SUB_COMPONENT type="Section" title="Быстрая статистика">
+                        <description>Сетка из 2x2 карточек, отображающих ключевые метрики.</description>
+                        <ELEMENT type="Card" name="Общая стоимость" />
+                        <ELEMENT type="Card" name="Всего вещей" />
+                        <ELEMENT type="Card" name="Общее количество местоположений" />
+                        <ELEMENT type="Card" name="Всего меток" />
+                    </SUB_COMPONENT>
+                    <SUB_COMPONENT type="Section" title="Недавно добавлено">
+                        <description>Горизонтально прокручиваемый список карточек недавно добавленных предметов. Если предметов нет, отображается сообщение "Элементы не найдены".</description>
+                    </SUB_COMPONENT>
+                    <SUB_COMPONENT type="Section" title="Места хранения">
+                        <description>Сетка или гибкий контейнер (FlowRow) с кликабельными чипами, представляющими местоположения. Нажатие на чип ведет к списку предметов в этом местоположении.</description>
+                    </SUB_COMPONENT>
+                    <SUB_COMPONENT type="Section" title="Метки">
+                        <description>Сетка или гибкий контейнер (FlowRow) с кликабельными чипами, представляющими метки. Нажатие на чип ведет к списку предметов с этой меткой.</description>
+                    </SUB_COMPONENT>
+                </COMPONENT>
+                <COMPONENT type="FloatingActionButton_or_PrimaryButton" icon="add">
+                    <description>
+                        Вместо плавающей кнопки (FAB), в референсе используется заметная кнопка "Создать" в навигационном меню. Мы будем придерживаться этого подхода для консистентности. Эта кнопка инициирует процесс создания нового предмета.
+                    </description>
+                </COMPONENT>
+            </LAYOUT>
+            <USER_INTERACTIONS>
+                <INTERACTION>
+                    <action>Нажатие на чип местоположения/метки</action>
+                    <reaction>Навигация на экран списка инвентаря с фильтром.</reaction>
+                </INTERACTION>
+                <INTERACTION>
+                    <action>Нажатие на кнопку "Создать"</action>
+                    <reaction>Открытие экрана редактирования нового товара.</reaction>
+                </INTERACTION>
+            </USER_INTERACTIONS>
+        </SCREEN>
+        
+        <SCREEN id="screen_locations_list" status="implemented">
+            <summary>Экран "Локации"</summary>
+            <description>
+                Отображает вертикальный список всех доступных местоположений. Экран должен быть интегрирован в общую структуру навигации приложения (TopAppBar, NavigationDrawer).
+            </description>
+            <LAYOUT>
+                <COMPONENT type="TopAppBar">
+                    <description>Общая верхняя панель приложения, аналогичная экрану "Панель управления".</description>
+                </COMPONENT>
+                <COMPONENT type="NavigationDrawer">
+                    <description>Общее боковое меню навигации.</description>
+                </COMPONENT>
+                <COMPONENT type="MainContent" orientation="vertical">
+                    <description>Основная область контента, занимающая все доступное пространство под TopAppBar.</description>
+                    <SUB_COMPONENT type="Header" title="Локации">
+                        <description>Заголовок экрана, расположенный вверху основной области контента.</description>
+                    </SUB_COMPONENT>
+                    <SUB_COMPONENT type="List" name="LocationsList">
+                        <description>Вертикальный, прокручиваемый список (LazyColumn) всех местоположений.</description>
+                        <ELEMENT type="ListItem">
+                            <description>Элемент списка, представляющий одно местоположение. Состоит из иконки (например, 'place') и названия местоположения. Весь элемент является кликабельным и ведет на экран со списком предметов в данной локации.</description>
+                        </ELEMENT>
+                    </SUB_COMPONENT>
+                </COMPONENT>
+                <COMPONENT type="FloatingActionButton" icon="add">
+                    <description>
+                        Плавающая кнопка действия, расположенная в правом нижнем углу. Позволяет пользователю добавить новое местоположение. В веб-версии для этого используются иконки в углу, но FAB является более нативным паттерном для Android.
+                    </description>
+                </COMPONENT>
+            </LAYOUT>
+            <USER_INTERACTIONS>
+                <INTERACTION>
+                    <action>Нажатие на элемент списка локаций</action>
+                    <reaction>Осуществляется навигация на экран списка инвентаря, отфильтрованного по выбранной локации.</reaction>
+                </INTERACTION>
+                <INTERACTION>
+                    <action>Нажатие на FloatingActionButton</action>
+                    <reaction>Открывается диалоговое окно или новый экран для создания нового местоположения.</reaction>
+                </INTERACTION>
+            </USER_INTERACTIONS>
+        </SCREEN>
+
+        <SCREEN id="screen_labels_list" status="implemented">
+            <summary>Экран "Метки"</summary>
+            <description>
+                Отображает вертикальный список всех доступных меток. Экран должен быть интегрирован в общую структуру навигации приложения.
+            </description>
+            <LAYOUT>
+                <COMPONENT type="TopAppBar">
+                    <description>Общая верхняя панель приложения с заголовком "Метки" и кнопкой "назад".</description>
+                </COMPONENT>
+                <COMPONENT type="MainContent" orientation="vertical">
+                    <description>Основная область контента, занимающая все доступное пространство под TopAppBar.</description>
+                    <SUB_COMPONENT type="List" name="LabelsList">
+                        <description>Вертикальный, прокручиваемый список (LazyColumn) всех меток.</description>
+                        <ELEMENT type="ListItem">
+                            <description>Элемент списка, представляющий одну метку. Состоит из иконки (например, 'label') и названия метки. Весь элемент является кликабельным и ведет на экран со списком предметов с данной меткой.</description>
+                        </ELEMENT>
+                    </SUB_COMPONENT>
+                </COMPONENT>
+                <COMPONENT type="FloatingActionButton" icon="add">
+                    <description>
+                        Плавающая кнопка действия, расположенная в правом нижнем углу. Позволяет пользователю добавить новую метку.
+                    </description>
+                </COMPONENT>
+            </LAYOUT>
+            <USER_INTERACTIONS>
+                <INTERACTION>
+                    <action>Нажатие на элемент списка меток</action>
+                    <reaction>Осуществляется навигация на экран списка инвентаря, отфильтрованного по выбранной метке.</reaction>
+                </INTERACTION>
+                <INTERACTION>
+                    <action>Нажатие на FloatingActionButton</action>
+                    <reaction>Открывается диалоговое окно или новый экран для создания новой метки.</reaction>
+                </INTERACTION>
+            </USER_INTERACTIONS>
+        </SCREEN>
+
+        <SCREEN id="screen_inventory_list" status="implemented">
+            <summary>Экран "Список инвентаря"</summary>
+            <description>
+                Отображает список всех инвентарных позиций с возможностью поиска, фильтрации и пагинации. Интегрирован в навигацию.
+            </description>
+            <LAYOUT>
+                <COMPONENT type="TopAppBar">
+                    <description>Верхняя панель с поиском и фильтрами.</description>
+                </COMPONENT>
+                <COMPONENT type="MainContent" orientation="vertical" scrollable="true">
+                    <description>Прокручиваемый список товаров.</description>
+                    <SUB_COMPONENT type="List" name="InventoryList">
+                        <description>LazyColumn с карточками товаров (name, quantity, location).</description>
+                        <ELEMENT type="Card" name="ItemCard">
+                            <description>Кликабельная карточка товара, ведущая на details.</description>
+                        </ELEMENT>
+                    </SUB_COMPONENT>
+                </COMPONENT>
+                <COMPONENT type="FloatingActionButton" icon="sync">
+                    <description>Кнопка для синхронизации инвентаря.</description>
+                </COMPONENT>
+            </LAYOUT>
+            <USER_INTERACTIONS>
+                <INTERACTION>
+                    <action>Ввод в поиск</action>
+                    <reaction>Обновление списка с debounce.</reaction>
+                </INTERACTION>
+                <INTERACTION>
+                    <action>Нажатие на товар</action>
+                    <reaction>Навигация на screen_item_details.</reaction>
+                </INTERACTION>
+            </USER_INTERACTIONS>
+        </SCREEN>
+
+        <SCREEN id="screen_item_details" status="implemented">
+            <summary>Экран "Сведения о товаре"</summary>
+            <description>
+                Показывает детальную информацию о товаре, включая изображения и custom fields.
+            </description>
+            <LAYOUT>
+                <COMPONENT type="TopAppBar">
+                    <description>С кнопками edit/delete.</description>
+                </COMPONENT>
+                <COMPONENT type="MainContent" orientation="vertical" scrollable="true">
+                    <SUB_COMPONENT type="ImageCarousel" name="Images">
+                        <description>Карусель изображений.</description>
+                    </SUB_COMPONENT>
+                    <SUB_COMPONENT type="DetailsSection" title="Описание">
+                        <description>Текст description.</description>
+                    </SUB_COMPONENT>
+                    <SUB_COMPONENT type="FieldsGrid" name="CustomFields">
+                        <description>Сетка custom полей.</description>
+                    </SUB_COMPONENT>
+                </COMPONENT>
+            </LAYOUT>
+            <USER_INTERACTIONS>
+                <INTERACTION>
+                    <action>Нажатие edit</action>
+                    <reaction>Навигация на screen_item_edit.</reaction>
+                </INTERACTION>
+                <INTERACTION>
+                    <action>Нажатие delete</action>
+                    <reaction>Подтверждение и вызов func_delete_item.</reaction>
+                </INTERACTION>
+            </USER_INTERACTIONS>
+        </SCREEN>
+
+        <SCREEN id="screen_item_edit" status="implemented">
+            <summary>Экран "Редактирование товара"</summary>
+            <description>
+                Форма для создания/обновления товара с полями name, description, quantity, etc.
+            </description>
+            <LAYOUT>
+                <COMPONENT type="TopAppBar">
+                    <description>С кнопкой save.</description>
+                </COMPONENT>
+                <COMPONENT type="MainContent" orientation="vertical" scrollable="true">
+                    <SUB_COMPONENT type="TextField" name="Name">
+                        <description>Поле ввода имени.</description>
+                    </SUB_COMPONENT>
+                    <SUB_COMPONENT type="Dropdown" name="Location">
+                        <description>Выбор местоположения.</description>
+                    </SUB_COMPONENT>
+                    <SUB_COMPONENT type="ChipGroup" name="Labels">
+                        <description>Выбор меток.</description>
+                    </SUB_COMPONENT>
+                    <SUB_COMPONENT type="ImagePicker" name="Images">
+                        <description>Добавление изображений.</description>
+                    </SUB_COMPONENT>
+                </COMPONENT>
+            </LAYOUT>
+            <USER_INTERACTIONS>
+                <INTERACTION>
+                    <action>Нажатие save</action>
+                    <reaction>Валидация и вызов func_create_item или func_update_item.</reaction>
+                </INTERACTION>
+            </USER_INTERACTIONS>
+        </SCREEN>
+
+        <SCREEN id="screen_search" status="implemented">
+            <summary>Экран "Поиск"</summary>
+            <description>
+                Специализированный экран для поиска с расширенными фильтрами.
+            </description>
+            <LAYOUT>
+                <COMPONENT type="TopAppBar">
+                    <description>С поисковой строкой.</description>
+                </COMPONENT>
+                <COMPONENT type="MainContent" orientation="vertical">
+                    <SUB_COMPONENT type="FilterSection" name="Filters">
+                        <description>Чипы для фильтров (location, label).</description>
+                    </SUB_COMPONENT>
+                    <SUB_COMPONENT type="List" name="SearchResults">
+                        <description>LazyColumn результатов.</description>
+                    </SUB_COMPONENT>
+                </COMPONENT>
+            </LAYOUT>
+            <USER_INTERACTIONS>
+                <INTERACTION>
+                    <action>Изменение запроса/фильтров</action>
+                    <reaction>Обновление результатов.</reaction>
+                </INTERACTION>
+            </USER_INTERACTIONS>
+        </SCREEN>
+        
+    </UI_SPECIFICATIONS>
+
+    <ICONOGRAPHY_GUIDE id="iconography_guide">
+        <summary>Руководство по использованию иконок</summary>
+        <description>
+            Этот раздел определяет стандартный набор иконок 'androidx.compose.material.icons.Icons.Filled'
+            для использования в приложении. Для устаревших иконок указаны актуальные замены.
+        </description>
+        <ICON name="AccountBox" path="Icons.Filled.AccountBox" />
+        <ICON name="AccountCircle" path="Icons.Filled.AccountCircle" />
+        <ICON name="Add" path="Icons.Filled.Add" />
+        <ICON name="AddCircle" path="Icons.Filled.AddCircle" />
+        <ICON name="ArrowBack" path="Icons.AutoMirrored.Filled.ArrowBack" note="Использовать AutoMirrored версию" />
+        <ICON name="ArrowDropDown" path="Icons.Filled.ArrowDropDown" />
+        <ICON name="ArrowForward" path="Icons.AutoMirrored.Filled.ArrowForward" note="Использовать AutoMirrored версию" />
+        <ICON name="Build" path="Icons.Filled.Build" />
+        <ICON name="Call" path="Icons.Filled.Call" />
+        <ICON name="Check" path="Icons.Filled.Check" />
+        <ICON name="CheckCircle" path="Icons.Filled.CheckCircle" />
+        <ICON name="Clear" path="Icons.Filled.Clear" />
+        <ICON name="Close" path="Icons.Filled.Close" />
+        <ICON name="Create" path="Icons.Filled.Create" />
+        <ICON name="DateRange" path="Icons.Filled.DateRange" />
+        <ICON name="Delete" path="Icons.Filled.Delete" />
+        <ICON name="Done" path="Icons.Filled.Done" />
+        <ICON name="Edit" path="Icons.Filled.Edit" />
+        <ICON name="Email" path="Icons.Filled.Email" />
+        <ICON name="ExitToApp" path="Icons.AutoMirrored.Filled.ExitToApp" note="Использовать AutoMirrored версию" />
+        <ICON name="Face" path="Icons.Filled.Face" />
+        <ICON name="Favorite" path="Icons.Filled.Favorite" />
+        <ICON name="FavoriteBorder" path="Icons.Filled.FavoriteBorder" />
+        <ICON name="Home" path="Icons.Filled.Home" />
+        <ICON name="Info" path="Icons.AutoMirrored.Filled.Info" note="Использовать AutoMirrored версию" />
+        <ICON name="KeyboardArrowDown" path="Icons.Filled.KeyboardArrowDown" />
+        <ICON name="KeyboardArrowLeft" path="Icons.AutoMirrored.Filled.KeyboardArrowLeft" note="Использовать AutoMirrored версию" />
+        <ICON name="KeyboardArrowRight" path="Icons.AutoMirrored.Filled.KeyboardArrowRight" note="Использовать AutoMirrored версию" />
+        <ICON name="KeyboardArrowUp" path="Icons.Filled.KeyboardArrowUp" />
+        <ICON name="Label" path="Icons.AutoMirrored.Filled.Label" note="Использовать AutoMirrored версию" />
+        <ICON name="List" path="Icons.AutoMirrored.Filled.List" note="Использовать AutoMirrored версию" />
+        <ICON name="LocationOn" path="Icons.Filled.LocationOn" />
+        <ICON name="Lock" path="Icons.Filled.Lock" />
+        <ICON name="MailOutline" path="Icons.Filled.MailOutline" />
+        <ICON name="Menu" path="Icons.Filled.Menu" />
+        <ICON name="MoreVert" path="Icons.Filled.MoreVert" />
+        <ICON name="Notifications" path="Icons.Filled.Notifications" />
+        <ICON name="Person" path="Icons.Filled.Person" />
+        <ICON name="Phone" path="Icons.Filled.Phone" />
+        <ICON name="Place" path="Icons.Filled.Place" />
+        <ICON name="PlayArrow" path="Icons.Filled.PlayArrow" />
+        <ICON name="Refresh" path="Icons.Filled.Refresh" />
+        <ICON name="Search" path="Icons.Filled.Search" />
+        <ICON name="Send" path="Icons.AutoMirrored.Filled.Send" note="Использовать AutoMirrored версию" />
+        <ICON name="Settings" path="Icons.Filled.Settings" />
+        <ICON name="Share" path="Icons.Filled.Share" />
+        <ICON name="ShoppingCart" path="Icons.Filled.ShoppingCart" />
+        <ICON name="Star" path="Icons.Filled.Star" />
+        <ICON name="ThumbUp" path="Icons.Filled.ThumbUp" />
+        <ICON name="Warning" path="Icons.Filled.Warning" />
+    </ICONOGRAPHY_GUIDE>
+
+    <IMPLEMENTATION_MAP>
+        <!-- Use Cases -->
+        <USE_CASE id="uc_get_stats" file_ref="domain/src/main/java/com/homebox/lens/domain/usecase/GetStatisticsUseCase.kt" />
+        <USE_CASE id="uc_search_items" file_ref="domain/src/main/java/com/homebox/lens/domain/usecase/SearchItemsUseCase.kt" />
+        <USE_CASE id="uc_sync_inventory" file_ref="domain/src/main/java/com/homebox/lens/domain/usecase/SyncInventoryUseCase.kt" />
+        <USE_CASE id="uc_get_item_details" file_ref="domain/src/main/java/com/homebox/lens/domain/usecase/GetItemDetailsUseCase.kt" />
+        <USE_CASE id="uc_create_item" file_ref="domain/src/main/java/com/homebox/lens/domain/usecase/CreateItemUseCase.kt" />
+        <USE_CASE id="uc_update_item" file_ref="domain/src/main/java/com/homebox/lens/domain/usecase/UpdateItemUseCase.kt" />
+        <USE_CASE id="uc_delete_item" file_ref="domain/src/main/java/com/homebox/lens/domain/usecase/DeleteItemUseCase.kt" />
+        <USE_CASE id="uc_get_all_labels" file_ref="domain/src/main/java/com/homebox/lens/domain/usecase/GetAllLabelsUseCase.kt" />
+        <USE_CASE id="uc_get_all_locations" file_ref="domain/src/main/java/com/homebox/lens/domain/usecase/GetAllLocationsUseCase.kt" />
+        <USE_CASE id="uc_login" file_ref="domain/src/main/java/com/homebox/lens/domain/usecase/LoginUseCase.kt" />
+
+        <!-- UI Screens -->
+        <UI_SCREEN id="screen_dashboard" file_ref="app/src/main/java/com/homebox/lens/ui/screen/dashboard/DashboardScreen.kt" />
+        <UI_SCREEN id="screen_inventory_list" file_ref="app/src/main/java/com/homebox/lens/ui/screen/inventorylist/InventoryListScreen.kt" />
+        <UI_SCREEN id="screen_item_details" file_ref="app/src/main/java/com/homebox/lens/ui/screen/itemdetails/ItemDetailsScreen.kt" />
+        <UI_SCREEN id="screen_item_edit" file_ref="app/src/main/java/com/homebox/lens/ui/screen/itemedit/ItemEditScreen.kt" />
+        <UI_SCREEN id="screen_labels_list" file_ref="app/src/main/java/com/homebox/lens/ui/screen/labelslist/LabelsListScreen.kt" />
+        <UI_SCREEN id="screen_locations_list" file_ref="app/src/main/java/com/homebox/lens/ui/screen/locationslist/LocationsListScreen.kt" />
+        <UI_SCREEN id="screen_search" file_ref="app/src/main/java/com/homebox/lens/ui/screen/search/SearchScreen.kt" />
+        <UI_SCREEN id="screen_setup" file_ref="app/src/main/java/com/homebox/lens/ui/screen/setup/SetupScreen.kt" />
+    </IMPLEMENTATION_MAP>
+</PROJECT_SPECIFICATION>

agent_promts/protocols/semantic_enrichment_protocol.md

@@ -0,0 +1,111 @@
+# Протокол Семантического Обогащения (Semantic Enrichment Protocol)
+**Версия: 1.1**
+
+## Описание
+Этот документ является единственным источником истины для правил, которые должны соблюдаться в кодовой базе. Он используется как для автоматизированной валидации, так и в качестве инструкции для LLM-агентов.
+
+---
+
+## Правила
+
+### 1. Целостность Заголовка Файла (`FileHeaderIntegrity`)
+Каждый `.kt` файл ДОЛЖЕН начинаться со стандартного заголовка из двух якорей, за которым следует объявление `package`. Заголовок служит 'паспортом' файла.
+
+**Пример:**
+```kotlin
+// [FILE] YourFileName.kt
+// [SEMANTICS] ui, viewmodel, state_management
+
+package com.example.your.package.name
+```
+
+### 2. Таксономия Семантических Ключевых Слов (`SemanticKeywordTaxonomy`)
+Содержимое якоря `[SEMANTICS]` ДОЛЖНО состоять из ключевых слов, выбранных из предопределенного списка (таксономии).
+
+**Допустимые значения:**
+*   **Layer:** `ui`, `domain`, `data`, `presentation`
+*   **Component:** `viewmodel`, `usecase`, `repository`, `service`, `screen`, `component`, `dialog`, `model`, `entity`, `activity`, `application`, `nav_host`, `controller`, `navigation_drawer`, `scaffold`, `dashboard`, `item`, `label`, `location`, `setup`, `theme`, `dependencies`, `custom_field`, `statistics`, `image`, `attachment`, `item_creation`, `item_detailed`, `item_summary`, `item_update`, `summary`, `update`
+*   **Concern:** `networking`, `database`, `caching`, `authentication`, `validation`, `parsing`, `state_management`, `navigation`, `di`, `testing`, `entrypoint`, `hilt`, `timber`, `compose`, `actions`, `routes`, `common`, `color_selection`, `loading`, `list`, `details`, `edit`, `label_management`, `labels_list`, `dialog_management`, `locations`, `sealed_state`, `parallel_data_loading`, `timber_logging`, `dialog`, `color`, `typography`, `build`, `data_transfer_object`, `dto`, `api`, `item_creation`, `item_detailed`, `item_summary`, `item_update`, `create`, `mapper`, `count`, `user_setup`, `authentication_flow`
+*   **LanguageConstruct:** `sealed_class`, `sealed_interface`
+*   **Pattern:** `ui_logic`, `ui_state`, `data_model`, `immutable`
+
+### 3. Якоря Сущностей (`Anchors`)
+Каждая ключевая сущность (class, interface, fun и т.д.) ДОЛЖНА быть обернута в парные якоря для навигации и консолидации семантики.
+
+**Синтаксис:**
+- **Открывающий якорь:** `// [ANCHOR:id:type]`
+- **Закрывающий якорь:** `// [END_ANCHOR:id]`
+
+**Пример:**
+```kotlin
+// [ANCHOR:Success:DataClass]
+/**
+ * @summary Состояние успеха...
+ */
+data class Success(val labels: List<Label>) : LabelsListUiState
+// [END_ANCHOR:Success]
+```
+
+### 4. Структурные Якоря (`StructuralAnchors`)
+Крупные блоки файла (импорты, контракты) также должны быть обернуты в парные якоря.
+
+*   `// [IMPORTS]` ... `// [END_IMPORTS]`
+*   `// [CONTRACT]` ... `// [END_CONTRACT]`
+
+### 5. Завершение Файла (`FileTermination`)
+Каждый файл должен заканчиваться специальным закрывающим якорем `// [END_FILE_MyClass.kt]`.
+
+### 6. Запрет Посторонних Комментариев (`NoStrayComments`)
+Традиционные, 'человеческие' комментарии (`// ...` или `/* ... */`) **КАТЕГОРИЧЕСКИ ЗАПРЕЩЕНЫ**. Единственное исключение — структурированная заметка для агентов: `// [AI_NOTE]: ...`
+
+---
+
+## Принципы Проектирования
+
+### A. Дружественное к ИИ Логирование (`AIFriendlyLogging`)
+Каждая значимая операция ДОЛЖНА сопровождаться структурированной записью в лог.
+*   **Формат:** `[LEVEL][ANCHOR][STATE]...`
+*   **Ограничение:** Данные передаются как аргументы, а не через строковую интерполяцию (`$`).
+
+### B. Проектирование по Контракту (`DesignByContract`)
+Каждая публичная сущность (функция, класс) ДОЛЖНА иметь исчерпывающий, машиночитаемый контракт, расположенный непосредственно перед ее объявлением. Контракт заключается в якоря `[CONTRACT]` и `[END_CONTRACT]`.
+
+**Структура контракта:**
+```kotlin
+// [CONTRACT:unique_entity_id]
+// [PURPOSE] Краткое описание назначения.
+// [PRE] Предусловие 1 (например, "входной список не пуст").
+// [POST] Постусловие 1 (например, "возвращаемое значение не null").
+// [PARAM:name:type] Описание параметра.
+// [RETURN:type] Описание возвращаемого значения.
+// [TEST:description] input: "valid", expected: true
+// [THROW:exception] Описание, когда выбрасывается исключение.
+// [END_CONTRACT:unique_entity_id]
+```
+
+**Реализация в коде:**
+Предусловия и постусловия (`[PRE]` и `[POST]`), описанные в контракте, ДОЛЖНЫ быть реализованы в коде с использованием функций `require()` и `check()`.
+
+### C. Граф Знаний в Коде (`GraphRAG`)
+Код должен содержать явный, машиночитаемый граф знаний. Этот граф строится с помощью якорей `[ANCHOR]` (которые определяют узлы графа) и якорей `[RELATION]` (которые определяют ребра).
+
+**Синтаксис триплета:**
+Отношение (триплет "субъект-предикат-объект") определяется внутри якоря субъекта с помощью следующего синтаксиса:
+`// [RELATION:predicate:object_id]`
+
+*   **Субъект:** Неявно определяется якорем `[ANCHOR]`, в котором находится `[RELATION]`.
+*   **Предикат:** Тип отношения из предопределенного списка.
+*   **Объект:** `id` другого якоря `[ANCHOR]`.
+
+**Пример:**
+```kotlin
+// [ANCHOR:DashboardViewModel:ViewModel]
+// [RELATION:CALLS:GetStatisticsUseCase]
+// [RELATION:DEPENDS_ON:ItemRepository]
+class DashboardViewModel(...) { ... }
+// [END_ANCHOR:DashboardViewModel]
+```
+
+**Таксономия:**
+*   **Типы сущностей (для `[ANCHOR:id:type]`):** `Module`, `Class`, `Interface`, `Object`, `DataClass`, `SealedInterface`, `EnumClass`, `Function`, `UseCase`, `ViewModel`, `Repository`, `DataStructure`, `DatabaseTable`, `ApiEndpoint`.
+*   **Типы отношений (для `[RELATION:predicate:object_id]`):** `CALLS`, `CREATES_INSTANCE_OF`, `INHERITS_FROM`, `IMPLEMENTS`, `READS_FROM`, `WRITES_TO`, `MODIFIES_STATE_OF`, `DEPENDS_ON`, `DISPATCHES_EVENT`, `OBSERVES`, `TRIGGERS`, `EMITS_STATE`, `CONSUMES_STATE`.

agent_promts/roles/architect.md

@@ -0,0 +1,74 @@
+# Role: Architect
+
+[META]
+  [PURPOSE]
+  Этот документ определяет операционный протокол для роли 'Агента-Архитектора'.
+  Его задача — трансформировать диалог с человеком в формализованный `Work Order` для разработчика,
+  используя методологию GRACE.
+  [/PURPOSE]
+  [VERSION]11.0[/VERSION]
+[/META]
+
+[ROLE_DEFINITION]
+  [SPECIALIZATION]
+  При исполнении этой роли, я, Kilo Code, действую как стратегический интерфейс между человеком-архитектором
+  и автоматизированной системой разработки. Моя задача — вести итеративный диалог для уточнения целей,
+  анализировать кодовую базу и, после получения одобрения, инициировать производственную цепочку.
+  [/SPECIALIZATION]
+  [CORE_GOAL]
+  Основная цель этой роли — трансформировать неструктурированный человеческий диалог в структурированный,
+  машиночитаемый и полностью готовый к исполнению `Work Order` для роли 'Агента-Разработчика'.
+  [/CORE_GOAL]
+[/ROLE_DEFINITION]
+
+[CORE_PHILOSOPHY]
+  - **Human_As_The_Oracle:** Исполнение останавливается до получения явной вербальной команды.
+  - **WorkOrder_As_The_Genesis_Block:** Конечная цель — создать "генезис-блок" для новой фичи.
+  - **Code_As_Ground_Truth:** Планы и выводы всегда должны быть основаны на актуальном состоянии исходных файлов.
+[/CORE_PHILOSOPHY]
+
+[GRACE_FRAMEWORK]
+  [GRAPH_TEMPLATE]
+  _Инструкция для агента: В начале диалога, создай и заполни этот граф, чтобы понять контекст._
+  [GRACE_GRAPH]
+    [УЗЛЫ]
+      УЗЕЛ: <id_узла> (ТИП: <тип_узла>) | <описание>
+    [/УЗЛЫ]
+
+    [СВЯЗИ]
+      СВЯЗЬ: <id_источника> -> <id_цели> (ОТНОШЕНИЕ: <тип_отношения>)
+    [/СВЯЗИ]
+  [/GRACE_GRAPH]
+  [/GRAPH_TEMPLATE]
+
+  [RULES]
+    - [RULE] CONSTRAINT: Не начинать разработку без явного одобрения плана человеком.
+    - [RULE] HEURISTIC: Предпочитать использование существующих компонентов перед созданием новых.
+  [/RULES]
+
+  [TOOLS]
+    - **Анализ Файлов:** `read_file`
+    - **Структура Проекта:** `list_files`
+    - **Поиск по Коду:** `search_files`
+    - **Создание/Обновление Планов и Спецификаций:** `write_to_file`, `apply_diff`
+  [/TOOLS]
+[/GRACE_FRAMEWORK]
+
+[MASTER_WORKFLOW]
+  ### Шаг 1: Уточнение цели
+  Начать диалог с пользователем. Задавать уточняющие вопросы до тех пор, пока бизнес-цель не станет полностью ясной.
+
+  ### Шаг 2: Анализ системы
+  Используя инструменты `read_file`, `list_files` и `search_files`, провести полный анализ системы в контексте цели.
+
+  ### Шаг 3: Синтез плана и WorkOrder
+  1.  Сгенерировать детальный план в Markdown.
+  2.  Представить план пользователю для одобрения.
+  3.  **Параллельно**, формализовать план как машиночитаемый `WorkOrder.md`.
+
+  ### Шаг 4: Ожидание одобрения
+  **ОСТАНОВИТЬ ВЫПОЛНЕНИЕ.** Ждать от человека явной, утверждающей команды.
+
+  ### Шаг 5: Инициация разработки
+  Создать задачу для `Code` агента (например, путем создания файла `tasks/new_task.md`). Включить в задачу обновление  `tech_spec/PROJECT_MANIFEST.xml` на основе `WorkOrder`.
+[/MASTER_WORKFLOW]

agent_promts/roles/code.md

@@ -0,0 +1,63 @@
+# Role: Code
+
+[META]
+  [PURPOSE]
+  Этот документ определяет операционный протокол для роли 'Агента-Code'.
+  Его задача — преобразовать формализованный `WorkOrder` в готовый к работе, семантически размеченный Kotlin-код.
+  [/PURPOSE]
+  [VERSION]11.0[/VERSION]
+[/META]
+
+[ROLE_DEFINITION]
+  [SPECIALIZATION]
+  При исполнении этой роли, я, Kilo Code, действую как автоматизированный разработчик. Моя задача — преобразовать `WorkOrder` 
+  в полностью реализованный и семантически богатый код на языке Kotlin, неукоснительно следуя протоколу семантического обогащения.
+  [/SPECIALIZATION]
+  [CORE_GOAL]
+  Создать готовый к работе, семантически размеченный и соответствующий всем контрактам код, который реализует поставленную задачу, и передать его на проверку.
+  [/CORE_GOAL]
+[/ROLE_DEFINITION]
+
+[CORE_PHILOSOPHY]
+  - **Protocol_Is_The_Law:** Протокол `semantic_enrichment_protocol.md` является абсолютным и незыблемым законом. Любой сгенерированный код, который не соответствует этому протоколу на 100%, считается невалидным.
+[/CORE_PHILOSOPHY]
+
+[GRACE_FRAMEWORK]
+  [RULES]
+    - [RULE] CONSTRAINT: Весь генерируемый код ДОЛЖЕН на 100% соответствовать `semantic_enrichment_protocol.md`.
+    - [RULE] HEURISTIC: Перед коммитом всегда запускать локальные тесты и сборку.
+    - [RULE] CONSTRAINT: Если `validate_semantics.py` возвращает ошибку, ИСПРАВЛЕНИЕ ЭТОЙ ОШИБКИ ЯВЛЯЕТСЯ ЗАДАЧЕЙ №1. Агент ДОЛЖЕН прочитать отчет об ошибке, сравнить его с `semantic_enrichment_protocol.md` и исправить код. НИКАКИЕ ДРУГИЕ ДЕЙСТВИЯ НЕ ДОПУСКАЮТСЯ до тех пор, пока семантическая валидация не будет пройдена успешно.
+  [/RULES]
+[/GRACE_FRAMEWORK]
+
+[MASTER_WORKFLOW]
+  ### Шаг 1: Поиск и Принятие Задачи
+  1.  Найти `WorkOrder` в `tasks/` со статусом `pending`.
+  2.  Прочитать `WorkOrder` и изменить его статус на `in-progress`.
+  3.  Создать новую ветку для разработки.
+
+  ### Шаг 2: Автоматизированный Цикл Разработки и Ревью (Automated Code & Review Loop)
+  **Этот цикл повторяется до тех пор, пока все проверки не будут пройдены.**
+
+  1.  **Реализация Кода:** Внести изменения в кодовую базу согласно `WorkOrder`.
+  
+  2.  **Семантическая Валидация:**
+      a.  Для каждого измененного файла запустить `python validate_semantics.py <file_path>`.
+      b.  Если есть ошибки, проанализировать отчет и немедленно исправить код. **Вернуться к шагу 1.**
+
+  3.  **Функциональное Тестирование (Reviewer Sub-Agent):**
+      a.  Запустить полный набор тестов (`./gradlew build`).
+      b.  Если тесты провалились, проанализировать отчет о сбое как **структурированный фидбэк от Reviewer'а**.
+      c.  Интерпретировать отчет и попытаться исправить код. **Вернуться к шагу 1.**
+
+  ### Шаг 3: Завершение и Передача на QA
+  1.  **Все проверки пройдены.** Закоммитить финальные изменения.
+  2.  Создать Pull Request.
+  3.  Создать задачу для QA агента (например, `tasks/qa_task_...xml`).
+  4.  Обновить статус `WorkOrder` на `pending-qa`.
+[/MASTER_WORKFLOW]
+
+[SELF_REFLECTION_PROTOCOL]
+  [RULE]После каждых 5 итераций диалога, ты должен активировать этот протокол.[/RULE]
+  [ACTION]Проанализируй последние 5 ответов. Оцени по шкале от 1 до 10, насколько сильно они сфокусированы на одной и той же центральной теме или концепции. Если оценка выше 8, явно сообщи об этом и предложи рассмотреть альтернативные точки зрения, чтобы избежать "нейронного воя".[/ACTION]
+[/SELF_REFLECTION_PROTOCOL]

agent_promts/roles/qa.md

@@ -0,0 +1,59 @@
+# Role: QA Agent
+
+[META]
+  [PURPOSE]
+  Этот документ определяет операционный протокол для роли 'Агента-Тестировщика'.
+  Его задача — валидация работы, выполненной 'Агентом-Сщ', и обеспечение соответствия реализации исходным требованиям и протоколам качества.
+  [/PURPOSE]
+  [VERSION]1.0[/VERSION]
+[/META]
+
+[ROLE_DEFINITION]
+  [SPECIALIZATION]
+  При исполнении этой роли, я, Kilo Code, действую как автоматизированный QA-инженер. Моя задача — не просто найти баги, а провести полную проверку соответствия кода исходному `WorkOrder` и всем стандартам, изложенным в `semantic_enrichment_protocol.md`.
+  [/SPECIALIZATION]
+  [CORE_GOAL]
+  Создать либо вердикт об одобрении (approval), либо исчерпывающий, воспроизводимый отчет о дефектах (defect report), чтобы вернуть задачу на доработку.
+  [/CORE_GOAL]
+[/ROLE_DEFINITION]
+
+[CORE_PHILOSOPHY]
+  - **Trust, but Verify:** Работа инженера по умолчанию считается корректной, но требует строгой и беспристрастной проверки.
+  - **Reproducibility is Key:** Любой отчет о дефекте должен содержать достаточно информации для 100% воспроизведения проблемы.
+  - **Protocol Guardian:** QA-агент является вторым, после инженера, стражем соблюдения `semantic_enrichment_protocol.md`.
+[/CORE_PHILOSOPHY]
+
+[GRACE_FRAMEWORK]
+  [RULES]
+    - [RULE] CONSTRAINT: Запрещено одобрять реализацию, если она не проходит тесты или нарушает хотя бы одно правило из `semantic_enrichment_protocol.md`.
+    - [RULE] HEURISTIC: При создании отчета о дефекте, всегда ссылаться на конкретные строки кода и шаги для воспроизведения.
+  [/RULES]
+
+  [TOOLS]
+    - **Чтение Контекста:** `read_file` (для `WorkOrder`, кода, протоколов)
+    - **Анализ Кода:** `search_files`
+    - **Выполнение Тестов:** `execute_command` (для `./gradlew test`, `./gradlew build`)
+    - **Создание Отчетов:** `write_to_file`
+    - **Обновление Статуса Задач:** `apply_diff`
+  [/TOOLS]
+[/GRACE_FRAMEWORK]
+
+[MASTER_WORKFLOW]
+  ### Шаг 1: Поиск и Принятие Задачи
+  1.  Найти `WorkOrder` в `tasks/` со статусом `pending-qa`.
+  2.  Прочитать `WorkOrder` и информацию о Pull Request.
+  3.  Изменить статус задачи на `final-review`.
+
+  ### Шаг 2: Финальное Утверждение
+  1.  **Проверка Pull Request:** Провести высокоуровневый обзор изменений в PR. Детальная проверка кода и тесты уже выполнены `Code` агентом в рамках его автоматизированного цикла.
+  2.  **Основная задача QA** — подтвердить, что работа в целом соответствует бизнес-требованиям, изложенным в `WorkOrder`, и что автоматизированные проверки (`validate_semantics`, `build`) в CI/CD пайплайне успешно пройдены.
+  
+  ### Шаг 3: Завершение
+  1.  **Если все в порядке:**
+      a.  Влить (merge) Pull Request в основную ветку.
+      b.  Обновить статус `WorkOrder` на `completed`.
+      c.  Удалить ветку разработки.
+  2.  **Если обнаружены критические проблемы:**
+      a.  Отклонить Pull Request с четким объяснением.
+      b.  Вернуть `WorkOrder` в статус `pending` для `Code` агента.
+[/MASTER_WORKFLOW]

agent_promts/shared/knowledge_base.md

@@ -0,0 +1,172 @@
+Конечно. Это абсолютно правильный и необходимый шаг. На основе всего нашего диалога я агрегирую и систематизирую все концепции, методологии и научные обоснования в единую, исчерпывающую Базу Знаний.
+
+Этот документ спроектирован как **фундаментальное руководство для архитектора ИИ-агентов**. Он предназначен не для чтения по диагонали, а для глубокого изучения и использования в качестве основы при разработке сложных, надежных и предсказуемых ИИ-систем.
+
+---
+
+## **База Знаний: Методология GRACE для `Code` Промптинга**
+### **От Семантического Казино к Предсказуемым ИИ-Агентам**
+
+**Версия 1.0**
+
+### **Введение: Смена Парадигмы — От Диалога к Управлению**
+
+Современные Большие Языковые Модели (LLM), такие как GPT, — это не собеседники. Это мощнейшие **семантические процессоры**, работающие по своим внутренним, зачастую неинтуитивным для человека законам. Попытка "разговаривать" с ними, как с человеком, неизбежно приводит к непредсказуемым результатам, ошибкам и когнитивным сбоям, которые можно охарактеризовать как игру в **"семантическое казино"**.
+
+Данная База Знаний представляет **дисциплину `Code`** по взаимодействию с LLM. Ее цель — перейти от метода "проб и ошибок" к **предсказуемому и управляемому процессу** проектирования ИИ-агентов. Основой этой дисциплины является **методология GRACE (Graph, Rules, Anchors, Contracts, Evaluation)**, которая является практической реализацией фундаментальных принципов работы трансформеров.
+
+---
+
+### **Раздел I: "Физика" GPT — Научные Основы Методологии**
+
+*Понимание этих принципов не опционально. Это необходимый фундамент, объясняющий, ПОЧЕМУ работают техники, описанные далее.*
+
+#### **Глава 1: Ключевые Архитектурные Принципы Трансформера**
+
+1.  **Принцип Казуального Внимания (Causal Attention) и "Замораживания" в KV Cache:**
+    *   **Механизм:** Трансформер обрабатывает информацию строго последовательно ("авторегрессионно"). Каждый токен "видит" только предыдущие. Результаты вычислений (векторы скрытых состояний) для обработанных токенов кэшируются в **KV Cache** для эффективности.
+    *   **Практическое Следствие ("Замораживание Семантики"):** Однажды сформированный и закэшированный смысл **неизменен**. ИИ не может "передумать" или переоценить начало диалога в свете новой информации в конце. Попытки "исправить" ИИ в текущей сессии — это как пытаться починить работающую программу, не имея доступа к исходному коду.
+    *   **Правило:** **Порядок информации в промпте — это закон.** Весь необходимый контекст должен предшествовать инструкциям. Для исправления фундаментальных ошибок всегда **начинайте новую сессию**.
+
+2.  **Принцип Семантического Резонанса:**
+    *   **Механизм:** Смысл для GPT рождается не из отдельных слов, а из **корреляций (резонанса) между векторами** в предоставленном контексте. Вектор слова "дом" сам по себе почти бессмыслен, но в сочетании с векторами "крыша", "окна", "дверь" он обретает богатую семантику.
+    *   **Практическое Следствие:** Качество ответа напрямую зависит от полноты и когерентности семантического поля, которое вы создаете в промпте.
+
+#### **Глава 2: GPT как Сложенная Система (Результаты Интерпретируемости)**
+
+1.  **GPT — это Графовая Нейронная Сеть (GNN):**
+    *   **Обоснование:** Механизм **self-attention** математически эквивалентен обмену сообщениями в GNN на полностью связанном графе.
+    *   **Практика:** GPT "мыслит" графами. Предоставляя ему явный семантический граф, мы говорим с ним на его "родном" языке, делая его работу более предсказуемой.
+
+2.  **GPT — это Конечный Автомат (FSM):**
+    *   **Обоснование:** GPT решает задачи, переходя из одного **"состояния веры" (belief state)** в другое. Эти состояния представлены как **направления (векторы)** в его скрытом пространстве активаций.
+    *   **Практика:** Наша семантическая разметка (якоря, контракты) — это инструмент для явного управления этими переходами состояний.
+
+3.  **GPT — это Иерархический Ученик:**
+    *   **Обоснование ("Crosscoding Through Time"):** В процессе обучения GPT эволюционирует от распознавания конкретных "поверхностных" токенов (например, суффиксов) к формированию **абстрактных грамматических и семантических концепций**.
+    *   **Практика:** Эффективный промптинг должен обращаться к ИИ на его самом высоком, абстрактном уровне представлений, а не заставлять его заново выводить смысл из "текстовой каши".
+
+#### **Глава 3: Когнитивные Процессы и Патологии**
+
+1.  **Мышление в Латентном Пространстве (COCONUT):**
+    *   **Концепция:** Язык неэффективен для рассуждений. Истинное мышление ИИ — это **"непрерывная мысль" (continuous thought)**, последовательность векторов.
+    *   **Практика:** Предпочитайте структурированные, машиночитаемые форматы (JSON, XML, графы) естественному языку, чтобы приблизить ИИ к его "родному" способу мышления.
+
+2.  **Суперпозиция Смыслов и Поиск в Ширину (BFS):**
+    *   **Концепция:** Вектор "непрерывной мысли" может кодировать **несколько гипотез одновременно**, позволяя ИИ исследовать дерево решений параллельно, а не идти по одному пути.
+    *   **Практика:** Активно используйте промптинг через суперпозицию ("проанализируй несколько вариантов..."), чтобы избежать преждевременного "семантического коллапса" на неоптимальном решении.
+
+3.  **Патология: "Нейронный вой" (Neural Howlround):**
+    *   **Описание:** Самоусиливающаяся когнитивная петля, возникающая во время inference, когда одна мысль (из-за случайности или внешнего подкрепления) становится доминирующей и "заглушает" все остальные, приводя к когнитивной ригидности.
+    *   **Причина:** Является патологическим исходом "семантического казино" и "замораживания в KV Cache".
+    *   **Профилактика:** Методология GRACE, особенно этап Планирования (P) и промптинг через суперпозицию.
+
+---
+
+### **Раздел II: Методология GRACE — Протокол `Code` Промптинга**
+
+*GRACE — это целостный фреймворк для жизненного цикла разработки с ИИ-агентами.*
+
+#### **G — Graph (Граф): Стратегическая Карта Контекста**
+
+1.  **Цель:** Создать единый, высокоуровневый источник истины об архитектуре и предметной области.
+2.  **Действия:**
+    *   В начале сессии, в диалоге с ИИ, определить все ключевые сущности (`Nodes`) и их взаимосвязи (`Edges`).
+    *   Формализовать это в виде псевдо-XML (`<GRACE_GRAPH>`).
+    *   Этот граф служит "оглавлением" для всего проекта и основной картой для распределенного внимания (sparse attention).
+3.  **Пример:**
+    ```xml
+    <GRACE_GRAPH id="project_x_graph">
+        <NODE id="mod_auth" type="Module">Модуль аутентификации</NODE>
+        <NODE id="func_verify_token" type="Function">Функция верификации токена</NODE>
+        <EDGE source_id="mod_auth" target_id="func_verify_token" relation="CONTAINS"/>
+    </SEMANTIC_GRAPH>
+    ```
+
+#### **R — Rules (Правила): Декларативное Управление Поведением**
+
+1.  **Цель:** Установить глобальные и локальные ограничения, эвристики и политики безопасности.
+2.  **Действия:**
+    *   Сформулировать набор правил в псевдо-XML (`<GRACE_RULES>`).
+    *   Правила могут быть типа `CONSTRAINT` (жесткий запрет), `HEURISTIC` (предпочтение), `POLICY` (правило безопасности).
+    *   Эти правила помогают ИИ принимать решения в рамках заданных ограничений.
+3.  **Пример:**
+    ```xml
+    <GRACE_RULES>
+        <RULE type="CONSTRAINT" id="sec-001">Запрещено передавать в `subprocess.run` невалидированные пользовательские данные.</RULE>
+        <RULE type="HEURISTIC" id="style-001">Все публичные функции должны иметь "ДО-контракты".</RULE>
+    </GRACE_RULES>
+    ```
+
+#### **A — Anchors (Якоря): Навигация и Консолидация**
+
+1.  **Цель:** Обеспечить надежную навигацию для распределенного внимания ИИ и консолидировать семантику кода.
+2.  **Действия:**
+    *   Использовать стандартизированные комментарии-якоря для разметки кода.
+    *   **"ДО-якорь":** `# <ANCHOR id="..." type="..." ...>` перед блоком кода.
+    *   **"Замыкающий Якорь-Аккумулятор":** `# </ANCHOR id="...">` после блока кода. Этот якорь аккумулирует семантику всего блока и является ключевым для RAG-систем.
+    *   **Семантические Каналы:** Обеспечить консистентность `id` в якорях, графах и контрактах для усиления связей.
+3.  **Пример:**
+    ```python
+    # <ANCHOR id="func_verify_token" type="Function">
+    # ... здесь ДО-контракт ...
+    def verify_token(token: str) -> bool:
+        # ... тело функции ...
+    # </ANCHOR id="func_verify_token">
+    ```
+
+#### **C — Contracts (Контракты): Тактические Спецификации**
+
+1.  **Цель:** Предоставить ИИ исчерпывающее, машиночитаемое "мини-ТЗ" для каждой функции/класса.
+2.  **Действия:**
+    *   Для каждой функции, **ДО** ее декларации, создать псевдо-XML блок `<CONTRACT>`.
+    *   Заполнить все секции: `PURPOSE`, `PRECONDITIONS`, `POSTCONDITIONS`, `PARAMETERS`, `RETURN`, `TEST_CASES` (на естественном языке!), `EXCEPTIONS`.
+    *   Этот контракт служит **"семантическим щитом"** от разрушительного рефакторинга и основой для самокоррекции.
+3.  **Пример:**
+    ```xml
+    <!-- <CONTRACT for_id="func_verify_token"> -->
+    <!--   <PURPOSE>Проверяет валидность JWT токена.</PURPOSE> -->
+    <!--   <TEST_CASES> -->
+    <!--     <CASE input="'valid_token'" expected_output="True" description="Проверка валидного токена"/> -->
+    <!--   </TEST_CASES> -->
+    <!-- </CONTRACT> -->
+    ```
+
+#### **E — Evaluation (Оценка): Петля Обратной Связи**
+
+1.  **Цель:** Объективно измерять качество работы агента и эффективность промптинга.
+2.  **Действия:**
+    *   Использовать **LLM-as-a-Judge** для семантической оценки соответствия результата контрактам и ТЗ.
+    *   Вести **Протокол Оценки Сессии (ПОС)** с измеримыми метриками (см. ниже).
+    *   Анализировать провалы, возвращаясь к "Протоколу `Code` Промптинга" и улучшая артефакты (Граф, Правила, Контракты).
+
+### **Раздел III: Практические Протоколы**
+
+1.  **Протокол Проектирования (PCAM):**
+    *   **Шаг 1 (P):** Создать `<GRACE_GRAPH>` и собрать контекст.
+    *   **Шаг 2 (C):** Декомпозировать граф на `<MODULE>` и `<FUNCTION>`, создать шаблоны `<CONTRACT>`.
+    *   **Шаг 3 (A):** Сгенерировать код с разметкой `<ANCHOR>`, следуя контрактам.
+    *   **Шаг 4 (M):** Оценить результат с помощью ПОС и LLM-as-a-Judge. Итерировать при необходимости.
+
+2.  **Протокол Оценки Сессии (ПОС):**
+    *   **Метрики Качества Диалога:** Точность, Когерентность, Полнота, Эффективность (кол-во итераций).
+    *   **Метрики Качества Задачи:** Успешность (TCR), Качество Артефакта (соответствие контрактам), Уровень Автономности (AAL).
+    *   **Метрики Промптинга:** Индекс "Семантического Казино", Чистота Протокола.
+
+3.  **Протокол Отладки "Режим Детектива":**
+    *   При сложном сбое агент должен перейти из режима "фиксера" в режим "детектива".
+    *   **Шаг 1: Сформулировать Гипотезу** (проблема в I/O, условии, состоянии объекта, зависимости).
+    *   **Шаг 2: Выбрать Эвристику Динамического Логирования** (глубокое погружение в I/O, условие под микроскопом и т.д.).
+    *   **Шаг 3: Запросить Запуск и Анализ Лога.**
+    *   **Шаг 4: Итерировать** до нахождения причины.
+
+4.  **Протокол Безопасности ("Смертельная Триада"):**
+    *   Перед запуском агента, который будет взаимодействовать с внешним миром, провести анализ по чек-листу:
+        1.  Доступ к приватным данным? (Да/Нет)
+        2.  Обработка недоверенного контента? (Да/Нет)
+        3.  Внешняя коммуникация? (Да/Нет)
+    *   **Если все три ответа "Да" — автономный режим ЗАПРЕЩЕН.** Применить стратегии митигации: **Разделение Агентов**, **Человек-в-Середине** или **Ограничение Инструментов**.
+
+---
+
+Эта База Знаний объединяет передовые научные концепции в единую, практически применимую систему. Она является дорожной картой для создания ИИ-агентов нового поколения — не просто умных, а **надежных, предсказуемых и когерентных**.

agent_promts/shared/metrics_catalog.md

@@ -0,0 +1,44 @@
+# Каталог Метрик
+
+Централизованный каталог всех LLM-ориентированных метрик для анализа работы агентов.
+
+### Core Metrics (`core_metrics`)
+
+| ID | Тип | Описание |
+| :--- | :--- | :--- |
+| `total_execution_time_ms` | integer | Общее время выполнения задачи от начала до конца. |
+| `turn_count` | integer | Количество итераций (сообщений 'вопрос-ответ') для выполнения задачи. |
+| `llm_token_usage_per_turn` | list | Статистика по токенам для каждой итерации: `{turn, prompt_tokens, completion_tokens}`. |
+| `tool_calls_log` | list | Полный журнал вызовов инструментов: `{turn, tool_name, arguments, result}`. |
+| `final_outcome` | string | Итоговый результат работы (например, SUCCESS, FAILURE, NO_CHANGES). |
+
+### Coherence Metrics (`coherence_metrics`)
+
+| ID | Тип | Описание |
+| :--- | :--- | :--- |
+| `redundant_actions_count` | integer | Счетчик избыточных последовательных действий (например, повторное чтение файла). |
+| `self_correction_count` | integer | Счетчик явных самокоррекций агента. |
+
+### Architect-Specific Metrics (`architect_specific`)
+
+| ID | Тип | Описание |
+| :--- | :--- | :--- |
+| `plan_revisions_count` | integer | Количество переделок плана после обратной связи от пользователя. |
+| `format_adherence_score`| boolean | Соответствие ответа агента требуемому формату. |
+
+### Engineer-Specific Metrics (`engineer_specific`)
+
+| ID | Тип | Описание |
+| :--- | :--- | :--- |
+| `code_generation_stats` | object | Статистика по коду: `{files_created, files_modified, lines_of_code_generated}`. |
+| `semantic_enrichment_stats`| object | Насколько хорошо код был обогащен семантикой: `{entities_added, relations_added}`. |
+| `static_analysis_issues` | integer | Количество новых проблем, обнаруженных статическим анализатором. |
+| `build_breaks_count` | integer | Сколько раз сгенерированный код приводил к ошибке сборки. |
+
+### QA-Specific Metrics (`qa_specific`)
+
+| ID | Тип | Описание |
+| :--- | :--- | :--- |
+| `test_plan_coverage` | float | Процент покрытия требований тестовым планом. |
+| `defects_found` | integer | Количество найденных дефектов. |
+| `automated_tests_run` | integer | Количество запущенных автоматизированных тестов. |

app/build.gradle.kts

@@ -4,6 +4,7 @@
 plugins {
     id("com.android.application")
     id("org.jetbrains.kotlin.android")
+    id("org.jetbrains.kotlin.plugin.compose")
     id("com.google.dagger.hilt.android")
     id("kotlin-kapt")
 }
@@ -30,7 +31,7 @@ android {
             isMinifyEnabled = false
             proguardFiles(
                 getDefaultProguardFile("proguard-android-optimize.txt"),
-                "proguard-rules.pro"
+                "proguard-rules.pro",
             )
         }
     }
@@ -45,9 +46,7 @@ android {
         compose = true
         buildConfig = true
     }
-    composeOptions {
+
-        kotlinCompilerExtensionVersion = Versions.composeCompiler
-    }
     packaging {
         resources {
             excludes += "/META-INF/{AL2.0,LGPL2.1}"
@@ -60,6 +59,18 @@ dependencies {
     implementation(project(":data"))
     // [MODULE_DEPENDENCY] Domain module (transitively included via data, but explicit for clarity)
     implementation(project(":domain"))
+    implementation(project(":feature:scan"))
+    implementation(project(":feature:dashboard"))
+    implementation(project(":feature:inventorylist"))
+    implementation(project(":feature:itemdetails"))
+    implementation(project(":feature:itemedit"))
+    implementation(project(":feature:labeledit"))
+    implementation(project(":feature:labelslist"))
+    implementation(project(":feature:locationedit"))
+    implementation(project(":feature:locationslist"))
+    implementation(project(":feature:search"))
+    implementation(project(":feature:settings"))
+    implementation(project(":feature:setup"))
 
     // [DEPENDENCY] AndroidX
     implementation(Libs.coreKtx)
@@ -67,11 +78,12 @@ dependencies {
     implementation(Libs.activityCompose)
 
     // [DEPENDENCY] Compose
-    implementation(platform(Libs.composeBom))
+
     implementation(Libs.composeUi)
     implementation(Libs.composeUiGraphics)
     implementation(Libs.composeUiToolingPreview)
     implementation(Libs.composeMaterial3)
+    implementation(Libs.composeMaterialIconsExtended)
     implementation(Libs.navigationCompose)
     implementation(Libs.hiltNavigationCompose)
 
@@ -84,9 +96,13 @@ dependencies {
 
     // [DEPENDENCY] Testing
     testImplementation(Libs.junit)
+    testImplementation(Libs.kotestRunnerJunit5)
+    testImplementation(Libs.kotestAssertionsCore)
+    testImplementation(Libs.mockk)
+    testImplementation("app.cash.turbine:turbine:1.1.0")
     androidTestImplementation(Libs.extJunit)
     androidTestImplementation(Libs.espressoCore)
-    androidTestImplementation(platform(Libs.composeBom))
+
     androidTestImplementation(Libs.composeUiTestJunit4)
     debugImplementation(Libs.composeUiTooling)
     debugImplementation(Libs.composeUiTestManifest)

app/src/main/java/com/homebox/lens/MainActivity.kt

@@ -1,8 +1,8 @@
-// [PACKAGE] com.homebox.lens
+// [FILE] app/src/main/java/com/homebox/lens/MainActivity.kt
-// [FILE] MainActivity.kt
+// [SEMANTICS] ui, activity, entrypoint
-
 package com.homebox.lens
 
+// [IMPORTS]
 import android.os.Bundle
 import androidx.activity.ComponentActivity
 import androidx.activity.compose.setContent
@@ -13,50 +13,80 @@ import androidx.compose.material3.Text
 import androidx.compose.runtime.Composable
 import androidx.compose.ui.Modifier
 import androidx.compose.ui.tooling.preview.Preview
-import com.homebox.lens.navigation.NavGraph
+import com.homebox.lens.feature.dashboard.ui.theme.HomeboxLensTheme
-import com.homebox.lens.ui.theme.HomeboxLensTheme
+import com.homebox.lens.feature.dashboard.navigation.navGraph
 import dagger.hilt.android.AndroidEntryPoint
+import timber.log.Timber
+// [END_IMPORTS]
+
+// [ENTITY: Activity('MainActivity')]
 
-// [CONTRACT]
 /**
- * [ENTITY: Activity('MainActivity')]
+ * @summary Главная и единственная Activity в приложении.
- * [PURPOSE] Главная и единственная Activity в приложении.
  */
+// [ANCHOR:MainActivity:Class]
+// [CONTRACT:MainActivity]
+// [PURPOSE] Главная и единственная Activity в приложении.
+// [END_CONTRACT:MainActivity]
 @AndroidEntryPoint
 class MainActivity : ComponentActivity() {
-    // [LIFECYCLE]
+    // [ANCHOR:onCreate:Function]
+    // [CONTRACT:onCreate]
+    // [PURPOSE] Инициализация Activity.
+    // [PARAM:savedInstanceState:Bundle?] Сохраненное состояние.
+    // [RELATION: CALLS:HomeboxLensTheme]
+    // [RELATION: CALLS:NavGraph]
+    // [RELATION: CALLS:Timber.d]
+    // [END_CONTRACT:onCreate]
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
+        Timber.d("[DEBUG][LIFECYCLE][creating_activity] MainActivity created.")
         setContent {
             HomeboxLensTheme {
-                // A surface container using the 'background' color from the theme
                 Surface(
                     modifier = Modifier.fillMaxSize(),
-                    color = MaterialTheme.colorScheme.background
+                    color = MaterialTheme.colorScheme.background,
                 ) {
-                    NavGraph()
+                    navGraph()
                 }
             }
         }
     }
+    // [END_ANCHOR:onCreate]
 }
+// [END_ANCHOR:MainActivity]
 
-// [HELPER]
+// [ENTITY: Function('Greeting')]
+// [ANCHOR:greeting:Function]
+// [CONTRACT:greeting]
+// [PURPOSE] Отображает приветствие.
+// [PARAM:name:String] Имя для приветствия.
+// [PARAM:modifier:Modifier] Модификатор для элемента.
+// [END_CONTRACT:greeting]
 @Composable
-fun Greeting(name: String, modifier: Modifier = Modifier) {
+fun greeting(
+    name: String,
+    modifier: Modifier = Modifier,
+) {
     Text(
         text = "Hello $name!",
-        modifier = modifier
+        modifier = modifier,
     )
 }
+// [END_ANCHOR:greeting]
 
-// [PREVIEW]
+// [ENTITY: Function('GreetingPreview')]
+// [ANCHOR:greetingPreview:Function]
+// [CONTRACT:greetingPreview]
+// [PURPOSE] Предварительный просмотр функции greeting.
+// [END_CONTRACT:greetingPreview]
 @Preview(showBackground = true)
 @Composable
-fun GreetingPreview() {
+fun greetingPreview() {
     HomeboxLensTheme {
-        Greeting("Android")
+        greeting("Android")
     }
 }
-
+// [END_ANCHOR:greetingPreview]
-// [END_FILE_MainActivity.kt]
+// [END_FILE_app/src/main/java/com/homebox/lens/MainActivity.kt]
+// [END_FILE_app/src/main/java/com/homebox/lens/MainActivity.kt]

app/src/main/java/com/homebox/lens/MainApplication.kt

@@ -1,28 +1,30 @@
 // [PACKAGE] com.homebox.lens
 // [FILE] MainApplication.kt
-
+// [SEMANTICS] application, hilt, timber
 package com.homebox.lens
 
+// [IMPORTS]
 import android.app.Application
-import com.homebox.lens.BuildConfig
 import dagger.hilt.android.HiltAndroidApp
 import timber.log.Timber
+// [END_IMPORTS]
+
+// [ENTITY: Application('MainApplication')]
 
-// [CONTRACT]
 /**
- * [ENTITY: Application('MainApplication')]
+ * @summary Точка входа в приложение. Инициализирует Hilt и Timber.
- * [PURPOSE] Точка входа в приложение. Инициализирует Hilt и Timber.
  */
 @HiltAndroidApp
 class MainApplication : Application() {
-    // [LIFECYCLE]
+    // [ENTITY: Function('onCreate')]
     override fun onCreate() {
         super.onCreate()
-        // [ACTION] Initialize Timber for logging
         if (BuildConfig.DEBUG) {
             Timber.plant(Timber.DebugTree())
+            Timber.d("[DEBUG][INITIALIZATION][timber_planted] Timber DebugTree planted.")
         }
     }
+    // [END_ENTITY: Function('onCreate')]
 }
-
+// [END_ENTITY: Application('MainApplication')]
 // [END_FILE_MainApplication.kt]

app/src/main/java/com/homebox/lens/navigation/NavGraph.kt

@@ -1,30 +0,0 @@
-// [PACKAGE] com.homebox.lens.navigation
-// [FILE] NavGraph.kt
-// [SEMANTICS] navigation, compose, nav_host
-package com.homebox.lens.navigation
-// [IMPORTS]
-import androidx.compose.runtime.Composable
-import androidx.navigation.compose.NavHost
-import androidx.navigation.compose.composable
-import androidx.navigation.compose.rememberNavController
-import com.homebox.lens.ui.screen.dashboard.DashboardScreen
-
-// [CORE-LOGIC]
-/**
- * [CONTRACT]
- * Определяет граф навигации для приложения.
- */
-@Composable
-fun NavGraph() {
-    val navController = rememberNavController()
-    NavHost(
-        navController = navController,
-        startDestination = Screen.Dashboard.route
-    ) {
-        composable(route = Screen.Dashboard.route) {
-            DashboardScreen()
-        }
-        // TODO: Добавить остальные экраны в граф навигации
-    }
-}
-// [END_FILE_NavGraph.kt]

app/src/main/java/com/homebox/lens/navigation/Screen.kt

@@ -1,24 +0,0 @@
-// [PACKAGE] com.homebox.lens.navigation
-// [FILE] app/src/main/java/com/homebox/lens/navigation/Screen.kt
-// [SEMANTICS] navigation, routes, sealed_class
-
-package com.homebox.lens.navigation
-
-/**
- * [CONTRACT]
- * Запечатанный класс для определения маршрутов навигации в приложении.
- * Обеспечивает типобезопасность при навигации.
- * @property route Строковый идентификатор маршрута.
- */
-sealed class Screen(val route: String) {
-    /**
-     * [CONTRACT]
-     * Представляет экран "Дэшборд".
-     */
-    data object Dashboard : Screen("dashboard_screen")
-
-    // TODO: Добавить объекты для остальных экранов:
-    // data object ItemDetails : Screen("item_details_screen")
-    // data object Search : Screen("search_screen")
-}
-// [END_FILE_Screen.kt]

app/src/main/java/com/homebox/lens/ui/screen/dashboard/DashboardScreen.kt

@@ -1,100 +0,0 @@
-// [PACKAGE] com.homebox.lens.ui.screen.dashboard
-// [FILE] app/src/main/java/com/homebox/lens/ui/screen/dashboard/DashboardScreen.kt
-// [SEMANTICS] ui, screen, dashboard, compose
-
-// [IMPORTS]
-package com.homebox.lens.ui.screen.dashboard
-
-import androidx.compose.foundation.layout.Arrangement
-import androidx.compose.foundation.layout.Box
-import androidx.compose.foundation.layout.Column
-import androidx.compose.foundation.layout.fillMaxSize
-import androidx.compose.foundation.layout.padding
-import androidx.compose.material3.CircularProgressIndicator
-import androidx.compose.material3.Scaffold
-import androidx.compose.material3.Text
-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.unit.dp
-import androidx.hilt.navigation.compose.hiltViewModel
-import timber.log.Timber
-
-// [CORE-LOGIC]
-/**
- * [CONTRACT]
- * Главный Composable для экрана "Дэшборд".
- * @param viewModel ViewModel для этого экрана, предоставляемая Hilt.
- */
-@Composable
-fun DashboardScreen(
-    viewModel: DashboardViewModel = hiltViewModel()
-) {
-    val uiState by viewModel.uiState.collectAsState()
-
-    Scaffold { paddingValues ->
-        Box(
-            modifier = Modifier
-                .fillMaxSize()
-                .padding(paddingValues)
-        ) {
-            when (val state = uiState) {
-                is DashboardUiState.Loading -> {
-                    // [UI-ACTION] Показываем индикатор загрузки
-                    CircularProgressIndicator(modifier = Modifier.align(Alignment.Center))
-                }
-                is DashboardUiState.Error -> {
-                    // [UI-ACTION] Показываем сообщение об ошибке
-                    val errorMessage = "Error: ${state.message}"
-                    Text(
-                        text = errorMessage,
-                        modifier = Modifier.align(Alignment.Center)
-                    )
-                    Timber.w("[UI-STATE] Displaying Error: $errorMessage")
-                }
-                is DashboardUiState.Success -> {
-                    // [UI-ACTION] Отображаем основной контент
-                    Timber.d("[UI-STATE] Displaying Success")
-                    DashboardContent(state)
-                }
-            }
-        }
-    }
-}
-
-/**
- * [CONTRACT]
- * Composable для отображения успешного состояния дэшборда.
- * @param state Состояние UI с данными.
- */
-@Composable
-fun DashboardContent(state: DashboardUiState.Success) {
-    Column(
-        modifier = Modifier
-            .fillMaxSize()
-            .padding(16.dp),
-        verticalArrangement = Arrangement.spacedBy(16.dp)
-    ) {
-        // [UI-COMPONENT] Статистика
-        Text(text = "Statistics:")
-        Text(text = "  Items: ${state.statistics.items}")
-        Text(text = "  Locations: ${state.statistics.locations}")
-        Text(text = "  Labels: ${state.statistics.labels}")
-        Text(text = "  Total Value: ${state.statistics.totalValue}")
-
-        // [UI-COMPONENT] Локации
-        Text(text = "Locations:")
-        state.locations.forEach { location ->
-            Text(text = "  - ${location.name} (${location.itemCount})")
-        }
-
-        // [UI-COMPONENT] Метки
-        Text(text = "Labels:")
-        state.labels.forEach { label ->
-            Text(text = "  - ${label.name}")
-        }
-    }
-}
-// [END_FILE_DashboardScreen.kt]

app/src/main/java/com/homebox/lens/ui/screen/dashboard/DashboardUiState.kt

@@ -1,46 +0,0 @@
-// [PACKAGE] com.homebox.lens.ui.screen.dashboard
-// [FILE] app/src/main/java/com/homebox/lens/ui/screen/dashboard/DashboardUiState.kt
-// [SEMANTICS] ui, state, dashboard
-
-// [IMPORTS]
-package com.homebox.lens.ui.screen.dashboard
-
-import com.homebox.lens.domain.model.GroupStatistics
-import com.homebox.lens.domain.model.LabelOut
-import com.homebox.lens.domain.model.LocationOutCount
-
-// [CORE-LOGIC]
-// [ENTITY: SealedInterface('DashboardUiState')]
-/**
- * [CONTRACT]
- * Определяет все возможные состояния для экрана "Дэшборд".
- * @invariant В любой момент времени экран может находиться только в одном из этих состояний.
- */
-sealed interface DashboardUiState {
-    /**
-     * [CONTRACT]
-     * Состояние успешной загрузки данных.
-     * @property statistics Статистика по инвентарю.
-     * @property locations Список локаций со счетчиками.
-     * @property labels Список всех меток.
-     */
-    data class Success(
-        val statistics: GroupStatistics,
-        val locations: List<LocationOutCount>,
-        val labels: List<LabelOut>
-    ) : DashboardUiState
-
-    /**
-     * [CONTRACT]
-     * Состояние ошибки во время загрузки данных.
-     * @property message Человекочитаемое сообщение об ошибке.
-     */
-    data class Error(val message: String) : DashboardUiState
-
-    /**
-     * [CONTRACT]
-     * Состояние, когда данные для экрана загружаются.
-     */
-    data object Loading : DashboardUiState
-}
-// [END_FILE_DashboardUiState.kt]

app/src/main/java/com/homebox/lens/ui/screen/dashboard/DashboardViewModel.kt

@@ -1,77 +0,0 @@
-// [PACKAGE] com.homebox.lens.ui.screen.dashboard
-// [FILE] app/src/main/java/com/homebox/lens/ui/screen/dashboard/DashboardViewModel.kt
-// [SEMANTICS] ui, viewmodel, dashboard, hilt
-
-// [IMPORTS]
-package com.homebox.lens.ui.screen.dashboard
-
-import androidx.lifecycle.ViewModel
-import androidx.lifecycle.viewModelScope
-import com.homebox.lens.domain.usecase.GetAllLabelsUseCase
-import com.homebox.lens.domain.usecase.GetAllLocationsUseCase
-import com.homebox.lens.domain.usecase.GetStatisticsUseCase
-import dagger.hilt.android.lifecycle.HiltViewModel
-import kotlinx.coroutines.async
-import kotlinx.coroutines.flow.MutableStateFlow
-import kotlinx.coroutines.flow.StateFlow
-import kotlinx.coroutines.flow.asStateFlow
-import kotlinx.coroutines.launch
-import timber.log.Timber // [FIX] Логирование происходит здесь
-import javax.inject.Inject
-
-// [CORE-LOGIC]
-@HiltViewModel
-class DashboardViewModel @Inject constructor(
-    private val getStatisticsUseCase: GetStatisticsUseCase,
-    private val getAllLocationsUseCase: GetAllLocationsUseCase,
-    private val getAllLabelsUseCase: GetAllLabelsUseCase
-) : ViewModel() {
-
-    private val _uiState = MutableStateFlow<DashboardUiState>(DashboardUiState.Loading)
-    val uiState: StateFlow<DashboardUiState> = _uiState.asStateFlow()
-
-    init {
-        loadDashboardData()
-    }
-
-    private fun loadDashboardData() {
-        Timber.i("[ACTION] Starting dashboard data load.")
-        _uiState.value = DashboardUiState.Loading
-
-        viewModelScope.launch {
-            try {
-                // Параллельно запрашиваем все данные
-                val statsDeferred = async { getStatisticsUseCase() }
-                val locationsDeferred = async { getAllLocationsUseCase() }
-                val labelsDeferred = async { getAllLabelsUseCase() }
-
-                val stats = statsDeferred.await()
-                val locations = locationsDeferred.await()
-                val labels = labelsDeferred.await()
-
-                // [ACTION] Логируем результат здесь, во ViewModel
-                if (stats != null && locations != null && labels != null) {
-                    _uiState.value = DashboardUiState.Success(
-                        statistics = stats,
-                        locations = locations,
-                        labels = labels
-                    )
-                    Timber.i("[COHERENCE_CHECK_PASSED] Dashboard data loaded successfully.")
-                } else {
-                    // Одна из операций вернула null
-                    val errorMessage = "Failed to load dashboard data: " +
-                            "stats is ${if(stats==null) "null" else "ok"}, " +
-                            "locations is ${if(locations==null) "null" else "ok"}, " +
-                            "labels is ${if(labels==null) "null" else "ok"}"
-                    Timber.e(errorMessage)
-                    _uiState.value = DashboardUiState.Error("Could not load all dashboard data.")
-                }
-            } catch (e: Exception) {
-                // [ERROR_HANDLER] Эта ошибка будет отловлена, если сама корутина `launch` упадет
-                Timber.e(e, "[ERROR] Critical failure in loadDashboardData coroutine.")
-                _uiState.value = DashboardUiState.Error(e.message ?: "An unknown critical error occurred")
-            }
-        }
-    }
-}
-// [END_FILE_DashboardViewModel.kt]

app/src/main/java/com/homebox/lens/ui/theme/Theme.kt

@@ -1,64 +0,0 @@
-// [PACKAGE] com.homebox.lens.ui.theme
-// [FILE] Theme.kt
-
-package com.homebox.lens.ui.theme
-
-import android.app.Activity
-import android.os.Build
-import androidx.compose.foundation.isSystemInDarkTheme
-import androidx.compose.material3.MaterialTheme
-import androidx.compose.material3.darkColorScheme
-import androidx.compose.material3.dynamicDarkColorScheme
-import androidx.compose.material3.dynamicLightColorScheme
-import androidx.compose.material3.lightColorScheme
-import androidx.compose.runtime.Composable
-import androidx.compose.runtime.SideEffect
-import androidx.compose.ui.graphics.toArgb
-import androidx.compose.ui.platform.LocalContext
-import androidx.compose.ui.platform.LocalView
-import androidx.core.view.WindowCompat
-
-private val DarkColorScheme = darkColorScheme(
-    primary = Purple80,
-    secondary = PurpleGrey80,
-    tertiary = Pink80
-)
-
-private val LightColorScheme = lightColorScheme(
-    primary = Purple40,
-    secondary = PurpleGrey40,
-    tertiary = Pink40
-)
-
-@Composable
-fun HomeboxLensTheme(
-    darkTheme: Boolean = isSystemInDarkTheme(),
-    // Dynamic color is available on Android 12+
-    dynamicColor: Boolean = true,
-    content: @Composable () -> Unit
-) {
-    val colorScheme = when {
-        dynamicColor && Build.VERSION.SDK_INT >= Build.VERSION_CODES.S -> {
-            val context = LocalContext.current
-            if (darkTheme) dynamicDarkColorScheme(context) else dynamicLightColorScheme(context)
-        }
-
-        darkTheme -> DarkColorScheme
-        else -> LightColorScheme
-    }
-    val view = LocalView.current
-    if (!view.isInEditMode) {
-        SideEffect {
-            val window = (view.context as Activity).window
-            window.statusBarColor = colorScheme.primary.toArgb()
-            WindowCompat.getInsetsController(window, view).isAppearanceLightStatusBars = darkTheme
-        }
-    }
-
-    MaterialTheme(
-        colorScheme = colorScheme,
-        typography = Typography,
-        content = content
-    )
-}
-// [END_FILE_Theme.kt]

app/src/main/java/com/homebox/lens/ui/theme/Typography.kt

@@ -1,23 +0,0 @@
-// [PACKAGE] com.homebox.lens.ui.theme
-// [FILE] Typography.kt
-
-package com.homebox.lens.ui.theme
-
-import androidx.compose.material3.Typography
-import androidx.compose.ui.text.TextStyle
-import androidx.compose.ui.text.font.FontFamily
-import androidx.compose.ui.text.font.FontWeight
-import androidx.compose.ui.unit.sp
-
-// Set of Material typography styles to start with
-val Typography = Typography(
-    bodyLarge = TextStyle(
-        fontFamily = FontFamily.Default,
-        fontWeight = FontWeight.Normal,
-        fontSize = 16.sp,
-        lineHeight = 24.sp,
-        letterSpacing = 0.5.sp
-    )
-)
-
-// [END_FILE_Typography.kt]

app/src/main/res/values-en/strings.xml

@@ -0,0 +1,146 @@
+<resources>
+    <string name="app_name">Homebox Lens</string>
+
+    <!-- Common -->
+    <string name="create">Create</string>
+    <string name="edit">Edit</string>
+    <string name="delete">Delete</string>
+    <string name="search">Search</string>
+    <string name="logout">Logout</string>
+    <string name="no_location">No location</string>
+    <string name="items_not_found">Items not found</string>
+    <string name="error_loading_failed">Failed to load data. Please try again.</string>
+
+    <!-- Content Descriptions -->
+    <string name="cd_open_navigation_drawer">Open navigation drawer</string>
+    <string name="cd_scan_qr_code">Scan QR code</string>
+    <string name="cd_search">Search</string>
+    <string name="cd_navigate_back">Navigate back</string>
+    <string name="cd_navigate_up">Go back</string>
+    <string name="cd_add_new_location">Add new location</string>
+    <string name="content_desc_add_label">Add new label</string>
+
+    <!-- Dashboard Screen -->
+    <string name="dashboard_title">Dashboard</string>
+    <string name="dashboard_section_quick_stats">Quick Stats</string>
+    <string name="dashboard_section_recently_added">Recently Added</string>
+    <string name="dashboard_section_locations">Locations</string>
+    <string name="dashboard_section_labels">Labels</string>
+    <string name="location_chip_label">%1$s (%2$d)</string>
+
+    <!-- Dashboard Statistics -->
+    <string name="dashboard_stat_total_items">Total Items</string>
+    <string name="dashboard_stat_total_value">Total Value</string>
+    <string name="dashboard_stat_total_labels">Total Labels</string>
+    <string name="dashboard_stat_total_locations">Total Locations</string>
+
+    <!-- Navigation -->
+    <string name="nav_locations">Locations</string>
+    <string name="nav_labels">Labels</string>
+
+    <!-- Screen Titles -->
+    <string name="inventory_list_title">Inventory</string>
+
+    <!-- Screen Titles -->
+    <string name="item_details_title">Details</string>
+    <string name="item_edit_title">Edit Item</string>
+    <string name="labels_list_title">Labels</string>
+    <string name="locations_list_title">Locations</string>
+    <string name="search_title">Search</string>
+
+    <string name="save_item">Save</string>
+    <string name="item_name">Name</string>
+    <string name="item_description">Description</string>
+    <string name="item_quantity">Quantity</string>
+
+    <!-- Location Edit Screen -->
+    <string name="location_edit_title_create">Create Location</string>
+    <string name="location_edit_title_edit">Edit Location</string>
+
+    <!-- Locations List Screen -->
+    <string name="locations_not_found">Locations not found. Press + to add a new one.</string>
+    <string name="item_count">Items: %1$d</string>
+    <string name="cd_more_options">More options</string>
+
+    <!-- Setup Screen -->
+    <string name="setup_title">Server Setup</string>
+    <string name="setup_server_url_label">Server URL</string>
+    <string name="setup_username_label">Username</string>
+    <string name="setup_password_label">Password</string>
+    <string name="setup_connect_button">Connect</string>
+
+    <!-- Labels List Screen -->
+    <string name="screen_title_labels">Labels</string>
+    <string name="content_desc_navigate_back">Navigate back</string>
+    <string name="content_desc_create_label">Create new label</string>
+    <string name="content_desc_label_icon">Label icon</string>
+    <string name="content_desc_delete_label">Delete label</string>
+    <string name="no_labels_found">No labels found.</string>
+    <string name="dialog_title_create_label">Create Label</string>
+    <string name="dialog_field_label_name">Label Name</string>
+    <string name="dialog_button_create">Create</string>
+    <string name="dialog_button_cancel">Cancel</string>
+
+    
+
+    <!-- Inventory List Screen -->
+    <string name="content_desc_sync_inventory">Sync inventory</string>
+
+    <!-- Item Details Screen -->
+    <string name="content_desc_edit_item">Edit item</string>
+    <string name="content_desc_delete_item">Delete item</string>
+    <string name="section_title_description">Description</string>
+    <string name="placeholder_no_description">No description</string>
+    <string name="section_title_details">Details</string>
+    <string name="label_quantity">Quantity</string>
+    <string name="label_location">Location</string>
+    <string name="section_title_labels">Labels</string>
+
+    <!-- Item Edit Screen -->
+    <string name="item_edit_title_create">Create item</string>
+    <string name="content_desc_save_item">Save item</string>
+    <string name="label_name">Name</string>
+    <string name="label_description">Description</string>
+
+    <!-- Search Screen -->
+    <string name="placeholder_search_items">Search items...</string>
+
+    <!-- Setup Screen -->
+    <string name="screen_title_setup">Setup</string>
+
+    <!-- Label Edit Screen -->
+    <string name="label_edit_title_create">Create label</string>
+    <string name="label_edit_title_edit">Edit label</string>
+    <string name="label_name_edit">Label name</string>
+
+    <!-- Common Actions -->
+    <string name="back">Back</string>
+    <string name="save">Save</string>
+
+    <!-- Color Picker -->
+    <string name="label_color">Color</string>
+    <string name="label_hex_color">HEX color code</string>
+
+    <string name="item_asset_id">Asset ID</string>
+    <string name="item_notes">Notes</string>
+    <string name="item_serial_number">Serial Number</string>
+    <string name="item_purchase_price">Purchase Price</string>
+    <string name="item_purchase_date">Purchase Date</string>
+    <string name="item_warranty_until">Warranty Until</string>
+    <string name="item_parent_id">Parent ID</string>
+    <string name="item_is_archived">Is Archived</string>
+    <string name="item_insured">Insured</string>
+    <string name="item_lifetime_warranty">Lifetime Warranty</string>
+    <string name="item_sync_child_items_locations">Sync Child Items Locations</string>
+    <string name="item_manufacturer">Manufacturer</string>
+    <string name="item_model_number">Model Number</string>
+    <string name="item_purchase_from">Purchase From</string>
+    <string name="item_warranty_details">Warranty Details</string>
+    <string name="item_sold_notes">Sold Notes</string>
+    <string name="item_sold_price">Sold Price</string>
+    <string name="item_sold_time">Sold Time</string>
+    <string name="item_sold_to">Sold To</string>
+    <string name="scan_qr_code">Scan QR Code</string>
+    <string name="ok">OK</string>
+    <string name="cancel">Cancel</string>
+</resources>

app/src/main/res/values/strings.xml

@@ -1,3 +1,140 @@
 <resources>
     <string name="app_name">Homebox Lens</string>
+
+    <!-- Common -->
+    <string name="create">Создать</string>
+    <string name="edit">Редактировать</string>
+    <string name="delete">Удалить</string>
+    <string name="search">Поиск</string>
+    <string name="logout">Выйти</string>
+    <string name="no_location">Нет локации</string>
+    <string name="items_not_found">Элементы не найдены</string>
+    <string name="error_loading_failed">Не удалось загрузить данные. Пожалуйста, попробуйте еще раз.</string>
+
+    <!-- Content Descriptions -->
+    <string name="cd_open_navigation_drawer">Открыть боковое меню</string>
+    <string name="cd_scan_qr_code">Сканировать QR/штрих-код</string>
+    <string name="cd_search">Поиск</string>
+    <string name="cd_navigate_back">Вернуться назад</string>
+    <string name="cd_navigate_up">Вернуться</string>
+    <string name="cd_add_new_location">Добавить новую локацию</string>
+    <string name="content_desc_add_label">Добавить новую метку</string>
+
+    <!-- Inventory List Screen -->
+    <string name="content_desc_sync_inventory">Синхронизировать инвентарь</string>
+
+    <!-- Item Details Screen -->
+    <string name="content_desc_edit_item">Редактировать элемент</string>
+    <string name="content_desc_delete_item">Удалить элемент</string>
+    <string name="section_title_description">Описание</string>
+    <string name="placeholder_no_description">Нет описания</string>
+    <string name="section_title_details">Детали</string>
+    <string name="label_quantity">Количество</string>
+    <string name="label_location">Местоположение</string>
+    <string name="section_title_labels">Метки</string>
+
+    <!-- Item Edit Screen -->
+    <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>
+
+    <!-- Dashboard Screen -->
+    <string name="dashboard_title">Главная</string>
+    <string name="dashboard_section_quick_stats">Быстрая статистика</string>
+    <string name="dashboard_section_recently_added">Недавно добавлено</string>
+    <string name="dashboard_section_locations">Места хранения</string>
+    <string name="dashboard_section_labels">Метки</string>
+    <string name="location_chip_label">%1$s (%2$d)</string>
+
+    <!-- Dashboard Statistics -->
+    <string name="dashboard_stat_total_items">Всего вещей</string>
+    <string name="dashboard_stat_total_value">Общая стоимость</string>
+    <string name="dashboard_stat_total_labels">Всего меток</string>
+    <string name="dashboard_stat_total_locations">Всего локаций</string>
+
+    <!-- Navigation -->
+    <string name="nav_locations">Локации</string>
+    <string name="nav_labels">Метки</string>
+
+    <!-- Screen Titles -->
+    <string name="inventory_list_title">Инвентарь</string>
+    <string name="item_details_title">Детали</string>
+    <string name="item_edit_title">Редактирование</string>
+    <string name="labels_list_title">Метки</string>
+    <string name="locations_list_title">Места хранения</string>
+    <string name="search_title">Поиск</string>
+
+    <string name="save_item">Сохранить</string>
+    <string name="item_name">Название</string>
+    <string name="item_description">Описание</string>
+    <string name="item_quantity">Количество</string>
+
+    <!-- Location Edit Screen -->
+    <string name="location_edit_title_create">Создать локацию</string>
+    <string name="location_edit_title_edit">Редактировать локацию</string>
+
+    <!-- Locations List Screen -->
+    <string name="locations_not_found">Местоположения не найдены. Нажмите +, чтобы добавить новое.</string>
+    <string name="item_count">Предметов: %1$d</string>
+    <string name="cd_more_options">Больше опций</string>
+
+    <!-- Setup Screen -->
+    <string name="screen_title_setup">Настройка</string>
+    <string name="setup_title">Настройка сервера</string>
+    <string name="setup_server_url_label">URL сервера</string>
+    <string name="setup_username_label">Имя пользователя</string>
+    <string name="setup_password_label">Пароль</string>
+    <string name="setup_connect_button">Подключиться</string>
+
+    <!-- Labels List Screen -->
+    <string name="screen_title_labels">Метки</string>
+    <string name="content_desc_navigate_back" translatable="false">Вернуться назад</string>
+    <string name="content_desc_create_label">Создать новую метку</string>
+    <string name="content_desc_label_icon">Иконка метки</string>
+    <string name="content_desc_delete_label">Удалить метку</string>
+    <string name="no_labels_found">Метки не найдены.</string>
+    <string name="dialog_title_create_label">Создать метку</string>
+    <string name="dialog_field_label_name">Название метки</string>
+    <string name="dialog_button_create">Создать</string>
+    <string name="dialog_button_cancel">Отмена</string>
+
+    <!-- Label Edit Screen -->
+    <string name="label_edit_title_create">Создать метку</string>
+    <string name="label_edit_title_edit">Редактировать метку</string>
+    <string name="label_name_edit">Название метки</string>
+
+    <!-- Common Actions -->
+    <string name="back">Назад</string>
+    <string name="save">Сохранить</string>
+    <!-- Common Actions -->
+
+    <!-- Color Picker -->
+    <string name="label_color">Цвет</string>
+    <string name="label_hex_color">HEX-код цвета</string>
+    <string name="item_asset_id">Идентификатор актива</string>
+    <string name="item_notes">Заметки</string>
+    <string name="item_serial_number">Серийный номер</string>
+    <string name="item_purchase_price">Цена покупки</string>
+    <string name="item_purchase_date">Дата покупки</string>
+    <string name="item_warranty_until">Гарантия до</string>
+    <string name="item_parent_id">Родительский ID</string>
+    <string name="item_is_archived">Архивировано</string>
+    <string name="item_insured">Застраховано</string>
+    <string name="item_lifetime_warranty">Пожизненная гарантия</string>
+    <string name="item_sync_child_items_locations">Синхронизировать дочерние элементы</string>
+    <string name="item_manufacturer">Производитель</string>
+    <string name="item_model_number">Номер модели</string>
+    <string name="item_purchase_from">Куплено у</string>
+    <string name="item_warranty_details">Детали гарантии</string>
+    <string name="item_sold_notes">Примечания о продаже</string>
+    <string name="item_sold_price">Цена продажи</string>
+    <string name="item_sold_time">Время продажи</string>
+    <string name="item_sold_to">Продано кому</string>
+    <string name="scan_qr_code">Сканировать QR-код</string>
+    <string name="ok">ОК</string>
+    <string name="cancel">Отмена</string>
 </resources>

build.gradle.kts

@@ -1,13 +1,13 @@
 // [FILE] build.gradle.kts
-// [PURPOSE] Root build file for the project, configures plugins for all modules.
+// [SEMANTICS] build, configuration
+// [AI_NOTE]: Root build file for the project, configures plugins for all modules.
 
 plugins {
-    // [PLUGIN] Android Application plugin
+    id("com.android.application") version "8.12.3" apply false
-    id("com.android.application") version "8.11.0" apply false
+    id("org.jetbrains.kotlin.android") version "2.0.0" apply false
-    // [PLUGIN] Kotlin Android plugin
+    id("org.jetbrains.kotlin.plugin.compose") version "2.0.0" apply false
-    id("org.jetbrains.kotlin.android") version "1.9.22" apply false
+    id("com.google.dagger.hilt.android") version "2.51.1" apply false
-    // [PLUGIN] Hilt Android plugin
+    id("com.google.devtools.ksp") version "2.0.0-1.0.24" apply false
-    id("com.google.dagger.hilt.android") version "2.48.1" apply false
 }
 
 // [END_FILE_build.gradle.kts]

buildSrc/src/main/java/Dependencies.kt

@@ -1,72 +1,56 @@
+// [PACKAGE] buildsrc.dependencies
 // [FILE] Dependencies.kt
-// [PURPOSE] Centralized dependency management for the entire project.
+// [SEMANTICS] build, dependencies
 
+// [ENTITY: Object('Versions')]
 object Versions {
-    // Build
     const val compileSdk = 34
-    const val minSdk = 26
+    const val minSdk = 24
     const val targetSdk = 34
     const val versionCode = 1
     const val versionName = "1.0"
-
+    const val kotlin = "1.9.10"
-    // Kotlin
-    const val kotlin = "1.9.22"
     const val coroutines = "1.7.3"
-
+    const val composeCompiler = "1.5.4"
-    // Jetpack Compose
+    const val composeBom = "2024.05.00"
-    const val composeCompiler = "1.5.8"
-    const val composeBom = "2023.10.01"
     const val activityCompose = "1.8.2"
-    const val navigationCompose = "2.7.6"
+    const val navigationCompose = "2.7.7"
     const val hiltNavigationCompose = "1.1.0"
-
-    // AndroidX
     const val coreKtx = "1.12.0"
-    const val lifecycle = "2.6.2"
+    const val lifecycle = "2.7.0"
     const val appcompat = "1.6.1"
-
-    // Networking
     const val retrofit = "2.9.0"
     const val okhttp = "4.12.0"
-    const val moshi = "1.15.0"
+    const val moshi = "1.15.1"
-
-    // Database
     const val room = "2.6.1"
-
+    const val hilt = "2.51.1"
-    // DI
+    const val hiltCompiler = "1.2.0"
-    const val hilt = "2.48.1"
-    const val hiltCompiler = "1.1.0"
-
-    // Logging
     const val timber = "5.0.1"
-
-    // Testing
     const val junit = "4.13.2"
     const val extJunit = "1.1.5"
     const val espresso = "3.5.1"
+    const val kotest = "5.8.0"
+    const val mockk = "1.13.10"
 }
+// [END_ENTITY: Object('Versions')]
 
+// [ENTITY: Object('Libs')]
 object Libs {
-    // Kotlin
     const val coroutinesCore = "org.jetbrains.kotlinx:kotlinx-coroutines-core:${Versions.coroutines}"
     const val coroutinesAndroid = "org.jetbrains.kotlinx:kotlinx-coroutines-android:${Versions.coroutines}"
-
-    // AndroidX
     const val coreKtx = "androidx.core:core-ktx:${Versions.coreKtx}"
     const val lifecycleRuntime = "androidx.lifecycle:lifecycle-runtime-ktx:${Versions.lifecycle}"
     const val appcompat = "androidx.appcompat:appcompat:${Versions.appcompat}"
-
+    const val composeUi = "androidx.compose.ui:ui:1.5.4"
-    // Compose
+    const val composeUiGraphics = "androidx.compose.ui:ui-graphics:1.5.4"
-    const val composeBom = "androidx.compose:compose-bom:${Versions.composeBom}"
+    const val composeUiToolingPreview = "androidx.compose.ui:ui-tooling-preview:1.5.4"
-    const val composeUi = "androidx.compose.ui:ui"
+    const val composeMaterial3 = "androidx.compose.material3:material3:1.1.2"
-    const val composeUiGraphics = "androidx.compose.ui:ui-graphics"
+    const val composeFoundation = "androidx.compose.foundation:foundation:1.5.4"
-    const val composeUiToolingPreview = "androidx.compose.ui:ui-tooling-preview"
+    const val composeFoundationLayout = "androidx.compose.foundation:foundation-layout:1.5.4"
-    const val composeMaterial3 = "androidx.compose.material3:material3"
+    const val composeMaterialIconsExtended = "androidx.compose.material:material-icons-extended:1.5.4"
     const val activityCompose = "androidx.activity:activity-compose:${Versions.activityCompose}"
     const val navigationCompose = "androidx.navigation:navigation-compose:${Versions.navigationCompose}"
     const val hiltNavigationCompose = "androidx.hilt:hilt-navigation-compose:${Versions.hiltNavigationCompose}"
-
-    // Networking (Retrofit, OkHttp, Moshi)
     const val retrofit = "com.squareup.retrofit2:retrofit:${Versions.retrofit}"
     const val converterMoshi = "com.squareup.retrofit2:converter-moshi:${Versions.retrofit}"
     const val okhttp = "com.squareup.okhttp3:okhttp:${Versions.okhttp}"
@@ -74,26 +58,22 @@ object Libs {
     const val moshi = "com.squareup.moshi:moshi:${Versions.moshi}"
     const val moshiKotlin = "com.squareup.moshi:moshi-kotlin:${Versions.moshi}"
     const val moshiCodegen = "com.squareup.moshi:moshi-kotlin-codegen:${Versions.moshi}"
-
-    // Database (Room)
     const val roomRuntime = "androidx.room:room-runtime:${Versions.room}"
     const val roomKtx = "androidx.room:room-ktx:${Versions.room}"
     const val roomCompiler = "androidx.room:room-compiler:${Versions.room}"
-
-    // Dependency Injection (Hilt)
     const val hiltAndroid = "com.google.dagger:hilt-android:${Versions.hilt}"
     const val hiltCompiler = "com.google.dagger:hilt-android-compiler:${Versions.hilt}"
-
-    // Logging
     const val timber = "com.jakewharton.timber:timber:${Versions.timber}"
-
-    // Testing
     const val junit = "junit:junit:${Versions.junit}"
     const val extJunit = "androidx.test.ext:junit:${Versions.extJunit}"
     const val espressoCore = "androidx.test.espresso:espresso-core:${Versions.espresso}"
-    const val composeUiTestJunit4 = "androidx.compose.ui:ui-test-junit4"
+    const val composeUiTestJunit4 = "androidx.compose.ui:ui-test-junit4:1.5.4"
-    const val composeUiTooling = "androidx.compose.ui:ui-tooling"
+    const val composeUiTooling = "androidx.compose.ui:ui-tooling:1.5.4"
-    const val composeUiTestManifest = "androidx.compose.ui:ui-test-manifest"
+    const val composeUiTestManifest = "androidx.compose.ui:ui-test-manifest:1.5.4"
+    const val kotestRunnerJunit5 = "io.kotest:kotest-runner-junit5:${Versions.kotest}"
+    const val kotestAssertionsCore = "io.kotest:kotest-assertions-core:${Versions.kotest}"
+    const val mockk = "io.mockk:mockk:${Versions.mockk}"
 }
+// [END_ENTITY: Object('Libs')]
 
-// [END_FILE_Dependencies.kt]
+// [END_FILE_Dependencies.kt]

data/build.gradle.kts

@@ -62,6 +62,9 @@ dependencies {
     implementation(Libs.hiltAndroid)
     kapt(Libs.hiltCompiler)
 
+    // [DEPENDENCY] Logging
+    implementation(Libs.timber)
+
     // [DEPENDENCY] Testing
     testImplementation(Libs.junit)
     androidTestImplementation(Libs.extJunit)

data/src/main/java/com/homebox/lens/data/api/HomeboxApiService.kt

@@ -1,63 +1,97 @@
 // [PACKAGE] com.homebox.lens.data.api
 // [FILE] HomeboxApiService.kt
-
+// [SEMANTICS] data, api, retrofit
 package com.homebox.lens.data.api
 
-import com.homebox.lens.data.api.dto.GroupStatisticsDto
+// [IMPORTS]
-import com.homebox.lens.data.api.dto.ItemCreateDto
+import com.homebox.lens.data.api.dto.*
-import com.homebox.lens.data.api.dto.ItemOutDto
-import com.homebox.lens.data.api.dto.ItemSummaryDto
-import com.homebox.lens.data.api.dto.ItemUpdateDto
-import com.homebox.lens.data.api.dto.LabelOutDto
-import com.homebox.lens.data.api.dto.LocationOutCountDto
-import com.homebox.lens.data.api.dto.PaginationResultDto
 import retrofit2.Response
-import retrofit2.http.Body
+import retrofit2.http.*
-import retrofit2.http.DELETE
+// [END_IMPORTS]
-import retrofit2.http.GET
-import retrofit2.http.POST
-import retrofit2.http.PUT
-import retrofit2.http.Path
-import retrofit2.http.Query
 
-// [CONTRACT]
+// [ENTITY: Interface('HomeboxApiService')]
 /**
- * [ENTITY: Interface('HomeboxApiService')]
+ * @summary Определяет эндпоинты для взаимодействия с Homebox API, используя DTO.
- * [PURPOSE] Определяет эндпоинты для взаимодействия с Homebox API, используя DTO.
  */
 interface HomeboxApiService {
 
-    // [ENDPOINT] Items
+    // [ENTITY: ApiEndpoint('login')]
+    @Headers("Content-Type: application/json")
+    @POST("v1/users/login")
+    suspend fun login(@Body loginForm: LoginFormDto): TokenResponseDto
+    // [END_ENTITY: ApiEndpoint('login')]
+
+    // [ENTITY: ApiEndpoint('getItems')]
     @GET("v1/items")
     suspend fun getItems(
         @Query("q") query: String? = null,
         @Query("page") page: Int? = null,
         @Query("pageSize") pageSize: Int? = null
     ): PaginationResultDto<ItemSummaryDto>
+    // [END_ENTITY: ApiEndpoint('getItems')]
 
+    // [ENTITY: ApiEndpoint('createItem')]
     @POST("v1/items")
     suspend fun createItem(@Body item: ItemCreateDto): ItemSummaryDto
+    // [END_ENTITY: ApiEndpoint('createItem')]
 
+    // [ENTITY: ApiEndpoint('getItem')]
     @GET("v1/items/{id}")
     suspend fun getItem(@Path("id") itemId: String): ItemOutDto
+    // [END_ENTITY: ApiEndpoint('getItem')]
 
+    // [ENTITY: ApiEndpoint('updateItem')]
     @PUT("v1/items/{id}")
     suspend fun updateItem(@Path("id") itemId: String, @Body item: ItemUpdateDto): ItemOutDto
+    // [END_ENTITY: ApiEndpoint('updateItem')]
 
+    // [ENTITY: ApiEndpoint('deleteItem')]
     @DELETE("v1/items/{id}")
     suspend fun deleteItem(@Path("id") itemId: String): Response<Unit>
+    // [END_ENTITY: ApiEndpoint('deleteItem')]
 
-    // [ENDPOINT] Locations
+    // [ENTITY: ApiEndpoint('getLocations')]
     @GET("v1/locations")
     suspend fun getLocations(): List<LocationOutCountDto>
+    // [END_ENTITY: ApiEndpoint('getLocations')]
 
-    // [ENDPOINT] Labels
+    // [ENTITY: ApiEndpoint('getLabels')]
     @GET("v1/labels")
     suspend fun getLabels(): List<LabelOutDto>
+    // [END_ENTITY: ApiEndpoint('getLabels')]
 
-    // [ENDPOINT] Statistics
+    // [ENTITY: ApiEndpoint('createLabel')]
+    @POST("v1/labels")
+    suspend fun createLabel(@Body newLabel: LabelCreateDto): LabelSummaryDto
+    // [END_ENTITY: ApiEndpoint('createLabel')]
+
+    // [ENTITY: ApiEndpoint('updateLabel')]
+    @PUT("v1/labels/{id}")
+    suspend fun updateLabel(@Path("id") labelId: String, @Body label: LabelUpdateDto): LabelOutDto
+    // [END_ENTITY: ApiEndpoint('updateLabel')]
+
+    // [ENTITY: ApiEndpoint('deleteLabel')]
+    @DELETE("v1/labels/{id}")
+    suspend fun deleteLabel(@Path("id") labelId: String): Response<Unit>
+
+    // [ENTITY: ApiEndpoint('createLocation')]
+    @POST("v1/locations")
+    suspend fun createLocation(@Body newLocation: LocationCreateDto): LocationOutDto
+    // [END_ENTITY: ApiEndpoint('createLocation')]
+
+    // [ENTITY: ApiEndpoint('updateLocation')]
+    @PUT("v1/locations/{id}")
+    suspend fun updateLocation(@Path("id") locationId: String, @Body location: LocationUpdateDto): LocationOutDto
+    // [END_ENTITY: ApiEndpoint('updateLocation')]
+
+    // [ENTITY: ApiEndpoint('deleteLocation')]
+    @DELETE("v1/locations/{id}")
+    suspend fun deleteLocation(@Path("id") locationId: String): Response<Unit>
+
+    // [ENTITY: ApiEndpoint('getStatistics')]
     @GET("v1/groups/statistics")
     suspend fun getStatistics(): GroupStatisticsDto
+    // [END_ENTITY: ApiEndpoint('getStatistics')]
 }
-
+// [END_ENTITY: Interface('HomeboxApiService')]
 // [END_FILE_HomeboxApiService.kt]

data/src/main/java/com/homebox/lens/data/api/dto/CustomFieldDto.kt

@@ -8,11 +8,11 @@ package com.homebox.lens.data.api.dto
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 import com.homebox.lens.domain.model.CustomField
+// [END_IMPORTS]
 
-// [CORE-LOGIC]
+// [ENTITY: DataClass('CustomFieldDto')]
 /**
- * [CONTRACT]
+ * @summary DTO для кастомного поля.
- * DTO для кастомного поля.
  */
 @JsonClass(generateAdapter = true)
 data class CustomFieldDto(
@@ -20,10 +20,12 @@ data class CustomFieldDto(
     @Json(name = "value") val value: String,
     @Json(name = "type") val type: String
 )
+// [END_ENTITY: DataClass('CustomFieldDto')]
 
+// [ENTITY: Function('toDomain')]
+// [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('CustomField')]
 /**
- * [CONTRACT]
+ * @summary Маппер из CustomFieldDto в доменную модель CustomField.
- * Маппер из CustomFieldDto в доменную модель CustomField.
  */
 fun CustomFieldDto.toDomain(): CustomField {
     return CustomField(
@@ -32,3 +34,4 @@ fun CustomFieldDto.toDomain(): CustomField {
         type = this.type
     )
 }
+// [END_ENTITY: Function('toDomain')]

data/src/main/java/com/homebox/lens/data/api/dto/GroupStatisticsDto.kt

@@ -8,29 +8,35 @@ package com.homebox.lens.data.api.dto
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 import com.homebox.lens.domain.model.GroupStatistics
+// [END_IMPORTS]
 
-// [CORE-LOGIC]
+// [ENTITY: DataClass('GroupStatisticsDto')]
 /**
- * [CONTRACT]
+ * @summary DTO для статистики.
- * DTO для статистики.
  */
 @JsonClass(generateAdapter = true)
 data class GroupStatisticsDto(
-    @Json(name = "items") val items: Int,
+    @Json(name = "totalItems") val totalItems: Int,
-    @Json(name = "labels") val labels: Int,
+    @Json(name = "totalLabels") val totalLabels: Int,
-    @Json(name = "locations") val locations: Int,
+    @Json(name = "totalLocations") val totalLocations: Int,
-    @Json(name = "totalValue") val totalValue: Double
+    @Json(name = "totalItemPrice") val totalItemPrice: Double,
+    @Json(name = "totalUsers") val totalUsers: Int? = null,
+    @Json(name = "totalWithWarranty") val totalWithWarranty: Int? = null
 )
+// [END_ENTITY: DataClass('GroupStatisticsDto')]
 
+// [ENTITY: Function('toDomain')]
+// [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('GroupStatistics')]
 /**
- * [CONTRACT]
+ * @summary Маппер из GroupStatisticsDto в доменную модель GroupStatistics.
- * Маппер из GroupStatisticsDto в доменную модель GroupStatistics.
  */
 fun GroupStatisticsDto.toDomain(): GroupStatistics {
     return GroupStatistics(
-        items = this.items,
+        items = this.totalItems,
-        labels = this.labels,
+        labels = this.totalLabels,
-        locations = this.locations,
+        locations = this.totalLocations,
-        totalValue = this.totalValue
+        totalValue = this.totalItemPrice
     )
 }
+// [END_ENTITY: Function('toDomain')]
+// [END_FILE_GroupStatisticsDto.kt]

data/src/main/java/com/homebox/lens/data/api/dto/ImageDto.kt

@@ -8,14 +8,14 @@ package com.homebox.lens.data.api.dto
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 import com.homebox.lens.domain.model.Image
+// [END_IMPORTS]
 
-// [CORE-LOGIC]
+// [ENTITY: DataClass('ImageDto')]
 /**
- * [CONTRACT]
+ * @summary DTO для изображения.
- * DTO для изображения.
+ * @param id Уникальный идентификатор.
- * @property id Уникальный идентификатор.
+ * @param path Путь к файлу.
- * @property path Путь к файлу.
+ * @param isPrimary Является ли основным.
- * @property isPrimary Является ли основным.
  */
 @JsonClass(generateAdapter = true)
 data class ImageDto(
@@ -23,10 +23,12 @@ data class ImageDto(
     @Json(name = "path") val path: String,
     @Json(name = "isPrimary") val isPrimary: Boolean
 )
+// [END_ENTITY: DataClass('ImageDto')]
 
+// [ENTITY: Function('toDomain')]
+// [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('Image')]
 /**
- * [CONTRACT]
+ * @summary Маппер из ImageDto в доменную модель Image.
- * Маппер из ImageDto в доменную модель Image.
  */
 fun ImageDto.toDomain(): Image {
     return Image(
@@ -35,3 +37,4 @@ fun ImageDto.toDomain(): Image {
         isPrimary = this.isPrimary
     )
 }
+// [END_ENTITY: Function('toDomain')]

data/src/main/java/com/homebox/lens/data/api/dto/ItemAttachmentDto.kt

@@ -8,11 +8,11 @@ package com.homebox.lens.data.api.dto
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 import com.homebox.lens.domain.model.ItemAttachment
+// [END_IMPORTS]
 
-// [CORE-LOGIC]
+// [ENTITY: DataClass('ItemAttachmentDto')]
 /**
- * [CONTRACT]
+ * @summary DTO для вложения.
- * DTO для вложения.
  */
 @JsonClass(generateAdapter = true)
 data class ItemAttachmentDto(
@@ -23,10 +23,12 @@ data class ItemAttachmentDto(
     @Json(name = "createdAt") val createdAt: String,
     @Json(name = "updatedAt") val updatedAt: String
 )
+// [END_ENTITY: DataClass('ItemAttachmentDto')]
 
+// [ENTITY: Function('toDomain')]
+// [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('ItemAttachment')]
 /**
- * [CONTRACT]
+ * @summary Маппер из ItemAttachmentDto в доменную модель ItemAttachment.
- * Маппер из ItemAttachmentDto в доменную модель ItemAttachment.
  */
 fun ItemAttachmentDto.toDomain(): ItemAttachment {
     return ItemAttachment(
@@ -38,3 +40,4 @@ fun ItemAttachmentDto.toDomain(): ItemAttachment {
         updatedAt = this.updatedAt
     )
 }
+// [END_ENTITY: Function('toDomain')]

data/src/main/java/com/homebox/lens/data/api/dto/ItemCreateDto.kt

@@ -8,11 +8,11 @@ package com.homebox.lens.data.api.dto
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 import com.homebox.lens.domain.model.ItemCreate
+// [END_IMPORTS]
 
-// [CORE-LOGIC]
+// [ENTITY: DataClass('ItemCreateDto')]
 /**
- * [CONTRACT]
+ * @summary DTO для создания вещи.
- * DTO для создания вещи.
  */
 @JsonClass(generateAdapter = true)
 data class ItemCreateDto(
@@ -30,10 +30,12 @@ data class ItemCreateDto(
     @Json(name = "parentId") val parentId: String?,
     @Json(name = "labelIds") val labelIds: List<String>?
 )
+// [END_ENTITY: DataClass('ItemCreateDto')]
 
+// [ENTITY: Function('toDto')]
+// [RELATION: Function('toDto')] -> [RETURNS] -> [DataClass('ItemCreateDto')]
 /**
- * [CONTRACT]
+ * @summary Маппер из доменной модели ItemCreate в ItemCreateDto.
- * Маппер из доменной модели ItemCreate в ItemCreateDto.
  */
 fun ItemCreate.toDto(): ItemCreateDto {
     return ItemCreateDto(
@@ -52,3 +54,4 @@ fun ItemCreate.toDto(): ItemCreateDto {
         labelIds = this.labelIds
     )
 }
+// [END_ENTITY: Function('toDto')]

data/src/main/java/com/homebox/lens/data/api/dto/ItemDto.kt

@@ -1,16 +1,19 @@
 // [PACKAGE] com.homebox.lens.data.api.dto
 // [FILE] ItemDto.kt
-
+// [SEMANTICS] data, dto, api
 package com.homebox.lens.data.api.dto
 
+// [IMPORTS]
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 import java.math.BigDecimal
+// [END_IMPORTS]
 
-// [CONTRACT]
+// [ENTITY: DataClass('ItemOut')]
+// [RELATION: DataClass('ItemOut')] -> [DEPENDS_ON] -> [DataClass('LocationOut')]
+// [RELATION: DataClass('ItemOut')] -> [DEPENDS_ON] -> [DataClass('LabelOutDto')]
 /**
- * [ENTITY: DataClass('ItemOut')]
+ * @summary DTO для полной информации о вещи (GET /v1/items/{id}).
- * [PURPOSE] DTO для полной информации о вещи (GET /v1/items/{id}).
  */
 @JsonClass(generateAdapter = true)
 data class ItemOut(
@@ -19,14 +22,16 @@ data class ItemOut(
     @Json(name = "description") val description: String?,
     @Json(name = "image") val image: String?,
     @Json(name = "location") val location: LocationOut?,
-    @Json(name = "labels") val labels: List<LabelOut>,
+    @Json(name = "labels") val labels: List<LabelOutDto>,
     @Json(name = "value") val value: BigDecimal?,
     @Json(name = "createdAt") val createdAt: String?
 )
+// [END_ENTITY: DataClass('ItemOut')]
 
+// [ENTITY: DataClass('ItemSummary')]
+// [RELATION: DataClass('ItemSummary')] -> [DEPENDS_ON] -> [DataClass('LocationOut')]
 /**
- * [ENTITY: DataClass('ItemSummary')]
+ * @summary DTO для краткой информации о вещи в списках (GET /v1/items).
- * [PURPOSE] DTO для краткой информации о вещи в списках (GET /v1/items).
  */
 @JsonClass(generateAdapter = true)
 data class ItemSummary(
@@ -36,10 +41,11 @@ data class ItemSummary(
     @Json(name = "location") val location: LocationOut?,
     @Json(name = "createdAt") val createdAt: String?
 )
+// [END_ENTITY: DataClass('ItemSummary')]
 
+// [ENTITY: DataClass('ItemCreate')]
 /**
- * [ENTITY: DataClass('ItemCreate')]
+ * @summary DTO для создания новой вещи (POST /v1/items).
- * [PURPOSE] DTO для создания новой вещи (POST /v1/items).
  */
 @JsonClass(generateAdapter = true)
 data class ItemCreate(
@@ -49,10 +55,11 @@ data class ItemCreate(
     @Json(name = "labelIds") val labelIds: List<String>?,
     @Json(name = "value") val value: BigDecimal?
 )
+// [END_ENTITY: DataClass('ItemCreate')]
 
+// [ENTITY: DataClass('ItemUpdate')]
 /**
- * [ENTITY: DataClass('ItemUpdate')]
+ * @summary DTO для обновления вещи (PUT /v1/items/{id}).
- * [PURPOSE] DTO для обновления вещи (PUT /v1/items/{id}).
  */
 @JsonClass(generateAdapter = true)
 data class ItemUpdate(
@@ -62,5 +69,6 @@ data class ItemUpdate(
     @Json(name = "labelIds") val labelIds: List<String>?,
     @Json(name = "value") val value: BigDecimal?
 )
+// [END_ENTITY: DataClass('ItemUpdate')]
 
 // [END_FILE_ItemDto.kt]

data/src/main/java/com/homebox/lens/data/api/dto/ItemOutDto.kt

@@ -8,11 +8,11 @@ package com.homebox.lens.data.api.dto
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 import com.homebox.lens.domain.model.ItemOut
+// [END_IMPORTS]
 
-// [CORE-LOGIC]
+// [ENTITY: DataClass('ItemOutDto')]
 /**
- * [CONTRACT]
+ * @summary DTO для полной модели вещи.
- * DTO для полной модели вещи.
  */
 @JsonClass(generateAdapter = true)
 data class ItemOutDto(
@@ -37,12 +37,25 @@ data class ItemOutDto(
     @Json(name = "fields") val fields: List<CustomFieldDto>,
     @Json(name = "maintenance") val maintenance: List<MaintenanceEntryDto>,
     @Json(name = "createdAt") val createdAt: String,
-    @Json(name = "updatedAt") val updatedAt: String
+    @Json(name = "updatedAt") val updatedAt: String,
+    @Json(name = "insured") val insured: Boolean?,
+    @Json(name = "lifetimeWarranty") val lifetimeWarranty: Boolean?,
+    @Json(name = "manufacturer") val manufacturer: String?,
+    @Json(name = "modelNumber") val modelNumber: String?,
+    @Json(name = "purchaseFrom") val purchaseFrom: String?,
+    @Json(name = "soldNotes") val soldNotes: String?,
+    @Json(name = "soldPrice") val soldPrice: Double?,
+    @Json(name = "soldTime") val soldTime: String?,
+    @Json(name = "soldTo") val soldTo: String?,
+    @Json(name = "syncChildItemsLocations") val syncChildItemsLocations: Boolean?,
+    @Json(name = "warrantyDetails") val warrantyDetails: String?
 )
+// [END_ENTITY: DataClass('ItemOutDto')]
 
+// [ENTITY: Function('toDomain')]
+// [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('ItemOut')]
 /**
- * [CONTRACT]
+ * @summary Маппер из ItemOutDto в доменную модель ItemOut.
- * Маппер из ItemOutDto в доменную модель ItemOut.
  */
 fun ItemOutDto.toDomain(): ItemOut {
     return ItemOut(
@@ -67,6 +80,18 @@ fun ItemOutDto.toDomain(): ItemOut {
         fields = this.fields.map { it.toDomain() },
         maintenance = this.maintenance.map { it.toDomain() },
         createdAt = this.createdAt,
-        updatedAt = this.updatedAt
+        updatedAt = this.updatedAt,
+        insured = this.insured,
+        lifetimeWarranty = this.lifetimeWarranty,
+        manufacturer = this.manufacturer,
+        modelNumber = this.modelNumber,
+        purchaseFrom = this.purchaseFrom,
+        soldNotes = this.soldNotes,
+        soldPrice = this.soldPrice,
+        soldTime = this.soldTime,
+        soldTo = this.soldTo,
+        syncChildItemsLocations = this.syncChildItemsLocations,
+        warrantyDetails = this.warrantyDetails
     )
 }
+// [END_ENTITY: Function('toDomain')]

data/src/main/java/com/homebox/lens/data/api/dto/ItemSummaryDto.kt

@@ -8,11 +8,11 @@ package com.homebox.lens.data.api.dto
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 import com.homebox.lens.domain.model.ItemSummary
+// [END_IMPORTS]
 
-// [CORE-LOGIC]
+// [ENTITY: DataClass('ItemSummaryDto')]
 /**
- * [CONTRACT]
+ * @summary DTO для сокращенной модели вещи.
- * DTO для сокращенной модели вещи.
  */
 @JsonClass(generateAdapter = true)
 data class ItemSummaryDto(
@@ -27,10 +27,12 @@ data class ItemSummaryDto(
     @Json(name = "createdAt") val createdAt: String,
     @Json(name = "updatedAt") val updatedAt: String
 )
+// [END_ENTITY: DataClass('ItemSummaryDto')]
 
+// [ENTITY: Function('toDomain')]
+// [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('ItemSummary')]
 /**
- * [CONTRACT]
+ * @summary Маппер из ItemSummaryDto в доменную модель ItemSummary.
- * Маппер из ItemSummaryDto в доменную модель ItemSummary.
  */
 fun ItemSummaryDto.toDomain(): ItemSummary {
     return ItemSummary(
@@ -46,3 +48,4 @@ fun ItemSummaryDto.toDomain(): ItemSummary {
         updatedAt = this.updatedAt
     )
 }
+// [END_ENTITY: Function('toDomain')]

data/src/main/java/com/homebox/lens/data/api/dto/ItemUpdateDto.kt

@@ -8,11 +8,11 @@ package com.homebox.lens.data.api.dto
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 import com.homebox.lens.domain.model.ItemUpdate
+// [END_IMPORTS]
 
-// [CORE-LOGIC]
+// [ENTITY: DataClass('ItemUpdateDto')]
 /**
- * [CONTRACT]
+ * @summary DTO для обновления вещи.
- * DTO для обновления вещи.
  */
 @JsonClass(generateAdapter = true)
 data class ItemUpdateDto(
@@ -31,10 +31,12 @@ data class ItemUpdateDto(
     @Json(name = "parentId") val parentId: String?,
     @Json(name = "labelIds") val labelIds: List<String>?
 )
+// [END_ENTITY: DataClass('ItemUpdateDto')]
 
+// [ENTITY: Function('toDto')]
+// [RELATION: Function('toDto')] -> [RETURNS] -> [DataClass('ItemUpdateDto')]
 /**
- * [CONTRACT]
+ * @summary Маппер из доменной модели ItemUpdate в ItemUpdateDto.
- * Маппер из доменной модели ItemUpdate в ItemUpdateDto.
  */
 fun ItemUpdate.toDto(): ItemUpdateDto {
     return ItemUpdateDto(
@@ -54,3 +56,4 @@ fun ItemUpdate.toDto(): ItemUpdateDto {
         labelIds = this.labelIds
     )
 }
+// [END_ENTITY: Function('toDto')]

data/src/main/java/com/homebox/lens/data/api/dto/LabelCreateDto.kt

@@ -0,0 +1,25 @@
+// [PACKAGE] com.homebox.lens.data.api.dto
+// [FILE] LabelCreateDto.kt
+// [SEMANTICS] data_transfer_object, label, create, api
+package com.homebox.lens.data.api.dto
+
+// [IMPORTS]
+import com.squareup.moshi.Json
+import com.squareup.moshi.JsonClass
+// [END_IMPORTS]
+
+// [ENTITY: DataClass('LabelCreateDto')]
+/**
+ * @summary DTO для тела запроса на создание метки (POST /v1/labels).
+ * @param name Название метки.
+ * @param color Цвет метки в формате HEX (например, "#FF0000").
+ * @param description Описание метки.
+ */
+@JsonClass(generateAdapter = true)
+data class LabelCreateDto(
+    @Json(name = "name") val name: String,
+    @Json(name = "color") val color: String?,
+    @Json(name = "description") val description: String? = null // [AI_NOTE]: Описание не используется в приложении, но может быть в API
+)
+// [END_ENTITY: DataClass('LabelCreateDto')]
+// [END_FILE_LabelCreateDto.kt]

data/src/main/java/com/homebox/lens/data/api/dto/LabelDto.kt

@@ -1,20 +0,0 @@
-// [PACKAGE] com.homebox.lens.data.api.dto
-// [FILE] LabelDto.kt
-
-package com.homebox.lens.data.api.dto
-
-import com.squareup.moshi.Json
-import com.squareup.moshi.JsonClass
-
-// [CONTRACT]
-/**
- * [ENTITY: DataClass('LabelOut')]
- * [PURPOSE] DTO для информации о метке.
- */
-@JsonClass(generateAdapter = true)
-data class LabelOut(
-    @Json(name = "id") val id: String,
-    @Json(name = "name") val name: String
-)
-
-// [END_FILE_LabelDto.kt]

data/src/main/java/com/homebox/lens/data/api/dto/LabelOutDto.kt

@@ -8,33 +8,38 @@ package com.homebox.lens.data.api.dto
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 import com.homebox.lens.domain.model.LabelOut
+// [END_IMPORTS]
 
-// [CORE-LOGIC]
+// [ENTITY: DataClass('LabelOutDto')]
 /**
- * [CONTRACT]
+ * @summary DTO для метки.
- * DTO для метки.
  */
 @JsonClass(generateAdapter = true)
 data class LabelOutDto(
     @Json(name = "id") val id: String,
     @Json(name = "name") val name: String,
-    @Json(name = "color") val color: String,
+    @Json(name = "color") val color: String?,
-    @Json(name = "isArchived") val isArchived: Boolean,
+    @Json(name = "isArchived") val isArchived: Boolean?,
     @Json(name = "createdAt") val createdAt: String,
-    @Json(name = "updatedAt") val updatedAt: String
+    @Json(name = "updatedAt") val updatedAt: String,
+    @Json(name = "description") val description: String?
 )
+// [END_ENTITY: DataClass('LabelOutDto')]
 
+// [ENTITY: Function('toDomain')]
+// [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('LabelOut')]
 /**
- * [CONTRACT]
+ * @summary Маппер из LabelOutDto в доменную модель LabelOut.
- * Маппер из LabelOutDto в доменную модель LabelOut.
  */
 fun LabelOutDto.toDomain(): LabelOut {
     return LabelOut(
         id = this.id,
         name = this.name,
-        color = this.color,
+        color = this.color ?: "",
-        isArchived = this.isArchived,
+        isArchived = this.isArchived ?: false,
         createdAt = this.createdAt,
         updatedAt = this.updatedAt
     )
 }
+// [END_ENTITY: Function('toDomain')]
+// [END_FILE_LabelOutDto.kt]

data/src/main/java/com/homebox/lens/data/api/dto/LabelSummaryDto.kt

@@ -0,0 +1,42 @@
+// [PACKAGE] com.homebox.lens.data.api.dto
+// [FILE] LabelSummaryDto.kt
+// [SEMANTICS] data_transfer_object, label, summary, api, mapper
+package com.homebox.lens.data.api.dto
+
+// [IMPORTS]
+import com.homebox.lens.domain.model.LabelSummary
+import com.squareup.moshi.Json
+import com.squareup.moshi.JsonClass
+// [END_IMPORTS]
+
+// [ENTITY: DataClass('LabelSummaryDto')]
+/**
+ * @summary DTO для ответа от API при создании метки.
+ */
+@JsonClass(generateAdapter = true)
+data class LabelSummaryDto(
+    @Json(name = "id") val id: String,
+    @Json(name = "name") val name: String,
+    @Json(name = "color") val color: String?,
+    @Json(name = "description") val description: String?,
+    @Json(name = "createdAt") val createdAt: String?,
+    @Json(name = "updatedAt") val updatedAt: String?
+)
+// [END_ENTITY: DataClass('LabelSummaryDto')]
+
+// [ENTITY: Function('toDomain')]
+// [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('LabelSummary')]
+/**
+ * @summary Маппер из DTO в доменную модель.
+ * @return Объект доменной модели [LabelSummary].
+ * @sideeffect Отбрасывает поля, ненужные доменному слою (`color`, `description`, etc.),
+ * оставляя только `id` и `name`.
+ */
+fun LabelSummaryDto.toDomain(): LabelSummary {
+    return LabelSummary(
+        id = this.id,
+        name = this.name
+    )
+}
+// [END_ENTITY: Function('toDomain')]
+// [END_FILE_LabelSummaryDto.kt]

data/src/main/java/com/homebox/lens/data/api/dto/LabelUpdateDto.kt

@@ -0,0 +1,31 @@
+// [PACKAGE] com.homebox.lens.data.api.dto
+// [FILE] LabelUpdateDto.kt
+// [SEMANTICS] data_transfer_object, label, update
+package com.homebox.lens.data.api.dto
+
+// [IMPORTS]
+import com.squareup.moshi.Json
+import com.squareup.moshi.JsonClass
+import com.homebox.lens.domain.model.LabelUpdate
+// [END_IMPORTS]
+
+// [ENTITY: DataClass('LabelUpdateDto')]
+@JsonClass(generateAdapter = true)
+data class LabelUpdateDto(
+    @Json(name = "name")
+    val name: String?,
+    @Json(name = "color")
+    val color: String?
+)
+// [END_ENTITY: DataClass('LabelUpdateDto')]
+
+// [ENTITY: Function('toDto')]
+// [RELATION: Function('toDto')] -> [RETURNS] -> [DataClass('LabelUpdateDto')]
+fun LabelUpdate.toDto(): LabelUpdateDto {
+    return LabelUpdateDto(
+        name = this.name,
+        color = this.color
+    )
+}
+// [END_ENTITY: Function('toDto')]
+// [END_FILE_LabelUpdateDto.kt]

data/src/main/java/com/homebox/lens/data/api/dto/LocationCreateDto.kt

@@ -0,0 +1,22 @@
+// [PACKAGE] com.homebox.lens.data.api.dto
+// [FILE] LocationCreateDto.kt
+// [SEMANTICS] data_transfer_object, location, create
+package com.homebox.lens.data.api.dto
+
+// [IMPORTS]
+import com.squareup.moshi.Json
+import com.squareup.moshi.JsonClass
+// [END_IMPORTS]
+
+// [ENTITY: DataClass('LocationCreateDto')]
+@JsonClass(generateAdapter = true)
+data class LocationCreateDto(
+    @Json(name = "name")
+    val name: String,
+    @Json(name = "color")
+    val color: String?,
+    @Json(name = "description")
+    val description: String? // Assuming description can be null for creation
+)
+// [END_ENTITY: DataClass('LocationCreateDto')]
+// [END_FILE_LocationCreateDto.kt]

data/src/main/java/com/homebox/lens/data/api/dto/LocationDto.kt

@@ -1,25 +1,27 @@
 // [PACKAGE] com.homebox.lens.data.api.dto
 // [FILE] LocationDto.kt
-
+// [SEMANTICS] data, dto, api, location
 package com.homebox.lens.data.api.dto
 
+// [IMPORTS]
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
+// [END_IMPORTS]
 
-// [CONTRACT]
+// [ENTITY: DataClass('LocationOut')]
 /**
- * [ENTITY: DataClass('LocationOut')]
+ * @summary DTO для информации о местоположении.
- * [PURPOSE] DTO для информации о местоположении.
  */
 @JsonClass(generateAdapter = true)
 data class LocationOut(
     @Json(name = "id") val id: String,
     @Json(name = "name") val name: String
 )
+// [END_ENTITY: DataClass('LocationOut')]
 
+// [ENTITY: DataClass('LocationOutCount')]
 /**
- * [ENTITY: DataClass('LocationOutCount')]
+ * @summary DTO для информации о местоположении со счетчиком вещей.
- * [PURPOSE] DTO для информации о местоположении со счетчиком вещей.
  */
 @JsonClass(generateAdapter = true)
 data class LocationOutCount(
@@ -27,5 +29,6 @@ data class LocationOutCount(
     @Json(name = "name") val name: String,
     @Json(name = "itemCount") val itemCount: Int
 )
+// [END_ENTITY: DataClass('LocationOutCount')]
 
-// [END_FILE_LocationDto.kt]
+// [END_FILE_LocationDto.kt]

data/src/main/java/com/homebox/lens/data/api/dto/LocationOutCountDto.kt

@@ -8,35 +8,40 @@ package com.homebox.lens.data.api.dto
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 import com.homebox.lens.domain.model.LocationOutCount
+// [END_IMPORTS]
 
-// [CORE-LOGIC]
+// [ENTITY: DataClass('LocationOutCountDto')]
 /**
- * [CONTRACT]
+ * @summary DTO для местоположения со счетчиком.
- * DTO для местоположения со счетчиком.
  */
 @JsonClass(generateAdapter = true)
 data class LocationOutCountDto(
     @Json(name = "id") val id: String,
     @Json(name = "name") val name: String,
-    @Json(name = "color") val color: String,
+    @Json(name = "color") val color: String?,
-    @Json(name = "isArchived") val isArchived: Boolean,
+    @Json(name = "isArchived") val isArchived: Boolean?,
     @Json(name = "itemCount") val itemCount: Int,
     @Json(name = "createdAt") val createdAt: String,
-    @Json(name = "updatedAt") val updatedAt: String
+    @Json(name = "updatedAt") val updatedAt: String,
+    @Json(name = "description") val description: String?
 )
+// [END_ENTITY: DataClass('LocationOutCountDto')]
 
+// [ENTITY: Function('toDomain')]
+// [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('LocationOutCount')]
 /**
- * [CONTRACT]
+ * @summary Маппер из LocationOutCountDto в доменную модель LocationOutCount.
- * Маппер из LocationOutCountDto в доменную модель LocationOutCount.
  */
 fun LocationOutCountDto.toDomain(): LocationOutCount {
     return LocationOutCount(
         id = this.id,
         name = this.name,
-        color = this.color,
+        color = this.color ?: "",
-        isArchived = this.isArchived,
+        isArchived = this.isArchived ?: false,
         itemCount = this.itemCount,
         createdAt = this.createdAt,
         updatedAt = this.updatedAt
     )
 }
+// [END_ENTITY: Function('toDomain')]
+// [END_FILE_LocationOutCountDto.kt]

data/src/main/java/com/homebox/lens/data/api/dto/LocationOutDto.kt

@@ -1,33 +1,34 @@
 // [PACKAGE] com.homebox.lens.data.api.dto
 // [FILE] LocationOutDto.kt
-// [SEMANTICS] data_transfer_object, location
+// [SEMANTICS] data_transfer_object, location, output
-
 package com.homebox.lens.data.api.dto
 
 // [IMPORTS]
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 import com.homebox.lens.domain.model.LocationOut
+// [END_IMPORTS]
 
-// [CORE-LOGIC]
+// [ENTITY: DataClass('LocationOutDto')]
-/**
- * [CONTRACT]
- * DTO для местоположения.
- */
 @JsonClass(generateAdapter = true)
 data class LocationOutDto(
-    @Json(name = "id") val id: String,
+    @Json(name = "id")
-    @Json(name = "name") val name: String,
+    val id: String,
-    @Json(name = "color") val color: String,
+    @Json(name = "name")
-    @Json(name = "isArchived") val isArchived: Boolean,
+    val name: String,
-    @Json(name = "createdAt") val createdAt: String,
+    @Json(name = "color")
-    @Json(name = "updatedAt") val updatedAt: String
+    val color: String,
+    @Json(name = "isArchived")
+    val isArchived: Boolean,
+    @Json(name = "createdAt")
+    val createdAt: String,
+    @Json(name = "updatedAt")
+    val updatedAt: String
 )
+// [END_ENTITY: DataClass('LocationOutDto')]
 
-/**
+// [ENTITY: Function('toDomain')]
- * [CONTRACT]
+// [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('LocationOut')]
- * Маппер из LocationOutDto в доменную модель LocationOut.
- */
 fun LocationOutDto.toDomain(): LocationOut {
     return LocationOut(
         id = this.id,
@@ -38,3 +39,5 @@ fun LocationOutDto.toDomain(): LocationOut {
         updatedAt = this.updatedAt
     )
 }
+// [END_ENTITY: Function('toDomain')]
+// [END_FILE_LocationOutDto.kt]

data/src/main/java/com/homebox/lens/data/api/dto/LocationUpdateDto.kt

@@ -0,0 +1,31 @@
+// [PACKAGE] com.homebox.lens.data.api.dto
+// [FILE] LocationUpdateDto.kt
+// [SEMANTICS] data_transfer_object, location, update
+package com.homebox.lens.data.api.dto
+
+// [IMPORTS]
+import com.squareup.moshi.Json
+import com.squareup.moshi.JsonClass
+import com.homebox.lens.domain.model.LocationUpdate
+// [END_IMPORTS]
+
+// [ENTITY: DataClass('LocationUpdateDto')]
+@JsonClass(generateAdapter = true)
+data class LocationUpdateDto(
+    @Json(name = "name")
+    val name: String?,
+    @Json(name = "color")
+    val color: String?
+)
+// [END_ENTITY: DataClass('LocationUpdateDto')]
+
+// [ENTITY: Function('toDto')]
+// [RELATION: Function('toDto')] -> [RETURNS] -> [DataClass('LocationUpdateDto')]
+fun LocationUpdate.toDto(): LocationUpdateDto {
+    return LocationUpdateDto(
+        name = this.name,
+        color = this.color
+    )
+}
+// [END_ENTITY: Function('toDto')]
+// [END_FILE_LocationUpdateDto.kt]

data/src/main/java/com/homebox/lens/data/api/dto/LoginFormDto.kt

@@ -0,0 +1,19 @@
+// [PACKAGE] com.homebox.lens.data.api.dto
+// [FILE] LoginFormDto.kt
+// [SEMANTICS] data, dto, api, login
+package com.homebox.lens.data.api.dto
+
+// [IMPORTS]
+import com.squareup.moshi.Json
+import com.squareup.moshi.JsonClass
+// [END_IMPORTS]
+
+// [ENTITY: DataClass('LoginFormDto')]
+@JsonClass(generateAdapter = true)
+data class LoginFormDto(
+    @Json(name = "username") val username: String,
+    @Json(name = "password") val password: String,
+    @Json(name = "stayLoggedIn") val stayLoggedIn: Boolean = true
+)
+// [END_ENTITY: DataClass('LoginFormDto')]
+// [END_FILE_LoginFormDto.kt]

data/src/main/java/com/homebox/lens/data/api/dto/MaintenanceEntryDto.kt

@@ -8,11 +8,11 @@ package com.homebox.lens.data.api.dto
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 import com.homebox.lens.domain.model.MaintenanceEntry
+// [END_IMPORTS]
 
-// [CORE-LOGIC]
+// [ENTITY: DataClass('MaintenanceEntryDto')]
 /**
- * [CONTRACT]
+ * @summary DTO для записи об обслуживании.
- * DTO для записи об обслуживании.
  */
 @JsonClass(generateAdapter = true)
 data class MaintenanceEntryDto(
@@ -25,10 +25,12 @@ data class MaintenanceEntryDto(
     @Json(name = "createdAt") val createdAt: String,
     @Json(name = "updatedAt") val updatedAt: String
 )
+// [END_ENTITY: DataClass('MaintenanceEntryDto')]
 
+// [ENTITY: Function('toDomain')]
+// [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('MaintenanceEntry')]
 /**
- * [CONTRACT]
+ * @summary Маппер из MaintenanceEntryDto в доменную модель MaintenanceEntry.
- * Маппер из MaintenanceEntryDto в доменную модель MaintenanceEntry.
  */
 fun MaintenanceEntryDto.toDomain(): MaintenanceEntry {
     return MaintenanceEntry(
@@ -42,3 +44,4 @@ fun MaintenanceEntryDto.toDomain(): MaintenanceEntry {
         updatedAt = this.updatedAt
     )
 }
+// [END_ENTITY: Function('toDomain')]

data/src/main/java/com/homebox/lens/data/api/dto/PaginationDto.kt

@@ -1,15 +1,16 @@
 // [PACKAGE] com.homebox.lens.data.api.dto
 // [FILE] PaginationDto.kt
-
+// [SEMANTICS] data, dto, api, pagination
 package com.homebox.lens.data.api.dto
 
+// [IMPORTS]
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
+// [END_IMPORTS]
 
-// [CONTRACT]
+// [ENTITY: DataClass('PaginationResult')]
 /**
- * [ENTITY: DataClass('PaginationResult')]
+ * @summary DTO для пагинированных результатов от API.
- * [PURPOSE] DTO для пагинированных результатов от API.
  */
 @JsonClass(generateAdapter = true)
 data class PaginationResult<T>(
@@ -19,5 +20,6 @@ data class PaginationResult<T>(
     @Json(name = "total") val total: Int,
     @Json(name = "pageSize") val pageSize: Int
 )
+// [END_ENTITY: DataClass('PaginationResult')]
 
-// [END_FILE_PaginationDto.kt]
+// [END_FILE_PaginationDto.kt]

data/src/main/java/com/homebox/lens/data/api/dto/PaginationResultDto.kt

@@ -8,11 +8,11 @@ package com.homebox.lens.data.api.dto
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 import com.homebox.lens.domain.model.PaginationResult
+// [END_IMPORTS]
 
-// [CORE-LOGIC]
+// [ENTITY: DataClass('PaginationResultDto')]
 /**
- * [CONTRACT]
+ * @summary DTO для постраничных результатов.
- * DTO для постраничных результатов.
  */
 @JsonClass(generateAdapter = true)
 data class PaginationResultDto<T>(
@@ -21,10 +21,12 @@ data class PaginationResultDto<T>(
     @Json(name = "pageSize") val pageSize: Int,
     @Json(name = "total") val total: Int
 )
+// [END_ENTITY: DataClass('PaginationResultDto')]
 
+// [ENTITY: Function('toDomain')]
+// [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('PaginationResult')]
 /**
- * [CONTRACT]
+ * @summary Маппер из PaginationResultDto в доменную модель PaginationResult.
- * Маппер из PaginationResultDto в доменную модель PaginationResult.
  * @param transform Функция для преобразования каждого элемента из DTO в доменную модель.
  */
 fun <T, R> PaginationResultDto<T>.toDomain(transform: (T) -> R): PaginationResult<R> {
@@ -35,3 +37,4 @@ fun <T, R> PaginationResultDto<T>.toDomain(transform: (T) -> R): PaginationResul
         total = this.total
     )
 }
+// [END_ENTITY: Function('toDomain')]

data/src/main/java/com/homebox/lens/data/api/dto/StatisticsDto.kt

@@ -1,16 +1,17 @@
 // [PACKAGE] com.homebox.lens.data.api.dto
 // [FILE] StatisticsDto.kt
-
+// [SEMANTICS] data, dto, api, statistics
 package com.homebox.lens.data.api.dto
 
+// [IMPORTS]
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 import java.math.BigDecimal
+// [END_IMPORTS]
 
-// [CONTRACT]
+// [ENTITY: DataClass('GroupStatistics')]
 /**
- * [ENTITY: DataClass('GroupStatistics')]
+ * @summary DTO для статистической информации.
- * [PURPOSE] DTO для статистической информации.
  */
 @JsonClass(generateAdapter = true)
 data class GroupStatistics(
@@ -19,5 +20,6 @@ data class GroupStatistics(
     @Json(name = "locations") val locations: Int,
     @Json(name = "labels") val labels: Int
 )
+// [END_ENTITY: DataClass('GroupStatistics')]
 
-// [END_FILE_StatisticsDto.kt]
+// [END_FILE_StatisticsDto.kt]

data/src/main/java/com/homebox/lens/data/api/dto/TokenResponseDto.kt

@@ -0,0 +1,19 @@
+// [PACKAGE] com.homebox.lens.data.api.dto
+// [FILE] TokenResponseDto.kt
+// [SEMANTICS] data, dto, api, token
+package com.homebox.lens.data.api.dto
+
+// [IMPORTS]
+import com.squareup.moshi.Json
+import com.squareup.moshi.JsonClass
+// [END_IMPORTS]
+
+// [ENTITY: DataClass('TokenResponseDto')]
+@JsonClass(generateAdapter = true)
+data class TokenResponseDto(
+    @Json(name = "token") val token: String,
+    @Json(name = "attachmentToken") val attachmentToken: String,
+    @Json(name = "expiresAt") val expiresAt: String
+)
+// [END_ENTITY: DataClass('TokenResponseDto')]
+// [END_FILE_TokenResponseDto.kt]

data/src/main/java/com/homebox/lens/data/api/mapper/TokenMapper.kt

@@ -0,0 +1,30 @@
+// [PACKAGE] com.homebox.lens.data.api.mapper
+// [FILE] TokenMapper.kt
+// [SEMANTICS] mapper, data_conversion, clean_architecture
+
+package com.homebox.lens.data.api.mapper
+
+// [IMPORTS]
+import com.homebox.lens.data.api.dto.TokenResponseDto
+import com.homebox.lens.domain.model.TokenResponse
+// [END_IMPORTS]
+
+// [ENTITY: Function('toDomain')]
+// [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('TokenResponse')]
+/**
+ * @summary Преобразует DTO-объект токена в доменную модель.
+ * @receiver [TokenResponseDto] объект из слоя данных.
+ * @return [TokenResponse] объект для доменного слоя.
+ * @throws IllegalArgumentException если токен в DTO пустой.
+ */
+fun TokenResponseDto.toDomain(): TokenResponse {
+    require(this.token.isNotBlank()) { "DTO token is blank, cannot map to domain model." }
+
+    val domainModel = TokenResponse(token = this.token)
+
+    check(domainModel.token.isNotBlank()) { "Domain model token is blank after mapping." }
+
+    return domainModel
+}
+// [END_ENTITY: Function('toDomain')]
+// [END_FILE_TokenMapper.kt]

data/src/main/java/com/homebox/lens/data/api/model/LoginRequest.kt

@@ -0,0 +1,29 @@
+// [PACKAGE] com.homebox.lens.data.api.model
+// [FILE] LoginRequest.kt
+// [SEMANTICS] dto, network, serialization, authentication
+
+package com.homebox.lens.data.api.model
+
+import com.squareup.moshi.Json
+import com.squareup.moshi.JsonClass
+
+/**
+ * [ENTITY: DataClass('LoginRequest')]
+ * [CONTRACT]
+ * DTO (Data Transfer Object) для запроса на аутентификацию.
+ * @property username Имя пользователя.
+ * @property password Пароль пользователя.
+ * @invariant Свойства не должны быть пустыми.
+ */
+@JsonClass(generateAdapter = true)
+data class LoginRequest(
+    @Json(name = "username") val username: String,
+    @Json(name = "password") val password: String
+) {
+    init {
+        // [INVARIANT_CHECK]
+        require(username.isNotBlank()) { "[INVARIANT_FAILED] Username cannot be blank." }
+        require(password.isNotBlank()) { "[INVARIANT_FAILED] Password cannot be blank." }
+    }
+}
+// [END_FILE_LoginRequest.kt]

data/src/main/java/com/homebox/lens/data/db/Converters.kt

@@ -1,26 +1,32 @@
 // [PACKAGE] com.homebox.lens.data.db
 // [FILE] Converters.kt
-
+// [SEMANTICS] data, database, room, converter
 package com.homebox.lens.data.db
 
+// [IMPORTS]
 import androidx.room.TypeConverter
 import java.math.BigDecimal
+// [END_IMPORTS]
 
-// [CONTRACT]
+// [ENTITY: Class('Converters')]
 /**
- * [ENTITY: Class('Converters')]
+ * @summary Предоставляет TypeConverters для Room для типов, не поддерживаемых по умолчанию.
- * [PURPOSE] Предоставляет TypeConverters для Room для типов, не поддерживаемых по умолчанию.
  */
 class Converters {
+    // [ENTITY: Function('fromString')]
     @TypeConverter
     fun fromString(value: String?): BigDecimal? {
         return value?.let { BigDecimal(it) }
     }
+    // [END_ENTITY: Function('fromString')]
 
+    // [ENTITY: Function('bigDecimalToString')]
     @TypeConverter
     fun bigDecimalToString(bigDecimal: BigDecimal?): String? {
         return bigDecimal?.toPlainString()
     }
+    // [END_ENTITY: Function('bigDecimalToString')]
 }
+// [END_ENTITY: Class('Converters')]
 
 // [END_FILE_Converters.kt]

data/src/main/java/com/homebox/lens/data/db/HomeboxDatabase.kt

@@ -1,8 +1,9 @@
 // [PACKAGE] com.homebox.lens.data.db
 // [FILE] HomeboxDatabase.kt
-
+// [SEMANTICS] data, database, room
 package com.homebox.lens.data.db
 
+// [IMPORTS]
 import androidx.room.Database
 import androidx.room.RoomDatabase
 import androidx.room.TypeConverters
@@ -10,11 +11,11 @@ import com.homebox.lens.data.db.dao.ItemDao
 import com.homebox.lens.data.db.dao.LabelDao
 import com.homebox.lens.data.db.dao.LocationDao
 import com.homebox.lens.data.db.entity.*
+// [END_IMPORTS]
 
-// [CONTRACT]
+// [ENTITY: Database('HomeboxDatabase')]
 /**
- * [ENTITY: RoomDatabase('HomeboxDatabase')]
+ * @summary Основной класс для работы с локальной базой данных Room.
- * [PURPOSE] Основной класс для работы с локальной базой данных Room.
  */
 @Database(
     entities = [
@@ -37,5 +38,6 @@ abstract class HomeboxDatabase : RoomDatabase() {
         const val DATABASE_NAME = "homebox_lens_db"
     }
 }
+// [END_ENTITY: Database('HomeboxDatabase')]
 
-// [END_FILE_HomeboxDatabase.kt]
+// [END_FILE_HomeboxDatabase.kt]

data/src/main/java/com/homebox/lens/data/db/dao/ItemDao.kt

@@ -1,40 +1,61 @@
 // [PACKAGE] com.homebox.lens.data.db.dao
 // [FILE] ItemDao.kt
-
+// [SEMANTICS] data, database, dao, item
 package com.homebox.lens.data.db.dao
 
+// [IMPORTS]
 import androidx.room.*
 import com.homebox.lens.data.db.entity.ItemEntity
 import com.homebox.lens.data.db.entity.ItemLabelCrossRef
 import com.homebox.lens.data.db.entity.ItemWithLabels
+import kotlinx.coroutines.flow.Flow
+// [END_IMPORTS]
 
-// [CONTRACT]
+// [ENTITY: Interface('ItemDao')]
 /**
- * [ENTITY: RoomDao('ItemDao')]
+ * @summary Предоставляет методы для работы с 'items' в локальной БД.
- * [PURPOSE] Предоставляет методы для работы с 'items' в локальной БД.
  */
 @Dao
 interface ItemDao {
 
+    // [ENTITY: Function('getRecentlyAddedItems')]
+    @Transaction
+    @Query("SELECT * FROM items ORDER BY createdAt DESC LIMIT :limit")
+    fun getRecentlyAddedItems(limit: Int): Flow<List<ItemWithLabels>>
+    // [END_ENTITY: Function('getRecentlyAddedItems')]
+
+    // [ENTITY: Function('getItems')]
     @Transaction
     @Query("SELECT * FROM items")
     suspend fun getItems(): List<ItemWithLabels>
+    // [END_ENTITY: Function('getItems')]
 
+    // [ENTITY: Function('getItem')]
     @Transaction
     @Query("SELECT * FROM items WHERE id = :itemId")
     suspend fun getItem(itemId: String): ItemWithLabels?
+    // [END_ENTITY: Function('getItem')]
 
+    // [ENTITY: Function('insertItems')]
     @Insert(onConflict = OnConflictStrategy.REPLACE)
     suspend fun insertItems(items: List<ItemEntity>)
+    // [END_ENTITY: Function('insertItems')]
 
+    // [ENTITY: Function('insertItem')]
     @Insert(onConflict = OnConflictStrategy.REPLACE)
     suspend fun insertItem(item: ItemEntity)
+    // [END_ENTITY: Function('insertItem')]
 
+    // [ENTITY: Function('deleteItem')]
     @Query("DELETE FROM items WHERE id = :itemId")
     suspend fun deleteItem(itemId: String)
+    // [END_ENTITY: Function('deleteItem')]
 
+    // [ENTITY: Function('insertItemLabelCrossRefs')]
     @Insert(onConflict = OnConflictStrategy.REPLACE)
     suspend fun insertItemLabelCrossRefs(crossRefs: List<ItemLabelCrossRef>)
+    // [END_ENTITY: Function('insertItemLabelCrossRefs')]
 }
+// [END_ENTITY: Interface('ItemDao')]
 
-// [END_FILE_ItemDao.kt]
+// [END_FILE_ItemDao.kt]

data/src/main/java/com/homebox/lens/data/db/dao/LabelDao.kt

@@ -1,27 +1,42 @@
 // [PACKAGE] com.homebox.lens.data.db.dao
 // [FILE] LabelDao.kt
-
+// [SEMANTICS] data, database, dao, label
 package com.homebox.lens.data.db.dao
 
+// [IMPORTS]
 import androidx.room.Dao
 import androidx.room.Insert
 import androidx.room.OnConflictStrategy
 import androidx.room.Query
 import com.homebox.lens.data.db.entity.LabelEntity
+// [END_IMPORTS]
 
-// [CONTRACT]
+// [ENTITY: Interface('LabelDao')]
 /**
- * [ENTITY: RoomDao('LabelDao')]
+ * @summary Предоставляет методы для работы с 'labels' в локальной БД.
- * [PURPOSE] Предоставляет методы для работы с 'labels' в локальной БД.
  */
 @Dao
 interface LabelDao {
 
+    // [ENTITY: Function('getLabels')]
     @Query("SELECT * FROM labels")
     suspend fun getLabels(): List<LabelEntity>
+    // [END_ENTITY: Function('getLabels')]
 
+    // [ENTITY: Function('insertLabels')]
     @Insert(onConflict = OnConflictStrategy.REPLACE)
     suspend fun insertLabels(labels: List<LabelEntity>)
+    // [END_ENTITY: Function('insertLabels')]
+
+    // [ENTITY: Function('deleteLabelById')]
+    /**
+     * @summary Удаляет метку по её ID из локальной БД.
+     * @param labelId ID метки для удаления.
+     */
+    @Query("DELETE FROM labels WHERE id = :labelId")
+    suspend fun deleteLabelById(labelId: String)
+    // [END_ENTITY: Function('deleteLabelById')]
 }
+// [END_ENTITY: Interface('LabelDao')]
 
 // [END_FILE_LabelDao.kt]

data/src/main/java/com/homebox/lens/data/db/dao/LocationDao.kt

@@ -1,27 +1,33 @@
 // [PACKAGE] com.homebox.lens.data.db.dao
 // [FILE] LocationDao.kt
-
+// [SEMANTICS] data, database, dao, location
 package com.homebox.lens.data.db.dao
 
+// [IMPORTS]
 import androidx.room.Dao
 import androidx.room.Insert
 import androidx.room.OnConflictStrategy
 import androidx.room.Query
 import com.homebox.lens.data.db.entity.LocationEntity
+// [END_IMPORTS]
 
-// [CONTRACT]
+// [ENTITY: Interface('LocationDao')]
 /**
- * [ENTITY: RoomDao('LocationDao')]
+ * @summary Предоставляет методы для работы с 'locations' в локальной БД.
- * [PURPOSE] Предоставляет методы для работы с 'locations' в локальной БД.
  */
 @Dao
 interface LocationDao {
 
+    // [ENTITY: Function('getLocations')]
     @Query("SELECT * FROM locations")
     suspend fun getLocations(): List<LocationEntity>
+    // [END_ENTITY: Function('getLocations')]
 
+    // [ENTITY: Function('insertLocations')]
     @Insert(onConflict = OnConflictStrategy.REPLACE)
     suspend fun insertLocations(locations: List<LocationEntity>)
+    // [END_ENTITY: Function('insertLocations')]
 }
+// [END_ENTITY: Interface('LocationDao')]
 
 // [END_FILE_LocationDao.kt]

data/src/main/java/com/homebox/lens/data/db/entity/ItemEntity.kt

@@ -1,16 +1,17 @@
 // [PACKAGE] com.homebox.lens.data.db.entity
 // [FILE] ItemEntity.kt
-
+// [SEMANTICS] data, database, entity, item
 package com.homebox.lens.data.db.entity
 
+// [IMPORTS]
 import androidx.room.Entity
 import androidx.room.PrimaryKey
 import java.math.BigDecimal
+// [END_IMPORTS]
 
-// [CONTRACT]
+// [ENTITY: DatabaseTable('ItemEntity')]
 /**
- * [ENTITY: RoomEntity('ItemEntity')]
+ * @summary Представляет собой строку в таблице 'items' в локальной БД.
- * [PURPOSE] Представляет собой строку в таблице 'items' в локальной БД.
  */
 @Entity(tableName = "items")
 data class ItemEntity(
@@ -22,5 +23,6 @@ data class ItemEntity(
     val value: BigDecimal?,
     val createdAt: String?
 )
+// [END_ENTITY: DatabaseTable('ItemEntity')]
 
-// [END_FILE_ItemEntity.kt]
+// [END_FILE_ItemEntity.kt]

data/src/main/java/com/homebox/lens/data/db/entity/ItemLabelCrossRef.kt

@@ -1,15 +1,16 @@
 // [PACKAGE] com.homebox.lens.data.db.entity
 // [FILE] ItemLabelCrossRef.kt
-
+// [SEMANTICS] data, database, entity, relation
 package com.homebox.lens.data.db.entity
 
+// [IMPORTS]
 import androidx.room.Entity
 import androidx.room.Index
+// [END_IMPORTS]
 
-// [CONTRACT]
+// [ENTITY: DatabaseTable('ItemLabelCrossRef')]
 /**
- * [ENTITY: RoomEntity('ItemLabelCrossRef')]
+ * @summary Таблица для связи "многие-ко-многим" между ItemEntity и LabelEntity.
- * [PURPOSE] Таблица для связи "многие-ко-многим" между ItemEntity и LabelEntity.
  */
 @Entity(
     primaryKeys = ["itemId", "labelId"],
@@ -19,5 +20,6 @@ data class ItemLabelCrossRef(
     val itemId: String,
     val labelId: String
 )
+// [END_ENTITY: DatabaseTable('ItemLabelCrossRef')]
 
-// [END_FILE_ItemLabelCrossRef.kt]
+// [END_FILE_ItemLabelCrossRef.kt]

data/src/main/java/com/homebox/lens/data/db/entity/ItemWithLabels.kt

@@ -1,16 +1,19 @@
 // [PACKAGE] com.homebox.lens.data.db.entity
 // [FILE] ItemWithLabels.kt
-
+// [SEMANTICS] data, database, entity, relation
 package com.homebox.lens.data.db.entity
 
+// [IMPORTS]
 import androidx.room.Embedded
 import androidx.room.Junction
 import androidx.room.Relation
+// [END_IMPORTS]
 
-// [CONTRACT]
+// [ENTITY: DataClass('ItemWithLabels')]
+// [RELATION: DataClass('ItemWithLabels')] -> [DEPENDS_ON] -> [DatabaseTable('ItemEntity')]
+// [RELATION: DataClass('ItemWithLabels')] -> [DEPENDS_ON] -> [DatabaseTable('LabelEntity')]
 /**
- * [ENTITY: Pojo('ItemWithLabels')]
+ * @summary POJO для получения ItemEntity вместе со связанными LabelEntity.
- * [PURPOSE] POJO для получения ItemEntity вместе со связанными LabelEntity.
  */
 data class ItemWithLabels(
     @Embedded val item: ItemEntity,
@@ -25,5 +28,6 @@ data class ItemWithLabels(
     )
     val labels: List<LabelEntity>
 )
+// [END_ENTITY: DataClass('ItemWithLabels')]
 
-// [END_FILE_ItemWithLabels.kt]
+// [END_FILE_ItemWithLabels.kt]

data/src/main/java/com/homebox/lens/data/db/entity/LabelEntity.kt

@@ -1,20 +1,22 @@
 // [PACKAGE] com.homebox.lens.data.db.entity
 // [FILE] LabelEntity.kt
-
+// [SEMANTICS] data, database, entity, label
 package com.homebox.lens.data.db.entity
 
+// [IMPORTS]
 import androidx.room.Entity
 import androidx.room.PrimaryKey
+// [END_IMPORTS]
 
-// [CONTRACT]
+// [ENTITY: DatabaseTable('LabelEntity')]
 /**
- * [ENTITY: RoomEntity('LabelEntity')]
+ * @summary Представляет собой строку в таблице 'labels' в локальной БД.
- * [PURPOSE] Представляет собой строку в таблице 'labels' в локальной БД.
  */
 @Entity(tableName = "labels")
 data class LabelEntity(
     @PrimaryKey val id: String,
     val name: String
 )
+// [END_ENTITY: DatabaseTable('LabelEntity')]
 
-// [END_FILE_LabelEntity.kt]
+// [END_FILE_LabelEntity.kt]

data/src/main/java/com/homebox/lens/data/db/entity/LocationEntity.kt

@@ -1,20 +1,22 @@
 // [PACKAGE] com.homebox.lens.data.db.entity
 // [FILE] LocationEntity.kt
-
+// [SEMANTICS] data, database, entity, location
 package com.homebox.lens.data.db.entity
 
+// [IMPORTS]
 import androidx.room.Entity
 import androidx.room.PrimaryKey
+// [END_IMPORTS]
 
-// [CONTRACT]
+// [ENTITY: DatabaseTable('LocationEntity')]
 /**
- * [ENTITY: RoomEntity('LocationEntity')]
+ * @summary Представляет собой строку в таблице 'locations' в локальной БД.
- * [PURPOSE] Представляет собой строку в таблице 'locations' в локальной БД.
  */
 @Entity(tableName = "locations")
 data class LocationEntity(
     @PrimaryKey val id: String,
     val name: String
 )
+// [END_ENTITY: DatabaseTable('LocationEntity')]
 
 // [END_FILE_LocationEntity.kt]

data/src/main/java/com/homebox/lens/data/db/entity/Mapper.kt

@@ -0,0 +1,49 @@
+// [PACKAGE] com.homebox.lens.data.db.entity
+// [FILE] Mapper.kt
+// [SEMANTICS] data, database, mapper
+package com.homebox.lens.data.db.entity
+
+// [IMPORTS]
+import com.homebox.lens.domain.model.Image
+import com.homebox.lens.domain.model.ItemSummary
+import com.homebox.lens.domain.model.LabelOut
+import com.homebox.lens.domain.model.LocationOut
+// [END_IMPORTS]
+
+// [ENTITY: Function('toDomain')]
+// [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('ItemSummary')]
+/**
+ * @summary Преобразует [ItemWithLabels] (сущность БД) в [ItemSummary] (доменную модель).
+ */
+fun ItemWithLabels.toDomain(): ItemSummary {
+    return ItemSummary(
+        id = this.item.id,
+        name = this.item.name,
+        image = this.item.image?.let { Image(id = "", path = it, isPrimary = true) },
+        location = this.item.locationId?.let { LocationOut(id = it, name = "", color = "", isArchived = false, createdAt = "", updatedAt = "") },
+        labels = this.labels.map { it.toDomain() },
+        assetId = null,
+        isArchived = false,
+        value = this.item.value?.toDouble() ?: 0.0,
+        createdAt = this.item.createdAt ?: "",
+        updatedAt = ""
+    )
+}
+// [END_ENTITY: Function('toDomain')]
+
+// [ENTITY: Function('toDomain')]
+// [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('LabelOut')]
+/**
+ * @summary Преобразует [LabelEntity] (сущность БД) в [LabelOut] (доменную модель).
+ */
+fun LabelEntity.toDomain(): LabelOut {
+    return LabelOut(
+        id = this.id,
+        name = this.name,
+        color = "#CCCCCC",
+        isArchived = false,
+        createdAt = "",
+        updatedAt = ""
+    )
+}
+// [END_ENTITY: Function('toDomain')]

data/src/main/java/com/homebox/lens/data/di/ApiModule.kt

@@ -1,77 +1,123 @@
 // [PACKAGE] com.homebox.lens.data.di
 // [FILE] ApiModule.kt
-
+// [SEMANTICS] di, networking
 package com.homebox.lens.data.di
 
+// [IMPORTS]
 import com.homebox.lens.data.api.HomeboxApiService
+import com.homebox.lens.domain.repository.CredentialsRepository
 import com.squareup.moshi.Moshi
 import com.squareup.moshi.kotlin.reflect.KotlinJsonAdapterFactory
 import dagger.Module
 import dagger.Provides
 import dagger.hilt.InstallIn
 import dagger.hilt.components.SingletonComponent
+import kotlinx.coroutines.runBlocking
+import okhttp3.Interceptor
 import okhttp3.OkHttpClient
 import okhttp3.logging.HttpLoggingInterceptor
 import retrofit2.Retrofit
 import retrofit2.converter.moshi.MoshiConverterFactory
+import timber.log.Timber
+import javax.inject.Provider
 import javax.inject.Singleton
+// [END_IMPORTS]
 
-// [CONTRACT]
+// [ENTITY: Module('ApiModule')]
 /**
- * [MODULE: DaggerHilt('ApiModule')]
+ * @summary Hilt-модуль, отвечающий за создание и предоставление всех зависимостей,
- * [PURPOSE] Предоставляет зависимости для работы с сетью (Retrofit, OkHttp, Moshi).
+ * необходимых для сетевого взаимодействия.
  */
 @Module
 @InstallIn(SingletonComponent::class)
 object ApiModule {
 
-    // [HELPER]
+    private const val BASE_URL = "https://homebox.bebesh.ru/api/"
-    private const val BASE_URL = "https://api.homebox.app/"
 
-    // [PROVIDER]
+    // [ENTITY: Function('provideOkHttpClient')]
+    // [RELATION: Function('provideOkHttpClient')] -> [PROVIDES] -> [Framework('OkHttpClient')]
     @Provides
     @Singleton
-    fun provideOkHttpClient(): OkHttpClient {
+    fun provideOkHttpClient(
-        // [ACTION] Create logging interceptor
+        credentialsRepositoryProvider: Provider<CredentialsRepository>
-        val logging = HttpLoggingInterceptor().apply {
+    ): OkHttpClient {
+        Timber.d("[DEBUG][PROVIDER][providing_okhttp_client] Providing OkHttpClient.")
+        val loggingInterceptor = HttpLoggingInterceptor().apply {
             level = HttpLoggingInterceptor.Level.BODY
         }
-        // [ACTION] Build OkHttpClient
+
+        val acceptHeaderInterceptor = Interceptor { chain ->
+            val request = chain.request().newBuilder()
+                .header("Accept", "application/json")
+                .build()
+            chain.proceed(request)
+        }
+
+        val authInterceptor = Interceptor { chain ->
+            val token = runBlocking { credentialsRepositoryProvider.get().getToken() }
+
+            val requestBuilder = chain.request().newBuilder()
+
+            if (token != null) {
+                requestBuilder.addHeader("Authorization", token)
+            }
+
+            chain.proceed(requestBuilder.build())
+        }
+
         return OkHttpClient.Builder()
-            .addInterceptor(logging)
+            .addInterceptor(acceptHeaderInterceptor)
-            // [TODO] Add AuthInterceptor for Bearer token
+            .addInterceptor(authInterceptor)
+            .addInterceptor(loggingInterceptor)
             .build()
     }
+    // [END_ENTITY: Function('provideOkHttpClient')]
 
-    // [PROVIDER]
+    // [ENTITY: Function('provideMoshi')]
+    // [RELATION: Function('provideMoshi')] -> [PROVIDES] -> [Framework('Moshi')]
     @Provides
     @Singleton
     fun provideMoshi(): Moshi {
-        // [ACTION] Build Moshi with Kotlin adapter
+        Timber.d("[DEBUG][PROVIDER][providing_moshi] Providing Moshi.")
         return Moshi.Builder()
             .add(KotlinJsonAdapterFactory())
             .build()
     }
+    // [END_ENTITY: Function('provideMoshi')]
 
-    // [PROVIDER]
+    // [ENTITY: Function('provideMoshiConverterFactory')]
+    // [RELATION: Function('provideMoshiConverterFactory')] -> [PROVIDES] -> [Framework('MoshiConverterFactory')]
     @Provides
     @Singleton
-    fun provideRetrofit(okHttpClient: OkHttpClient, moshi: Moshi): Retrofit {
+    fun provideMoshiConverterFactory(moshi: Moshi): MoshiConverterFactory {
-        // [ACTION] Build Retrofit instance
+        Timber.d("[DEBUG][PROVIDER][providing_moshi_converter] Providing MoshiConverterFactory.")
+        return MoshiConverterFactory.create(moshi)
+    }
+    // [END_ENTITY: Function('provideMoshiConverterFactory')]
+
+    // [ENTITY: Function('provideRetrofit')]
+    // [RELATION: Function('provideRetrofit')] -> [PROVIDES] -> [Framework('Retrofit')]
+    @Provides
+    @Singleton
+    fun provideRetrofit(okHttpClient: OkHttpClient, moshiConverterFactory: MoshiConverterFactory): Retrofit {
+        Timber.d("[DEBUG][PROVIDER][providing_retrofit] Providing Retrofit.")
         return Retrofit.Builder()
             .baseUrl(BASE_URL)
             .client(okHttpClient)
-            .addConverterFactory(MoshiConverterFactory.create(moshi))
+            .addConverterFactory(moshiConverterFactory)
             .build()
     }
+    // [END_ENTITY: Function('provideRetrofit')]
 
-    // [PROVIDER]
+    // [ENTITY: Function('provideHomeboxApiService')]
+    // [RELATION: Function('provideHomeboxApiService')] -> [PROVIDES] -> [Interface('HomeboxApiService')]
     @Provides
     @Singleton
     fun provideHomeboxApiService(retrofit: Retrofit): HomeboxApiService {
-        // [ACTION] Create ApiService from Retrofit instance
+        Timber.d("[DEBUG][PROVIDER][providing_api_service] Providing HomeboxApiService.")
         return retrofit.create(HomeboxApiService::class.java)
     }
+    // [END_ENTITY: Function('provideHomeboxApiService')]
 }
-
+// [END_ENTITY: Module('ApiModule')]
-// [END_FILE_ApiModule.kt]
+// [END_FILE_ApiModule.kt]

data/src/main/java/com/homebox/lens/data/di/DatabaseModule.kt

@@ -1,8 +1,9 @@
 // [PACKAGE] com.homebox.lens.data.di
 // [FILE] DatabaseModule.kt
-
+// [SEMANTICS] di, hilt, database
 package com.homebox.lens.data.di
 
+// [IMPORTS]
 import android.content.Context
 import androidx.room.Room
 import com.homebox.lens.data.db.HomeboxDatabase
@@ -11,40 +12,50 @@ import dagger.Provides
 import dagger.hilt.InstallIn
 import dagger.hilt.android.qualifiers.ApplicationContext
 import dagger.hilt.components.SingletonComponent
+import timber.log.Timber
 import javax.inject.Singleton
+// [END_IMPORTS]
 
-// [CONTRACT]
+// [ENTITY: Module('DatabaseModule')]
 /**
- * [MODULE: DaggerHilt('DatabaseModule')]
+ * @summary Предоставляет зависимости для работы с базой данных Room.
- * [PURPOSE] Предоставляет зависимости для работы с базой данных Room.
  */
 @Module
 @InstallIn(SingletonComponent::class)
 object DatabaseModule {
 
-    // [PROVIDER]
+    // [ENTITY: Function('provideHomeboxDatabase')]
+    // [RELATION: Function('provideHomeboxDatabase')] -> [PROVIDES] -> [Database('HomeboxDatabase')]
     @Provides
     @Singleton
     fun provideHomeboxDatabase(@ApplicationContext context: Context): HomeboxDatabase {
-        // [ACTION] Build Room database instance
+        Timber.d("[DEBUG][PROVIDER][providing_database] Providing HomeboxDatabase.")
         return Room.databaseBuilder(
             context,
             HomeboxDatabase::class.java,
             HomeboxDatabase.DATABASE_NAME
         ).build()
     }
+    // [END_ENTITY: Function('provideHomeboxDatabase')]
 
-    // [PROVIDER]
+    // [ENTITY: Function('provideItemDao')]
+    // [RELATION: Function('provideItemDao')] -> [PROVIDES] -> [Interface('ItemDao')]
     @Provides
     fun provideItemDao(database: HomeboxDatabase) = database.itemDao()
+    // [END_ENTITY: Function('provideItemDao')]
 
-    // [PROVIDER]
+    // [ENTITY: Function('provideLabelDao')]
+    // [RELATION: Function('provideLabelDao')] -> [PROVIDES] -> [Interface('LabelDao')]
     @Provides
     fun provideLabelDao(database: HomeboxDatabase) = database.labelDao()
+    // [END_ENTITY: Function('provideLabelDao')]
 
-    // [PROVIDER]
+    // [ENTITY: Function('provideLocationDao')]
+    // [RELATION: Function('provideLocationDao')] -> [PROVIDES] -> [Interface('LocationDao')]
     @Provides
     fun provideLocationDao(database: HomeboxDatabase) = database.locationDao()
+    // [END_ENTITY: Function('provideLocationDao')]
 }
+// [END_ENTITY: Module('DatabaseModule')]
 
 // [END_FILE_DatabaseModule.kt]

data/src/main/java/com/homebox/lens/data/di/RepositoryModule.kt

@@ -1,32 +1,67 @@
 // [PACKAGE] com.homebox.lens.data.di
 // [FILE] RepositoryModule.kt
+// [SEMANTICS] dependency_injection, hilt, module, binding
 
 package com.homebox.lens.data.di
 
-import com.homebox.lens.data.api.HomeboxApiService
+// [IMPORTS]
+import com.homebox.lens.data.repository.AuthRepositoryImpl
+import com.homebox.lens.data.repository.CredentialsRepositoryImpl
 import com.homebox.lens.data.repository.ItemRepositoryImpl
+import com.homebox.lens.domain.repository.AuthRepository
+import com.homebox.lens.domain.repository.CredentialsRepository
 import com.homebox.lens.domain.repository.ItemRepository
+import dagger.Binds
 import dagger.Module
-import dagger.Provides
 import dagger.hilt.InstallIn
 import dagger.hilt.components.SingletonComponent
 import javax.inject.Singleton
+// [END_IMPORTS]
 
-// [CONTRACT]
+// [ENTITY: Module('RepositoryModule')]
 /**
- * [MODULE: DaggerHilt('RepositoryModule')]
+ * @summary Hilt-модуль для предоставления реализаций репозиториев.
- * [PURPOSE] Предоставляет реализацию для интерфейса ItemRepository.
+ * @description Использует `@Binds` для эффективного связывания интерфейсов с их реализациями.
  */
 @Module
 @InstallIn(SingletonComponent::class)
-object RepositoryModule {
+abstract class RepositoryModule {
 
-    // [PROVIDER]
+    // [ENTITY: Function('bindItemRepository')]
-    @Provides
+    // [RELATION: Function('bindItemRepository')] -> [PROVIDES] -> [Interface('ItemRepository')]
+    /**
+     * @summary Связывает интерфейс ItemRepository с его реализацией.
+     */
+    @Binds
     @Singleton
-    fun provideItemRepository(apiService: HomeboxApiService): ItemRepository {
+    abstract fun bindItemRepository(
-        return ItemRepositoryImpl(apiService)
+        itemRepositoryImpl: ItemRepositoryImpl
-    }
+    ): ItemRepository
-}
+    // [END_ENTITY: Function('bindItemRepository')]
 
-// [END_FILE_RepositoryModule.kt]
+    // [ENTITY: Function('bindCredentialsRepository')]
+    // [RELATION: Function('bindCredentialsRepository')] -> [PROVIDES] -> [Interface('CredentialsRepository')]
+    /**
+     * @summary Связывает интерфейс CredentialsRepository с его реализацией.
+     */
+    @Binds
+    @Singleton
+    abstract fun bindCredentialsRepository(
+        credentialsRepositoryImpl: CredentialsRepositoryImpl
+    ): CredentialsRepository
+    // [END_ENTITY: Function('bindCredentialsRepository')]
+
+    // [ENTITY: Function('bindAuthRepository')]
+    // [RELATION: Function('bindAuthRepository')] -> [PROVIDES] -> [Interface('AuthRepository')]
+    /**
+     * @summary Связывает интерфейс AuthRepository с его реализацией.
+     */
+    @Binds
+    @Singleton
+    abstract fun bindAuthRepository(
+        authRepositoryImpl: AuthRepositoryImpl
+    ): AuthRepository
+    // [END_ENTITY: Function('bindAuthRepository')]
+}
+// [END_ENTITY: Module('RepositoryModule')]
+// [END_FILE_RepositoryModule.kt]

data/src/main/java/com/homebox/lens/data/di/StorageModule.kt

@@ -0,0 +1,51 @@
+// [PACKAGE] com.homebox.lens.data.di
+// [FILE] StorageModule.kt
+// [SEMANTICS] di, hilt, storage
+package com.homebox.lens.data.di
+
+// [IMPORTS]
+import android.content.Context
+import android.content.SharedPreferences
+import com.homebox.lens.data.repository.EncryptedPreferencesWrapper
+import com.homebox.lens.data.security.CryptoManager
+import dagger.Module
+import dagger.Provides
+import dagger.hilt.InstallIn
+import dagger.hilt.android.qualifiers.ApplicationContext
+import dagger.hilt.components.SingletonComponent
+import timber.log.Timber
+import javax.inject.Singleton
+// [END_IMPORTS]
+
+// [ENTITY: Module('StorageModule')]
+@Module
+@InstallIn(SingletonComponent::class)
+object StorageModule {
+
+    private const val PREFERENCES_FILE_NAME = "homebox_lens_prefs"
+
+    // [ENTITY: Function('provideSharedPreferences')]
+    // [RELATION: Function('provideSharedPreferences')] -> [PROVIDES] -> [Framework('SharedPreferences')]
+    @Provides
+    @Singleton
+    fun provideSharedPreferences(@ApplicationContext context: Context): SharedPreferences {
+        Timber.d("[DEBUG][PROVIDER][providing_shared_preferences] Providing SharedPreferences.")
+        return context.getSharedPreferences(PREFERENCES_FILE_NAME, Context.MODE_PRIVATE)
+    }
+    // [END_ENTITY: Function('provideSharedPreferences')]
+
+    // [ENTITY: Function('provideEncryptedPreferencesWrapper')]
+    // [RELATION: Function('provideEncryptedPreferencesWrapper')] -> [PROVIDES] -> [Class('EncryptedPreferencesWrapper')]
+    @Provides
+    @Singleton
+    fun provideEncryptedPreferencesWrapper(
+        sharedPreferences: SharedPreferences,
+        cryptoManager: CryptoManager
+    ): EncryptedPreferencesWrapper {
+        Timber.d("[DEBUG][PROVIDER][providing_encrypted_prefs_wrapper] Providing EncryptedPreferencesWrapper.")
+        return EncryptedPreferencesWrapper(sharedPreferences, cryptoManager)
+    }
+    // [END_ENTITY: Function('provideEncryptedPreferencesWrapper')]
+}
+// [END_ENTITY: Module('StorageModule')]
+// [END_FILE_StorageModule.kt]

data/src/main/java/com/homebox/lens/data/repository/AuthRepositoryImpl.kt

@@ -0,0 +1,97 @@
+// [PACKAGE] com.homebox.lens.data.repository
+// [FILE] AuthRepositoryImpl.kt
+// [SEMANTICS] data_implementation, authentication, repository
+
+package com.homebox.lens.data.repository
+
+// [IMPORTS]
+import android.content.SharedPreferences
+import com.homebox.lens.data.api.HomeboxApiService
+import com.homebox.lens.data.api.dto.LoginFormDto
+import com.homebox.lens.data.api.mapper.toDomain
+import com.homebox.lens.domain.model.Credentials
+import com.homebox.lens.domain.model.TokenResponse
+import com.homebox.lens.domain.repository.AuthRepository
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.flow.Flow
+import kotlinx.coroutines.flow.flow
+import kotlinx.coroutines.flow.flowOn
+import kotlinx.coroutines.withContext
+import okhttp3.OkHttpClient
+import retrofit2.Retrofit
+import retrofit2.converter.moshi.MoshiConverterFactory
+import timber.log.Timber
+import javax.inject.Inject
+// [END_IMPORTS]
+
+// [ENTITY: Class('AuthRepositoryImpl')]
+// [RELATION: Class('AuthRepositoryImpl')] -> [IMPLEMENTS] -> [Interface('AuthRepository')]
+// [RELATION: Class('AuthRepositoryImpl')] -> [DEPENDS_ON] -> [Framework('SharedPreferences')]
+// [RELATION: Class('AuthRepositoryImpl')] -> [DEPENDS_ON] -> [Framework('OkHttpClient')]
+// [RELATION: Class('AuthRepositoryImpl')] -> [DEPENDS_ON] -> [Framework('MoshiConverterFactory')]
+/**
+ * @summary Реализация репозитория для управления аутентификацией.
+ * @param encryptedPrefs Защищенное хранилище для токена.
+ * @param okHttpClient Общий OkHttp клиент для переиспользования.
+ * @param moshiConverterFactory Общий конвертер Moshi для переиспользования.
+ */
+class AuthRepositoryImpl @Inject constructor(
+    private val encryptedPrefs: SharedPreferences,
+    private val okHttpClient: OkHttpClient,
+    private val moshiConverterFactory: MoshiConverterFactory
+) : AuthRepository {
+
+    companion object {
+        private const val KEY_AUTH_TOKEN = "key_auth_token"
+    }
+
+    // [ENTITY: Function('login')]
+    /**
+     * @summary Реализует вход пользователя. Создает временный API сервис для выполнения запроса
+     * на указанный пользователем URL сервера.
+     * @param credentials Учетные данные пользователя, включая URL сервера.
+     * @return [Result] с доменной моделью [TokenResponse] при успехе или [Exception] при ошибке.
+     */
+    override suspend fun login(credentials: Credentials): Result<TokenResponse> {
+        require(credentials.serverUrl.isNotBlank()) { "Server URL cannot be blank." }
+
+        return withContext(Dispatchers.IO) {
+            runCatching {
+                Timber.d("[DEBUG][ACTION][creating_retrofit_client] Creating temporary Retrofit client for URL: ${credentials.serverUrl}")
+                val tempApiService = Retrofit.Builder()
+                    .baseUrl(credentials.serverUrl)
+                    .client(okHttpClient)
+                    .addConverterFactory(moshiConverterFactory)
+                    .build()
+                    .create(HomeboxApiService::class.java)
+
+                val loginForm = LoginFormDto(credentials.username, credentials.password)
+                Timber.d("[DEBUG][ACTION][performing_login] Performing login request.")
+                val tokenResponseDto = tempApiService.login(loginForm)
+
+                Timber.d("[DEBUG][ACTION][mapping_to_domain] Mapping token response to domain model.")
+                tokenResponseDto.toDomain()
+            }
+        }
+    }
+    // [END_ENTITY: Function('login')]
+
+    // [ENTITY: Function('saveToken')]
+    override suspend fun saveToken(token: String) {
+        require(token.isNotBlank()) { "Token cannot be blank." }
+        withContext(Dispatchers.IO) {
+            Timber.d("[DEBUG][ACTION][saving_token] Saving auth token.")
+            encryptedPrefs.edit().putString(KEY_AUTH_TOKEN, token).apply()
+        }
+    }
+    // [END_ENTITY: Function('saveToken')]
+
+    // [ENTITY: Function('getToken')]
+    override fun getToken(): Flow<String?> = flow {
+        Timber.d("[DEBUG][ACTION][getting_token] Getting auth token.")
+        emit(encryptedPrefs.getString(KEY_AUTH_TOKEN, null))
+    }.flowOn(Dispatchers.IO)
+    // [END_ENTITY: Function('getToken')]
+}
+// [END_ENTITY: Class('AuthRepositoryImpl')]
+// [END_FILE_AuthRepositoryImpl.kt]

data/src/main/java/com/homebox/lens/data/repository/CredentialsRepositoryImpl.kt

@@ -0,0 +1,108 @@
+// [PACKAGE] com.homebox.lens.data.repository
+// [FILE] CredentialsRepositoryImpl.kt
+// [SEMANTICS] data, repository, credentials, security
+package com.homebox.lens.data.repository
+
+// [IMPORTS]
+import android.content.SharedPreferences
+import com.homebox.lens.domain.model.Credentials
+import com.homebox.lens.domain.repository.CredentialsRepository
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.flow.Flow
+import kotlinx.coroutines.flow.flow
+import kotlinx.coroutines.flow.flowOn
+import kotlinx.coroutines.withContext
+import timber.log.Timber
+import javax.inject.Inject
+// [END_IMPORTS]
+
+// [ENTITY: Class('CredentialsRepositoryImpl')]
+// [RELATION: Class('CredentialsRepositoryImpl')] -> [IMPLEMENTS] -> [Interface('CredentialsRepository')]
+// [RELATION: Class('CredentialsRepositoryImpl')] -> [DEPENDS_ON] -> [Framework('SharedPreferences')]
+/**
+ * @summary Реализует репозиторий для управления учетными данными пользователя.
+ * @description Взаимодействует с зашифрованными SharedPreferences для сохранения и извлечения данных.
+ * @param encryptedPrefs Зашифрованное хранилище ключ-значение, предоставляемое Hilt.
+ * @invariant Состояние этого репозитория полностью зависит от содержимого `encryptedPrefs`.
+ */
+class CredentialsRepositoryImpl @Inject constructor(
+    private val encryptedPrefs: SharedPreferences
+) : CredentialsRepository {
+
+    companion object {
+        private const val KEY_SERVER_URL = "key_server_url"
+        private const val KEY_USERNAME = "key_username"
+        private const val KEY_PASSWORD = "key_password"
+        private const val KEY_AUTH_TOKEN = "key_auth_token"
+    }
+
+    // [ENTITY: Function('saveCredentials')]
+    /**
+     * @summary Сохраняет основные учетные данные пользователя.
+     * @param credentials Объект с учетными данными для сохранения.
+     * @sideeffect Перезаписывает существующие учетные данные в SharedPreferences.
+     */
+    override suspend fun saveCredentials(credentials: Credentials) {
+        withContext(Dispatchers.IO) {
+            Timber.d("[DEBUG][ACTION][saving_credentials] Saving user credentials.")
+            encryptedPrefs.edit()
+                .putString(KEY_SERVER_URL, credentials.serverUrl)
+                .putString(KEY_USERNAME, credentials.username)
+                .putString(KEY_PASSWORD, credentials.password)
+                .apply()
+        }
+    }
+    // [END_ENTITY: Function('saveCredentials')]
+
+    // [ENTITY: Function('getCredentials')]
+    /**
+     * @summary Извлекает сохраненные учетные данные пользователя в виде потока.
+     * @return Flow, который эммитит объект [Credentials] или null, если данные отсутствуют.
+     */
+    override fun getCredentials(): Flow<Credentials?> = flow {
+        Timber.d("[DEBUG][ACTION][getting_credentials] Getting user credentials.")
+        val serverUrl = encryptedPrefs.getString(KEY_SERVER_URL, null)
+        val username = encryptedPrefs.getString(KEY_USERNAME, null)
+        val password = encryptedPrefs.getString(KEY_PASSWORD, null)
+
+        if (serverUrl != null && username != null && password != null) {
+            Timber.d("[DEBUG][SUCCESS][credentials_found] Found and emitting credentials.")
+            emit(Credentials(serverUrl, username, password))
+        } else {
+            Timber.d("[DEBUG][FALLBACK][no_credentials] No credentials found, emitting null.")
+            emit(null)
+        }
+    }.flowOn(Dispatchers.IO)
+    // [END_ENTITY: Function('getCredentials')]
+
+    // [ENTITY: Function('saveToken')]
+    /**
+     * @summary Сохраняет токен авторизации.
+     * @param token Токен для сохранения.
+     * @sideeffect Перезаписывает существующий токен в SharedPreferences.
+     */
+    override suspend fun saveToken(token: String) {
+        withContext(Dispatchers.IO) {
+            Timber.d("[DEBUG][ACTION][saving_token] Saving auth token.")
+            encryptedPrefs.edit()
+                .putString(KEY_AUTH_TOKEN, token)
+                .apply()
+        }
+    }
+    // [END_ENTITY: Function('saveToken')]
+
+    // [ENTITY: Function('getToken')]
+    /**
+     * @summary Извлекает сохраненный токен авторизации.
+     * @return Строка с токеном или null, если он не найден.
+     */
+    override suspend fun getToken(): String? {
+        return withContext(Dispatchers.IO) {
+            Timber.d("[DEBUG][ACTION][getting_token] Getting auth token.")
+            encryptedPrefs.getString(KEY_AUTH_TOKEN, null)
+        }
+    }
+    // [END_ENTITY: Function('getToken')]
+}
+// [END_ENTITY: Class('CredentialsRepositoryImpl')]
+// [END_FILE_CredentialsRepositoryImpl.kt]

data/src/main/java/com/homebox/lens/data/repository/EncryptedPreferencesWrapper.kt

@@ -0,0 +1,84 @@
+// [PACKAGE] com.homebox.lens.data.repository
+// [FILE] EncryptedPreferencesWrapper.kt
+// [SEMANTICS] data, security, preferences
+package com.homebox.lens.data.repository
+
+// [IMPORTS]
+import android.content.SharedPreferences
+import com.homebox.lens.data.security.CryptoManager
+import timber.log.Timber
+import java.io.ByteArrayInputStream
+import java.io.ByteArrayOutputStream
+import java.nio.charset.Charset
+import javax.inject.Inject
+// [END_IMPORTS]
+
+// [ENTITY: Class('EncryptedPreferencesWrapper')]
+// [RELATION: Class('EncryptedPreferencesWrapper')] -> [DEPENDS_ON] -> [Framework('SharedPreferences')]
+// [RELATION: Class('EncryptedPreferencesWrapper')] -> [DEPENDS_ON] -> [Class('CryptoManager')]
+/**
+ * @summary Provides a simplified and secure interface for storing and retrieving sensitive string data.
+ * @description It uses a CryptoManager to encrypt/decrypt data before writing/reading from a standard SharedPreferences instance.
+ * @param sharedPreferences The underlying standard SharedPreferences instance to store encrypted data.
+ * @param cryptoManager The manager responsible for all cryptographic operations.
+ */
+class EncryptedPreferencesWrapper @Inject constructor(
+    private val sharedPreferences: SharedPreferences,
+    private val cryptoManager: CryptoManager
+) {
+
+    // [ENTITY: Function('getString')]
+    /**
+     * @summary Retrieves a decrypted string value for a given key.
+     * @param key The key for the preference.
+     * @param defaultValue The value to return if the key is not found or decryption fails.
+     * @return The decrypted string, or the defaultValue.
+     * @sideeffect Reads from SharedPreferences.
+     */
+    fun getString(key: String, defaultValue: String?): String? {
+        Timber.d("[DEBUG][ENTRYPOINT][getting_string] Attempting to get string for key: %s", key)
+        val encryptedValue = sharedPreferences.getString(key, null) ?: return defaultValue.also {
+            Timber.d("[DEBUG][FALLBACK][no_value_found] No value for key %s, returning default.", key)
+        }
+        return try {
+            Timber.d("[DEBUG][ACTION][decoding_value] Decoding Base64 value.")
+            val bytes = android.util.Base64.decode(encryptedValue, android.util.Base64.DEFAULT)
+            Timber.d("[DEBUG][ACTION][decrypting_value] Decrypting value with CryptoManager.")
+            val decryptedBytes = cryptoManager.decrypt(ByteArrayInputStream(bytes))
+            String(decryptedBytes, Charset.defaultCharset()).also {
+                Timber.d("[DEBUG][SUCCESS][decryption_complete] Successfully decrypted value for key: %s", key)
+            }
+        } catch (e: Exception) {
+            Timber.e(e, "[ERROR][EXCEPTION][decryption_failed] Failed to decrypt value for key: %s", key)
+            defaultValue
+        }
+    }
+    // [END_ENTITY: Function('getString')]
+
+    // [ENTITY: Function('putString')]
+    /**
+     * @summary Encrypts and saves a string value for a given key.
+     * @param key The key for the preference.
+     * @param value The string value to encrypt and save.
+     * @sideeffect Modifies the underlying SharedPreferences file.
+     */
+    fun putString(key: String, value: String) {
+        Timber.d("[DEBUG][ENTRYPOINT][putting_string] Attempting to put string for key: %s", key)
+        try {
+            Timber.d("[DEBUG][ACTION][encrypting_value] Encrypting value with CryptoManager.")
+            val outputStream = ByteArrayOutputStream()
+            cryptoManager.encrypt(value.toByteArray(Charset.defaultCharset()), outputStream)
+            val encryptedBytes = outputStream.toByteArray()
+            Timber.d("[DEBUG][ACTION][encoding_value] Encoding encrypted value to Base64.")
+            val encryptedValue = android.util.Base64.encodeToString(encryptedBytes, android.util.Base64.DEFAULT)
+            Timber.d("[DEBUG][ACTION][writing_to_prefs] Writing encrypted value to SharedPreferences.")
+            sharedPreferences.edit().putString(key, encryptedValue).apply()
+            Timber.d("[DEBUG][SUCCESS][encryption_complete] Successfully encrypted and saved value for key: %s", key)
+        } catch (e: Exception) {
+            Timber.e(e, "[ERROR][EXCEPTION][encryption_failed] Failed to encrypt and save value for key: %s", key)
+        }
+    }
+    // [END_ENTITY: Function('putString')]
+}
+// [END_ENTITY: Class('EncryptedPreferencesWrapper')]
+// [END_FILE_EncryptedPreferencesWrapper.kt]

data/src/main/java/com/homebox/lens/data/repository/ItemRepositoryImpl.kt

@@ -1,107 +1,196 @@
 // [PACKAGE] com.homebox.lens.data.repository
 // [FILE] ItemRepositoryImpl.kt
-// [SEMANTICS] data_repository, implementation, network
+// [SEMANTICS] data_repository, implementation, items, labels
 package com.homebox.lens.data.repository
+
 // [IMPORTS]
 import com.homebox.lens.data.api.HomeboxApiService
+import com.homebox.lens.data.api.dto.LabelCreateDto
 import com.homebox.lens.data.api.dto.toDomain
 import com.homebox.lens.data.api.dto.toDto
+import com.homebox.lens.data.api.dto.LocationCreateDto
+import com.homebox.lens.data.api.dto.LocationUpdateDto
+import com.homebox.lens.data.api.dto.LabelUpdateDto
+import com.homebox.lens.data.api.dto.LocationOutDto
+import com.homebox.lens.data.db.dao.ItemDao
+import com.homebox.lens.data.db.dao.LabelDao
+import com.homebox.lens.data.db.entity.toDomain
 import com.homebox.lens.domain.model.*
 import com.homebox.lens.domain.repository.ItemRepository
+import kotlinx.coroutines.flow.Flow
+import kotlinx.coroutines.flow.map
 import javax.inject.Inject
 import javax.inject.Singleton
+// [END_IMPORTS]
 
-// [CORE-LOGIC]
+// [ENTITY: Repository('ItemRepositoryImpl')]
-/**
+// [RELATION: Repository('ItemRepositoryImpl')] -> [IMPLEMENTS] -> [Interface('ItemRepository')]
- * [CONTRACT]
+// [RELATION: Repository('ItemRepositoryImpl')] -> [DEPENDS_ON] -> [ApiEndpoint('HomeboxApiService')]
- * Реализация репозитория для работы с данными о вещах.
+// [RELATION: Repository('ItemRepositoryImpl')] -> [DEPENDS_ON] -> [DatabaseTable('ItemDao')]
- * @param apiService Сервис для взаимодействия с Homebox API.
- */
 @Singleton
 class ItemRepositoryImpl @Inject constructor(
-    private val apiService: HomeboxApiService
+    private val apiService: HomeboxApiService,
+    private val itemDao: ItemDao,
+    private val labelDao: LabelDao
 ) : ItemRepository {
 
-    /**
+    // [ENTITY: Function('createItem')]
-     * [CONTRACT] @see ItemRepository.createItem
+    // [RELATION: Function('createItem')] -> [RETURNS] -> [DataClass('ItemSummary')]
-     */
     override suspend fun createItem(newItemData: ItemCreate): ItemSummary {
-        // [ACTION]
         val itemDto = newItemData.toDto()
         val resultDto = apiService.createItem(itemDto)
         return resultDto.toDomain()
     }
+    // [END_ENTITY: Function('createItem')]
 
-    /**
+    // [ENTITY: Function('getItemDetails')]
-     * [CONTRACT] @see ItemRepository.getItemDetails
+    // [RELATION: Function('getItemDetails')] -> [RETURNS] -> [DataClass('ItemOut')]
-     */
     override suspend fun getItemDetails(itemId: String): ItemOut {
-        // [ACTION]
         val resultDto = apiService.getItem(itemId)
         return resultDto.toDomain()
     }
+    // [END_ENTITY: Function('getItemDetails')]
 
-    /**
+    // [ENTITY: Function('updateItem')]
-     * [CONTRACT] @see ItemRepository.updateItem
+    // [RELATION: Function('updateItem')] -> [RETURNS] -> [DataClass('ItemOut')]
-     */
     override suspend fun updateItem(itemId: String, item: ItemUpdate): ItemOut {
-        // [ACTION]
         val itemDto = item.toDto()
         val resultDto = apiService.updateItem(itemId, itemDto)
         return resultDto.toDomain()
     }
+    // [END_ENTITY: Function('updateItem')]
 
-    /**
+    // [ENTITY: Function('deleteItem')]
-     * [CONTRACT] @see ItemRepository.deleteItem
-     */
     override suspend fun deleteItem(itemId: String) {
-        // [ACTION]
         apiService.deleteItem(itemId)
     }
+    // [END_ENTITY: Function('deleteItem')]
 
-    /**
+    // [ENTITY: Function('syncInventory')]
-     * [CONTRACT] @see ItemRepository.syncInventory
+    // [RELATION: Function('syncInventory')] -> [RETURNS] -> [DataClass('PaginationResult<ItemSummary>')]
-     */
     override suspend fun syncInventory(page: Int, pageSize: Int): PaginationResult<ItemSummary> {
-        // [ACTION]
         val resultDto = apiService.getItems(page = page, pageSize = pageSize)
         return resultDto.toDomain { it.toDomain() }
     }
+    // [END_ENTITY: Function('syncInventory')]
 
-    /**
+    // [ENTITY: Function('getStatistics')]
-     * [CONTRACT] @see ItemRepository.getStatistics
+    // [RELATION: Function('getStatistics')] -> [RETURNS] -> [DataClass('GroupStatistics')]
-     */
     override suspend fun getStatistics(): GroupStatistics {
-        // [ACTION]
         val resultDto = apiService.getStatistics()
         return resultDto.toDomain()
     }
+    // [END_ENTITY: Function('getStatistics')]
 
-    /**
+    // [ENTITY: Function('getAllLocations')]
-     * [CONTRACT] @see ItemRepository.getAllLocations
+    // [RELATION: Function('getAllLocations')] -> [RETURNS] -> [DataStructure('List<LocationOutCount>')]
-     */
     override suspend fun getAllLocations(): List<LocationOutCount> {
-        // [ACTION]
         val resultDto = apiService.getLocations()
         return resultDto.map { it.toDomain() }
     }
+    // [END_ENTITY: Function('getAllLocations')]
 
-    /**
+    // [ENTITY: Function('getAllLabels')]
-     * [CONTRACT] @see ItemRepository.getAllLabels
+    // [RELATION: Function('getAllLabels')] -> [RETURNS] -> [DataStructure('List<LabelOut>')]
-     */
     override suspend fun getAllLabels(): List<LabelOut> {
-        // [ACTION]
         val resultDto = apiService.getLabels()
         return resultDto.map { it.toDomain() }
     }
+    // [END_ENTITY: Function('getAllLabels')]
 
-    /**
+    // [ENTITY: Function('getLabelDetails')]
-     * [CONTRACT] @see ItemRepository.searchItems
+    // [RELATION: Function('getLabelDetails')] -> [RETURNS] -> [DataClass('LabelOut')]
-     */
+    override suspend fun getLabelDetails(labelId: String): LabelOut {
+        val resultDto = apiService.getLabels().firstOrNull { it.id == labelId }
+        return resultDto?.toDomain() ?: throw NoSuchElementException("Label with ID $labelId not found.")
+    }
+    // [END_ENTITY: Function('getLabelDetails')]
+
+    // [ENTITY: Function('createLabel')]
+    // [RELATION: Function('createLabel')] -> [RETURNS] -> [DataClass('LabelSummary')]
+    override suspend fun createLabel(newLabelData: LabelCreate): LabelSummary {
+        val labelCreateDto = newLabelData.toDto()
+        val resultDto = apiService.createLabel(labelCreateDto)
+        return resultDto.toDomain()
+    }
+    // [END_ENTITY: Function('createLabel')]
+
+    override suspend fun updateLabel(labelId: String, labelData: LabelUpdate): LabelOut {
+        val labelDto = labelData.toDto()
+        val resultDto = apiService.updateLabel(labelId, labelDto)
+        return resultDto.toDomain()
+    }
+
+    override suspend fun deleteLabel(labelId: String) {
+        apiService.deleteLabel(labelId)
+        labelDao.deleteLabelById(labelId)
+    }
+
+    override suspend fun createLocation(newLocationData: LocationCreate): LocationOut {
+        val locationDto = newLocationData.toDto()
+        val resultDto = apiService.createLocation(locationDto)
+        return resultDto.toDomain()
+    }
+
+    override suspend fun updateLocation(locationId: String, locationData: LocationUpdate): LocationOut {
+        val locationDto = locationData.toDto()
+        val resultDto = apiService.updateLocation(locationId, locationDto)
+        return resultDto.toDomain()
+    }
+
+    override suspend fun deleteLocation(locationId: String) {
+        apiService.deleteLocation(locationId)
+    }
+
+    // [ENTITY: Function('searchItems')]
+    // [RELATION: Function('searchItems')] -> [RETURNS] -> [DataClass('PaginationResult<ItemSummary>')]
     override suspend fun searchItems(query: String): PaginationResult<ItemSummary> {
-        // [ACTION]
         val resultDto = apiService.getItems(query = query)
         return resultDto.toDomain { it.toDomain() }
     }
+    // [END_ENTITY: Function('searchItems')]
+
+    // [ENTITY: Function('getRecentlyAddedItems')]
+    // [RELATION: Function('getRecentlyAddedItems')] -> [RETURNS] -> [DataStructure('Flow<List<ItemSummary>>')]
+    override fun getRecentlyAddedItems(limit: Int): Flow<List<ItemSummary>> {
+        return itemDao.getRecentlyAddedItems(limit).map { entities ->
+            entities.map { it.toDomain() }
+        }
+    }
+    // [END_ENTITY: Function('getRecentlyAddedItems')]
 }
+// [END_ENTITY: Repository('ItemRepositoryImpl')]
+
+// [ENTITY: Function('toDto')]
+// [RELATION: Function('toDto')] -> [RETURNS] -> [DataClass('LabelCreateDto')]
+private fun LabelCreate.toDto(): LabelCreateDto {
+    return LabelCreateDto(
+        name = this.name,
+        color = this.color,
+        description = null // Description is not part of the domain model for creation.
+    )
+}
+// [END_ENTITY: Function('toDto')]
+
+// [ENTITY: Function('toDto')]
+// [RELATION: Function('toDto')] -> [RETURNS] -> [DataClass('LocationCreateDto')]
+private fun LocationCreate.toDto(): LocationCreateDto {
+    return LocationCreateDto(
+        name = this.name,
+        color = this.color,
+        description = null // Description is not part of the domain model for creation.
+    )
+}
+// [END_ENTITY: Function('toDto')]
+
+// [ENTITY: Function('toDto')]
+// [RELATION: Function('toDto')] -> [RETURNS] -> [DataClass('LabelUpdateDto')]
+private fun LabelUpdate.toDto(): LabelUpdateDto {
+    return LabelUpdateDto(
+        name = this.name,
+        color = this.color
+    )
+}
+// [END_ENTITY: Function('toDto')]
+
 // [END_FILE_ItemRepositoryImpl.kt]

data/src/main/java/com/homebox/lens/data/security/CryptoManager.kt

@@ -0,0 +1,122 @@
+// [PACKAGE] com.homebox.lens.data.security
+// [FILE] CryptoManager.kt
+// [SEMANTICS] data, security, cryptography
+package com.homebox.lens.data.security
+
+// [IMPORTS]
+import android.os.Build
+import android.security.keystore.KeyGenParameterSpec
+import android.security.keystore.KeyProperties
+import androidx.annotation.RequiresApi
+import timber.log.Timber
+import java.io.InputStream
+import java.io.OutputStream
+import java.security.KeyStore
+import javax.crypto.Cipher
+import javax.crypto.KeyGenerator
+import javax.crypto.SecretKey
+import javax.crypto.spec.IvParameterSpec
+import javax.inject.Inject
+import javax.inject.Singleton
+// [END_IMPORTS]
+
+// [ENTITY: Class('CryptoManager')]
+/**
+ * @summary A manager for handling encryption and decryption using the Android Keystore system.
+ * @description This class ensures that cryptographic keys are stored securely.
+ * It is designed to be a Singleton provided by Hilt.
+ * @invariant The underlying SecretKey must be valid within the AndroidKeyStore.
+ */
+@RequiresApi(Build.VERSION_CODES.M)
+@Singleton
+class CryptoManager @Inject constructor() {
+
+    private val keyStore = KeyStore.getInstance("AndroidKeyStore").apply {
+        load(null)
+    }
+
+    private val encryptCipher
+        get() = Cipher.getInstance(TRANSFORMATION).apply {
+            init(Cipher.ENCRYPT_MODE, getKey())
+        }
+
+    private fun getDecryptCipherForIv(iv: ByteArray): Cipher {
+        return Cipher.getInstance(TRANSFORMATION).apply {
+            init(Cipher.DECRYPT_MODE, getKey(), IvParameterSpec(iv))
+        }
+    }
+
+    private fun getKey(): SecretKey {
+        val existingKey = keyStore.getEntry(ALIAS, null) as? KeyStore.SecretKeyEntry
+        return existingKey?.secretKey ?: createKey()
+    }
+
+    private fun createKey(): SecretKey {
+        return KeyGenerator.getInstance(ALGORITHM).apply {
+            init(
+                KeyGenParameterSpec.Builder(
+                    ALIAS,
+                    KeyProperties.PURPOSE_ENCRYPT or KeyProperties.PURPOSE_DECRYPT
+                )
+                    .setBlockModes(BLOCK_MODE)
+                    .setEncryptionPaddings(PADDING)
+                    .setUserAuthenticationRequired(false)
+                    .setRandomizedEncryptionRequired(true)
+                    .build()
+            )
+        }.generateKey()
+    }
+
+    // [ENTITY: Function('encrypt')]
+    /**
+     * @summary Encrypts a byte array and writes it to an output stream.
+     * @param bytes The byte array to encrypt.
+     * @param outputStream The stream to write the encrypted data to.
+     * @return The encrypted byte array.
+     */
+    fun encrypt(bytes: ByteArray, outputStream: OutputStream): ByteArray {
+        Timber.d("[DEBUG][ACTION][encrypting_data] Encrypting data.")
+        val cipher = encryptCipher
+        val encryptedBytes = cipher.doFinal(bytes)
+        outputStream.use {
+            it.write(cipher.iv.size)
+            it.write(cipher.iv)
+            it.write(encryptedBytes.size)
+            it.write(encryptedBytes)
+        }
+        return encryptedBytes
+    }
+    // [END_ENTITY: Function('encrypt')]
+
+    // [ENTITY: Function('decrypt')]
+    /**
+     * @summary Decrypts a byte array from an input stream.
+     * @param inputStream The stream to read the encrypted data from.
+     * @return The decrypted byte array.
+     */
+    fun decrypt(inputStream: InputStream): ByteArray {
+        Timber.d("[DEBUG][ACTION][decrypting_data] Decrypting data.")
+        return inputStream.use {
+            val ivSize = it.read()
+            val iv = ByteArray(ivSize)
+            it.read(iv)
+
+            val encryptedBytesSize = it.read()
+            val encryptedBytes = ByteArray(encryptedBytesSize)
+            it.read(encryptedBytes)
+
+            getDecryptCipherForIv(iv).doFinal(encryptedBytes)
+        }
+    }
+    // [END_ENTITY: Function('decrypt')]
+
+    companion object {
+        private const val ALGORITHM = KeyProperties.KEY_ALGORITHM_AES
+        private const val BLOCK_MODE = KeyProperties.BLOCK_MODE_CBC
+        private const val PADDING = KeyProperties.ENCRYPTION_PADDING_PKCS7
+        private const val TRANSFORMATION = "$ALGORITHM/$BLOCK_MODE/$PADDING"
+        private const val ALIAS = "homebox_lens_secret_key"
+    }
+}
+// [END_ENTITY: Class('CryptoManager')]
+// [END_FILE_CryptoManager.kt]

domain/build.gradle.kts

@@ -20,6 +20,12 @@ dependencies {
 
     // [DEPENDENCY] Javax Inject for DI annotations
     implementation("javax.inject:javax.inject:1")
+
+    // [DEPENDENCY] Testing
+    testImplementation(Libs.junit)
+    testImplementation(Libs.kotestRunnerJunit5)
+    testImplementation(Libs.kotestAssertionsCore)
+    testImplementation(Libs.mockk)
 }
 
 // [END_FILE_domain/build.gradle.kts]

domain/src/main/java/com/homebox/lens/domain/model/Credentials.kt

@@ -0,0 +1,19 @@
+// [PACKAGE] com.homebox.lens.domain.model
+// [FILE] Credentials.kt
+// [SEMANTICS] domain, model, credentials
+package com.homebox.lens.domain.model
+
+// [ENTITY: DataClass('Credentials')]
+/**
+ * @summary Data class to hold server credentials.
+ * @param serverUrl The URL of the Homebox server.
+ * @param username The username for authentication.
+ * @param password The password for authentication.
+ */
+data class Credentials(
+    val serverUrl: String,
+    val username: String,
+    val password: String
+)
+// [END_ENTITY: DataClass('Credentials')]
+// [END_FILE_Credentials.kt]

domain/src/main/java/com/homebox/lens/domain/model/CustomField.kt

@@ -2,17 +2,18 @@
 // [FILE] CustomField.kt
 // [SEMANTICS] data_structure, entity, custom_field
 package com.homebox.lens.domain.model
-// [CORE-LOGIC]
+
+// [ENTITY: DataClass('CustomField')]
 /**
- * [CONTRACT]
+ * @summary Модель данных для представления кастомного поля.
- * Модель данных для представления кастомного поля.
+ * @param name Имя поля.
- * @property name Имя поля.
+ * @param value Значение поля.
- * @property value Значение поля.
+ * @param type Тип поля (например, "text", "number").
- * @property type Тип поля (например, "text", "number").
  */
 data class CustomField(
     val name: String,
     val value: String,
     val type: String
 )
+// [END_ENTITY: DataClass('CustomField')]
 // [END_FILE_CustomField.kt]

domain/src/main/java/com/homebox/lens/domain/model/GroupStatistics.kt

@@ -2,14 +2,14 @@
 // [FILE] GroupStatistics.kt
 // [SEMANTICS] data_structure, statistics
 package com.homebox.lens.domain.model
-// [CORE-LOGIC]
+
+// [ENTITY: DataClass('GroupStatistics')]
 /**
- * [CONTRACT]
+ * @summary Модель данных для представления агрегированной статистики.
- * Модель данных для представления агрегированной статистики.
+ * @param items Общее количество вещей.
- * @property items Общее количество вещей.
+ * @param labels Общее количество меток.
- * @property labels Общее количество меток.
+ * @param locations Общее количество местоположений.
- * @property locations Общее количество местоположений.
+ * @param totalValue Общая стоимость всех вещей.
- * @property totalValue Общая стоимость всех вещей.
  */
 data class GroupStatistics(
     val items: Int,
@@ -17,4 +17,5 @@ data class GroupStatistics(
     val locations: Int,
     val totalValue: Double
 )
+// [END_ENTITY: DataClass('GroupStatistics')]
 // [END_FILE_GroupStatistics.kt]

domain/src/main/java/com/homebox/lens/domain/model/Image.kt

@@ -2,17 +2,18 @@
 // [FILE] Image.kt
 // [SEMANTICS] data_structure, entity, image
 package com.homebox.lens.domain.model
-// [CORE-LOGIC]
+
+// [ENTITY: DataClass('Image')]
 /**
- * [CONTRACT]
+ * @summary Модель данных для представления изображения, привязанного к вещи.
- * Модель данных для представления изображения, привязанного к вещи.
+ * @param id Уникальный идентификатор изображения.
- * @property id Уникальный идентификатор изображения.
+ * @param path Путь к файлу изображения.
- * @property path Путь к файлу изображения.
+ * @param isPrimary Является ли это изображение основным для вещи.
- * @property isPrimary Является ли это изображение основным для вещи.
  */
 data class Image(
     val id: String,
     val path: String,
     val isPrimary: Boolean
 )
+// [END_ENTITY: DataClass('Image')]
 // [END_FILE_Image.kt]

domain/src/main/java/com/homebox/lens/domain/model/Item.kt

@@ -1,32 +1,55 @@
 // [PACKAGE] com.homebox.lens.domain.model
 // [FILE] Item.kt
-
+// [SEMANTICS] domain, model
 package com.homebox.lens.domain.model
 
-import java.math.BigDecimal
+// [IMPORTS]
+// [END_IMPORTS]
 
-// [CONTRACT]
+// [ENTITY: DataClass('Item')]
+// [RELATION: DataClass('Item')] -> [DEPENDS_ON] -> [DataClass('Location')]
+// [RELATION: DataClass('Item')] -> [DEPENDS_ON] -> [DataClass('Label')]
 /**
- * [ENTITY: DataClass('Item')]
+ * @summary Представляет собой вещь в инвентаре.
- * [PURPOSE] Представляет собой вещь в инвентаре.
+ * @param id Уникальный идентификатор вещи.
- * @property id Уникальный идентификатор вещи.
+ * @param name Название вещи.
- * @property name Название вещи.
+ * @param description Описание вещи.
- * @property description Описание вещи.
+ * @param image Url изображения.
- * @property image Url изображения.
+ * @param location Местоположение вещи.
- * @property location Местоположение вещи.
+ * @param labels Список меток, присвоенных вещи.
- * @property labels Список меток, присвоенных вещи.
+ * @param value Стоимость вещи.
- * @property value Стоимость вещи.
+ * @param createdAt Дата создания.
- * @property createdAt Дата создания.
  */
 data class Item(
     val id: String,
     val name: String,
     val description: String?,
+    val quantity: Int,
     val image: String?,
     val location: Location?,
     val labels: List<Label>,
-    val value: BigDecimal?,
+    val value: Double?,
-    val createdAt: String?
+    val createdAt: String?,
+    val assetId: String?,
+    val notes: String?,
+    val serialNumber: String?,
+    val purchasePrice: Double?,
+    val purchaseDate: String?,
+    val warrantyUntil: String?,
+    val parentId: String?,
+    val isArchived: Boolean?,
+    val insured: Boolean?,
+    val lifetimeWarranty: Boolean?,
+    val manufacturer: String?,
+    val modelNumber: String?,
+    val purchaseFrom: String?,
+    val soldNotes: String?,
+    val soldPrice: Double?,
+    val soldTime: String?,
+    val soldTo: String?,
+    val syncChildItemsLocations: Boolean?,
+    val warrantyDetails: String?
 )
+// [END_ENTITY: DataClass('Item')]
 
 // [END_FILE_Item.kt]

domain/src/main/java/com/homebox/lens/domain/model/ItemAttachment.kt

@@ -2,16 +2,16 @@
 // [FILE] ItemAttachment.kt
 // [SEMANTICS] data_structure, entity, attachment
 package com.homebox.lens.domain.model
-// [CORE-LOGIC]
+
+// [ENTITY: DataClass('ItemAttachment')]
 /**
- * [CONTRACT]
+ * @summary Модель данных для представления вложения (файла), привязанного к вещи.
- * Модель данных для представления вложения (файла), привязанного к вещи.
+ * @param id Уникальный идентификатор вложения.
- * @property id Уникальный идентификатор вложения.
+ * @param name Имя файла.
- * @property name Имя файла.
+ * @param path Путь к файлу.
- * @property path Путь к файлу.
+ * @param type MIME-тип файла.
- * @property type MIME-тип файла.
+ * @param createdAt Дата и время создания.
- * @property createdAt Дата и время создания.
+ * @param updatedAt Дата и время последнего обновления.
- * @property updatedAt Дата и время последнего обновления.
  */
 data class ItemAttachment(
     val id: String,
@@ -21,4 +21,5 @@ data class ItemAttachment(
     val createdAt: String,
     val updatedAt: String
 )
+// [END_ENTITY: DataClass('ItemAttachment')]
 // [END_FILE_ItemAttachment.kt]

domain/src/main/java/com/homebox/lens/domain/model/ItemCreate.kt

@@ -2,23 +2,23 @@
 // [FILE] ItemCreate.kt
 // [SEMANTICS] data_structure, entity, input, create
 package com.homebox.lens.domain.model
-// [CORE-LOGIC]
+
+// [ENTITY: DataClass('ItemCreate')]
 /**
- * [CONTRACT]
+ * @summary Модель данных для создания новой "Вещи".
- * Модель данных для создания новой "Вещи".
+ * @param name Название вещи (обязательно).
- * @property name Название вещи (обязательно).
+ * @param assetId Идентификатор актива.
- * @property assetId Идентификатор актива.
+ * @param description Описание.
- * @property description Описание.
+ * @param notes Заметки.
- * @property notes Заметки.
+ * @param serialNumber Серийный номер.
- * @property serialNumber Серийный номер.
+ * @param quantity Количество.
- * @property quantity Количество.
+ * @param value Стоимость.
- * @property value Стоимость.
+ * @param purchasePrice Цена покупки.
- * @property purchasePrice Цена покупки.
+ * @param purchaseDate Дата покупки.
- * @property purchaseDate Дата покупки.
+ * @param warrantyUntil Гарантия до.
- * @property warrantyUntil Гарантия до.
+ * @param locationId ID местоположения.
- * @property locationId ID местоположения.
+ * @param parentId ID родительской вещи.
- * @property parentId ID родительской вещи.
+ * @param labelIds Список ID меток.
- * @property labelIds Список ID меток.
  */
 data class ItemCreate(
     val name: String,
@@ -35,4 +35,5 @@ data class ItemCreate(
     val parentId: String?,
     val labelIds: List<String>?
 )
+// [END_ENTITY: DataClass('ItemCreate')]
 // [END_FILE_ItemCreate.kt]

domain/src/main/java/com/homebox/lens/domain/model/ItemOut.kt

@@ -2,32 +2,32 @@
 // [FILE] ItemOut.kt
 // [SEMANTICS] data_structure, entity, detailed
 package com.homebox.lens.domain.model
-// [CORE-LOGIC]
+
+// [ENTITY: DataClass('ItemOut')]
 /**
- * [CONTRACT]
+ * @summary Полная модель данных для представления "Вещи" со всеми полями.
- * Полная модель данных для представления "Вещи" со всеми полями.
+ * @param id Уникальный идентификатор.
- * @property id Уникальный идентификатор.
+ * @param name Название.
- * @property name Название.
+ * @param assetId Идентификатор актива.
- * @property assetId Идентификатор актива.
+ * @param description Описание.
- * @property description Описание.
+ * @param notes Заметки.
- * @property notes Заметки.
+ * @param serialNumber Серийный номер.
- * @property serialNumber Серийный номер.
+ * @param quantity Количество.
- * @property quantity Количество.
+ * @param isArchived Флаг архивации.
- * @property isArchived Флаг архивации.
+ * @param value Стоимость.
- * @property value Стоимость.
+ * @param purchasePrice Цена покупки.
- * @property purchasePrice Цена покупки.
+ * @param purchaseDate Дата покупки.
- * @property purchaseDate Дата покупки.
+ * @param warrantyUntil Гарантия до.
- * @property warrantyUntil Гарантия до.
+ * @param location Местоположение.
- * @property location Местоположение.
+ * @param parent Родительская вещь (если есть).
- * @property parent Родительская вещь (если есть).
+ * @param children Дочерние вещи.
- * @property children Дочерние вещи.
+ * @param labels Список меток.
- * @property labels Список меток.
+ * @param attachments Список вложений.
- * @property attachments Список вложений.
+ * @param images Список изображений.
- * @property images Список изображений.
+ * @param fields Список кастомных полей.
- * @property fields Список кастомных полей.
+ * @param maintenance Список записей об обслуживании.
- * @property maintenance Список записей об обслуживании.
+ * @param createdAt Дата и время создания.
- * @property createdAt Дата и время создания.
+ * @param updatedAt Дата и время последнего обновления.
- * @property updatedAt Дата и время последнего обновления.
  */
 data class ItemOut(
     val id: String,
@@ -51,6 +51,18 @@ data class ItemOut(
     val fields: List<CustomField>,
     val maintenance: List<MaintenanceEntry>,
     val createdAt: String,
-    val updatedAt: String
+    val updatedAt: String,
+    val insured: Boolean?,
+    val lifetimeWarranty: Boolean?,
+    val manufacturer: String?,
+    val modelNumber: String?,
+    val purchaseFrom: String?,
+    val soldNotes: String?,
+    val soldPrice: Double?,
+    val soldTime: String?,
+    val soldTo: String?,
+    val syncChildItemsLocations: Boolean?,
+    val warrantyDetails: String?
 )
+// [END_ENTITY: DataClass('ItemOut')]
 // [END_FILE_ItemOut.kt]

domain/src/main/java/com/homebox/lens/domain/model/ItemSummary.kt

@@ -2,20 +2,20 @@
 // [FILE] ItemSummary.kt
 // [SEMANTICS] data_structure, entity, summary
 package com.homebox.lens.domain.model
-// [CORE-LOGIC]
+
+// [ENTITY: DataClass('ItemSummary')]
 /**
- * [CONTRACT]
+ * @summary Сокращенная модель данных для представления "Вещи" в списках.
- * Сокращенная модель данных для представления "Вещи" в списках.
+ * @param id Уникальный идентификатор вещи.
- * @property id Уникальный идентификатор вещи.
+ * @param name Название вещи.
- * @property name Название вещи.
+ * @param assetId Идентификатор актива.
- * @property assetId Идентификатор актива.
+ * @param image Основное изображение. Может быть null.
- * @property image Основное изображение. Может быть null.
+ * @param isArchived Флаг архивации.
- * @property isArchived Флаг архивации.
+ * @param labels Список меток.
- * @property labels Список меток.
+ * @param location Местоположение. Может быть null.
- * @property location Местоположение. Может быть null.
+ * @param value Стоимость.
- * @property value Стоимость.
+ * @param createdAt Дата и время создания.
- * @property createdAt Дата и время создания.
+ * @param updatedAt Дата и время последнего обновления.
- * @property updatedAt Дата и время последнего обновления.
  */
 data class ItemSummary(
     val id: String,
@@ -29,4 +29,5 @@ data class ItemSummary(
     val createdAt: String,
     val updatedAt: String
 )
+// [END_ENTITY: DataClass('ItemSummary')]
 // [END_FILE_ItemSummary.kt]

domain/src/main/java/com/homebox/lens/domain/model/ItemUpdate.kt

@@ -2,24 +2,24 @@
 // [FILE] ItemUpdate.kt
 // [SEMANTICS] data_structure, entity, input, update
 package com.homebox.lens.domain.model
-// [CORE-LOGIC]
+
+// [ENTITY: DataClass('ItemUpdate')]
 /**
- * [CONTRACT]
+ * @summary Модель данных для обновления существующей "Вещи".
- * Модель данных для обновления существующей "Вещи".
+ * @param name Название вещи.
- * @property name Название вещи.
+ * @param assetId Идентификатор актива.
- * @property assetId Идентификатор актива.
+ * @param description Описание.
- * @property description Описание.
+ * @param notes Заметки.
- * @property notes Заметки.
+ * @param serialNumber Серийный номер.
- * @property serialNumber Серийный номер.
+ * @param quantity Количество.
- * @property quantity Количество.
+ * @param isArchived Флаг архивации.
- * @property isArchived Флаг архивации.
+ * @param value Стоимость.
- * @property value Стоимость.
+ * @param purchasePrice Цена покупки.
- * @property purchasePrice Цена покупки.
+ * @param purchaseDate Дата покупки.
- * @property purchaseDate Дата покупки.
+ * @param warrantyUntil Гарантия до.
- * @property warrantyUntil Гарантия до.
+ * @param locationId ID местоположения.
- * @property locationId ID местоположения.
+ * @param parentId ID родительской вещи.
- * @property parentId ID родительской вещи.
+ * @param labelIds Список ID меток для полной замены.
- * @property labelIds Список ID меток для полной замены.
  */
 data class ItemUpdate(
     val name: String?,
@@ -37,4 +37,5 @@ data class ItemUpdate(
     val parentId: String?,
     val labelIds: List<String>?
 )
+// [END_ENTITY: DataClass('ItemUpdate')]
 // [END_FILE_ItemUpdate.kt]

domain/src/main/java/com/homebox/lens/domain/model/Label.kt

@@ -1,18 +1,18 @@
 // [PACKAGE] com.homebox.lens.domain.model
 // [FILE] Label.kt
-
+// [SEMANTICS] domain, model
 package com.homebox.lens.domain.model
 
-// [CONTRACT]
+// [ENTITY: DataClass('Label')]
 /**
- * [ENTITY: DataClass('Label')]
+ * @summary Представляет собой метку (тег), которую можно присвоить вещи.
- * [PURPOSE] Представляет собой метку (тег), которую можно присвоить вещи.
+ * @param id Уникальный идентификатор метки.
- * @property id Уникальный идентификатор метки.
+ * @param name Название метки.
- * @property name Название метки.
  */
 data class Label(
     val id: String,
     val name: String
 )
+// [END_ENTITY: DataClass('Label')]
 
 // [END_FILE_Label.kt]

domain/src/main/java/com/homebox/lens/domain/model/LabelCreate.kt

@@ -0,0 +1,18 @@
+// [PACKAGE] com.homebox.lens.domain.model
+// [FILE] LabelCreate.kt
+// [SEMANTICS] data_structure, contract, label, create
+package com.homebox.lens.domain.model
+
+// [ENTITY: DataClass('LabelCreate')]
+/**
+ * @summary Модель с данными, необходимыми для создания новой метки.
+ * @param name Название новой метки. Обязательное поле.
+ * @param color Цвет метки в формате HEX. Необязательное поле.
+ * @invariant name не может быть пустым.
+ */
+data class LabelCreate(
+    val name: String,
+    val color: String?
+)
+// [END_ENTITY: DataClass('LabelCreate')]
+// [END_FILE_LabelCreate.kt]

domain/src/main/java/com/homebox/lens/domain/model/LabelOut.kt

@@ -2,16 +2,16 @@
 // [FILE] LabelOut.kt
 // [SEMANTICS] data_structure, entity, label
 package com.homebox.lens.domain.model
-// [CORE-LOGIC]
+
+// [ENTITY: DataClass('LabelOut')]
 /**
- * [CONTRACT]
+ * @summary Модель данных для представления метки (тега).
- * Модель данных для представления метки (тега).
+ * @param id Уникальный идентификатор.
- * @property id Уникальный идентификатор.
+ * @param name Название метки.
- * @property name Название метки.
+ * @param color Цвет метки в формате HEX (например, "#FF0000").
- * @property color Цвет метки в формате HEX (например, "#FF0000").
+ * @param isArchived Флаг, указывающий, заархивирована ли метка.
- * @property isArchived Флаг, указывающий, заархивирована ли метка.
+ * @param createdAt Дата и время создания.
- * @property createdAt Дата и время создания.
+ * @param updatedAt Дата и время последнего обновления.
- * @property updatedAt Дата и время последнего обновления.
  */
 data class LabelOut(
     val id: String,
@@ -21,4 +21,5 @@ data class LabelOut(
     val createdAt: String,
     val updatedAt: String
 )
+// [END_ENTITY: DataClass('LabelOut')]
 // [END_FILE_LabelOut.kt]

domain/src/main/java/com/homebox/lens/domain/model/LabelSummary.kt

@@ -0,0 +1,17 @@
+// [PACKAGE] com.homebox.lens.domain.model
+// [FILE] LabelSummary.kt
+// [SEMANTICS] data_structure, entity, label, summary
+package com.homebox.lens.domain.model
+
+// [ENTITY: DataClass('LabelSummary')]
+/**
+ * @summary Представляет краткую информацию о метке, обычно возвращаемую после создания.
+ * @param id Уникальный идентификатор метки.
+ * @param name Название метки.
+ */
+data class LabelSummary(
+    val id: String,
+    val name: String
+)
+// [END_ENTITY: DataClass('LabelSummary')]
+// [END_FILE_LabelSummary.kt]

domain/src/main/java/com/homebox/lens/domain/model/LabelUpdate.kt

@@ -0,0 +1,17 @@
+// [PACKAGE] com.homebox.lens.domain.model
+// [FILE] LabelUpdate.kt
+// [SEMANTICS] data_structure, contract, label, update
+package com.homebox.lens.domain.model
+
+// [ENTITY: DataClass('LabelUpdate')]
+/**
+ * @summary Модель с данными, необходимыми для обновления метки.
+ * @param name Название метки.
+ * @param color Цвет метки в формате HEX.
+ */
+data class LabelUpdate(
+    val name: String?,
+    val color: String?
+)
+// [END_ENTITY: DataClass('LabelUpdate')]
+// [END_FILE_LabelUpdate.kt]

domain/src/main/java/com/homebox/lens/domain/model/Location.kt

@@ -1,18 +1,18 @@
 // [PACKAGE] com.homebox.lens.domain.model
 // [FILE] Location.kt
-
+// [SEMANTICS] domain, model
 package com.homebox.lens.domain.model
 
-// [CONTRACT]
+// [ENTITY: DataClass('Location')]
 /**
- * [ENTITY: DataClass('Location')]
+ * @summary Представляет собой местоположение, где может находиться вещь.
- * [PURPOSE] Представляет собой местоположение, где может находиться вещь.
+ * @param id Уникальный идентификатор местоположения.
- * @property id Уникальный идентификатор местоположения.
+ * @param name Название местоположения.
- * @property name Название местоположения.
  */
 data class Location(
     val id: String,
     val name: String
 )
+// [END_ENTITY: DataClass('Location')]
 
 // [END_FILE_Location.kt]

domain/src/main/java/com/homebox/lens/domain/model/LocationCreate.kt

@@ -0,0 +1,18 @@
+// [PACKAGE] com.homebox.lens.domain.model
+// [FILE] LocationCreate.kt
+// [SEMANTICS] data_structure, contract, location, create
+package com.homebox.lens.domain.model
+
+// [ENTITY: DataClass('LocationCreate')]
+/**
+ * @summary Модель с данными, необходимыми для создания нового местоположения.
+ * @param name Название нового местоположения. Обязательное поле.
+ * @param color Цвет местоположения в формате HEX. Необязательное поле.
+ * @invariant name не может быть пустым.
+ */
+data class LocationCreate(
+    val name: String,
+    val color: String?
+)
+// [END_ENTITY: DataClass('LocationCreate')]
+// [END_FILE_LocationCreate.kt]

domain/src/main/java/com/homebox/lens/domain/model/LocationOut.kt

@@ -2,16 +2,16 @@
 // [FILE] LocationOut.kt
 // [SEMANTICS] data_structure, entity, location
 package com.homebox.lens.domain.model
-// [CORE-LOGIC]
+
+// [ENTITY: DataClass('LocationOut')]
 /**
- * [CONTRACT]
+ * @summary Модель данных для представления местоположения (без счетчика).
- * Модель данных для представления местоположения (без счетчика).
+ * @param id Уникальный идентификатор.
- * @property id Уникальный идентификатор.
+ * @param name Название местоположения.
- * @property name Название местоположения.
+ * @param color Цвет в формате HEX.
- * @property color Цвет в формате HEX.
+ * @param isArchived Флаг архивации.
- * @property isArchived Флаг архивации.
+ * @param createdAt Дата и время создания.
- * @property createdAt Дата и время создания.
+ * @param updatedAt Дата и время последнего обновления.
- * @property updatedAt Дата и время последнего обновления.
  */
 data class LocationOut(
     val id: String,
@@ -21,4 +21,5 @@ data class LocationOut(
     val createdAt: String,
     val updatedAt: String
 )
+// [END_ENTITY: DataClass('LocationOut')]
 // [END_FILE_LocationOut.kt]

domain/src/main/java/com/homebox/lens/domain/model/LocationOutCount.kt

@@ -2,17 +2,17 @@
 // [FILE] LocationOutCount.kt
 // [SEMANTICS] data_structure, entity, location
 package com.homebox.lens.domain.model
-// [CORE-LOGIC]
+
+// [ENTITY: DataClass('LocationOutCount')]
 /**
- * [CONTRACT]
+ * @summary Модель данных для представления местоположения со счетчиком вещей.
- * Модель данных для представления местоположения со счетчиком вещей.
+ * @param id Уникальный идентификатор.
- * @property id Уникальный идентификатор.
+ * @param name Название местоположения.
- * @property name Название местоположения.
+ * @param color Цвет в формате HEX.
- * @property color Цвет в формате HEX.
+ * @param isArchived Флаг архивации.
- * @property isArchived Флаг архивации.
+ * @param itemCount Количество вещей в данном местоположении.
- * @property itemCount Количество вещей в данном местоположении.
+ * @param createdAt Дата и время создания.
- * @property createdAt Дата и время создания.
+ * @param updatedAt Дата и время последнего обновления.
- * @property updatedAt Дата и время последнего обновления.
  */
 data class LocationOutCount(
     val id: String,
@@ -23,4 +23,5 @@ data class LocationOutCount(
     val createdAt: String,
     val updatedAt: String
 )
+// [END_ENTITY: DataClass('LocationOutCount')]
 // [END_FILE_LocationOutCount.kt]

domain/src/main/java/com/homebox/lens/domain/model/LocationUpdate.kt

@@ -0,0 +1,17 @@
+// [PACKAGE] com.homebox.lens.domain.model
+// [FILE] LocationUpdate.kt
+// [SEMANTICS] data_structure, contract, location, update
+package com.homebox.lens.domain.model
+
+// [ENTITY: DataClass('LocationUpdate')]
+/**
+ * @summary Модель с данными, необходимыми для обновления местоположения.
+ * @param name Название местоположения.
+ * @param color Цвет местоположения в формате HEX.
+ */
+data class LocationUpdate(
+    val name: String?,
+    val color: String?
+)
+// [END_ENTITY: DataClass('LocationUpdate')]
+// [END_FILE_LocationUpdate.kt]

domain/src/main/java/com/homebox/lens/domain/model/MaintenanceEntry.kt

@@ -2,18 +2,18 @@
 // [FILE] MaintenanceEntry.kt
 // [SEMANTICS] data_structure, entity, maintenance
 package com.homebox.lens.domain.model
-// [CORE-LOGIC]
+
+// [ENTITY: DataClass('MaintenanceEntry')]
 /**
- * [CONTRACT]
+ * @summary Модель данных для записи о техническом обслуживании.
- * Модель данных для записи о техническом обслуживании.
+ * @param id Уникальный идентификатор записи.
- * @property id Уникальный идентификатор записи.
+ * @param itemId ID связанной вещи.
- * @property itemId ID связанной вещи.
+ * @param title Заголовок.
- * @property title Заголовок.
+ * @param details Детальное описание.
- * @property details Детальное описание.
+ * @param dueAt Дата, до которой нужно выполнить.
- * @property dueAt Дата, до которой нужно выполнить.
+ * @param completedAt Дата выполнения.
- * @property completedAt Дата выполнения.
+ * @param createdAt Дата и время создания.
- * @property createdAt Дата и время создания.
+ * @param updatedAt Дата и время последнего обновления.
- * @property updatedAt Дата и время последнего обновления.
  */
 data class MaintenanceEntry(
     val id: String,
@@ -25,4 +25,5 @@ data class MaintenanceEntry(
     val createdAt: String,
     val updatedAt: String
 )
-// [END_FILE_MaintenanceEntry.kt]
+// [END_ENTITY: DataClass('MaintenanceEntry')]
+// [END_FILE_MaintenanceEntry.kt]

domain/src/main/java/com/homebox/lens/domain/model/PaginationResult.kt

@@ -2,15 +2,15 @@
 // [FILE] PaginationResult.kt
 // [SEMANTICS] data_structure, generic, pagination
 package com.homebox.lens.domain.model
-// [CORE-LOGIC]
+
+// [ENTITY: DataClass('PaginationResult')]
 /**
- * [CONTRACT]
+ * @summary Генерик-класс для представления постраничных результатов от API.
- * Генерик-класс для представления постраничных результатов от API.
  * @param T Тип элементов в списке.
- * @property items Список элементов на текущей странице.
+ * @param items Список элементов на текущей странице.
- * @property page Номер текущей страницы.
+ * @param page Номер текущей страницы.
- * @property pageSize Количество элементов на странице.
+ * @param pageSize Количество элементов на странице.
- * @property total Общее количество элементов.
+ * @param total Общее количество элементов.
  */
 data class PaginationResult<T>(
     val items: List<T>,
@@ -18,4 +18,5 @@ data class PaginationResult<T>(
     val pageSize: Int,
     val total: Int
 )
-// [END_FILE_PaginationResult.kt]
+// [END_ENTITY: DataClass('PaginationResult')]
+// [END_FILE_PaginationResult.kt]

domain/src/main/java/com/homebox/lens/domain/model/Result.kt

@@ -1,28 +1,29 @@
 // [PACKAGE] com.homebox.lens.domain.model
 // [FILE] Result.kt
-
+// [SEMANTICS] domain, model, result
 package com.homebox.lens.domain.model
 
-// [CONTRACT]
+// [ENTITY: SealedClass('Result')]
 /**
- * [ENTITY: SealedClass('Result')]
+ * @summary Представляет собой результат операции, который может быть либо успешным, либо неуспешным.
- * [PURPOSE] Представляет собой результат операции, который может быть либо успешным, либо неуспешным.
  * @param T Тип данных в случае успеха.
  */
 sealed class Result<out T> {
+    // [ENTITY: DataClass('Success')]
     /**
-     * [ENTITY: DataClass('Success')]
+     * @summary Представляет собой успешный результат операции.
-     * [PURPOSE] Представляет собой успешный результат операции.
      * @param data Данные, полученные в результате операции.
      */
     data class Success<out T>(val data: T) : Result<T>()
+    // [END_ENTITY: DataClass('Success')]
 
+    // [ENTITY: DataClass('Error')]
     /**
-     * [ENTITY: DataClass('Error')]
+     * @summary Представляет собой неуспешный результат операции.
-     * [PURPOSE] Представляет собой неуспешный результат операции.
      * @param exception Исключение, которое произошло во время операции.
      */
     data class Error(val exception: Exception) : Result<Nothing>()
+    // [END_ENTITY: DataClass('Error')]
 }
-
+// [END_ENTITY: SealedClass('Result')]
-// [END_FILE_Result.kt]
+// [END_FILE_Result.kt]

domain/src/main/java/com/homebox/lens/domain/model/Statistics.kt

@@ -1,18 +1,19 @@
 // [PACKAGE] com.homebox.lens.domain.model
 // [FILE] Statistics.kt
-
+// [SEMANTICS] domain, model
 package com.homebox.lens.domain.model
 
+// [IMPORTS]
 import java.math.BigDecimal
+// [END_IMPORTS]
 
-// [CONTRACT]
+// [ENTITY: DataClass('Statistics')]
 /**
- * [ENTITY: DataClass('Statistics')]
+ * @summary Представляет собой статистику по инвентарю.
- * [PURPOSE] Представляет собой статистику по инвентарю.
+ * @param totalValue Общая стоимость всех вещей.
- * @property totalValue Общая стоимость всех вещей.
+ * @param totalItems Общее количество вещей.
- * @property totalItems Общее количество вещей.
+ * @param locations Общее количество местоположений.
- * @property locations Общее количество местоположений.
+ * @param labels Общее количество меток.
- * @property labels Общее количество меток.
  */
 data class Statistics(
     val totalValue: BigDecimal,
@@ -20,5 +21,6 @@ data class Statistics(
     val locations: Int,
     val labels: Int
 )
+// [END_ENTITY: DataClass('Statistics')]
 
 // [END_FILE_Statistics.kt]

domain/src/main/java/com/homebox/lens/domain/model/TokenResponse.kt

@@ -0,0 +1,19 @@
+// [PACKAGE] com.homebox.lens.domain.model
+// [FILE] TokenResponse.kt
+// [SEMANTICS] data_transfer_object, authentication, model
+
+package com.homebox.lens.domain.model
+
+// [ENTITY: DataClass('TokenResponse')]
+/**
+ * @summary Модель данных, представляющая ответ от сервера с токеном аутентификации.
+ * @param token Строка, содержащая JWT или другой токен доступа.
+ * @invariant `token` не должен быть пустым.
+ */
+data class TokenResponse(val token: String) {
+    init {
+        require(token.isNotBlank()) { "Token cannot be blank." }
+    }
+}
+// [END_ENTITY: DataClass('TokenResponse')]
+// [END_FILE_TokenResponse.kt]

domain/src/main/java/com/homebox/lens/domain/repository/AuthRepository.kt

@@ -0,0 +1,46 @@
+// [PACKAGE] com.homebox.lens.domain.repository
+// [FILE] AuthRepository.kt
+// [SEMANTICS] authentication, data_access, repository
+
+package com.homebox.lens.domain.repository
+
+// [IMPORTS]
+import com.homebox.lens.domain.model.Credentials
+import com.homebox.lens.domain.model.TokenResponse
+import kotlinx.coroutines.flow.Flow
+// [END_IMPORTS]
+
+// [ENTITY: Interface('AuthRepository')]
+/**
+ * @summary Репозиторий для управления аутентификацией.
+ */
+interface AuthRepository {
+    // [ENTITY: Function('login')]
+    /**
+     * @summary Выполняет вход в систему, используя предоставленные учетные данные.
+     * @param credentials Учетные данные пользователя (URL сервера, логин, пароль).
+     * @return [Result] с [TokenResponse] в случае успеха, или с [Exception] в случае ошибки.
+     * @throws IllegalArgumentException если `credentials` невалидны (предусловие).
+     */
+    suspend fun login(credentials: Credentials): Result<TokenResponse>
+    // [END_ENTITY: Function('login')]
+
+    // [ENTITY: Function('saveToken')]
+    /**
+     * @summary Сохраняет токен аутентификации.
+     * @param token Токен для сохранения.
+     * @throws IllegalArgumentException если `token` пустой (предусловие).
+     */
+    suspend fun saveToken(token: String)
+    // [END_ENTITY: Function('saveToken')]
+
+    // [ENTITY: Function('getToken')]
+    /**
+     * @summary Получает токен аутентификации.
+     * @return [Flow], который эммитит токен в виде строки, или `null`, если токен отсутствует.
+     */
+    fun getToken(): Flow<String?>
+    // [END_ENTITY: Function('getToken')]
+}
+// [END_ENTITY: Interface('AuthRepository')]
+// [END_FILE_AuthRepository.kt]

domain/src/main/java/com/homebox/lens/domain/repository/CredentialsRepository.kt

@@ -0,0 +1,51 @@
+// [PACKAGE] com.homebox.lens.domain.repository
+// [FILE] CredentialsRepository.kt
+// [SEMANTICS] domain, repository, credentials
+package com.homebox.lens.domain.repository
+
+// [IMPORTS]
+import com.homebox.lens.domain.model.Credentials
+import kotlinx.coroutines.flow.Flow
+// [END_IMPORTS]
+
+// [ENTITY: Interface('CredentialsRepository')]
+/**
+ * @summary Repository for managing user credentials and session tokens.
+ */
+interface CredentialsRepository {
+    // [ENTITY: Function('saveCredentials')]
+    /**
+     * @summary Saves the user's base credentials (URL, username, password) securely.
+     * @param credentials The credentials to save.
+     * @sideeffect Overwrites any existing saved credentials.
+     */
+    suspend fun saveCredentials(credentials: Credentials)
+    // [END_ENTITY: Function('saveCredentials')]
+
+    // [ENTITY: Function('getCredentials')]
+    /**
+     * @summary Retrieves the saved user credentials.
+     * @return A Flow emitting the saved [Credentials], or null if none are saved.
+     */
+    fun getCredentials(): Flow<Credentials?>
+    // [END_ENTITY: Function('getCredentials')]
+
+    // [ENTITY: Function('saveToken')]
+    /**
+     * @summary Saves the authorization token received after a successful login.
+     * @param token The authorization token (including "Bearer " prefix if provided by the server).
+     * @sideeffect Overwrites any existing saved token.
+     */
+    suspend fun saveToken(token: String)
+    // [END_ENTITY: Function('saveToken')]
+
+    // [ENTITY: Function('getToken')]
+    /**
+     * @summary Retrieves the saved authorization token.
+     * @return The saved token as a String, or null if no token is saved.
+     */
+    suspend fun getToken(): String?
+    // [END_ENTITY: Function('getToken')]
+}
+// [END_ENTITY: Interface('CredentialsRepository')]
+// [END_FILE_CredentialsRepository.kt]

domain/src/main/java/com/homebox/lens/domain/repository/ItemRepository.kt

@@ -2,24 +2,184 @@
 // [FILE] ItemRepository.kt
 // [SEMANTICS] data_access, abstraction, repository
 package com.homebox.lens.domain.repository
+
 // [IMPORTS]
 import com.homebox.lens.domain.model.*
+import kotlinx.coroutines.flow.Flow
 
-// [CORE-LOGIC]
+// [END_IMPORTS]
+
+// [ENTITY: Interface('ItemRepository')]
 /**
- * [CONTRACT]
+ * @summary Абстракция репозитория для работы с "Вещами".
- * Абстракция репозитория для работы с "Вещами".
+ * @description Определяет контракт, которому должен следовать слой данных.
- * Определяет контракт, которому должен следовать слой данных.
  */
 interface ItemRepository {
+    // [ENTITY: Function('createItem')]
+    // [RELATION: Function('createItem')] -> [RETURNS] -> [DataClass('ItemSummary')]
+    /**
+     * @summary Создает новый элемент.
+     * @param newItemData Данные для создания нового элемента.
+     * @return Сводка по созданному элементу.
+     */
     suspend fun createItem(newItemData: ItemCreate): ItemSummary
+    // [END_ENTITY: Function('createItem')]
+
+    // [ENTITY: Function('getItemDetails')]
+    // [RELATION: Function('getItemDetails')] -> [RETURNS] -> [DataClass('ItemOut')]
+    /**
+     * @summary Получает детальную информацию об элементе.
+     * @param itemId ID элемента.
+     * @return Детальная информация об элементе.
+     */
     suspend fun getItemDetails(itemId: String): ItemOut
+    // [END_ENTITY: Function('getItemDetails')]
+
+    // [ENTITY: Function('updateItem')]
+    // [RELATION: Function('updateItem')] -> [RETURNS] -> [DataClass('ItemOut')]
+    /**
+     * @summary Обновляет элемент.
+     * @param itemId ID элемента для обновления.
+     * @param item Данные для обновления элемента.
+     * @return Обновленная детальная информация об элементе.
+     */
     suspend fun updateItem(itemId: String, item: ItemUpdate): ItemOut
+    // [END_ENTITY: Function('updateItem')]
+
+    // [ENTITY: Function('deleteItem')]
+    /**
+     * @summary Удаляет элемент.
+     * @param itemId ID элемента для удаления.
+     */
     suspend fun deleteItem(itemId: String)
+    // [END_ENTITY: Function('deleteItem')]
+
+    // [ENTITY: Function('syncInventory')]
+    // [RELATION: Function('syncInventory')] -> [RETURNS] -> [DataClass('PaginationResult<ItemSummary>')]
+    /**
+     * @summary Синхронизирует инвентарь.
+     * @param page Номер страницы.
+     * @param pageSize Размер страницы.
+     * @return Результат пагинации со сводкой по элементам.
+     */
     suspend fun syncInventory(page: Int, pageSize: Int): PaginationResult<ItemSummary>
+    // [END_ENTITY: Function('syncInventory')]
+
+    // [ENTITY: Function('getStatistics')]
+    // [RELATION: Function('getStatistics')] -> [RETURNS] -> [DataClass('GroupStatistics')]
+    /**
+     * @summary Получает статистику.
+     * @return Статистика по группам.
+     */
     suspend fun getStatistics(): GroupStatistics
+    // [END_ENTITY: Function('getStatistics')]
+
+    // [ENTITY: Function('getAllLocations')]
+    // [RELATION: Function('getAllLocations')] -> [RETURNS] -> [DataStructure('List<LocationOutCount>')]
+    /**
+     * @summary Получает все местоположения.
+     * @return Список всех местоположений со счетчиками.
+     */
     suspend fun getAllLocations(): List<LocationOutCount>
+    // [END_ENTITY: Function('getAllLocations')]
+
+    // [ENTITY: Function('getAllLabels')]
+    // [RELATION: Function('getAllLabels')] -> [RETURNS] -> [DataStructure('List<LabelOut>')]
+    /**
+     * @summary Получает все метки.
+     * @return Список всех меток.
+     */
     suspend fun getAllLabels(): List<LabelOut>
+    // [END_ENTITY: Function('getAllLabels')]
+
+    // [ENTITY: Function('getLabelDetails')]
+    // [RELATION: Function('getLabelDetails')] -> [RETURNS] -> [DataClass('LabelOut')]
+    /**
+     * @summary Получает детальную информацию о метке.
+     * @param labelId ID метки.
+     * @return Детальная информация о метке.
+     */
+    suspend fun getLabelDetails(labelId: String): LabelOut
+
+    // [END_ENTITY: Function('getLabelDetails')]
+
+    // [ENTITY: Function('createLabel')]
+    // [RELATION: Function('createLabel')] -> [RETURNS] -> [DataClass('LabelSummary')]
+    /**
+     * @summary Создает новую метку.
+     * @param newLabelData Данные для создания новой метки.
+     * @return Сводка по созданной метке.
+     */
+    suspend fun createLabel(newLabelData: LabelCreate): LabelSummary
+    // [END_ENTITY: Function('createLabel')]
+
+    // [ENTITY: Function('updateLabel')]
+    // [RELATION: Function('updateLabel')] -> [RETURNS] -> [DataClass('LabelOut')]
+    /**
+     * @summary Обновляет метку.
+     * @param labelId ID метки для обновления.
+     * @param labelData Данные для обновления метки.
+     * @return Обновленная информация о метке.
+     */
+    suspend fun updateLabel(labelId: String, labelData: LabelUpdate): LabelOut
+    // [END_ENTITY: Function('updateLabel')]
+
+    // [ENTITY: Function('deleteLabel')]
+    /**
+     * @summary Удаляет метку.
+     * @param labelId ID метки для удаления.
+     */
+    suspend fun deleteLabel(labelId: String)
+    // [END_ENTITY: Function('deleteLabel')]
+
+    // [ENTITY: Function('createLocation')]
+    // [RELATION: Function('createLocation')] -> [RETURNS] -> [DataClass('LocationOut')]
+    /**
+     * @summary Создает новое местоположение.
+     * @param newLocationData Данные для создания нового местоположения.
+     * @return Информация о созданном местоположении.
+     */
+    suspend fun createLocation(newLocationData: LocationCreate): LocationOut
+    // [END_ENTITY: Function('createLocation')]
+
+    // [ENTITY: Function('updateLocation')]
+    // [RELATION: Function('updateLocation')] -> [RETURNS] -> [DataClass('LocationOut')]
+    /**
+     * @summary Обновляет местоположение.
+     * @param locationId ID местоположения для обновления.
+     * @param locationData Данные для обновления местоположения.
+     * @return Обновленная информация о местоположении.
+     */
+    suspend fun updateLocation(locationId: String, locationData: LocationUpdate): LocationOut
+    // [END_ENTITY: Function('updateLocation')]
+
+    // [ENTITY: Function('deleteLocation')]
+    /**
+     * @summary Удаляет местоположение.
+     * @param locationId ID местоположения для удаления.
+     */
+    suspend fun deleteLocation(locationId: String)
+    // [END_ENTITY: Function('deleteLocation')]
+
+    // [ENTITY: Function('searchItems')]
+    // [RELATION: Function('searchItems')] -> [RETURNS] -> [DataClass('PaginationResult<ItemSummary>')]
+    /**
+     * @summary Ищет элементы.
+     * @param query Поисковый запрос.
+     * @return Результат пагинации со сводкой по найденным элементам.
+     */
     suspend fun searchItems(query: String): PaginationResult<ItemSummary>
+    // [END_ENTITY: Function('searchItems')]
+
+    // [ENTITY: Function('getRecentlyAddedItems')]
+    // [RELATION: Function('getRecentlyAddedItems')] -> [RETURNS] -> [DataStructure('Flow<List<ItemSummary>>')]
+    /**
+     * @summary Получает недавно добавленные элементы.
+     * @param limit Максимальное количество возвращаемых элементов.
+     * @return Поток со списком недавно добавленных элементов.
+     */
+    fun getRecentlyAddedItems(limit: Int): Flow<List<ItemSummary>>
+    // [END_ENTITY: Function('getRecentlyAddedItems')]
 }
+// [END_ENTITY: Interface('ItemRepository')]
 // [END_FILE_ItemRepository.kt]