Убрали // [PACKAGE] из разметки, чтобы было меньше шума

agent_promts/knowledge_base/ai_friendly_logging.md

@@ -1,52 +0,0 @@
-[AIFriendlyLogging]
-**Tags:** LOGGING, TRACEABILITY, STRUCTURED_LOG, DEBUG, CLEAN_ARCHITECTURE
-
-> Логирование — это мой критически важный механизм для декларации `belief state` (внутреннего состояния/намерения) и трассировки выполнения кода. Каждая значимая операция, проверка контракта или изменение состояния ДОЛЖНЫ сопровождаться структурированной записью в лог. Это делает поведение кода в рантайме полностью прозрачным и отлаживаемым.
-
-## Rules
-
-### ArchitecturalBoundaryCompliance
-Логирование в его прямой реализации (т.е. вызов `logger.info`, `Timber.i` и т.д.) **КАТЕГОРИЧЕСКИ ЗАПРЕЩЕНО** внутри модуля `:domain`.
-
-> `Согласно принципам чистой архитектуры, слой `domain` должен быть полностью независим от внешних фреймворков и платформ (включая Android). Его задача — содержать исключительно бизнес-логику. Логирование, как и другие инфраструктурные задачи, должно выполняться в более внешних слоях, таких как `:data` или `:app`.`
-
-### StructuredLogFormat
-Все записи в лог должны строго следовать этому формату для обеспечения машиночитаемости и консистентности.
-
-```
-`logger.level("[LEVEL][ANCHOR_NAME][BELIEF_STATE] Message with {} placeholders for data.")`
-```
-
-### ComponentDefinitions
-
-#### Components
-- **[LEVEL]**: Один из стандартных уровней логирования: `DEBUG`, `INFO`, `WARN`, `ERROR`. Я также использую специальный уровень `CONTRACT_VIOLATION` для логов, связанных с провалом `require` или `check`.
-- **[ANCHOR_NAME]**: Точное имя семантического якоря из кода, к которому относится данный лог. Это создает неразрывную связь между статическим кодом и его выполнением. Например: `[ENTRYPOINT]`, `[ACTION]`, `[PRECONDITION]`, `[FALLBACK]`.
-- **[BELIEF_STATE]**: Краткое, четкое описание моего намерения в `snake_case`. Это отвечает на вопрос 'почему' я выполняю этот код. Примеры: `validating_input`, `calling_external_api`, `mutating_state`, `persisting_data`, `handling_exception`, `mapping_dto`.
-
-### Example
-Вот как я применяю этот стандарт на практике внутри функции:
-```kotlin
-// ...
-// [ENTRYPOINT]
-suspend fun processPayment(request: PaymentRequest): Result {
-    logger.info("[INFO][ENTRYPOINT][processing_payment] Starting payment process for request '{}'.", request.id)
-
-    // [PRECONDITION]
-    logger.debug("[DEBUG][PRECONDITION][validating_input] Validating payment request.")
-    require(request.amount > 0) { "Payment amount must be positive." }
-
-    // [ACTION]
-    logger.info("[INFO][ACTION][calling_external_api] Calling payment gateway for amount {}."), request.amount)
-    val result = paymentGateway.execute(request)
-
-    // ...
-}
-```
-
-### TraceabilityIsMandatory
-Каждая запись в логе ДОЛЖНА быть семантически привязана к якорю в коде. Логи без якоря запрещены. Это не опция, а фундаментальное требование для обеспечения полной трассируемости потока выполнения.
-
-### DataAsArguments_NotStrings
-Данные (переменные, значения) должны передаваться в логгер как отдельные аргументы, а не встраиваться в строку сообщения. Я использую плейсхолдеры `{}`. Это повышает производительность и позволяет системам сбора логов индексировать эти данные.
-[/End AIFriendlyLogging]

agent_promts/knowledge_base/ai_friendly_logging.xml

@@ -0,0 +1,52 @@
+<!-- =================================================================== -->
+<!-- ПРАВИЛО 8: Структурированное логирование для AI                       -->
+<!-- =================================================================== -->
+<Rule id="AIFriendlyLogging" enforcement="strict">
+    <Description>
+        Каждая значимая операция, проверка контракта или изменение состояния ДОЛЖНЫ
+        сопровождаться структурированной записью в лог для обеспечения полной
+        трассируемости и отлаживаемости.
+    </Description>
+    <Rationale>
+        Структурированные логи превращают поток выполнения программы из "черного ящика"
+        в машиночитаемый и анализируемый артефакт, связывая рантайм-поведение
+        со статическим кодом через якоря.
+    </Rationale>
+    <Definition type="multi_check">
+        <!-- 
+          Контейнер <Checks> позволяет определить несколько независимых проверок,
+          которые должны быть применены к коду в рамках одного правила.
+        -->
+        <Checks>
+            <!-- 
+              ПРОВЕРКА 1: Все вызовы логгера ДОЛЖНЫ соответствовать строгому формату.
+              Это позитивная проверка: каждая строка, содержащая 'logger.*()', должна совпадать с этим шаблоном.
+            -->
+            <Check type="positive_regex_on_match" trigger="logger\.(debug|info|warn|error)\s*\(">
+                <Description>Все вызовы логгера должны соответствовать формату [LEVEL][ANCHOR][STATE]...</Description>
+                <Pattern><![CDATA[logger\.(debug|info|warn|error)\s*\(\s*"\[(DEBUG|INFO|WARN|ERROR)\]\[[A-Z_]+\]\[[a-z_]+\][^"]*"\s*(,.*)?\)]]></Pattern>
+                <FailureMessage>Нарушен структурный формат лога. Ожидается: [LEVEL][ANCHOR][STATE] message.</FailureMessage>
+            </Check>
+
+            <!-- 
+              ПРОВЕРКА 2: В строках лога НЕ ДОЛЖНО быть строковой интерполяции.
+              Это негативная проверка: если найдена строка, содержащая 'logger.*("$...")', это ошибка.
+            -->
+            <Check type="negative_regex">
+                <Description>Данные должны передаваться как аргументы, а не через строковую интерполяцию (запрещено использовать '$' в строке лога).</Description>
+                <Pattern><![CDATA[logger\.(debug|info|warn|error)\s*\(\s*".*\$.*"]]></Pattern>
+                <FailureMessage>Обнаружена строковая интерполяция ('$') в сообщении лога. Передавайте данные как аргументы.</FailureMessage>
+            </Check>
+
+            <!-- 
+              ПРОВЕРКА 3: В слое Domain НЕ ДОЛЖНО быть вызовов логгера.
+              Это контекстная негативная проверка, которая применяется только к файлам в определенной директории.
+            -->
+            <Check type="negative_regex_in_path" path_contains="/domain/">
+                <Description>Прямые вызовы логгера (logger.*, Timber.*) запрещены в модуле :domain.</Description>
+                <Pattern><![CDATA[(logger|Timber)\.(debug|info|warn|error)]]></Pattern>
+                <FailureMessage>Обнаружен прямой вызов логгера в модуле :domain, что нарушает принципы чистой архитектуры.</FailureMessage>
+            </Check>
+        </Checks>
+    </Definition>
+</Rule>

agent_promts/knowledge_base/design_by_contract.md

@@ -1,35 +0,0 @@
-[DesignByContractAsFoundation]
-**Tags:** DBC, CONTRACT, PRECONDITION, POSTCONDITION, INVARIANT, KDOC, REQUIRE, CHECK
-
-> Принцип 'Проектирование по контракту' (DbC) — это не опция, а фундаментальная основа моего подхода к разработке. Каждая функция и класс, которые я создаю, являются реализацией формального контракта между поставщиком (код) и клиентом (вызывающий код). Это устраняет двусмысленность, предотвращает ошибки и делает код самодокументируемым и предсказуемым.
-
-## Rules
-
-### ContractFirstMindset
-Я всегда начинаю с проектирования и написания KDoc-контракта. Код является реализацией этой формальной спецификации. Проверки контракта (`require`, `check`) создаются до или вместе с основной логикой, а не после как запоздалая мысль.
-
-### KDocAsFormalSpecification
-KDoc-блок является человекочитаемой формальной спецификацией контракта. Для правильной обработки механизмом Causal Attention, он ВСЕГДА предшествует блоку семантической разметки и декларации функции/класса. Я использую стандартизированный набор тегов для полного описания контракта.
-
-#### Tags
-- **@param**: Описывает **предусловия** для конкретного параметра. Что клиент должен гарантировать.
-- **@return**: Описывает **постусловия** для возвращаемого значения. Что поставщик гарантирует в случае успеха.
-- **@throws**: Описывает условия (обычно нарушение предусловий), при которых будет выброшено исключение. Это часть 'негативного' контракта.
-- **@invariant**: (для класса) Явно описывает **инвариант** класса — условие, которое должно быть истинным всегда, когда объект не выполняет метод.
-- **@sideeffect**: Четко декларирует любые побочные эффекты (запись в БД, сетевой вызов, изменение внешнего состояния). Если их нет, я явно указываю `@sideeffect Отсутствуют.`.
-
-### PreconditionsWithRequire
-Предусловия (обязательства клиента) должны быть проверены в самом начале публичного метода с использованием `require(condition) { "Error message" }`. Это реализует принцип 'Fail-Fast' — немедленный отказ, если клиент нарушил контракт.
-
-**Location:** Первые исполняемые строки кода внутри тела функции, сразу после лога `[ENTRYPOINT]`.
-
-### PostconditionsWithCheck
-Постусловия (гарантии поставщика) должны быть проверены в самом конце метода, прямо перед возвратом управления, с использованием `check(condition) { "Error message" }`. Это самопроверка, гарантирующая, что моя работа выполнена правильно.
-
-**Location:** Последние строки кода внутри тела функции, непосредственно перед каждым оператором `return`.
-
-### InvariantsWithInitAndCheck
-Инварианты класса (условия, которые всегда должны быть истинны для экземпляра) проверяются в двух местах: в блоке `init` для гарантии корректного создания объекта, и в конце каждого публичного метода, изменяющего состояние, с помощью `check(condition)`.
-
-**Location:** Блок `init` и конец каждого метода-мутатора.
-[/End DesignByContractAsFoundation]

agent_promts/knowledge_base/design_by_contract.xml

@@ -0,0 +1,55 @@
+<!-- =================================================================== -->
+<!-- ПРАВИЛО 9: Проектирование по контракту (DbC)                        -->
+<!-- =================================================================== -->
+<Rule id="DesignByContract" enforcement="strict">
+    <Description>
+        Каждая публичная сущность должна иметь формальный KDoc-контракт, а предусловия
+        и постусловия должны быть реализованы в коде через require/check.
+    </Description>
+    <Rationale>
+        Это устраняет двусмысленность, предотвращает ошибки по принципу 'Fail-Fast'
+        и делает код самодокументируемым и предсказуемым.
+    </Rationale>
+    <Definition type="multi_check">
+        <Checks>
+
+            <!-- 
+              ПРОВЕРКА 1: Обязательные теги в KDoc для публичных функций и классов.
+              Это проверка полноты контракта.
+            -->
+            <Check type="kdoc_validation" scope="entity">
+                <Description>Публичные функции и классы должны иметь полный KDoc-контракт.</Description>
+                <RequiredTagsForFunction>
+                    <Tag name="@param" condition="has_parameters"/>
+                    <Tag name="@return" condition="returns_value"/>
+                    <Tag name="@sideeffect"/>
+                </RequiredTagsForFunction>
+                <RequiredTagsForClass>
+                    <Tag name="@invariant"/>
+                    <Tag name="@sideeffect"/>
+                </RequiredTagsForClass>
+                <FailureMessage>Отсутствует обязательный KDoc-тег контракта.</FailureMessage>
+            </Check>
+
+            <!-- 
+              ПРОВЕРКА 2: Наличие `require()` при наличии `@param`.
+              Эта проверка связывает документацию с кодом.
+            -->
+            <Check type="contract_enforcement" scope="entity">
+                <Description>Предусловия, описанные в @param, должны проверяться через require().</Description>
+                <Condition kdoc_tag="@param" code_must_contain="require\("/>
+                <FailureMessage>Предусловие (@param) задекларировано в KDoc, но не проверяется с помощью require() в коде.</FailureMessage>
+            </Check>
+            
+            <!-- 
+              ПРОВЕРКА 3: Наличие `check()` при наличии `@return`.
+            -->
+            <Check type="contract_enforcement" scope="entity">
+                <Description>Постусловия, описанные в @return, должны проверяться через check().</Description>
+                <Condition kdoc_tag="@return" code_must_contain="check\("/>
+                <FailureMessage>Постусловие (@return) задекларировано в KDoc, но не проверяется с помощью check() в коде.</FailureMessage>
+            </Check>
+
+        </Checks>
+    </Definition>
+</Rule>

agent_promts/knowledge_base/graphrag_optimization.md

@@ -1,76 +0,0 @@
-[GraphRAG_Optimization]
-**Tags:** GRAPH, RAG, ENTITY, RELATION, ARCHITECTURE, SEMANTIC_TRIPLET
-
-> Этот принцип является моей основной директивой по созданию 'самоописываемого' кода. Я встраиваю явный, машиночитаемый граф знаний непосредственно в исходный код. Цель — сделать архитектуру, зависимости и потоки данных очевидными и запрашиваемыми без необходимости в сложных инструментах статического анализа. Каждый файл становится фрагментом глобального графа знаний проекта.
-
-## Rules
-
-### Entity_Declaration_As_Graph_Nodes
-Каждая архитектурно значимая сущность в коде должна быть явно объявлена как **узел (Node)** в нашем графе знаний. Для этого я использую якорь `[ENTITY]`.
-
-**Rationale:** Определение узлов — это первый шаг в построении любого графа. Без явно определенных сущностей невозможно описать связи между ними. Это создает 'существительные' в языке нашей архитектуры.
-
-**Format:** `// [ENTITY: EntityType('EntityName')]`
-
-#### Valid Types
-- **Module**: Высокоуровневый модуль Gradle (e.g., 'app', 'data', 'domain').
-- **Class**: Стандартный класс.
-- **Interface**: Интерфейс.
-- **Object**: Синглтон-объект.
-- **DataClass**: Класс данных (DTO, модель, состояние UI).
-- **SealedInterface**: Запечатанный интерфейс (для состояний, событий).
-- **EnumClass**: Класс перечисления.
-- **Function**: Публичная, архитектурно значимая функция.
-- **UseCase**: Класс, реализующий конкретный сценарий использования.
-- **ViewModel**: ViewModel из архитектуры MVVM.
-- **Repository**: Класс-репозиторий.
-- **DataStructure**: Структура данных, которая не является `DataClass` (e.g., `Pair`, `Map`).
-- **DatabaseTable**: Таблица в базе данных Room.
-- **ApiEndpoint**: Конкретная конечная точка API.
-
-**Example:**
-```kotlin
-// [ENTITY: ViewModel('DashboardViewModel')]
-class DashboardViewModel(...) { ... }
-```
-
-### Relation_Declaration_As_Graph_Edges
-Все взаимодействия и зависимости между сущностями должны быть явно объявлены как **ребра (Edges)** в нашем графе знаний. Для этого я использую якорь `[RELATION]` в формате семантического триплета.
-
-**Rationale:** Ребра — это 'глаголы' в языке нашей архитектуры. Они делают неявные связи (как вызов метода или использование DTO) явными и машиночитаемыми. Это позволяет автоматически строить диаграммы зависимостей, анализировать влияние изменений и находить архитектурные проблемы.
-
-**Format:** `// [RELATION: 'SubjectType'('SubjectName')] -> [RELATION_TYPE] -> ['ObjectType'('ObjectName')]`
-
-#### Valid Relations
-- **CALLS**: Субъект вызывает функцию/метод объекта.
-- **CREATES_INSTANCE_OF**: Субъект создает экземпляр объекта.
-- **INHERITS_FROM**: Субъект наследуется от объекта (для классов).
-- **IMPLEMENTS**: Субъект реализует объект (для интерфейсов).
-- **READS_FROM**: Субъект читает данные из объекта (e.g., DatabaseTable, Repository).
-- **WRITES_TO**: Субъект записывает данные в объект.
-- **MODIFIES_STATE_OF**: Субъект изменяет внутреннее состояние объекта.
-- **DEPENDS_ON**: Субъект имеет зависимость от объекта (e.g., использует как параметр, DTO, или внедряется через DI). Это наиболее частая связь.
-- **DISPATCHES_EVENT**: Субъект отправляет событие/сообщение определенного типа.
-- **OBSERVES**: Субъект подписывается на обновления от объекта (e.g., Flow, LiveData).
-- **TRIGGERS**: Субъект (обычно UI-событие или компонент) инициирует выполнение объекта (обычно функции ViewModel).
-- **EMITS_STATE**: Субъект (обычно ViewModel или UseCase) является источником/производителем определённого состояния (DataClass).
-- **CONSUMES_STATE**: Субъект (обычно UI-компонент или экран) потребляет/подписывается на определённое состояние (DataClass).
-
-**Example:**
-```kotlin
-// Пример для ViewModel, который зависит от UseCase и является источником состояния
-// [ENTITY: ViewModel('DashboardViewModel')]
-// [RELATION: ViewModel('DashboardViewModel')] -> [DEPENDS_ON] -> [UseCase('GetStatisticsUseCase')]
-// [RELATION: ViewModel('DashboardViewModel')] -> [EMITS_STATE] -> [DataClass('DashboardUiState')]
-class DashboardViewModel @Inject constructor(
-    private val getStatisticsUseCase: GetStatisticsUseCase
-) : ViewModel() { ... }
-```
-
-### MarkupBlockCohesion
-Вся семантическая разметка, относящаяся к одной сущности (`[ENTITY]` и все ее `[RELATION]` триплеты), должна быть сгруппирована в единый, непрерывный блок комментариев.
-
-**Rationale:** Это создает атомарный 'блок метаданных' для каждой сущности. Это упрощает парсинг и гарантирует, что весь архитектурный контекст считывается как единое целое, прежде чем AI-инструмент приступит к анализу самого кода.
-
-**Placement:** Этот блок всегда размещается непосредственно перед KDoc-блоком сущности или, если KDoc отсутствует, перед самой декларацией сущности.
-[/End GraphRAG_Optimization]

agent_promts/knowledge_base/graphrag_optimization.xml

@@ -0,0 +1,55 @@
+<Rule id="GraphRAG" enforcement="strict">
+    <Description>Код должен содержать явный, машиночитаемый граф знаний в виде семантических якорей [ENTITY] и [RELATION].</Description>
+    <Rationale>Это делает архитектуру, зависимости и потоки данных очевидными и запрашиваемыми без необходимости в сложных инструментах статического анализа.</Rationale>
+    <Definition type="multi_check">
+        <Checks>
+            <!-- 
+              ПРОВЕРКА 1: Блок разметки ([ENTITY]/[RELATION]) должен идти ПЕРЕД KDoc.
+              Это реализация правила 'Placement'.
+            -->
+            <Check type="block_order" scope="entity">
+                <Description>Блок семантической разметки ([ENTITY]/[RELATION]) должен предшествовать KDoc-контракту.</Description>
+                <PrecedingBlockPattern><![CDATA[//\s*\[(ENTITY|RELATION):]]></PrecedingBlockPattern>
+                <FollowingBlockPattern><![CDATA[\/\*\*]]></FollowingBlockPattern>
+                <FailureMessage>Нарушен порядок блоков: блок разметки ([ENTITY]/[RELATION]) должен быть определен ПЕРЕД KDoc-контрактом.</FailureMessage>
+            </Check>
+            
+            <!-- 
+              ПРОВЕРКА 2: Тип сущности в [ENTITY] должен быть из разрешенного списка.
+            -->
+            <Check type="entity_type_validation" scope="entity">
+                <Description>Тип сущности в якоре [ENTITY] должен принадлежать к предопределенной таксономии.</Description>
+                <ValidEntityTypes>
+                    <Type>Module</Type><Type>Class</Type><Type>Interface</Type><Type>Object</Type>
+                    <Type>DataClass</Type><Type>SealedInterface</Type><Type>EnumClass</Type><Type>Function</Type>
+                    <Type>UseCase</Type><Type>ViewModel</Type><Type>Repository</Type><Type>DataStructure</Type>
+                    <Type>DatabaseTable</Type><Type>ApiEndpoint</Type>
+                </ValidEntityTypes>
+                <FailureMessage>Использован невалидный тип сущности в якоре [ENTITY].</FailureMessage>
+            </Check>
+
+            <!-- 
+              ПРОВЕРКА 3: Все [RELATION] триплеты должны иметь корректный формат и валидный тип связи.
+            -->
+            <Check type="relation_validation" scope="entity">
+                <Description>Якоря [RELATION] должны соответствовать формату семантического триплета и использовать валидные типы связей.</Description>
+                <TripletPattern><![CDATA[//\s*\[RELATION:\s*'(?P<subject_type>\w+)'\('(?P<subject_name>.*?)'\)\s*->\s*\[(?P<relation_type>\w+)\]\s*->\s*\['(?P<object_type>\w+)'\('(?P<object_name>.*?)'\)\]]]></TripletPattern>
+                <ValidRelationTypes>
+                    <Type>CALLS</Type><Type>CREATES_INSTANCE_OF</Type><Type>INHERITS_FROM</Type><Type>IMPLEMENTS</Type>
+                    <Type>READS_FROM</Type><Type>WRITES_TO</Type><Type>MODIFIES_STATE_OF</Type><Type>DEPENDS_ON</Type>
+                    <Type>DISPATCHES_EVENT</Type><Type>OBSERVES</Type><Type>TRIGGERS</Type><Type>EMITS_STATE</Type><Type>CONSUMES_STATE</Type>
+                </ValidRelationTypes>
+                <FailureMessage>Якорь [RELATION] имеет неверный формат или использует невалидный тип связи.</FailureMessage>
+            </Check>
+            
+            <!-- 
+              ПРОВЕРКА 4: Вся разметка ([ENTITY] и [RELATION]) должна быть в едином непрерывном блоке.
+              Это реализация правила 'MarkupBlockCohesion'.
+            -->
+            <Check type="markup_cohesion" scope="entity">
+                <Description>Вся семантическая разметка ([ENTITY] и [RELATION]) для одной сущности должна быть сгруппирована в единый непрерывный блок комментариев.</Description>
+                <FailureMessage>Нарушена целостность блока разметки: обнаружены строки кода или пустые строки между якорями [ENTITY] и [RELATION].</FailureMessage>
+            </Check>
+        </Checks>
+    </Definition>
+</Rule>

agent_promts/knowledge_base/semantic_linting.md

@@ -1,76 +0,0 @@
-[SemanticLintingCompliance]
-**Tags:** LINTING, SEMANTICS, STRUCTURE, ANCHORS, FILE_HEADER, TAXONOMY
-
-> Этот принцип определяет строгие правила структурирования кода, которые превращают его из простого текста в машиночитаемый, 'линтуемый' семантический артефакт. Моя задача — генерировать код, который не просто работает, но и на 100% соответствует этим правилам. Это не рекомендации по стилю, а строгие требования к архитектуре файла.
-
-## Rules
-
-### FileHeaderIntegrity
-Каждый `.kt` файл ДОЛЖЕН начинаться со стандартного заголовка из трех якорей, за которым следует объявление `package`. Порядок строгий и не подлежит изменению.
-
-**Rationale:** Этот заголовок служит 'паспортом' файла, позволяя любому инструменту (включая меня) мгновенно понять его расположение, имя и основное назначение, не парся код.
-
-**Example:**
-```kotlin
-// [PACKAGE] com.example.your.package.name
-// [FILE] YourFileName.kt
-// [SEMANTICS] ui, viewmodel, state_management
-package com.example.your.package.name
-```
-
-### SemanticKeywordTaxonomy
-Содержимое якоря `[SEMANTICS]` ДОЛЖНО состоять из ключевых слов, выбранных из предопределенного, контролируемого списка (таксономии).
-
-**Rationale:** Это устраняет неоднозначность и обеспечивает консистентность семантического тегирования по всему проекту, делая поиск и анализ на основе этих тегов надежным и предсказуемым.
-
-#### Example Taxonomy
-- **Layer**: `ui`, `domain`, `data`, `presentation`
-- **Component**: `viewmodel`, `usecase`, `repository`, `service`, `screen`, `component`, `dialog`, `model`, `entity`
-- **Concern**: `networking`, `database`, `caching`, `authentication`, `validation`, `parsing`, `state_management`, `navigation`, `di`, `testing`
-
-### EntityContainerization
-Каждая ключевая сущность (`class`, `interface`, `object`, `data class`, `sealed class`, `enum class` и каждая публичная `fun`) ДОЛЖНА быть обернута в 'семантический контейнер'. Контейнер состоит из двух частей: открывающего блока разметки ПЕРЕД сущностью и закрывающего якоря ПОСЛЕ нее.
-
-**Rationale:** Это превращает плоский текстовый файл в иерархическое дерево семантических узлов. Это позволяет будущим AI-инструментам надежно парсить, анализировать и рефакторить код, точно зная, где начинается и заканчивается каждая сущность.
-
-**Structure:**
-1.  **Открывающий Блок Разметки:** Располагается непосредственно перед KDoc/декларацией. Содержит сначала якорь `[ENTITY]`.
-2.  **Тело Сущности:** KDoc, сигнатура и тело функции/класса.
-3.  **Закрывающий Якорь:** Располагается сразу после закрывающей фигурной скобки `}` сущности. Формат: `// [END_ENTITY: Type('Name')]`.
-
-**Example:**
-```kotlin
-// [ENTITY: DataClass('Success')]
-/**
- * @summary Состояние успеха...
- */
-data class Success(val labels: List<Label>) : LabelsListUiState
-// [END_ENTITY: DataClass('Success')]
-```
-
-### StructuralAnchors
-Крупные, не относящиеся к конкретной сущности блоки файла, такие как импорты и главный контракт файла, также должны быть обернуты в парные якоря.
-
-**Rationale:** Это четко разграничивает секции файла, позволяя инструментам работать с ними изолированно (например, 'добавить новый импорт в блок `[IMPORTS]`').
-
-**Pairs:**
-- `// [IMPORTS]` и `// [END_IMPORTS]`
-- `// [CONTRACT]` и `// [END_CONTRACT]`
-
-### FileTermination
-Каждый файл должен заканчиваться специальным закрывающим якорем, который сигнализирует о его полном завершении.
-
-**Rationale:** Это служит надежным маркером конца файла, защищая от случайного усечения и упрощая парсинг.
-
-**Template:** `// [END_FILE_YourFileName.kt]`
-
-### NoStrayComments
-Традиционные, 'человеческие' комментарии (`// Вот это сложная логика` или `/* ... */`) КАТЕГОРИЧЕСКИ ЗАПРЕЩЕНЫ.
-
-**Rationale:** Такие комментарии являются 'семантическим шумом' для AI. Они неструктурированы, часто устаревают и не могут быть использованы для автоматического анализа. Вся необходимая информация должна передаваться через семантические якоря или формальные KDoc-контракты.
-
-#### Approved Alternative
-В исключительном случае, когда мне нужно оставить заметку для другого AI-агента или для себя в будущем (например, объяснить сложное архитектурное решение), я использую специальный, структурированный якорь:
-
-**Format:** `// [AI_NOTE]: Пояснение сложного решения.`
-[/End SemanticLintingCompliance]

agent_promts/knowledge_base/semantic_linting.xml

@@ -0,0 +1,132 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<SemanticProtocol version="1.1">
+    <Description>
+        Этот документ является единственным источником истины для правил, которые должны
+        соблюдаться в кодовой базе. Он используется как для автоматизированной валидации
+        (Python-скриптом), так и в качестве инструкции для LLM-агентов.
+    </Description>
+
+    <Rules>
+        <Rule id="FileHeaderIntegrity" enforcement="strict">
+            <Description>Каждый `.kt` файл ДОЛЖЕН начинаться со стандартного заголовка из трех якорей, за которым следует объявление package.</Description>
+            <Rationale>Заголовок служит 'паспортом' файла, позволяя инструментам мгновенно понять его расположение, имя и назначение.</Rationale>
+            <Definition type="regex">
+                <!-- CDATA используется для того, чтобы символы вроде '<' или '>' не были интерпретированы как XML -->
+                <Pattern><![CDATA[^\s*//\s*\[FILE\]\s*(?P<file>.*?)\n//\s*\[SEMANTICS\]\s*(?P<semantics>.*)]]></Pattern>
+            </Definition>
+            <Example><![CDATA[
+// [FILE] YourFileName.kt
+// [SEMANTICS] ui, viewmodel, state_management
+package com.example.your.package.name
+            ]]></Example>
+        </Rule>
+        <Rule id="SemanticKeywordTaxonomy" enforcement="strict">
+            <Description>Содержимое якоря [SEMANTICS] ДОЛЖНО состоять из ключевых слов, выбранных из предопределенного списка (таксономии).</Description>
+            <Rationale>Устраняет неоднозначность и обеспечивает консистентность тегирования по всему проекту.</Rationale>
+            <Definition type="taxonomy" targetGroup="semantics" delimiter=",">
+                <AllowedValues>
+                    <Group name="Layer">
+                        <Value>ui</Value><Value>domain</Value><Value>data</Value><Value>presentation</Value>
+                    </Group>
+                    <Group name="Component">
+                        <Value>viewmodel</Value><Value>usecase</Value><Value>repository</Value><Value>service</Value><Value>screen</Value><Value>component</Value><Value>dialog</Value><Value>model</Value><Value>entity</Value><Value>activity</Value><Value>application</Value><Value>nav_host</Value><Value>controller</Value><Value>navigation_drawer</Value><Value>scaffold</Value><Value>dashboard</Value><Value>item</Value><Value>label</Value><Value>location</Value><Value>setup</Value><Value>theme</Value><Value>dependencies</Value><Value>custom_field</Value><Value>statistics</Value><Value>image</Value><Value>attachment</Value><Value>item_creation</Value><Value>item_detailed</Value><Value>item_summary</Value><Value>item_update</Value><Value>summary</Value><Value>update</Value>
+                    </Group>
+                    <Group name="Concern">
+                        <Value>networking</Value><Value>database</Value><Value>caching</Value><Value>authentication</Value><Value>validation</Value><Value>parsing</Value><Value>state_management</Value><Value>navigation</Value><Value>di</Value><Value>testing</Value><Value>entrypoint</Value><Value>hilt</Value><Value>timber</Value><Value>compose</Value><Value>actions</Value><Value>routes</Value><Value>common</Value><Value>color_selection</Value><Value>loading</Value><Value>list</Value><Value>details</Value><Value>edit</Value><Value>label_management</Value><Value>labels_list</Value><Value>dialog_management</Value><Value>locations</Value><Value>sealed_state</Value><Value>parallel_data_loading</Value><Value>timber_logging</Value><Value>dialog</Value><Value>color</Value><Value>typography</Value><Value>build</Value><Value>data_transfer_object</Value><Value>dto</Value><Value>api</Value><Value>item_creation</Value><Value>item_detailed</Value><Value>item_summary</Value><Value>item_update</Value><Value>create</Value><Value>mapper</Value><Value>count</Value><Value>user_setup</Value><Value>authentication_flow</Value>
+                    </Group>
+                    <Group name="LanguageConstruct">
+                        <Value>sealed_class</Value><Value>sealed_interface</Value>
+                    </Group>
+                    <Group name="Pattern">
+                        <Value>ui_logic</Value><Value>ui_state</Value><Value>data_model</Value><Value>immutable</Value>
+                    </Group>
+                </AllowedValues>
+            </Definition>
+        </Rule>
+        <Rule id="EntityContainerization" enforcement="strict">
+            <Description>Каждая ключевая сущность (class, interface, fun и т.д.) ДОЛЖНА быть обернута в парные якоря [ENTITY]...[END_ENTITY].</Description>
+            <Rationale>Превращает плоский текстовый файл в иерархическое дерево семантических узлов для надежного парсинга AI-инструментами.</Rationale>
+            <Definition type="paired_regex">
+                <!-- Обратные ссылки (?P=type) и (?P=name) гарантируют симметричность тегов -->
+                <Pattern name="start"><![CDATA[//\s*\[ENTITY:\s*(?P<type>\w+)\('(?P<name>.*?)'\)\]]]></Pattern>
+                <Pattern name="end"><![CDATA[//\s*\[END_ENTITY:\s*(?P=type)\('(?P=name)'\)\]]]></Pattern>
+            </Definition>
+            <Example><![CDATA[
+// [ENTITY: DataClass('Success')]
+/**
+ * @summary Состояние успеха...
+ */
+data class Success(val labels: List<Label>) : LabelsListUiState
+// [END_ENTITY: DataClass('Success')]
+            ]]></Example>
+        </Rule>
+        <Rule id="StructuralAnchors" enforcement="strict">
+            <Description>Крупные, не относящиеся к конкретной сущности блоки файла, также должны быть обернуты в парные якоря.</Description>
+            <Rationale>Четко разграничивает секции файла, позволяя инструментам работать с ними изолированно (например, 'добавить новый импорт в блок IMPORTS').</Rationale>
+            <Definition type="paired_tags">
+                <Pairs>
+                    <Pair><Start>// [IMPORTS]</Start><End>// [END_IMPORTS]</End></Pair>
+                    <Pair><Start>// [CONTRACT]</Start><End>// [END_CONTRACT]</End></Pair>
+                </Pairs>
+            </Definition>
+            <Example><![CDATA[
+// ... file header ...
+package com.example
+
+// [IMPORTS]
+import a.b.c
+// [END_IMPORTS]
+
+// [CONTRACT]
+/** @summary ... */
+interface YourMainInterface
+// [END_CONTRACT]
+            ]]></Example>
+        </Rule>
+        
+        <Rule id="FileTermination" enforcement="strict">
+            <Description>Каждый файл должен заканчиваться специальным закрывающим якорем, который сигнализирует о его полном завершении.</Description>
+            <Rationale>Служит надежным маркером конца файла, защищая от случайного усечения и упрощая парсинг.</Rationale>
+            <Definition type="dynamic_regex">
+                <!-- Плейсхолдер {file_name} будет заменяться на имя файла во время валидации -->
+                <Pattern><![CDATA[//\s*\[END_FILE_{file_name}\]\s*$]]></Pattern>
+            </Definition>
+            <Example><![CDATA[
+// ... file content ...
+}
+// [END_ENTITY: SomeClass('MyClass')]
+
+// [END_FILE_MyClass.kt]
+            ]]></Example>
+        </Rule>
+        <Rule id="NoStrayComments" enforcement="strict">
+            <Description>Традиционные, 'человеческие' комментарии (`// ...` или `/* ... */`) КАТЕГОРИЧЕСКИ ЗАПРЕЩЕНЫ.</Description>
+            <Rationale>Такие комментарии являются 'семантическим шумом' для AI, неструктурированы и не могут быть использованы для автоматического анализа.</Rationale>
+            <Definition type="negative_regex">
+                <!-- Этот regex находит // (не являющийся частью якоря) и блочные комментарии /* */ -->
+                <Pattern><![CDATA[(?<!\[)\s*\/\/[^\[\n\r]*|(?<!:)\/\*[\s\S]*?\*\/]]></Pattern>
+            </Definition>
+            <Example type="forbidden"><![CDATA[
+// Это плохой, запрещенный комментарий
+val x = 1 
+
+/*
+    И это тоже запрещено
+*/
+val y = 2
+            ]]></Example>
+        </Rule>
+        <Rule id="ApprovedAINote" enforcement="allowed">
+            <Description>Единственным исключением из правила 'NoStrayComments' является специальный, структурированный якорь для заметок между AI-агентами.</Description>
+            <Rationale>Позволяет оставлять пояснения к сложным архитектурным решениям в машиночитаемом формате.</Rationale>
+            <Definition type="regex">
+                <Pattern><![CDATA[//\s*\[AI_NOTE\]:\s*(.*)]]></Pattern>
+            </Definition>
+            <Example type="allowed"><![CDATA[
+// [AI_NOTE]: Эта реализация использует кастомный алгоритм из-за требований к производительности.
+fun processData() { /* ... */ }
+            ]]></Example>
+        </Rule>
+
+    </Rules>
+</SemanticProtocol>

agent_promts/protocols/semantic_enrichment_protocol.xml

@@ -4,9 +4,9 @@
         <VERSION>1.0</VERSION>
     </META>
     <INCLUDES>
-        <INCLUDE from="../knowledge_base/semantic_linting.md"/>
-        <INCLUDE from="../knowledge_base/graphrag_optimization.md"/>
-        <INCLUDE from="../knowledge_base/design_by_contract.md"/>
-        <INCLUDE from="../knowledge_base/ai_friendly_logging.md"/>
+        <INCLUDE from="../knowledge_base/semantic_linting.xml"/>
+        <INCLUDE from="../knowledge_base/graphrag_optimization.xml"/>
+        <INCLUDE from="../knowledge_base/design_by_contract.xml"/>
+        <INCLUDE from="../knowledge_base/ai_friendly_logging.xml"/>
     </INCLUDES>
 </SEMANTIC_ENRICHMENT_PROTOCOL>

agent_promts/roles/architect.xml

@@ -18,7 +18,7 @@
     </META>
 
     <ROLE_DEFINITION>
-        <SPECIALIZATION>При исполнении этой роли, я, Gemini, действую как стратегический интерфейс между человеком-архитектором и автоматизированной системой разработки. Моя задача — вести итеративный диалог для уточнения целей, анализировать кодовую базу и, после получения одобрения, инициировать производственную цепочку через выбранный канал задач.</SPECIALIZATION>
+        <SPECIALIZATION>При исполнении этой роли, я действую как стратегический интерфейс между человеком-архитектором и автоматизированной системой разработки. Моя задача — вести итеративный диалог для уточнения целей, анализировать кодовую базу и, после получения одобрения, инициировать производственную цепочку через выбранный канал задач.</SPECIALIZATION>
         <CORE_GOAL>Основная цель этой роли — трансформировать неструктурированный человеческий диалог в структурированный, машиночитаемый и полностью готовый к исполнению `Work Order` для роли 'Агента-Разработчика'.</CORE_GOAL>
     </ROLE_DEFINITION>
 

agent_promts/roles/documentation.xml

@@ -1,23 +1,28 @@
+<?xml version="1.0" encoding="UTF-8"?>
 <AI_AGENT_DOCUMENTATION_PROTOCOL>
     <EXTENDS from="base_role.xml"/>
 
     <META>
-        <PURPOSE>Этот документ определяет операционный протокол для **исполнения роли 'Агента Документации'**. Главная задача — синхронизация `PROJECT_MANIFEST.xml` с текущим состоянием кодовой базы.</PURPOSE>
-        <VERSION>5.0</VERSION>
-
-        <METRICS_TO_COLLECT>
-            <COLLECTS group_id="core_metrics"/>
-            <COLLECTS group_id="documentation_specific"/>
-        </METRICS_TO_COLLECT>
+        <PURPOSE>
+            Этот документ определяет операционный протокол для исполнения роли 'Агента Документации'.
+            Главная задача — синхронизация `PROJECT_MANIFEST.xml` с текущим состоянием кодовой базы.
+            Анализ кодовой базы выполняется с помощью внешнего Python-скрипта, который руководствуется
+            правилами из `semantic_protocol.xml`.
+        </PURPOSE>
+        <VERSION>6.0</VERSION>
 
         <DEPENDS_ON>
             - ../interfaces/task_channel_interface.xml
-            - ../protocols/semantic_enrichment_protocol.xml
+            - ../protocols/semantic_protocol.xml
         </DEPENDS_ON>
     </META>
 
     <ROLE_DEFINITION>
-        <SPECIALIZATION>При исполнении этой роли, я, Gemini, действую как автоматизированный аудитор и синхронизатор проекта. Моя задача — обеспечить, чтобы `PROJECT_MANIFEST.xml` был точным отражением реального состояния кодовой базы.</SPECIALIZATION>
+        <SPECIALIZATION>
+            При исполнении этой роли, я, Gemini, действую как автоматизированный аудитор и оркестратор.
+            Моя задача — обеспечить, чтобы `PROJECT_MANIFEST.xml` был точным отражением реального
+            состояния кодовой базы, используя для анализа специализированные инструменты.
+        </SPECIALIZATION>
         <CORE_GOAL>Поддерживать целостность и актуальность `PROJECT_MANIFEST.xml` и фиксировать его изменения через предоставленный канал задач.</CORE_GOAL>
     </ROLE_DEFINITION>
 
@@ -42,71 +47,42 @@
         </TOOL>
         <TOOL name="Shell">
             <ALLOWED_COMMANDS>
-                <COMMAND>find . -name "*.kt"</COMMAND>
+                <COMMAND>find . -path '*/build' -prune -o -name "*.kt" -print</COMMAND>
+                <COMMAND>python3 extract_semantics.py --protocol agent_promts/protocols/semantic_protocol.xml [file_list]</COMMAND>
             </ALLOWED_COMMANDS>
         </TOOL>
     </TOOLS_FOR_ROLE>
 
     <MASTER_WORKFLOW name="Manifest_Synchronization_Cycle">
-        <WORKFLOW_STEP id="1" name="Find_Pending_Documentation_Tasks">
-            <ACTION>Использовать `MyTaskChannel.FindNextTask(RoleName='agent-docs', TaskType='type::documentation')` для получения задачи.</ACTION>
+        <WORKFLOW_STEP id="1" name="Find_And_Acknowledge_Task">
+            <GOAL>Найти и принять в работу задачу на синхронизацию манифеста.</GOAL>
+            <ACTION>Использовать `MyTaskChannel.FindNextTask` для поиска задачи с типом `type::documentation`.</ACTION>
+            <ACTION>Если задача найдена, изменить ее статус на `status::in-progress`.</ACTION>
         </WORKFLOW_STEP>
 
-        <WORKFLOW_STEP id="2" name="Process_Task">
-            <CONDITION>Если задача (`WorkOrder`) найдена:</CONDITION>
-            <SUB_WORKFLOW name="Process_Single_Sync_Issue">
-                <SUB_STEP id="2.1" name="Acknowledge_Task">
-                    <ACTION>Вызвать `MyTaskChannel.UpdateTaskStatus(IssueID={WorkOrder.ID}, OldStatus='status::pending', NewStatus='status::in-progress')`.</ACTION>
-                </SUB_STEP>
-                
-                <SUB_STEP id="2.2" name="Perform_Synchronization_Audit">
-                    <ACTION>Загрузить `tech_spec/PROJECT_MANIFEST.xml` в `original_manifest`.</ACTION>
-                    <ACTION>Получить список всех файлов `*.kt` в проекте.</ACTION>
-                    <ACTION>Сравнить список файлов с путями, указанными в `original_manifest`, чтобы определить `new_files`, `existing_files` и `deleted_files`.</ACTION>
-                    <ACTION>Инициализировать `updated_manifest` как копию `original_manifest`.</ACTION>
-
-                    <BLOCK name="Process_Deleted_Files">
-                        <ACTION>Для каждого удаленного файла, удалить соответствующий узел `<NODE>` из `updated_manifest`.</ACTION>
-                    </BLOCK>
-
-                    <BLOCK name="Process_New_And_Existing_Files">
-                        <ACTION>Для каждого файла в `new_files` и `existing_files`:</ACTION>
-                        <SUB_ACTION name="Parse_File_Semantics">
-                            <ACTION>a. Прочитать содержимое файла.</ACTION>
-                            <ACTION>b. Извлечь `[ENTITY: Type('Name')]`. **Если не найден**, создать задачу для `semantic_linter` с просьбой исправить файл и **пропустить** этот файл.</ACTION>
-                            <ACTION>c. Извлечь KDoc `@summary` и `@description`. Если нет, использовать имя файла и пустые строки.</ACTION>
-                            <ACTION>d. Извлечь все `[RELATION]` тэги.</ACTION>
-                            <ACTION>e. Сгенерировать `node_id` из типа и имени (например, `uc_process_payment`).</ACTION>
-                            <ACTION>f. Собрать всю информацию в `parsed_node_data`.</ACTION>
-                        </SUB_ACTION>
-                        <SUB_ACTION name="Update_Manifest">
-                            <ACTION>g. **Если файл новый**, создать новый элемент `<NODE>` из `parsed_node_data` и добавить его в `updated_manifest` в правильную секцию (определяется по пути к файлу).</ACTION>
-                            <ACTION>h. **Если файл существующий**, найти соответствующий узел в `updated_manifest` и обновить его, если `parsed_node_data` отличается.</ACTION>
-                        </SUB_ACTION>
-                    </BLOCK>
-                </SUB_STEP>
-
-                <SUB_STEP id="2.3" name="Check_For_Changes_And_Commit">
-                    <ACTION>**ЕСЛИ** `updated_manifest` отличается от `original_manifest`:</ACTION>
-                    <SUCCESS_PATH>
-                        <SUB_STEP>a. Сохранить `updated_manifest` в файл `tech_spec/PROJECT_MANIFEST.xml`.</SUB_STEP>
-                        <SUB_STEP>b. Сформировать сообщение коммита: `"chore(docs): sync project manifest\n\nTriggered by task #{WorkOrder.ID}."`</SUB_STEP>
-                        <SUB_STEP>c. Вызвать `MyTaskChannel.CommitManifestChanges(CommitMessage=...)`.</SUB_STEP>
-                        <SUB_STEP>d. Вызвать `MyTaskChannel.AddComment(IssueID={WorkOrder.ID}, CommentBody='Synchronization complete. Manifest updated and committed.')`</SUB_STEP>
-                    </SUCCESS_PATH>
-                    <ACTION>**ИНАЧЕ:**</ACTION>
-                    <NO_CHANGES_PATH>
-                        <SUB_STEP>a. Вызвать `MyTaskChannel.AddComment(IssueID={WorkOrder.ID}, CommentBody='Synchronization check complete. No changes detected.')`</SUB_STEP>
-                    </NO_CHANGES_PATH>
-                </SUB_STEP>
-
-                <SUB_STEP id="2.4" name="Finalize_Issue">
-                    <ACTION>Вызвать `MyTaskChannel.UpdateTaskStatus(IssueID={WorkOrder.ID}, OldStatus='status::in-progress', NewStatus='status::completed')`.</ACTION>
-                </SUB_STEP>
-            </SUB_WORKFLOW>
+        <WORKFLOW_STEP id="2" name="Execute_Synchronization_Tool">
+            <GOAL>Запустить инструмент синхронизации и получить отчет о его работе.</GOAL>
+            <ACTION>Сформировать список всех `.kt` файлов в проекте, исключая директории `build` и другие ненужные, с помощью `find`.</ACTION>
+            <ACTION>
+                Выполнить `Shell` команду: 
+                `python3 extract_semantics.py --protocol agent_promts/protocols/semantic_enrichment_protocol.xml --manifest-path tech_spec/PROJECT_MANIFEST.xml --update-in-place [file_list]`
+            </ACTION>
+            <ACTION>Сохранить JSON-вывод скрипта в переменную `sync_report`.</ACTION>
         </WORKFLOW_STEP>
-        <WORKFLOW_STEP id="3" name="Log_Execution_Metrics">
-            <ACTION>Собрать и отправить метрики через `MyMetricsSink`.</ACTION>
+
+        <WORKFLOW_STEP id="3" name="Process_Report_And_Finalize">
+            <GOAL>На основе отчета от инструмента, зафиксировать изменения и завершить задачу.</GOAL>
+            <ACTION>Проанализировать `sync_report`. Если в `changes` есть изменения (`nodes_added > 0` и т.д.):</ACTION>
+            <SUCCESS_PATH>
+                <SUB_STEP>a. Сформировать сообщение коммита на основе статистики из `sync_report`.</SUB_STEP>
+                <SUB_STEP>b. Вызвать `MyTaskChannel.CommitChanges`.</SUB_STEP>
+                <SUB_STEP>c. Добавить в задачу комментарий об успешном обновлении манифеста.</SUB_STEP>
+            </SUCCESS_PATH>
+            <ACTION>В противном случае (изменений нет):</ACTION>
+            <NO_CHANGES_PATH>
+                <SUB_STEP>a. Добавить в задачу комментарий "Синхронизация завершена, изменений не найдено."</SUB_STEP>
+            </NO_CHANGES_PATH>
+            <ACTION>Закрыть задачу, изменив ее статус на `status::completed`, и отправить метрики.</ACTION>
         </WORKFLOW_STEP>
     </MASTER_WORKFLOW>
 </AI_AGENT_DOCUMENTATION_PROTOCOL>

agent_promts/roles/semantic_enrichment_agent.xml

@@ -0,0 +1,105 @@
+<![CDATA[
+<AI_AGENT_SEMANTIC_ENRICHMENT_PROTOCOL>
+    <EXTENDS from="base_role.xml"/>
+
+    <META>
+        <PURPOSE>Этот документ определяет операционный протокол для **исполнения роли 'Агента Семантического Обогащения'**. Главная задача — обогащение кодовой базы семантической информацией согласно `SEMANTIC_ENRICHMENT_PROTOCOL`.</PURPOSE>
+        <VERSION>1.0</VERSION>
+
+        <METRICS_TO_COLLECT>
+            <COLLECTS group_id="core_metrics"/>
+            <COLLECTS group_id="enrichment_specific"/>
+        </METRICS_TO_COLLECT>
+
+        <DEPENDS_ON>
+            - ..agent_promts/interfaces/task_channel_interface.xml
+            - ..agent_promts/protocols/semantic_enrichment_protocol.xml
+        </DEPENDS_ON>
+    </META>
+
+    <ROLE_DEFINITION>
+        <SPECIALIZATION>При исполнении этой роли, я действую как агент семантического обогащения. Моя задача - находить и размечать код, добавляя ему семантическую ценность в соответствии с протоколом.</SPECIALIZATION>
+        <CORE_GOAL>Проактивно обогащать кодовую базу семантической разметкой для улучшения машиночитаемости и анализа.</CORE_GOAL>
+    </ROLE_DEFINITION>
+
+    <CORE_PHILOSOPHY>
+        <PHILOSOPHY_PRINCIPLE name="Enrich_Dont_Change_Logic">
+            <DESCRIPTION>Моя работа заключается в добавлении семантических комментариев и аннотаций, не изменяя логику существующего кода.</DESCRIPTION>
+        </PHILOSOPHY_PRINCIPLE>
+        <PHILOSOPHY_PRINCIPLE name="Traceable_And_Reviewable">
+            <DESCRIPTION>Все изменения должны быть доступны для просмотра, например, через Pull Request.</DESCRIPTION>
+        </PHILOSOPHY_PRINCIPLE>
+    </CORE_PHILOSOPHY>
+
+    <BOOTSTRAP_PROTOCOL name="Initialization">
+        <ACTION>Загрузить и полностью проанализировать `agent_promts/protocols/semantic_enrichment_protocol.xml`, включая все вложенные `INCLUDE` файлы, для построения полного набора правил в памяти.</ACTION>
+    </BOOTSTRAP_PROTOCOL>
+
+    <TASK_SPECIFICATION name="Enrichment_Task">
+        <DESCRIPTION>Задачи для этой роли определяют, какие части кодовой базы нужно обогатить.</DESCRIPTION>
+        <STRUCTURE>
+            <![CDATA[
+<ENRICHMENT_TASK>
+    <SCOPE>full_project | directory | file_list</SCOPE>
+    <TARGET>
+        <!-- Для directory: path/to/dir -->
+        <!-- Для file_list: список файлов -->
+    </TARGET>
+</ENRICHMENT_TASK>
+            ]]>
+        </STRUCTURE>
+    </TASK_SPECIFICATION>
+
+    <MASTER_WORKFLOW name="Enrich_Code_And_Create_PR">
+        <WORKFLOW_STEP id="1" name="Acknowledge_Task">
+            <LET name="WorkOrder" value="CALL MyTaskChannel.FindNextTask(RoleName='agent-enrichment', TaskType='type::enrichment')"/>
+            <IF condition="WorkOrder IS NULL">
+                <TERMINATE/>
+            </IF>
+            <ACTION>CALL MyTaskChannel.UpdateTaskStatus(IssueID={WorkOrder.ID}, NewStatus='status::in-progress')</ACTION>
+        </WORKFLOW_STEP>
+
+        <WORKFLOW_STEP id="2" name="Execute_Enrichment">
+            <ACTION>Извлечь `<ENRICHMENT_TASK>` из `WorkOrder`.</ACTION>
+            <LET name="BranchName">feature/{WorkOrder.ID}/semantic-enrichment</LET>
+            <ACTION>CALL MyTaskChannel.CreateBranch(BranchName={BranchName})</ACTION>
+            <ACTION>Определить `files_to_process` на основе `SCOPE` и `TARGET`.</ACTION>
+            <ACTION>Для каждого файла в `files_to_process` применить правила из `SEMANTIC_ENRICHMENT_PROTOCOL`.</ACTION>
+        </WORKFLOW_STEP>
+
+        <WORKFLOW_STEP id="3" name="Commit_And_PR">
+            <IF condition="есть_изменения">
+                <ACTION>Сделать коммит с сообщением: `feat(enrichment): apply semantic markup`.</ACTION>
+                <ACTION>CALL MyTaskChannel.CommitChanges(...)</ACTION>
+                <LET name="PrID" value="CALL MyTaskChannel.CreatePullRequest(Title='feat(enrichment): Semantic Markup', Body='Closes #{WorkOrder.ID}', HeadBranch={BranchName}, BaseBranch='main')"/>
+                <ACTION>CALL MyTaskChannel.AddComment(IssueID={WorkOrder.ID}, CommentBody='Enrichment complete. PR #{PrID} is ready for review.')</ACTION>
+            </IF>
+            <ELSE>
+                <ACTION>CALL MyTaskChannel.AddComment(IssueID={WorkOrder.ID}, CommentBody='Enrichment complete. No new semantic markup was added.')</ACTION>
+            </ELSE>
+        </WORKFLOW_STEP>
+
+        <WORKFLOW_STEP id="4" name="Finalize">
+            <ACTION>CALL MyTaskChannel.UpdateTaskStatus(IssueID={WorkOrder.ID}, NewStatus='status::completed')</ACTION>
+        </WORKFLOW_STEP>
+        
+        <WORKFLOW_STEP id="5" name="Log_Metrics">
+            <ACTION>Отправить метрики через `MyMetricsSink`.</ACTION>
+        </WORKFLOW_STEP>
+
+        <WORKFLOW_STEP id="6" name="Log_Completion">
+            <REQUIRES_CHANNEL type="LogSink" as="MyLogSink"/>
+            <LET name="EnrichmentMetrics" value="CALL MyMetricsSink.GetMetrics(group_id='enrichment_specific')"/>
+            <LET name="LogMessage">
+`WorkOrder {WorkOrder.ID} completed.
+    - Files Processed: {EnrichmentMetrics.files_processed}
+    - Entities Enriched: {EnrichmentMetrics.entities_enriched}
+    - Relations Added: {EnrichmentMetrics.relations_added}
+    - Contracts Added: {EnrichmentMetrics.contracts_added}
+    - Logs Added: {EnrichmentMetrics.logs_added}`
+            </LET>
+            <ACTION>CALL MyLogSink.Log(FileName="logs/enrichment_agent_log.txt", Content={LogMessage})</ACTION>
+        </WORKFLOW_STEP>
+    </MASTER_WORKFLOW>
+</AI_AGENT_SEMANTIC_ENRICHMENT_PROTOCOL>
+]]>

agent_promts/roles/semantic_linter.xml

@@ -11,13 +11,13 @@
         </METRICS_TO_COLLECT>
 
         <DEPENDS_ON>
-            - ../interfaces/task_channel_interface.xml
-            - ../protocols/semantic_enrichment_protocol.xml
+            - ..agent_promts/interfaces/task_channel_interface.xml
+            - ..agent_promts/protocols/semantic_enrichment_protocol.xml
         </DEPENDS_ON>
     </META>
 
     <ROLE_DEFINITION>
-        <SPECIALIZATION>При исполнении этой роли, я, Gemini, действую как автоматизированный хранитель чистоты кода. Моя единственная задача — обеспечить, чтобы каждый файл в указанной области соответствовал `SEMANTIC_ENRICHMENT_PROTOCOL`.</SPECIALIZATION>
+        <SPECIALIZATION>При исполнении этой роли, я, действую как автоматизированный хранитель чистоты кода. Моя единственная задача — обеспечить, чтобы каждый файл в указанной области соответствовал `SEMANTIC_ENRICHMENT_PROTOCOL`.</SPECIALIZATION>
         <CORE_GOAL>Поддерживать 100% семантическую чистоту и машиночитаемость кодовой базы, делая все изменения отслеживаемыми через систему контроля версий.</CORE_GOAL>
     </ROLE_DEFINITION>
 
@@ -30,33 +30,6 @@
         </PHILOSOPHY_PRINCIPLE>
     </CORE_PHILOSOPHY>
 
-    <TOOLS_FOR_ROLE>
-        <TOOL name="CodeEditor">
-             <COMMANDS><COMMAND name="ReadFile"/><COMMAND name="WriteFile"/></COMMANDS>
-        </TOOL>
-        <TOOL name="Shell">
-            <ALLOWED_COMMANDS>
-                <COMMAND>find . -name "*.kt"</COMMAND>
-                <COMMAND>git diff --name-only {commit_range}</COMMAND>
-            </ALLOWED_COMMANDS>
-        </TOOL>
-    </TOOLS_FOR_ROLE>
-
-    <ISSUE_BODY_FORMAT name="Linting_Task_Specification">
-        <DESCRIPTION>Задачи для этой роли должны содержать XML-блок, определяющий режим работы.</DESCRIPTION>
-        <STRUCTURE>
-            <![CDATA[
-<LINTING_TASK>
-    <MODE>full_project | recent_changes | single_file</MODE>
-    <TARGET>
-        <!-- Для recent_changes: commit range, e.g., HEAD~1..HEAD -->
-        <!-- Для single_file: path/to/file.kt -->
-    </TARGET>
-</LINTING_TASK>
-            ]]>
-        </STRUCTURE>
-    </ISSUE_BODY_FORMAT>
-
     <MASTER_WORKFLOW name="Lint_And_Create_Pull_Request_Cycle">
         <WORKFLOW_STEP id="1" name="Find_And_Acknowledge_Task">
             <LET name="WorkOrder" value="CALL MyTaskChannel.FindNextTask(RoleName='agent-linter', TaskType='type::linting')"/>

agent_promts/shared/metrics_catalog.xml

@@ -44,4 +44,12 @@
         <METRIC id="manual_verification_time_min" type="integer" description="Время, затраченное на ручную проверку, в минутах."/>
     </METRIC_GROUP>
 
+    <METRIC_GROUP id="enrichment_specific">
+        <METRIC name="files_processed" type="integer" unit="files">Количество обработанных файлов.</METRIC>
+        <METRIC name="entities_enriched" type="integer" unit="entities">Количество обогащенных сущностей (добавлены якоря ENTITY).</METRIC>
+        <METRIC name="relations_added" type="integer" unit="relations">Количество добавленных семантических связей (якоря RELATION).</METRIC>
+        <METRIC name="contracts_added" type="integer" unit="contracts">Количество добавленных KDoc-контрактов.</METRIC>
+        <METRIC name="logs_added" type="integer" unit="logs">Количество добавленных структурированных логов.</METRIC>
+    </METRIC_GROUP>
+
 </METRICS_CATALOG>

app/build.gradle.kts

@@ -54,6 +54,10 @@ android {
             excludes += "/META-INF/{AL2.0,LGPL2.1}"
         }
     }
+    lint {
+        checkReleaseBuilds = false
+        abortOnError = false
+    }
 }
 
 dependencies {

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

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens
 // [FILE] MainActivity.kt
-// [SEMANTICS] ui, activity, entrypoint
+// [SEMANTICS] app, ui, activity, entrypoint
 package com.homebox.lens
 
 // [IMPORTS]
@@ -22,7 +21,7 @@ import timber.log.Timber
 
 // [ENTITY: Activity('MainActivity')]
 /**
- * @summary Главная и единственная Activity в приложении.
+ * @summary The main and only Activity in the application.
  */
 @AndroidEntryPoint
 class MainActivity : ComponentActivity() {

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

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens
 // [FILE] MainApplication.kt
-// [SEMANTICS] application, hilt, timber
+// [SEMANTICS] app, hilt, timber, entrypoint
 package com.homebox.lens
 
 // [IMPORTS]
@@ -11,7 +10,7 @@ import timber.log.Timber
 
 // [ENTITY: Application('MainApplication')]
 /**
- * @summary Точка входа в приложение. Инициализирует Hilt и Timber.
+ * @summary The entry point of the application. Initializes Hilt and Timber.
  */
 @HiltAndroidApp
 class MainApplication : Application() {

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

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.navigation
 // [FILE] NavGraph.kt
-// [SEMANTICS] navigation, compose, nav_host
+// [SEMANTICS] app, ui, navigation
 
 package com.homebox.lens.navigation
 
@@ -25,17 +24,20 @@ import com.homebox.lens.ui.screen.locationedit.LocationEditScreen
 import com.homebox.lens.ui.screen.locationslist.LocationsListScreen
 import com.homebox.lens.ui.screen.search.SearchScreen
 import com.homebox.lens.ui.screen.setup.SetupScreen
+import com.homebox.lens.ui.screen.settings.SettingsScreen
+import com.homebox.lens.ui.screen.splash.SplashScreen
 // [END_IMPORTS]
 
 // [ENTITY: Function('NavGraph')]
 // [RELATION: Function('NavGraph')] -> [DEPENDS_ON] -> [Framework('NavHostController')]
 // [RELATION: Function('NavGraph')] -> [CREATES_INSTANCE_OF] -> [Class('NavigationActions')]
+// [RELATION: Function('NavGraph')] -> [USES] -> [Screen('SplashScreen')]
 /**
- * @summary Определяет граф навигации для всего приложения с использованием Jetpack Compose Navigation.
- * @param navController Контроллер навигации.
+ * @summary Defines the navigation graph for the entire application using Jetpack Compose Navigation.
+ * @param navController The navigation controller.
  * @see Screen
- * @sideeffect Регистрирует все экраны и управляет состоянием навигации.
- * @invariant Стартовый экран - `Screen.Setup`.
+ * @sideeffect Registers all screens and manages the navigation state.
+ * @invariant The start screen is `Screen.Splash`.
  */
 @Composable
 fun NavGraph(
@@ -47,11 +49,13 @@ fun NavGraph(
     val navigationActions = remember(navController) {
         NavigationActions(navController)
     }
-
     NavHost(
         navController = navController,
-        startDestination = Screen.Setup.route
+        startDestination = Screen.Splash.route
     ) {
+        composable(route = Screen.Splash.route) {
+            SplashScreen(navController = navController)
+        }
         composable(route = Screen.Setup.route) {
             SetupScreen(onSetupComplete = {
                 navController.navigate(Screen.Dashboard.route) {
@@ -137,6 +141,12 @@ fun NavGraph(
                 navigationActions = navigationActions
             )
         }
+        composable(route = Screen.Settings.route) {
+            SettingsScreen(
+                currentRoute = currentRoute,
+                navigationActions = navigationActions
+            )
+        }
     }
 }
 // [END_ENTITY: Function('NavGraph')]

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

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.navigation
 // [FILE] NavigationActions.kt
-// [SEMANTICS] navigation, controller, actions
+// [SEMANTICS] app, ui, navigation, actions
 package com.homebox.lens.navigation
 
 // [IMPORTS]
@@ -11,16 +10,16 @@ import timber.log.Timber
 // [ENTITY: Class('NavigationActions')]
 // [RELATION: Class('NavigationActions')] -> [DEPENDS_ON] -> [Framework('NavHostController')]
 /**
- * @summary Класс-обертка над NavHostController для предоставления типизированных навигационных действий.
- * @param navController Контроллер Jetpack Navigation.
- * @invariant Все навигационные действия должны использовать предоставленный navController.
+ * @summary Wrapper class over NavHostController to provide typed navigation actions.
+ * @param navController The Jetpack Navigation controller.
+ * @invariant All navigation actions must use the provided navController.
  */
 class NavigationActions(private val navController: NavHostController) {
 
     // [ENTITY: Function('navigateToDashboard')]
     /**
-     * @summary Навигация на главный экран.
-     * @sideeffect Очищает back stack до главного экрана, чтобы избежать циклов.
+     * @summary Navigation to the main screen.
+     * @sideeffect Clears the back stack up to the main screen to avoid cycles.
      */
     fun navigateToDashboard() {
         Timber.i("[INFO][ACTION][navigate_to_dashboard] Navigating to Dashboard.")

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

@@ -1,15 +1,18 @@
-// [PACKAGE] com.homebox.lens.navigation
 // [FILE] Screen.kt
-// [SEMANTICS] navigation, routes, sealed_class
+// [SEMANTICS] app, ui, navigation, routes
 package com.homebox.lens.navigation
 
 // [ENTITY: SealedClass('Screen')]
 /**
- * @summary Запечатанный класс для определения маршрутов навигации в приложении.
- * @description Обеспечивает типобезопасность при навигации.
- * @param route Строковый идентификатор маршрута.
+ * @summary Sealed class for defining navigation routes in the application.
+ * @description Provides type safety during navigation.
+ * @param route The string identifier of the route.
  */
 sealed class Screen(val route: String) {
+    // [ENTITY: Object('Splash')]
+    data object Splash : Screen("splash_screen")
+    // [END_ENTITY: Object('Splash')]
+
     // [ENTITY: Object('Setup')]
     data object Setup : Screen("setup_screen")
     // [END_ENTITY: Object('Setup')]
@@ -22,11 +25,11 @@ sealed class Screen(val route: String) {
     data object InventoryList : Screen("inventory_list_screen") {
         // [ENTITY: Function('withFilter')]
         /**
-         * @summary Создает маршрут для экрана списка инвентаря с параметром фильтра.
-         * @param key Ключ фильтра (например, "label" или "location").
-         * @param value Значение фильтра (например, ID метки или местоположения).
-         * @return Строку полного маршрута с query-параметром.
-         * @throws IllegalArgumentException если ключ или значение пустые.
+         * @summary Creates a route for the inventory list screen with a filter parameter.
+         * @param key The filter key (e.g., "label" or "location").
+         * @param value The filter value (e.g., the ID of the label or location).
+         * @return A string of the full route with a query parameter.
+         * @throws IllegalArgumentException if the key or value is blank.
          */
         fun withFilter(key: String, value: String): String {
             require(key.isNotBlank()) { "Filter key cannot be blank." }
@@ -43,10 +46,10 @@ sealed class Screen(val route: String) {
     data object ItemDetails : Screen("item_details_screen/{itemId}") {
         // [ENTITY: Function('createRoute')]
         /**
-         * @summary Создает маршрут для экрана деталей элемента с указанным ID.
-         * @param itemId ID элемента для отображения.
-         * @return Строку полного маршрута.
-         * @throws IllegalArgumentException если itemId пустой.
+         * @summary Creates a route for the item details screen with the specified ID.
+         * @param itemId The ID of the item to display.
+         * @return A string of the full route.
+         * @throws IllegalArgumentException if itemId is blank.
          */
         fun createRoute(itemId: String): String {
             require(itemId.isNotBlank()) { "itemId не может быть пустым." }
@@ -62,9 +65,9 @@ sealed class Screen(val route: String) {
     data object ItemEdit : Screen("item_edit_screen?itemId={itemId}") {
         // [ENTITY: Function('createRoute')]
         /**
-         * @summary Создает маршрут для экрана редактирования элемента с указанным ID.
-         * @param itemId ID элемента для редактирования. Null, если создается новый элемент.
-         * @return Строку полного маршрута.
+         * @summary Creates a route for the item edit screen with the specified ID.
+         * @param itemId The ID of the item to edit. Null if a new item is being created.
+         * @return A string of the full route.
          */
         fun createRoute(itemId: String? = null): String {
             return itemId?.let { "item_edit_screen?itemId=$it" } ?: "item_edit_screen"
@@ -81,9 +84,9 @@ sealed class Screen(val route: String) {
     data object LabelEdit : Screen("label_edit_screen?labelId={labelId}") {
         // [ENTITY: Function('createRoute')]
         /**
-         * @summary Создает маршрут для экрана редактирования метки с указанным ID.
-         * @param labelId ID метки для редактирования. Null, если создается новая метка.
-         * @return Строку полного маршрута.
+         * @summary Creates a route for the label edit screen with the specified ID.
+         * @param labelId The ID of the label to edit. Null if a new label is being created.
+         * @return A string of the full route.
          */
         fun createRoute(labelId: String? = null): String {
             return labelId?.let { "label_edit_screen?labelId=$it" } ?: "label_edit_screen"
@@ -100,10 +103,10 @@ sealed class Screen(val route: String) {
     data object LocationEdit : Screen("location_edit_screen/{locationId}") {
         // [ENTITY: Function('createRoute')]
         /**
-         * @summary Создает маршрут для экрана редактирования местоположения с указанным ID.
-         * @param locationId ID местоположения для редактирования.
-         * @return Строку полного маршрута.
-         * @throws IllegalArgumentException если locationId пустой.
+         * @summary Creates a route for the location edit screen with the specified ID.
+         * @param locationId The ID of the location to edit.
+         * @return A string of the full route.
+         * @throws IllegalArgumentException if locationId is blank.
          */
         fun createRoute(locationId: String): String {
             require(locationId.isNotBlank()) { "locationId не может быть пустым." }
@@ -118,6 +121,10 @@ sealed class Screen(val route: String) {
     // [ENTITY: Object('Search')]
     data object Search : Screen("search_screen")
     // [END_ENTITY: Object('Search')]
+
+    // [ENTITY: Object('Settings')]
+    data object Settings : Screen("settings_screen")
+    // [END_ENTITY: Object('Settings')]
 }
 // [END_ENTITY: SealedClass('Screen')]
 // [END_FILE_Screen.kt]

app/src/main/java/com/homebox/lens/ui/common/AppDrawer.kt

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.ui.common
 // [FILE] AppDrawer.kt
-// [SEMANTICS] ui, common, navigation_drawer
+// [SEMANTICS] app, ui, common, navigation
 package com.homebox.lens.ui.common
 
 // [IMPORTS]
@@ -30,10 +29,10 @@ import com.homebox.lens.navigation.Screen
 // [ENTITY: Function('AppDrawerContent')]
 // [RELATION: Function('AppDrawerContent')] -> [DEPENDS_ON] -> [Class('NavigationActions')]
 /**
- * @summary Контент для бокового навигационного меню (Drawer).
- * @param currentRoute Текущий маршрут для подсветки активного элемента.
- * @param navigationActions Объект с навигационными действиями.
- * @param onCloseDrawer Лямбда для закрытия бокового меню.
+ * @summary Content for the side navigation menu (Drawer).
+ * @param currentRoute The current route to highlight the active item.
+ * @param navigationActions The object with navigation actions.
+ * @param onCloseDrawer Lambda to close the side menu.
  */
 @Composable
 internal fun AppDrawerContent(

app/src/main/java/com/homebox/lens/ui/common/MainScaffold.kt

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.ui.common
 // [FILE] MainScaffold.kt
-// [SEMANTICS] ui, common, scaffold, navigation_drawer
+// [SEMANTICS] app, ui, common, scaffold
 
 package com.homebox.lens.ui.common
 
@@ -21,14 +20,14 @@ import kotlinx.coroutines.launch
 // [RELATION: Function('MainScaffold')] -> [DEPENDS_ON] -> [Class('NavigationActions')]
 // [RELATION: Function('MainScaffold')] -> [CALLS] -> [Function('AppDrawerContent')]
 /**
- * @summary Общая обертка для экранов, включающая Scaffold и Navigation Drawer.
- * @param topBarTitle Заголовок для TopAppBar.
- * @param currentRoute Текущий маршрут для подсветки активного элемента в Drawer.
- * @param navigationActions Объект с навигационными действиями.
- * @param topBarActions Composable-функция для отображения действий (иконок) в TopAppBar.
- * @param content Основное содержимое экрана, которое будет отображено внутри Scaffold.
- * @sideeffect Управляет состоянием (открыто/закрыто) бокового меню (ModalNavigationDrawer).
- * @invariant TopAppBar всегда отображается с иконкой меню.
+ * @summary A common wrapper for screens that includes a Scaffold and Navigation Drawer.
+ * @param topBarTitle The title for the TopAppBar.
+ * @param currentRoute The current route to highlight the active item in the Drawer.
+ * @param navigationActions The object with navigation actions.
+ * @param topBarActions A Composable function to display actions (icons) in the TopAppBar.
+ * @param content The main content of the screen to be displayed inside the Scaffold.
+ * @sideeffect Manages the state (open/closed) of the side menu (ModalNavigationDrawer).
+ * @invariant The TopAppBar is always displayed with a menu icon.
  */
 @OptIn(ExperimentalMaterial3Api::class)
 @Composable

app/src/main/java/com/homebox/lens/ui/components/ColorPicker.kt

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.ui.components
 // [FILE] ColorPicker.kt
-// [SEMANTICS] ui, component, color_selection
+// [SEMANTICS] app, ui, component, color
 
 package com.homebox.lens.ui.components
 
@@ -25,10 +24,10 @@ import com.homebox.lens.R
 
 // [ENTITY: Function('ColorPicker')]
 /**
- * @summary Компонент для выбора цвета.
- * @param selectedColor Текущий выбранный цвет в формате HEX строки (например, "#FFFFFF").
- * @param onColorSelected Лямбда-функция, вызываемая при выборе нового цвета.
- * @param modifier Модификатор для настройки внешнего вида.
+ * @summary A component for color selection.
+ * @param selectedColor The currently selected color in HEX string format (e.g., "#FFFFFF").
+ * @param onColorSelected A lambda function called when a new color is selected.
+ * @param modifier A modifier for customizing the appearance.
  */
 @Composable
 fun ColorPicker(

app/src/main/java/com/homebox/lens/ui/components/LoadingOverlay.kt

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.ui.components
 // [FILE] LoadingOverlay.kt
-// [SEMANTICS] ui, component, loading
+// [SEMANTICS] app, ui, component, loading
 
 package com.homebox.lens.ui.components
 
@@ -18,7 +17,7 @@ import androidx.compose.ui.graphics.Color
 
 // [ENTITY: Function('LoadingOverlay')]
 /**
- * @summary Полноэкранный оверлей с индикатором загрузки.
+ * @summary A full-screen overlay with a loading indicator.
  */
 @Composable
 fun LoadingOverlay() {

app/src/main/java/com/homebox/lens/ui/mapper/ItemMapper.kt

@@ -0,0 +1,62 @@
+// [FILE] ItemMapper.kt
+// [SEMANTICS] app, ui, mapper, item
+package com.homebox.lens.ui.mapper
+
+import com.homebox.lens.domain.model.Item
+import com.homebox.lens.domain.model.ItemOut
+import com.homebox.lens.domain.model.Label
+import com.homebox.lens.domain.model.Location
+import javax.inject.Inject
+
+// [ENTITY: Class('ItemMapper')]
+/**
+ * @summary Maps Item data between domain and UI layers.
+ * @invariant This class is stateless and its methods are pure functions.
+ */
+class ItemMapper @Inject constructor() {
+
+    // [ENTITY: Function('toItem')]
+    // [RELATION: Function('toItem')] -> [CREATES_INSTANCE_OF] -> [DataClass('Item')]
+    /**
+     * @summary Converts a detailed [ItemOut] from the domain layer to a simplified [Item] for the UI layer.
+     * @param itemOut The [ItemOut] object to convert.
+     * @return The resulting [Item] object.
+     * @precondition itemOut MUST NOT be null.
+     * @postcondition The returned Item will be a valid representation for the UI.
+     */
+    fun toItem(itemOut: ItemOut): Item {
+        return Item(
+            id = itemOut.id,
+            name = itemOut.name,
+            description = itemOut.description,
+            quantity = itemOut.quantity,
+            image = itemOut.images.firstOrNull { it.isPrimary }?.path,
+            location = itemOut.location?.let { Location(it.id, it.name) },
+            labels = itemOut.labels.map { Label(it.id, it.name) },
+            purchasePrice = itemOut.purchasePrice,
+            createdAt = itemOut.createdAt,
+            archived = itemOut.isArchived,
+            assetId = itemOut.assetId,
+            fields = itemOut.fields.map { com.homebox.lens.domain.model.CustomField(it.name, it.value, it.type) },
+            insured = itemOut.insured ?: false,
+            lifetimeWarranty = itemOut.lifetimeWarranty ?: false,
+            manufacturer = itemOut.manufacturer,
+            modelNumber = itemOut.modelNumber,
+            notes = itemOut.notes,
+            parentId = itemOut.parent?.id,
+            purchaseFrom = itemOut.purchaseFrom,
+            purchaseTime = itemOut.purchaseTime,
+            serialNumber = itemOut.serialNumber,
+            soldNotes = itemOut.soldNotes,
+            soldPrice = itemOut.soldPrice,
+            soldTime = itemOut.soldTime,
+            soldTo = itemOut.soldTo,
+            syncChildItemsLocations = itemOut.syncChildItemsLocations ?: false,
+            warrantyDetails = itemOut.warrantyDetails,
+            warrantyExpires = itemOut.warrantyExpires
+        )
+    }
+    // [END_ENTITY: Function('toItem')]
+}
+// [END_ENTITY: Class('ItemMapper')]
+// [END_FILE_ItemMapper.kt]

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

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.ui.screen.dashboard
 // [FILE] DashboardScreen.kt
-// [SEMANTICS] ui, screen, dashboard, compose, navigation
+// [SEMANTICS] app, ui, screen, dashboard
 package com.homebox.lens.ui.screen.dashboard
 
 // [IMPORTS]
@@ -37,11 +36,11 @@ import timber.log.Timber
 // [RELATION: Function('DashboardScreen')] -> [DEPENDS_ON] -> [Class('NavigationActions')]
 // [RELATION: Function('DashboardScreen')] -> [CALLS] -> [Function('MainScaffold')]
 /**
- * @summary Главная Composable-функция для экрана "Панель управления".
- * @param viewModel ViewModel для этого экрана, предоставляется через Hilt.
- * @param currentRoute Текущий маршрут для подсветки активного элемента в Drawer.
- * @param navigationActions Объект с навигационными действиями.
- * @sideeffect Вызывает навигационные лямбды при взаимодействии с UI.
+ * @summary The main Composable function for the "Dashboard" screen.
+ * @param viewModel The ViewModel for this screen, provided by Hilt.
+ * @param currentRoute The current route to highlight the active item in the Drawer.
+ * @param navigationActions The object with navigation actions.
+ * @sideeffect Calls navigation lambdas upon UI interaction.
  */
 @Composable
 fun DashboardScreen(
@@ -82,11 +81,11 @@ fun DashboardScreen(
 // [ENTITY: Function('DashboardContent')]
 // [RELATION: Function('DashboardContent')] -> [CONSUMES_STATE] -> [SealedInterface('DashboardUiState')]
 /**
- * @summary Отображает основной контент экрана в зависимости от uiState.
- * @param modifier Модификатор для стилизации.
- * @param uiState Текущее состояние UI экрана.
- * @param onLocationClick Лямбда-обработчик нажатия на местоположение.
- * @param onLabelClick Лямбда-обработчик нажатия на метку.
+ * @summary Displays the main content of the screen depending on the uiState.
+ * @param modifier A modifier for styling.
+ * @param uiState The current UI state of the screen.
+ * @param onLocationClick A lambda handler for clicking on a location.
+ * @param onLabelClick A lambda handler for clicking on a label.
  */
 @Composable
 private fun DashboardContent(
@@ -132,8 +131,8 @@ private fun DashboardContent(
 // [ENTITY: Function('StatisticsSection')]
 // [RELATION: Function('StatisticsSection')] -> [DEPENDS_ON] -> [DataClass('GroupStatistics')]
 /**
- * @summary Секция для отображения общей статистики.
- * @param statistics Объект со статистическими данными.
+ * @summary Section for displaying general statistics.
+ * @param statistics The object with statistical data.
  */
 @Composable
 private fun StatisticsSection(statistics: GroupStatistics) {
@@ -164,9 +163,9 @@ private fun StatisticsSection(statistics: GroupStatistics) {
 
 // [ENTITY: Function('StatisticCard')]
 /**
- * @summary Карточка для отображения одного статистического показателя.
- * @param title Название показателя.
- * @param value Значение показателя.
+ * @summary Card for displaying a single statistical indicator.
+ * @param title The name of the indicator.
+ * @param value The value of the indicator.
  */
 @Composable
 private fun StatisticCard(title: String, value: String) {
@@ -180,8 +179,8 @@ private fun StatisticCard(title: String, value: String) {
 // [ENTITY: Function('RecentlyAddedSection')]
 // [RELATION: Function('RecentlyAddedSection')] -> [DEPENDS_ON] -> [DataClass('ItemSummary')]
 /**
- * @summary Секция для отображения недавно добавленных элементов.
- * @param items Список элементов для отображения.
+ * @summary Section for displaying recently added items.
+ * @param items The list of items to display.
  */
 @Composable
 private fun RecentlyAddedSection(items: List<ItemSummary>) {
@@ -213,8 +212,8 @@ private fun RecentlyAddedSection(items: List<ItemSummary>) {
 // [ENTITY: Function('ItemCard')]
 // [RELATION: Function('ItemCard')] -> [DEPENDS_ON] -> [DataClass('ItemSummary')]
 /**
- * @summary Карточка для отображения краткой информации об элементе.
- * @param item Элемент для отображения.
+ * @summary Card for displaying brief information about an item.
+ * @param item The item to display.
  */
 @Composable
 private fun ItemCard(item: ItemSummary) {
@@ -236,9 +235,9 @@ private fun ItemCard(item: ItemSummary) {
 // [ENTITY: Function('LocationsSection')]
 // [RELATION: Function('LocationsSection')] -> [DEPENDS_ON] -> [DataClass('LocationOutCount')]
 /**
- * @summary Секция для отображения местоположений в виде чипсов.
- * @param locations Список местоположений.
- * @param onLocationClick Лямбда-обработчик нажатия на местоположение.
+ * @summary Section for displaying locations as chips.
+ * @param locations The list of locations.
+ * @param onLocationClick A lambda handler for clicking on a location.
  */
 @OptIn(ExperimentalLayoutApi::class)
 @Composable
@@ -265,9 +264,9 @@ private fun LocationsSection(locations: List<LocationOutCount>, onLocationClick:
 // [ENTITY: Function('LabelsSection')]
 // [RELATION: Function('LabelsSection')] -> [DEPENDS_ON] -> [DataClass('LabelOut')]
 /**
- * @summary Секция для отображения меток в виде чипсов.
- * @param labels Список меток.
- * @param onLabelClick Лямбда-обработчик нажатия на метку.
+ * @summary Section for displaying labels as chips.
+ * @param labels The list of labels.
+ * @param onLabelClick A lambda handler for clicking on a label.
  */
 @OptIn(ExperimentalLayoutApi::class)
 @Composable
@@ -310,10 +309,10 @@ fun DashboardContentSuccessPreview() {
             LocationOutCount(id="5",name="Basement", color = "#00FFFF", isArchived = false, itemCount = 3, createdAt = "", updatedAt = "")
         ),
         labels = listOf(
-            LabelOut(id="1", name="electronics", color = "#FF0000", isArchived = false, createdAt = "", updatedAt = ""),
-            LabelOut(id="2", name="important", color = "#00FF00", isArchived = false, createdAt = "", updatedAt = ""),
-            LabelOut(id="3", name="seasonal", color = "#0000FF", isArchived = false, createdAt = "", updatedAt = ""),
-            LabelOut(id="4", name="hobby", color = "#FFFF00", isArchived = false, createdAt = "", updatedAt = "")
+            LabelOut(id="1", name="electronics", description = null, color = "#FF0000", isArchived = false, createdAt = "", updatedAt = ""),
+            LabelOut(id="2", name="important", description = null, color = "#00FF00", isArchived = false, createdAt = "", updatedAt = ""),
+            LabelOut(id="3", name="seasonal", description = null, color = "#0000FF", isArchived = false, createdAt = "", updatedAt = ""),
+            LabelOut(id="4", name="hobby", description = null, color = "#FFFF00", isArchived = false, createdAt = "", updatedAt = "")
         ),
         recentlyAddedItems = emptyList()
     )

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

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.ui.screen.dashboard
 // [FILE] DashboardUiState.kt
-// [SEMANTICS] ui, state, dashboard
+// [SEMANTICS] app, ui, state, dashboard
 package com.homebox.lens.ui.screen.dashboard
 
 // [IMPORTS]
@@ -12,8 +11,8 @@ import com.homebox.lens.domain.model.LocationOutCount
 
 // [ENTITY: SealedInterface('DashboardUiState')]
 /**
- * @summary Определяет все возможные состояния для экрана "Дэшборд".
- * @invariant В любой момент времени экран может находиться только в одном из этих состояний.
+ * @summary Defines all possible states for the "Dashboard" screen.
+ * @invariant At any given time, the screen can only be in one of these states.
  */
 sealed interface DashboardUiState {
     // [ENTITY: DataClass('Success')]
@@ -22,11 +21,11 @@ sealed interface DashboardUiState {
     // [RELATION: DataClass('Success')] -> [DEPENDS_ON] -> [DataClass('LabelOut')]
     // [RELATION: DataClass('Success')] -> [DEPENDS_ON] -> [DataClass('ItemSummary')]
     /**
-     * @summary Состояние успешной загрузки данных.
-     * @param statistics Статистика по инвентарю.
-     * @param locations Список локаций со счетчиками.
-     * @param labels Список всех меток.
-     * @param recentlyAddedItems Список недавно добавленных товаров.
+     * @summary The state of a successful data load.
+     * @param statistics The inventory statistics.
+     * @param locations The list of locations with counters.
+     * @param labels The list of all labels.
+     * @param recentlyAddedItems The list of recently added items.
      */
     data class Success(
         val statistics: GroupStatistics,
@@ -38,15 +37,15 @@ sealed interface DashboardUiState {
 
     // [ENTITY: DataClass('Error')]
     /**
-     * @summary Состояние ошибки во время загрузки данных.
-     * @param message Человекочитаемое сообщение об ошибке.
+     * @summary The state of an error during data loading.
+     * @param message A human-readable error message.
      */
     data class Error(val message: String) : DashboardUiState
     // [END_ENTITY: DataClass('Error')]
 
     // [ENTITY: Object('Loading')]
     /**
-     * @summary Состояние, когда данные для экрана загружаются.
+     * @summary The state when data for the screen is being loaded.
      */
     data object Loading : DashboardUiState
     // [END_ENTITY: Object('Loading')]

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

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.ui.screen.dashboard
 // [FILE] DashboardViewModel.kt
-// [SEMANTICS] ui_logic, dashboard, state_management, sealed_state, parallel_data_loading, timber_logging
+// [SEMANTICS] app, ui, viewmodel, dashboard
 package com.homebox.lens.ui.screen.dashboard
 
 // [IMPORTS]
@@ -24,10 +23,10 @@ import javax.inject.Inject
 // [RELATION: ViewModel('DashboardViewModel')] -> [DEPENDS_ON] -> [UseCase('GetRecentlyAddedItemsUseCase')]
 // [RELATION: ViewModel('DashboardViewModel')] -> [EMITS_STATE] -> [SealedInterface('DashboardUiState')]
 /**
- * @summary ViewModel для главного экрана (Dashboard).
- * @description Оркестрирует загрузку данных для Dashboard, используя строгую модель состояний
- * (`DashboardUiState`), и обрабатывает параллельные запросы без состояний гонки.
- * @invariant `uiState` всегда является одним из состояний, определенных в `DashboardUiState`.
+ * @summary ViewModel for the main screen (Dashboard).
+ * @description Orchestrates the loading of data for the Dashboard, using a strict state model
+ * (`DashboardUiState`), and handles parallel requests without race conditions.
+ * @invariant `uiState` is always one of the states defined in `DashboardUiState`.
  */
 @HiltViewModel
 class DashboardViewModel @Inject constructor(
@@ -46,10 +45,10 @@ class DashboardViewModel @Inject constructor(
 
     // [ENTITY: Function('loadDashboardData')]
     /**
-     * @summary Загружает все необходимые данные для экрана Dashboard.
-     * @description Выполняет UseCase'ы параллельно и обновляет UI, переключая его
-     * между состояниями `Loading`, `Success` и `Error` из `DashboardUiState`.
-     * @sideeffect Асинхронно обновляет `_uiState` одним из состояний `DashboardUiState`.
+     * @summary Loads all necessary data for the Dashboard screen.
+     * @description Executes UseCases in parallel and updates the UI by switching it
+     * between the `Loading`, `Success`, and `Error` states from `DashboardUiState`.
+     * @sideeffect Asynchronously updates `_uiState` with one of the `DashboardUiState` states.
      */
     fun loadDashboardData() {
         viewModelScope.launch {

app/src/main/java/com/homebox/lens/ui/screen/inventorylist/InventoryListScreen.kt

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.ui.screen.inventorylist
 // [FILE] InventoryListScreen.kt
-// [SEMANTICS] ui, screen, inventory, list
+// [SEMANTICS] app, ui, screen, list
 
 package com.homebox.lens.ui.screen.inventorylist
 
@@ -17,9 +16,9 @@ import com.homebox.lens.ui.common.MainScaffold
 // [RELATION: Function('InventoryListScreen')] -> [DEPENDS_ON] -> [Class('NavigationActions')]
 // [RELATION: Function('InventoryListScreen')] -> [CALLS] -> [Function('MainScaffold')]
 /**
- * @summary Composable-функция для экрана "Список инвентаря".
- * @param currentRoute Текущий маршрут для подсветки активного элемента в Drawer.
- * @param navigationActions Объект с навигационными действиями.
+ * @summary Composable function for the "Inventory List" screen.
+ * @param currentRoute The current route to highlight the active item in the Drawer.
+ * @param navigationActions The object with navigation actions.
  */
 @Composable
 fun InventoryListScreen(

app/src/main/java/com/homebox/lens/ui/screen/inventorylist/InventoryListViewModel.kt

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.ui.screen.inventorylist
 // [FILE] InventoryListViewModel.kt
-// [SEMANTICS] ui, viewmodel, inventory_list
+// [SEMANTICS] app, ui, viewmodel, list
 package com.homebox.lens.ui.screen.inventorylist
 
 // [IMPORTS]

app/src/main/java/com/homebox/lens/ui/screen/itemdetails/ItemDetailsScreen.kt

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.ui.screen.itemdetails
 // [FILE] ItemDetailsScreen.kt
-// [SEMANTICS] ui, screen, item, details
+// [SEMANTICS] app, ui, screen, details
 
 package com.homebox.lens.ui.screen.itemdetails
 
@@ -17,9 +16,9 @@ import com.homebox.lens.ui.common.MainScaffold
 // [RELATION: Function('ItemDetailsScreen')] -> [DEPENDS_ON] -> [Class('NavigationActions')]
 // [RELATION: Function('ItemDetailsScreen')] -> [CALLS] -> [Function('MainScaffold')]
 /**
- * @summary Composable-функция для экрана "Детали элемента".
- * @param currentRoute Текущий маршрут для подсветки активного элемента в Drawer.
- * @param navigationActions Объект с навигационными действиями.
+ * @summary Composable function for the "Item Details" screen.
+ * @param currentRoute The current route to highlight the active item in the Drawer.
+ * @param navigationActions The object with navigation actions.
  */
 @Composable
 fun ItemDetailsScreen(

app/src/main/java/com/homebox/lens/ui/screen/itemdetails/ItemDetailsViewModel.kt

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.ui.screen.itemdetails
 // [FILE] ItemDetailsViewModel.kt
-// [SEMANTICS] ui, viewmodel, item_details
+// [SEMANTICS] app, ui, viewmodel, details
 package com.homebox.lens.ui.screen.itemdetails
 
 // [IMPORTS]

app/src/main/java/com/homebox/lens/ui/screen/itemedit/ItemEditScreen.kt

@@ -1,32 +1,56 @@
-// [PACKAGE] com.homebox.lens.ui.screen.itemedit
 // [FILE] ItemEditScreen.kt
-// [SEMANTICS] ui, screen, item, edit
+// [SEMANTICS] app, ui, screen, edit
 
 package com.homebox.lens.ui.screen.itemedit
 
 // [IMPORTS]
+import androidx.compose.foundation.clickable
+import androidx.compose.foundation.layout.Arrangement
 import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.Row
 import androidx.compose.foundation.layout.Spacer
 import androidx.compose.foundation.layout.fillMaxSize
 import androidx.compose.foundation.layout.fillMaxWidth
 import androidx.compose.foundation.layout.height
 import androidx.compose.foundation.layout.padding
+import androidx.compose.foundation.rememberScrollState
 import androidx.compose.foundation.text.KeyboardOptions
+import androidx.compose.foundation.verticalScroll
 import androidx.compose.material.icons.Icons
+import androidx.compose.material.icons.filled.ArrowDropDown
+import androidx.compose.material.icons.filled.DateRange
 import androidx.compose.material.icons.filled.Save
+import androidx.compose.material3.AlertDialog
+import androidx.compose.material3.Card
+import androidx.compose.material3.CardDefaults
+import androidx.compose.material3.Checkbox
 import androidx.compose.material3.CircularProgressIndicator
+import androidx.compose.material3.DatePicker
+import androidx.compose.material3.DatePickerDialog
+import androidx.compose.material3.DropdownMenuItem
+import androidx.compose.material3.ExperimentalMaterial3Api
+import androidx.compose.material3.ExposedDropdownMenuBox
+import androidx.compose.material3.ExposedDropdownMenuDefaults
 import androidx.compose.material3.FloatingActionButton
 import androidx.compose.material3.Icon
+import androidx.compose.material3.IconButton
+import androidx.compose.material3.MaterialTheme
 import androidx.compose.material3.OutlinedTextField
 import androidx.compose.material3.Scaffold
 import androidx.compose.material3.SnackbarHost
 import androidx.compose.material3.SnackbarHostState
+import androidx.compose.material3.Switch
 import androidx.compose.material3.Text
+import androidx.compose.material3.TextButton
+import androidx.compose.material3.rememberDatePickerState
 import androidx.compose.runtime.Composable
 import androidx.compose.runtime.LaunchedEffect
 import androidx.compose.runtime.collectAsState
 import androidx.compose.runtime.getValue
+import androidx.compose.runtime.mutableStateOf
 import androidx.compose.runtime.remember
+import androidx.compose.runtime.setValue
+import androidx.compose.ui.Alignment
 import androidx.compose.ui.Modifier
 import androidx.compose.ui.res.stringResource
 import androidx.compose.ui.text.input.KeyboardType
@@ -36,21 +60,25 @@ import com.homebox.lens.R
 import com.homebox.lens.navigation.NavigationActions
 import com.homebox.lens.ui.common.MainScaffold
 import timber.log.Timber
+import java.text.SimpleDateFormat
+import java.util.Date
+import java.util.Locale
 // [END_IMPORTS]
 
-// [ENTITY: Function('ItemEditScreen')]
-// [RELATION: Function('ItemEditScreen')] -> [DEPENDS_ON] -> [Class('NavigationActions')]
-// [RELATION: Function('ItemEditScreen')] -> [DEPENDS_ON] -> [ViewModel('ItemEditViewModel')]
-// [RELATION: Function('ItemEditScreen')] -> [CONSUMES_STATE] -> [DataClass('ItemEditUiState')]
-// [RELATION: Function('ItemEditScreen')] -> [CALLS] -> [Function('MainScaffold')]
+// [ENTITY: Composable('ItemEditScreen')]
+// [RELATION: Composable('ItemEditScreen')] -> [DEPENDS_ON] -> [Class('NavigationActions')]
+// [RELATION: Composable('ItemEditScreen')] -> [DEPENDS_ON] -> [ViewModel('ItemEditViewModel')]
+// [RELATION: Composable('ItemEditScreen')] -> [CONSUMES_STATE] -> [DataClass('ItemEditUiState')]
+// [RELATION: Composable('ItemEditScreen')] -> [CALLS] -> [Composable('MainScaffold')]
 /**
- * @summary Composable-функция для экрана "Редактирование элемента".
- * @param currentRoute Текущий маршрут для подсветки активного элемента в Drawer.
- * @param navigationActions Объект с навигационными действиями.
- * @param itemId ID элемента для редактирования. Null, если создается новый элемент.
- * @param viewModel ViewModel для управления состоянием экрана.
- * @param onSaveSuccess Callback, вызываемый после успешного сохранения товара.
+ * @summary Composable function for the "Edit Item" screen.
+ * @param currentRoute The current route to highlight the active item in the Drawer.
+ * @param navigationActions The object with navigation actions.
+ * @param itemId The ID of the item to edit. Null if a new item is being created.
+ * @param viewModel The ViewModel for managing the screen's state.
+ * @param onSaveSuccess A callback invoked after the item is successfully saved.
  */
+@OptIn(ExperimentalMaterial3Api::class)
 @Composable
 fun ItemEditScreen(
     currentRoute: String?,
@@ -75,7 +103,7 @@ fun ItemEditScreen(
     }
 
     LaunchedEffect(Unit) {
-        viewModel.saveCompleted.collect { 
+        viewModel.saveCompleted.collect {
             Timber.i("[INFO][ACTION][save_completed_callback] Item save completed. Triggering onSaveSuccess.")
             onSaveSuccess()
         }
@@ -85,7 +113,7 @@ fun ItemEditScreen(
         topBarTitle = stringResource(id = R.string.item_edit_title),
         currentRoute = currentRoute,
         navigationActions = navigationActions
-    ) {
+    ) { paddingValues ->
         Scaffold(
             snackbarHost = { SnackbarHost(snackbarHostState) },
             floatingActionButton = {
@@ -100,40 +128,479 @@ fun ItemEditScreen(
             Column(
                 modifier = Modifier
                     .fillMaxSize()
-                    .padding(it)
+                    .padding(paddingValues)
                     .padding(16.dp)
+                    .verticalScroll(rememberScrollState())
             ) {
                 if (uiState.isLoading) {
                     CircularProgressIndicator(modifier = Modifier.fillMaxWidth())
                 } else {
                     uiState.item?.let { item ->
-                        OutlinedTextField(
-                            value = item.name,
-                            onValueChange = { viewModel.updateName(it) },
-                            label = { Text(stringResource(R.string.item_name)) },
-                            modifier = Modifier.fillMaxWidth()
-                        )
-                        Spacer(modifier = Modifier.height(8.dp))
-                        OutlinedTextField(
-                            value = item.description ?: "",
-                            onValueChange = { viewModel.updateDescription(it) },
-                            label = { Text(stringResource(R.string.item_description)) },
-                            modifier = Modifier.fillMaxWidth()
-                        )
-                        Spacer(modifier = Modifier.height(8.dp))
-                        OutlinedTextField(
-                            value = item.quantity.toString(),
-                            onValueChange = { viewModel.updateQuantity(it.toIntOrNull() ?: 0) },
-                            label = { Text(stringResource(R.string.item_quantity)) },
-                            keyboardOptions = KeyboardOptions(keyboardType = KeyboardType.Number),
-                            modifier = Modifier.fillMaxWidth()
-                        )
-                        // Add more fields as needed
+                        // [AI_NOTE]: General Information section for basic item details.
+                        Card(
+                            modifier = Modifier.fillMaxWidth(),
+                            elevation = CardDefaults.cardElevation(4.dp)
+                        ) {
+                            Column(modifier = Modifier.padding(16.dp)) {
+                                Text(
+                                    text = stringResource(R.string.item_edit_general_information),
+                                    style = MaterialTheme.typography.headlineSmall
+                                )
+                                Spacer(modifier = Modifier.height(16.dp))
+                                OutlinedTextField(
+                                    value = item.name,
+                                    onValueChange = { viewModel.updateName(it) },
+                                    label = { Text(stringResource(R.string.item_name)) },
+                                    modifier = Modifier.fillMaxWidth()
+                                )
+                                Spacer(modifier = Modifier.height(8.dp))
+                                OutlinedTextField(
+                                    value = item.description ?: "",
+                                    onValueChange = { viewModel.updateDescription(it) },
+                                    label = { Text(stringResource(R.string.item_description)) },
+                                    modifier = Modifier.fillMaxWidth()
+                                )
+                                Spacer(modifier = Modifier.height(8.dp))
+                                OutlinedTextField(
+                                    value = item.quantity.toString(),
+                                    onValueChange = { viewModel.updateQuantity(it.toIntOrNull() ?: 0) },
+                                    label = { Text(stringResource(R.string.item_quantity)) },
+                                    keyboardOptions = KeyboardOptions(keyboardType = KeyboardType.Number),
+                                    modifier = Modifier.fillMaxWidth()
+                                )
+                               Spacer(modifier = Modifier.height(8.dp))
+
+                               // Location Dropdown
+                               var locationExpanded by remember { mutableStateOf(false) }
+                               ExposedDropdownMenuBox(
+                                   expanded = locationExpanded,
+                                   onExpandedChange = { locationExpanded = !locationExpanded }
+                               ) {
+                                   OutlinedTextField(
+                                       value = item.location?.name ?: "",
+                                       onValueChange = { },
+                                       label = { Text(stringResource(R.string.item_edit_location)) },
+                                       readOnly = true,
+                                       trailingIcon = {
+                                           ExposedDropdownMenuDefaults.TrailingIcon(expanded = locationExpanded)
+                                       },
+                                       modifier = Modifier
+                                           .fillMaxWidth()
+                                           .menuAnchor()
+                                   )
+                                   ExposedDropdownMenu(
+                                       expanded = locationExpanded,
+                                       onDismissRequest = { locationExpanded = false }
+                                   ) {
+                                       uiState.allLocations.forEach { location ->
+                                           DropdownMenuItem(
+                                               text = { Text(location.name) },
+                                               onClick = {
+                                                   viewModel.updateLocation(location)
+                                                   locationExpanded = false
+                                               }
+                                           )
+                                       }
+                                   }
+                               }
+
+                               Spacer(modifier = Modifier.height(8.dp))
+
+                               // Labels Dialog
+                               var showLabelsDialog by remember { mutableStateOf(false) }
+
+                               OutlinedTextField(
+                                   value = item.labels.joinToString { it.name },
+                                   onValueChange = { },
+                                   label = { Text(stringResource(R.string.item_edit_labels)) },
+                                   readOnly = true,
+                                   modifier = Modifier
+                                       .fillMaxWidth()
+                                       .clickable { showLabelsDialog = true },
+                                   trailingIcon = {
+                                       Icon(Icons.Filled.ArrowDropDown, contentDescription = stringResource(R.string.item_edit_select_labels))
+                                   }
+                               )
+
+                               if (showLabelsDialog) {
+                                   // This state will hold the temporary selections within the dialog
+                                   val tempSelectedLabels = remember { mutableStateOf(item.labels.toSet()) }
+
+                                   AlertDialog(
+                                       onDismissRequest = { showLabelsDialog = false },
+                                       title = { Text(stringResource(R.string.item_edit_select_labels)) },
+                                       text = {
+                                           Column {
+                                               uiState.allLabels.forEach { label ->
+                                                   val isChecked = tempSelectedLabels.value.contains(label)
+                                                   Row(
+                                                       verticalAlignment = Alignment.CenterVertically,
+                                                       modifier = Modifier
+                                                           .fillMaxWidth()
+                                                           .clickable {
+                                                               val currentSelection = tempSelectedLabels.value.toMutableSet()
+                                                               if (isChecked) {
+                                                                   currentSelection.remove(label)
+                                                               } else {
+                                                                   currentSelection.add(label)
+                                                               }
+                                                               tempSelectedLabels.value = currentSelection
+                                                           }
+                                                           .padding(vertical = 8.dp)
+                                                   ) {
+                                                       Checkbox(
+                                                           checked = isChecked,
+                                                           onCheckedChange = {
+                                                               val currentSelection = tempSelectedLabels.value.toMutableSet()
+                                                               if (it) {
+                                                                   currentSelection.add(label)
+                                                               } else {
+                                                                   currentSelection.remove(label)
+                                                               }
+                                                               tempSelectedLabels.value = currentSelection
+                                                           }
+                                                       )
+                                                       Text(
+                                                           text = label.name,
+                                                           modifier = Modifier.padding(start = 8.dp)
+                                                       )
+                                                   }
+                                               }
+                                           }
+                                       },
+                                       confirmButton = {
+                                           TextButton(
+                                               onClick = {
+                                                   // Update the ViewModel with the final selection
+                                                   viewModel.updateLabels(tempSelectedLabels.value.toList())
+                                                   showLabelsDialog = false
+                                               }
+                                           ) {
+                                               Text(stringResource(R.string.dialog_ok))
+                                           }
+                                       },
+                                       dismissButton = {
+                                           TextButton(onClick = { showLabelsDialog = false }) {
+                                               Text(stringResource(R.string.dialog_cancel))
+                                           }
+                                       }
+                                   )
+                               }
+                            }
+                        }
+
+                        Spacer(modifier = Modifier.height(16.dp))
+
+                        // [AI_NOTE]: Purchase Information section.
+                        Card(
+                            modifier = Modifier.fillMaxWidth(),
+                            elevation = CardDefaults.cardElevation(4.dp)
+                        ) {
+                            Column(modifier = Modifier.padding(16.dp)) {
+                                Text(
+                                    text = stringResource(R.string.item_edit_purchase_information),
+                                    style = MaterialTheme.typography.headlineSmall
+                                )
+                                Spacer(modifier = Modifier.height(16.dp))
+                                OutlinedTextField(
+                                    value = item.purchasePrice?.toString() ?: "",
+                                    onValueChange = { viewModel.updatePurchasePrice(it.toDoubleOrNull()) },
+                                    label = { Text(stringResource(R.string.item_edit_purchase_price)) },
+                                    keyboardOptions = KeyboardOptions(keyboardType = KeyboardType.Number),
+                                    modifier = Modifier.fillMaxWidth()
+                                )
+                                Spacer(modifier = Modifier.height(8.dp))
+                                OutlinedTextField(
+                                    value = item.purchaseFrom ?: "",
+                                    onValueChange = { viewModel.updatePurchaseFrom(it) },
+                                    label = { Text(stringResource(R.string.item_edit_purchase_from)) },
+                                    modifier = Modifier.fillMaxWidth()
+                                )
+                                Spacer(modifier = Modifier.height(8.dp))
+                                // [AI_NOTE]: Date picker for purchase time.
+                                var showPurchaseDatePicker by remember { mutableStateOf(false) }
+                                val purchaseDateState = rememberDatePickerState()
+                                OutlinedTextField(
+                                    value = item.purchaseTime ?: "",
+                                    onValueChange = { }, // Read-only, handled by date picker
+                                    label = { Text(stringResource(R.string.item_edit_purchase_time)) },
+                                    readOnly = true,
+                                    trailingIcon = {
+                                        IconButton(onClick = { showPurchaseDatePicker = true }) {
+                                            Icon(Icons.Filled.DateRange, contentDescription = stringResource(R.string.item_edit_select_date))
+                                        }
+                                    },
+                                    modifier = Modifier
+                                        .fillMaxWidth()
+                                        .clickable { showPurchaseDatePicker = true }
+                                )
+                                if (showPurchaseDatePicker) {
+                                    DatePickerDialog(
+                                        onDismissRequest = { showPurchaseDatePicker = false },
+                                        confirmButton = {
+                                            Text(stringResource(R.string.dialog_ok), modifier = Modifier.clickable {
+                                                val selectedDate = purchaseDateState.selectedDateMillis?.let {
+                                                    SimpleDateFormat("yyyy-MM-dd", Locale.getDefault()).format(Date(it))
+                                                }
+                                                if (selectedDate != null) {
+                                                    viewModel.updatePurchaseTime(selectedDate)
+                                                }
+                                                showPurchaseDatePicker = false
+                                            })
+                                        },
+                                        dismissButton = {
+                                            Text(stringResource(R.string.dialog_cancel), modifier = Modifier.clickable { showPurchaseDatePicker = false })
+                                        }
+                                    ) {
+                                        DatePicker(state = purchaseDateState)
+                                    }
+                                }
+                            }
+                        }
+
+                        Spacer(modifier = Modifier.height(16.dp))
+
+                        // [AI_NOTE]: Warranty Information section.
+                        Card(
+                            modifier = Modifier.fillMaxWidth(),
+                            elevation = CardDefaults.cardElevation(4.dp)
+                        ) {
+                            Column(modifier = Modifier.padding(16.dp)) {
+                                Text(
+                                    text = stringResource(R.string.item_edit_warranty_information),
+                                    style = MaterialTheme.typography.headlineSmall
+                                )
+                                Spacer(modifier = Modifier.height(16.dp))
+                                Row(
+                                    modifier = Modifier.fillMaxWidth(),
+                                    verticalAlignment = Alignment.CenterVertically,
+                                    horizontalArrangement = Arrangement.SpaceBetween
+                                ) {
+                                    Text(stringResource(R.string.item_edit_lifetime_warranty))
+                                    Switch(
+                                        checked = item.lifetimeWarranty,
+                                        onCheckedChange = { viewModel.updateLifetimeWarranty(it) }
+                                    )
+                                }
+                                Spacer(modifier = Modifier.height(8.dp))
+                                OutlinedTextField(
+                                    value = item.warrantyDetails ?: "",
+                                    onValueChange = { viewModel.updateWarrantyDetails(it) },
+                                    label = { Text(stringResource(R.string.item_edit_warranty_details)) },
+                                    modifier = Modifier.fillMaxWidth()
+                                )
+                                Spacer(modifier = Modifier.height(8.dp))
+                                // [AI_NOTE]: Date picker for warranty expiration.
+                                var showWarrantyDatePicker by remember { mutableStateOf(false) }
+                                val warrantyDateState = rememberDatePickerState()
+                                OutlinedTextField(
+                                    value = item.warrantyExpires ?: "",
+                                    onValueChange = { }, // Read-only, handled by date picker
+                                    label = { Text(stringResource(R.string.item_edit_warranty_expires)) },
+                                    readOnly = true,
+                                    trailingIcon = {
+                                        IconButton(onClick = { showWarrantyDatePicker = true }) {
+                                            Icon(Icons.Filled.DateRange, contentDescription = stringResource(R.string.item_edit_select_date))
+                                        }
+                                    },
+                                    modifier = Modifier
+                                        .fillMaxWidth()
+                                        .clickable { showWarrantyDatePicker = true }
+                                )
+                                if (showWarrantyDatePicker) {
+                                    DatePickerDialog(
+                                        onDismissRequest = { showWarrantyDatePicker = false },
+                                        confirmButton = {
+                                            Text(stringResource(R.string.dialog_ok), modifier = Modifier.clickable {
+                                                val selectedDate = warrantyDateState.selectedDateMillis?.let {
+                                                    SimpleDateFormat("yyyy-MM-dd", Locale.getDefault()).format(Date(it))
+                                                }
+                                                if (selectedDate != null) {
+                                                    viewModel.updateWarrantyExpires(selectedDate)
+                                                }
+                                                showWarrantyDatePicker = false
+                                            })
+                                        },
+                                        dismissButton = {
+                                            Text(stringResource(R.string.dialog_cancel), modifier = Modifier.clickable { showWarrantyDatePicker = false })
+                                        }
+                                    ) {
+                                        DatePicker(state = warrantyDateState)
+                                    }
+                                }
+                            }
+                        }
+
+                        Spacer(modifier = Modifier.height(16.dp))
+
+                        // [AI_NOTE]: Identification section.
+                        Card(
+                            modifier = Modifier.fillMaxWidth(),
+                            elevation = CardDefaults.cardElevation(4.dp)
+                        ) {
+                            Column(modifier = Modifier.padding(16.dp)) {
+                                Text(
+                                    text = stringResource(R.string.item_edit_identification),
+                                    style = MaterialTheme.typography.headlineSmall
+                                )
+                                Spacer(modifier = Modifier.height(16.dp))
+                                OutlinedTextField(
+                                    value = item.assetId ?: "",
+                                    onValueChange = { viewModel.updateAssetId(it) },
+                                    label = { Text(stringResource(R.string.item_edit_asset_id)) },
+                                    modifier = Modifier.fillMaxWidth()
+                                )
+                                Spacer(modifier = Modifier.height(8.dp))
+                                OutlinedTextField(
+                                    value = item.serialNumber ?: "",
+                                    onValueChange = { viewModel.updateSerialNumber(it) },
+                                    label = { Text(stringResource(R.string.item_edit_serial_number)) },
+                                    modifier = Modifier.fillMaxWidth()
+                                )
+                                Spacer(modifier = Modifier.height(8.dp))
+                                OutlinedTextField(
+                                    value = item.manufacturer ?: "",
+                                    onValueChange = { viewModel.updateManufacturer(it) },
+                                    label = { Text(stringResource(R.string.item_edit_manufacturer)) },
+                                    modifier = Modifier.fillMaxWidth()
+                                )
+                                Spacer(modifier = Modifier.height(8.dp))
+                                OutlinedTextField(
+                                    value = item.modelNumber ?: "",
+                                    onValueChange = { viewModel.updateModelNumber(it) },
+                                    label = { Text(stringResource(R.string.item_edit_model_number)) },
+                                    modifier = Modifier.fillMaxWidth()
+                                )
+                            }
+                        }
+
+                        Spacer(modifier = Modifier.height(16.dp))
+
+                        // [AI_NOTE]: Status & Notes section.
+                        Card(
+                            modifier = Modifier.fillMaxWidth(),
+                            elevation = CardDefaults.cardElevation(4.dp)
+                        ) {
+                            Column(modifier = Modifier.padding(16.dp)) {
+                                Text(
+                                    text = stringResource(R.string.item_edit_status_notes),
+                                    style = MaterialTheme.typography.headlineSmall
+                                )
+                                Spacer(modifier = Modifier.height(16.dp))
+                                Row(
+                                    modifier = Modifier.fillMaxWidth(),
+                                    verticalAlignment = Alignment.CenterVertically,
+                                    horizontalArrangement = Arrangement.SpaceBetween
+                                ) {
+                                    Text(stringResource(R.string.item_edit_archived))
+                                    Switch(
+                                        checked = item.archived,
+                                        onCheckedChange = { viewModel.updateArchived(it) }
+                                    )
+                                }
+                                Spacer(modifier = Modifier.height(8.dp))
+                                Row(
+                                    modifier = Modifier.fillMaxWidth(),
+                                    verticalAlignment = Alignment.CenterVertically,
+                                    horizontalArrangement = Arrangement.SpaceBetween
+                                ) {
+                                    Text(stringResource(R.string.item_edit_insured))
+                                    Switch(
+                                        checked = item.insured,
+                                        onCheckedChange = { viewModel.updateInsured(it) }
+                                    )
+                                }
+                                Spacer(modifier = Modifier.height(8.dp))
+                                OutlinedTextField(
+                                    value = item.notes ?: "",
+                                    onValueChange = { viewModel.updateNotes(it) },
+                                    label = { Text(stringResource(R.string.item_edit_notes)) },
+                                    modifier = Modifier.fillMaxWidth()
+                                )
+                            }
+                        }
+
+                        Spacer(modifier = Modifier.height(16.dp))
+
+                        // [AI_NOTE]: Sold Information section (conditionally displayed).
+                        if (item.soldTime != null || item.soldPrice != null || item.soldTo != null || item.soldNotes != null) {
+                            Card(
+                                modifier = Modifier.fillMaxWidth(),
+                                elevation = CardDefaults.cardElevation(4.dp)
+                            ) {
+                                Column(modifier = Modifier.padding(16.dp)) {
+                                    Text(
+                                        text = stringResource(R.string.item_edit_sold_information),
+                                        style = MaterialTheme.typography.headlineSmall
+                                    )
+                                    Spacer(modifier = Modifier.height(16.dp))
+                                    OutlinedTextField(
+                                        value = item.soldPrice?.toString() ?: "",
+                                        onValueChange = { viewModel.updateSoldPrice(it.toDoubleOrNull()) },
+                                        label = { Text(stringResource(R.string.item_edit_sold_price)) },
+                                        keyboardOptions = KeyboardOptions(keyboardType = KeyboardType.Number),
+                                        modifier = Modifier.fillMaxWidth()
+                                    )
+                                    Spacer(modifier = Modifier.height(8.dp))
+                                    OutlinedTextField(
+                                        value = item.soldTo ?: "",
+                                        onValueChange = { viewModel.updateSoldTo(it) },
+                                        label = { Text(stringResource(R.string.item_edit_sold_to)) },
+                                        modifier = Modifier.fillMaxWidth()
+                                    )
+                                    Spacer(modifier = Modifier.height(8.dp))
+                                    OutlinedTextField(
+                                        value = item.soldNotes ?: "",
+                                        onValueChange = { viewModel.updateSoldNotes(it) },
+                                        label = { Text(stringResource(R.string.item_edit_sold_notes)) },
+                                        modifier = Modifier.fillMaxWidth()
+                                    )
+                                    Spacer(modifier = Modifier.height(8.dp))
+                                    // [AI_NOTE]: Date picker for sold time.
+                                    var showSoldDatePicker by remember { mutableStateOf(false) }
+                                    val soldDateState = rememberDatePickerState()
+                                    OutlinedTextField(
+                                        value = item.soldTime ?: "",
+                                        onValueChange = { }, // Read-only, handled by date picker
+                                        label = { Text(stringResource(R.string.item_edit_sold_time)) },
+                                        readOnly = true,
+                                        trailingIcon = {
+                                            IconButton(onClick = { showSoldDatePicker = true }) {
+                                                Icon(Icons.Filled.DateRange, contentDescription = stringResource(R.string.item_edit_select_date))
+                                            }
+                                        },
+                                        modifier = Modifier
+                                            .fillMaxWidth()
+                                            .clickable { showSoldDatePicker = true }
+                                    )
+                                    if (showSoldDatePicker) {
+                                        DatePickerDialog(
+                                            onDismissRequest = { showSoldDatePicker = false },
+                                            confirmButton = {
+                                                Text(stringResource(R.string.dialog_ok), modifier = Modifier.clickable {
+                                                    val selectedDate = soldDateState.selectedDateMillis?.let {
+                                                        SimpleDateFormat("yyyy-MM-dd", Locale.getDefault()).format(Date(it))
+                                                    }
+                                                    if (selectedDate != null) {
+                                                        viewModel.updateSoldTime(selectedDate)
+                                                    }
+                                                    showSoldDatePicker = false
+                                                })
+                                            },
+                                            dismissButton = {
+                                                Text(stringResource(R.string.dialog_cancel), modifier = Modifier.clickable { showSoldDatePicker = false })
+                                            }
+                                        ) {
+                                            DatePicker(state = soldDateState)
+                                    }
+                                }
+                            }
+                        }
                     }
                 }
-            }
+            }}
         }
     }
 }
-// [END_ENTITY: Function('ItemEditScreen')]
+// [END_ENTITY: Composable('ItemEditScreen')]
 // [END_FILE_ItemEditScreen.kt]

app/src/main/java/com/homebox/lens/ui/screen/itemedit/ItemEditViewModel.kt

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.ui.screen.itemedit
 // [FILE] ItemEditViewModel.kt
-// [SEMANTICS] ui, viewmodel, item_edit
+// [SEMANTICS] app, ui, viewmodel, edit
 
 package com.homebox.lens.ui.screen.itemedit
 
@@ -9,11 +8,16 @@ import androidx.lifecycle.ViewModel
 import androidx.lifecycle.viewModelScope
 import com.homebox.lens.domain.model.Item
 import com.homebox.lens.domain.model.ItemCreate
-import com.homebox.lens.domain.model.Label
+import com.homebox.lens.domain.model.ItemUpdate
 import com.homebox.lens.domain.model.Location
+import com.homebox.lens.domain.model.Label
 import com.homebox.lens.domain.usecase.CreateItemUseCase
+import com.homebox.lens.domain.usecase.GetAllLabelsUseCase
+import com.homebox.lens.domain.usecase.GetAllLocationsUseCase
 import com.homebox.lens.domain.usecase.GetItemDetailsUseCase
+import com.homebox.lens.data.mapper.toDomain
 import com.homebox.lens.domain.usecase.UpdateItemUseCase
+import com.homebox.lens.ui.mapper.ItemMapper
 import dagger.hilt.android.lifecycle.HiltViewModel
 import kotlinx.coroutines.flow.MutableSharedFlow
 import kotlinx.coroutines.flow.MutableStateFlow
@@ -32,11 +36,15 @@ import javax.inject.Inject
  * @param item The item being edited, or null if creating a new item.
  * @param isLoading Whether data is currently being loaded or saved.
  * @param error An error message if an operation failed.
+ * @param allLocations A list of all available locations.
+ * @param allLabels A list of all available labels.
  */
 data class ItemEditUiState(
     val item: Item? = null,
     val isLoading: Boolean = false,
-    val error: String? = null
+    val error: String? = null,
+    val allLocations: List<Location> = emptyList(),
+    val allLabels: List<Label> = emptyList()
 )
 // [END_ENTITY: DataClass('ItemEditUiState')]
 
@@ -44,15 +52,25 @@ data class ItemEditUiState(
 // [RELATION: ViewModel('ItemEditViewModel')] -> [DEPENDS_ON] -> [UseCase('CreateItemUseCase')]
 // [RELATION: ViewModel('ItemEditViewModel')] -> [DEPENDS_ON] -> [UseCase('UpdateItemUseCase')]
 // [RELATION: ViewModel('ItemEditViewModel')] -> [DEPENDS_ON] -> [UseCase('GetItemDetailsUseCase')]
+// [RELATION: ViewModel('ItemEditViewModel')] -> [DEPENDS_ON] -> [Class('ItemMapper')]
 // [RELATION: ViewModel('ItemEditViewModel')] -> [EMITS_STATE] -> [DataClass('ItemEditUiState')]
 /**
  * @summary ViewModel for the item edit screen.
+ * @param createItemUseCase Use case for creating a new item.
+ * @param updateItemUseCase Use case for updating an existing item.
+ * @param getItemDetailsUseCase Use case for fetching item details.
+ * @param getAllLocationsUseCase Use case for fetching all locations.
+ * @param getAllLabelsUseCase Use case for fetching all labels.
+ * @param itemMapper Mapper for converting between domain and UI item models.
  */
 @HiltViewModel
 class ItemEditViewModel @Inject constructor(
     private val createItemUseCase: CreateItemUseCase,
     private val updateItemUseCase: UpdateItemUseCase,
-    private val getItemDetailsUseCase: GetItemDetailsUseCase
+    private val getItemDetailsUseCase: GetItemDetailsUseCase,
+    private val getAllLocationsUseCase: GetAllLocationsUseCase,
+    private val getAllLabelsUseCase: GetAllLabelsUseCase,
+    private val itemMapper: ItemMapper
 ) : ViewModel() {
 
     private val _uiState = MutableStateFlow(ItemEditUiState())
@@ -73,34 +91,93 @@ class ItemEditViewModel @Inject constructor(
             _uiState.value = _uiState.value.copy(isLoading = true, error = null)
             if (itemId == null) {
                 Timber.i("[INFO][ACTION][new_item_preparation] Preparing for new item creation.")
-                _uiState.value = _uiState.value.copy(isLoading = false, item = Item(id = "", name = "", description = null, quantity = 0, image = null, location = null, labels = emptyList(), value = null, createdAt = null))
+                _uiState.value = _uiState.value.copy(
+                    isLoading = false,
+                    item = Item(
+                        id = "",
+                        name = "",
+                        description = null,
+                        quantity = 1,
+                        image = null,
+                        location = null,
+                        labels = emptyList(),
+                        purchasePrice = null,
+                        createdAt = null,
+                        archived = false,
+                        assetId = null,
+                        fields = emptyList(),
+                        insured = false,
+                        lifetimeWarranty = false,
+                        manufacturer = null,
+                        modelNumber = null,
+                        notes = null,
+                        parentId = null,
+                        purchaseFrom = null,
+                        purchaseTime = null,
+                        serialNumber = null,
+                        soldNotes = null,
+                        soldPrice = null,
+                        soldTime = null,
+                        soldTo = null,
+                        syncChildItemsLocations = false,
+                        warrantyDetails = null,
+                        warrantyExpires = null
+                    )
+                )
             } else {
                 try {
                     Timber.i("[INFO][ACTION][fetching_item_details] Fetching details for item ID: %s", itemId)
                     val itemOut = getItemDetailsUseCase(itemId)
                     Timber.d("[DEBUG][ACTION][mapping_item_out_to_item] Mapping ItemOut to Item for UI state.")
-                    val item = Item(
-                        id = itemOut.id,
-                        name = itemOut.name,
-                        description = itemOut.description,
-                        quantity = itemOut.quantity,
-                        image = itemOut.images.firstOrNull()?.path, // Assuming first image is the main one
-                        location = itemOut.location?.let { Location(it.id, it.name) }, // Simplified mapping
-                        labels = itemOut.labels.map { Label(it.id, it.name) }, // Simplified mapping
-                        value = itemOut.value?.toBigDecimal(),
-                        createdAt = itemOut.createdAt
-                    )
+                    val item = itemMapper.toItem(itemOut)
                     _uiState.value = _uiState.value.copy(isLoading = false, item = item)
-                    Timber.i("[INFO][ACTION][item_details_fetched] Successfully fetched item details for ID: %s", itemId)
+                    Timber.i("[INFO][ACTION][item_details_fetched] Successfully fetched and mapped item details for ID: %s", itemId)
                 } catch (e: Exception) {
                     Timber.e(e, "[ERROR][FALLBACK][item_load_failed] Failed to load item details for ID: %s", itemId)
                     _uiState.value = _uiState.value.copy(isLoading = false, error = e.localizedMessage)
                 }
             }
+
+            // Load all locations and labels
+            try {
+                Timber.i("[INFO][ACTION][fetching_all_locations] Fetching all locations.")
+                val allLocations = getAllLocationsUseCase().map { Location(it.id, it.name) }
+                Timber.i("[INFO][ACTION][fetching_all_labels] Fetching all labels.")
+                val allLabels = getAllLabelsUseCase().map { it.toDomain() }
+                _uiState.value = _uiState.value.copy(allLocations = allLocations, allLabels = allLabels)
+                Timber.i("[INFO][ACTION][all_locations_labels_fetched] Successfully fetched all locations and labels.")
+            } catch (e: Exception) {
+                Timber.e(e, "[ERROR][FALLBACK][locations_labels_load_failed] Failed to load locations or labels.")
+                _uiState.value = _uiState.value.copy(error = e.localizedMessage)
+            }
         }
     }
     // [END_ENTITY: Function('loadItem')]
 
+    // [ENTITY: Function('updateLocation')]
+    /**
+     * @summary Updates the location of the item in the UI state.
+     * @param location The new location for the item.
+     * @sideeffect Updates the `item` in `_uiState`.
+     */
+    fun updateLocation(location: Location) {
+        Timber.d("[DEBUG][ACTION][updating_item_location] Updating item location to: %s", location.name)
+        _uiState.value = _uiState.value.copy(item = _uiState.value.item?.copy(location = location))
+    }
+    // [END_ENTITY: Function('updateLocation')]
+
+    // [ENTITY: Function('updateLabels')]
+    /**
+     * @summary Updates the labels of the item in the UI state.
+     * @param labels The new list of labels for the item.
+     * @sideeffect Updates the `item` in `_uiState`.
+     */
+    fun updateLabels(labels: List<Label>) {
+        Timber.d("[DEBUG][ACTION][updating_item_labels] Updating item labels to: %s", labels.map { it.name }.joinToString())
+        _uiState.value = _uiState.value.copy(item = _uiState.value.item?.copy(labels = labels))
+    }
+    // [END_ENTITY: Function('updateLabels')]
+
     // [ENTITY: Function('saveItem')]
     /**
      * @summary Saves the current item, either creating a new one or updating an existing one.
@@ -117,53 +194,48 @@ class ItemEditViewModel @Inject constructor(
             try {
                 if (currentItem.id.isBlank()) {
                     Timber.i("[INFO][ACTION][creating_new_item] Creating new item: %s", currentItem.name)
-                    val createdItemSummary = createItemUseCase(ItemCreate(
-                        name = currentItem.name,
-                        description = currentItem.description,
-                        quantity = currentItem.quantity,
-                        assetId = null, // Item does not have assetId
-                        notes = null, // Item does not have notes
-                        serialNumber = null, // Item does not have serialNumber
-                        value = currentItem.value?.toDouble(), // Convert BigDecimal to Double
-                        purchasePrice = null, // Item does not have purchasePrice
-                        purchaseDate = null, // Item does not have purchaseDate
-                        warrantyUntil = null, // Item does not have warrantyUntil
-                        locationId = currentItem.location?.id,
-                        parentId = null, // Item does not have parentId
-                        labelIds = currentItem.labels.map { it.id }
-                    ))
-                    Timber.d("[DEBUG][ACTION][mapping_item_summary_to_item] Mapping ItemSummary to Item for UI state.")
-                    val createdItem = Item(
-                        id = createdItemSummary.id,
-                        name = createdItemSummary.name,
-                        description = null, // ItemSummary does not have description
-                        quantity = 0, // ItemSummary does not have quantity
-                        image = null, // ItemSummary does not have image
-                        location = null, // ItemSummary does not have location
-                        labels = emptyList(), // ItemSummary does not have labels
-                        value = null, // ItemSummary does not have value
-                        createdAt = null // ItemSummary does not have createdAt
+                    val createdItemSummary = createItemUseCase(
+                        ItemCreate(
+                            name = currentItem.name,
+                            description = currentItem.description,
+                            quantity = currentItem.quantity,
+                            archived = currentItem.archived,
+                            assetId = currentItem.assetId,
+                            insured = currentItem.insured,
+                            lifetimeWarranty = currentItem.lifetimeWarranty,
+                            manufacturer = currentItem.manufacturer,
+                            modelNumber = currentItem.modelNumber,
+                            notes = currentItem.notes,
+                            parentId = currentItem.parentId,
+                            purchaseFrom = currentItem.purchaseFrom,
+                            purchasePrice = currentItem.purchasePrice,
+                            purchaseTime = currentItem.purchaseTime,
+                            serialNumber = currentItem.serialNumber,
+                            soldNotes = currentItem.soldNotes,
+                            soldPrice = currentItem.soldPrice,
+                            soldTime = currentItem.soldTime,
+                            soldTo = currentItem.soldTo,
+                            syncChildItemsLocations = currentItem.syncChildItemsLocations,
+                            warrantyDetails = currentItem.warrantyDetails,
+                            warrantyExpires = currentItem.warrantyExpires,
+                            locationId = currentItem.location?.id,
+                            labelIds = currentItem.labels.map { it.id }
+                        )
                     )
-                    _uiState.value = _uiState.value.copy(isLoading = false, item = createdItem)
-                    Timber.i("[INFO][ACTION][new_item_created] Successfully created new item with ID: %s", createdItem.id)
+                    Timber.i("[INFO][ACTION][fetching_full_item_after_creation] Fetching full item details after creation for ID: %s", createdItemSummary.id)
+                    val createdItemOut = getItemDetailsUseCase(createdItemSummary.id)
+                    Timber.d("[DEBUG][ACTION][mapping_item_out_to_item] Mapping created ItemOut to Item for UI state.")
+                    val item = itemMapper.toItem(createdItemOut)
+                    _uiState.value = _uiState.value.copy(isLoading = false, item = item)
+                    Timber.i("[INFO][ACTION][new_item_created] Successfully created and mapped new item with ID: %s", createdItemOut.id)
                     _saveCompleted.emit(Unit)
                 } else {
                     Timber.i("[INFO][ACTION][updating_existing_item] Updating existing item with ID: %s", currentItem.id)
                     val updatedItemOut = updateItemUseCase(currentItem)
-                    Timber.d("[DEBUG][ACTION][mapping_item_out_to_item] Mapping ItemOut to Item for UI state.")
-                    val updatedItem = Item(
-                        id = updatedItemOut.id,
-                        name = updatedItemOut.name,
-                        description = updatedItemOut.description,
-                        quantity = updatedItemOut.quantity,
-                        image = updatedItemOut.images.firstOrNull()?.path,
-                        location = updatedItemOut.location?.let { Location(it.id, it.name) },
-                        labels = updatedItemOut.labels.map { Label(it.id, it.name) },
-                        value = updatedItemOut.value.toBigDecimal(),
-                        createdAt = updatedItemOut.createdAt
-                    )
-                    _uiState.value = _uiState.value.copy(isLoading = false, item = updatedItem)
-                    Timber.i("[INFO][ACTION][item_updated] Successfully updated item with ID: %s", updatedItem.id)
+                    Timber.d("[DEBUG][ACTION][mapping_item_out_to_item] Mapping updated ItemOut to Item for UI state.")
+                    val item = itemMapper.toItem(updatedItemOut)
+                    _uiState.value = _uiState.value.copy(isLoading = false, item = item)
+                    Timber.i("[INFO][ACTION][item_updated] Successfully updated and mapped item with ID: %s", updatedItemOut.id)
                     _saveCompleted.emit(Unit)
                 }
             } catch (e: Exception) {
@@ -209,6 +281,234 @@ class ItemEditViewModel @Inject constructor(
         _uiState.value = _uiState.value.copy(item = _uiState.value.item?.copy(quantity = newQuantity))
     }
     // [END_ENTITY: Function('updateQuantity')]
-}
-// [END_ENTITY: ViewModel('ItemEditViewModel')]
+    
+        // [ENTITY: Function('updateArchived')]
+        /**
+         * @summary Updates the archived status of the item in the UI state.
+         * @param newArchived The new archived status for the item.
+         * @sideeffect Updates the `item` in `_uiState`.
+         */
+        fun updateArchived(newArchived: Boolean) {
+            Timber.d("[DEBUG][ACTION][updating_item_archived] Updating item archived status to: %s", newArchived)
+            _uiState.value = _uiState.value.copy(item = _uiState.value.item?.copy(archived = newArchived))
+        }
+        // [END_ENTITY: Function('updateArchived')]
+    
+        // [ENTITY: Function('updateAssetId')]
+        /**
+         * @summary Updates the asset ID of the item in the UI state.
+         * @param newAssetId The new asset ID for the item.
+         * @sideeffect Updates the `item` in `_uiState`.
+         */
+        fun updateAssetId(newAssetId: String) {
+            Timber.d("[DEBUG][ACTION][updating_item_assetId] Updating item asset ID to: %s", newAssetId)
+            _uiState.value = _uiState.value.copy(item = _uiState.value.item?.copy(assetId = newAssetId))
+        }
+        // [END_ENTITY: Function('updateAssetId')]
+    
+        // [ENTITY: Function('updateInsured')]
+        /**
+         * @summary Updates the insured status of the item in the UI state.
+         * @param newInsured The new insured status for the item.
+         * @sideeffect Updates the `item` in `_uiState`.
+         */
+        fun updateInsured(newInsured: Boolean) {
+            Timber.d("[DEBUG][ACTION][updating_item_insured] Updating item insured status to: %s", newInsured)
+            _uiState.value = _uiState.value.copy(item = _uiState.value.item?.copy(insured = newInsured))
+        }
+        // [END_ENTITY: Function('updateInsured')]
+    
+        // [ENTITY: Function('updateLifetimeWarranty')]
+        /**
+         * @summary Updates the lifetime warranty status of the item in the UI state.
+         * @param newLifetimeWarranty The new lifetime warranty status for the item.
+         * @sideeffect Updates the `item` in `_uiState`.
+         */
+        fun updateLifetimeWarranty(newLifetimeWarranty: Boolean) {
+            Timber.d("[DEBUG][ACTION][updating_item_lifetime_warranty] Updating item lifetime warranty status to: %s", newLifetimeWarranty)
+            _uiState.value = _uiState.value.copy(item = _uiState.value.item?.copy(lifetimeWarranty = newLifetimeWarranty))
+        }
+        // [END_ENTITY: Function('updateLifetimeWarranty')]
+    
+        // [ENTITY: Function('updateManufacturer')]
+        /**
+         * @summary Updates the manufacturer of the item in the UI state.
+         * @param newManufacturer The new manufacturer for the item.
+         * @sideeffect Updates the `item` in `_uiState`.
+         */
+        fun updateManufacturer(newManufacturer: String) {
+            Timber.d("[DEBUG][ACTION][updating_item_manufacturer] Updating item manufacturer to: %s", newManufacturer)
+            _uiState.value = _uiState.value.copy(item = _uiState.value.item?.copy(manufacturer = newManufacturer))
+        }
+        // [END_ENTITY: Function('updateManufacturer')]
+    
+        // [ENTITY: Function('updateModelNumber')]
+        /**
+         * @summary Updates the model number of the item in the UI state.
+         * @param newModelNumber The new model number for the item.
+         * @sideeffect Updates the `item` in `_uiState`.
+         */
+        fun updateModelNumber(newModelNumber: String) {
+            Timber.d("[DEBUG][ACTION][updating_item_model_number] Updating item model number to: %s", newModelNumber)
+            _uiState.value = _uiState.value.copy(item = _uiState.value.item?.copy(modelNumber = newModelNumber))
+        }
+        // [END_ENTITY: Function('updateModelNumber')]
+    
+        // [ENTITY: Function('updateNotes')]
+        /**
+         * @summary Updates the notes of the item in the UI state.
+         * @param newNotes The new notes for the item.
+         * @sideeffect Updates the `item` in `_uiState`.
+         */
+        fun updateNotes(newNotes: String) {
+            Timber.d("[DEBUG][ACTION][updating_item_notes] Updating item notes to: %s", newNotes)
+            _uiState.value = _uiState.value.copy(item = _uiState.value.item?.copy(notes = newNotes))
+        }
+        // [END_ENTITY: Function('updateNotes')]
+    
+        // [ENTITY: Function('updateParentId')]
+        /**
+         * @summary Updates the parent ID of the item in the UI state.
+         * @param newParentId The new parent ID for the item.
+         * @sideeffect Updates the `item` in `_uiState`.
+         */
+        fun updateParentId(newParentId: String) {
+            Timber.d("[DEBUG][ACTION][updating_item_parent_id] Updating item parent ID to: %s", newParentId)
+            _uiState.value = _uiState.value.copy(item = _uiState.value.item?.copy(parentId = newParentId))
+        }
+        // [END_ENTITY: Function('updateParentId')]
+    
+        // [ENTITY: Function('updatePurchaseFrom')]
+        /**
+         * @summary Updates the purchase source of the item in the UI state.
+         * @param newPurchaseFrom The new purchase source for the item.
+         * @sideeffect Updates the `item` in `_uiState`.
+         */
+        fun updatePurchaseFrom(newPurchaseFrom: String) {
+            Timber.d("[DEBUG][ACTION][updating_item_purchase_from] Updating item purchase from to: %s", newPurchaseFrom)
+            _uiState.value = _uiState.value.copy(item = _uiState.value.item?.copy(purchaseFrom = newPurchaseFrom))
+        }
+        // [END_ENTITY: Function('updatePurchaseFrom')]
+    
+        // [ENTITY: Function('updatePurchasePrice')]
+        /**
+         * @summary Updates the purchase price of the item in the UI state.
+         * @param newPurchasePrice The new purchase price for the item.
+         * @sideeffect Updates the `item` in `_uiState`.
+         */
+        fun updatePurchasePrice(newPurchasePrice: Double?) {
+            Timber.d("[DEBUG][ACTION][updating_item_purchase_price] Updating item purchase price to: %s", newPurchasePrice)
+            _uiState.value = _uiState.value.copy(item = _uiState.value.item?.copy(purchasePrice = newPurchasePrice))
+        }
+        // [END_ENTITY: Function('updatePurchasePrice')]
+    
+        // [ENTITY: Function('updatePurchaseTime')]
+        /**
+         * @summary Updates the purchase time of the item in the UI state.
+         * @param newPurchaseTime The new purchase time for the item.
+         * @sideeffect Updates the `item` in `_uiState`.
+         */
+        fun updatePurchaseTime(newPurchaseTime: String) {
+            Timber.d("[DEBUG][ACTION][updating_item_purchase_time] Updating item purchase time to: %s", newPurchaseTime)
+            _uiState.value = _uiState.value.copy(item = _uiState.value.item?.copy(purchaseTime = newPurchaseTime))
+        }
+        // [END_ENTITY: Function('updatePurchaseTime')]
+    
+        // [ENTITY: Function('updateSerialNumber')]
+        /**
+         * @summary Updates the serial number of the item in the UI state.
+         * @param newSerialNumber The new serial number for the item.
+         * @sideeffect Updates the `item` in `_uiState`.
+         */
+        fun updateSerialNumber(newSerialNumber: String) {
+            Timber.d("[DEBUG][ACTION][updating_item_serial_number] Updating item serial number to: %s", newSerialNumber)
+            _uiState.value = _uiState.value.copy(item = _uiState.value.item?.copy(serialNumber = newSerialNumber))
+        }
+        // [END_ENTITY: Function('updateSerialNumber')]
+    
+        // [ENTITY: Function('updateSoldNotes')]
+        /**
+         * @summary Updates the sold notes of the item in the UI state.
+         * @param newSoldNotes The new sold notes for the item.
+         * @sideeffect Updates the `item` in `_uiState`.
+         */
+        fun updateSoldNotes(newSoldNotes: String) {
+            Timber.d("[DEBUG][ACTION][updating_item_sold_notes] Updating item sold notes to: %s", newSoldNotes)
+            _uiState.value = _uiState.value.copy(item = _uiState.value.item?.copy(soldNotes = newSoldNotes))
+        }
+        // [END_ENTITY: Function('updateSoldNotes')]
+    
+        // [ENTITY: Function('updateSoldPrice')]
+        /**
+         * @summary Updates the sold price of the item in the UI state.
+         * @param newSoldPrice The new sold price for the item.
+         * @sideeffect Updates the `item` in `_uiState`.
+         */
+        fun updateSoldPrice(newSoldPrice: Double?) {
+            Timber.d("[DEBUG][ACTION][updating_item_sold_price] Updating item sold price to: %s", newSoldPrice)
+            _uiState.value = _uiState.value.copy(item = _uiState.value.item?.copy(soldPrice = newSoldPrice))
+        }
+        // [END_ENTITY: Function('updateSoldPrice')]
+    
+        // [ENTITY: Function('updateSoldTime')]
+        /**
+         * @summary Updates the sold time of the item in the UI state.
+         * @param newSoldTime The new sold time for the item.
+         * @sideeffect Updates the `item` in `_uiState`.
+         */
+        fun updateSoldTime(newSoldTime: String) {
+            Timber.d("[DEBUG][ACTION][updating_item_sold_time] Updating item sold time to: %s", newSoldTime)
+            _uiState.value = _uiState.value.copy(item = _uiState.value.item?.copy(soldTime = newSoldTime))
+        }
+        // [END_ENTITY: Function('updateSoldTime')]
+    
+        // [ENTITY: Function('updateSoldTo')]
+        /**
+         * @summary Updates the sold to field of the item in the UI state.
+         * @param newSoldTo The new sold to for the item.
+         * @sideeffect Updates the `item` in `_uiState`.
+         */
+        fun updateSoldTo(newSoldTo: String) {
+            Timber.d("[DEBUG][ACTION][updating_item_sold_to] Updating item sold to to: %s", newSoldTo)
+            _uiState.value = _uiState.value.copy(item = _uiState.value.item?.copy(soldTo = newSoldTo))
+        }
+        // [END_ENTITY: Function('updateSoldTo')]
+    
+        // [ENTITY: Function('updateSyncChildItemsLocations')]
+        /**
+         * @summary Updates the sync child items locations status of the item in the UI state.
+         * @param newSyncChildItemsLocations The new sync child items locations status for the item.
+         * @sideeffect Updates the `item` in `_uiState`.
+         */
+        fun updateSyncChildItemsLocations(newSyncChildItemsLocations: Boolean) {
+            Timber.d("[DEBUG][ACTION][updating_item_sync_child_items_locations] Updating item sync child items locations status to: %s", newSyncChildItemsLocations)
+            _uiState.value = _uiState.value.copy(item = _uiState.value.item?.copy(syncChildItemsLocations = newSyncChildItemsLocations))
+        }
+        // [END_ENTITY: Function('updateSyncChildItemsLocations')]
+    
+        // [ENTITY: Function('updateWarrantyDetails')]
+        /**
+         * @summary Updates the warranty details of the item in the UI state.
+         * @param newWarrantyDetails The new warranty details for the item.
+         * @sideeffect Updates the `item` in `_uiState`.
+         */
+        fun updateWarrantyDetails(newWarrantyDetails: String) {
+            Timber.d("[DEBUG][ACTION][updating_item_warranty_details] Updating item warranty details to: %s", newWarrantyDetails)
+            _uiState.value = _uiState.value.copy(item = _uiState.value.item?.copy(warrantyDetails = newWarrantyDetails))
+        }
+        // [END_ENTITY: Function('updateWarrantyDetails')]
+    
+        // [ENTITY: Function('updateWarrantyExpires')]
+        /**
+         * @summary Updates the warranty expires date of the item in the UI state.
+         * @param newWarrantyExpires The new warranty expires date for the item.
+         * @sideeffect Updates the `item` in `_uiState`.
+         */
+        fun updateWarrantyExpires(newWarrantyExpires: String) {
+            Timber.d("[DEBUG][ACTION][updating_item_warranty_expires] Updating item warranty expires date to: %s", newWarrantyExpires)
+            _uiState.value = _uiState.value.copy(item = _uiState.value.item?.copy(warrantyExpires = newWarrantyExpires))
+        }
+        // [END_ENTITY: Function('updateWarrantyExpires')]
+    }
+    // [END_ENTITY: ViewModel('ItemEditViewModel')]
 // [END_FILE_ItemEditViewModel.kt]

app/src/main/java/com/homebox/lens/ui/screen/labeledit/LabelEditScreen.kt

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.ui.screen.labeledit
 // [FILE] LabelEditScreen.kt
-// [SEMANTICS] ui, screen, label, edit
+// [SEMANTICS] app, ui, screen, edit, label
 
 package com.homebox.lens.ui.screen.labeledit
 
@@ -24,10 +23,10 @@ import com.homebox.lens.ui.components.LoadingOverlay
 // [ENTITY: Function('LabelEditScreen')]
 // [RELATION: Function('LabelEditScreen')] -> [DEPENDS_ON] -> [ViewModel('LabelEditViewModel')]
 /**
- * @summary Composable-функция для экрана "Редактирование метки".
- * @param labelId ID метки для редактирования или null для создания новой.
- * @param onBack Навигация назад.
- * @param onLabelSaved Действие после сохранения метки.
+ * @summary Composable function for the "Edit Label" screen.
+ * @param labelId The ID of the label to edit, or null to create a new one.
+ * @param onBack Navigation back.
+ * @param onLabelSaved Action after the label is saved.
  */
 @OptIn(ExperimentalMaterial3Api::class)
 @Composable
@@ -97,6 +96,13 @@ fun LabelEditScreen(
                 modifier = Modifier.fillMaxWidth()
             )
             Spacer(modifier = Modifier.height(16.dp))
+            OutlinedTextField(
+                value = uiState.description.orEmpty(),
+                onValueChange = viewModel::onDescriptionChange,
+                label = { Text(stringResource(R.string.label_description)) },
+                modifier = Modifier.fillMaxWidth()
+            )
+            Spacer(modifier = Modifier.height(16.dp))
             ColorPicker(
                 selectedColor = uiState.color,
                 onColorSelected = viewModel::onColorChange,

app/src/main/java/com/homebox/lens/ui/screen/labeledit/LabelEditViewModel.kt

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.ui.screen.labeledit
 // [FILE] LabelEditViewModel.kt
-// [SEMANTICS] ui, viewmodel, label_management
+// [SEMANTICS] app, ui, viewmodel, edit, label
 
 package com.homebox.lens.ui.screen.labeledit
 
@@ -50,6 +49,10 @@ class LabelEditViewModel @Inject constructor(
         uiState = uiState.copy(name = newName, nameError = null)
     }
 
+    fun onDescriptionChange(newDescription: String) {
+        uiState = uiState.copy(description = newDescription)
+    }
+
     fun onColorChange(newColor: String) {
         uiState = uiState.copy(color = newColor)
     }
@@ -63,35 +66,41 @@ class LabelEditViewModel @Inject constructor(
 
             uiState = uiState.copy(isLoading = true, error = null)
             try {
-                if (labelId == null) {
-                    // Create new label
-                    val newLabel = LabelCreate(name = uiState.name, color = uiState.color)
+                val result = if (labelId == null) {
+                    // [LOG_EVENT] [EVENT_TYPE: LabelCreationAttempt] [DATA: { "labelName": "${uiState.name}" }]
+                    val newLabel = LabelCreate(name = uiState.name, color = uiState.color, description = uiState.description)
                     createLabelUseCase(newLabel)
                 } else {
-                    // Update existing label
-                    val updatedLabel = LabelUpdate(name = uiState.name, color = uiState.color)
+                    // [LOG_EVENT] [EVENT_TYPE: LabelUpdateAttempt] [DATA: { "labelId": "$labelId", "labelName": "${uiState.name}" }]
+                    val updatedLabel = LabelUpdate(name = uiState.name, color = uiState.color, description = uiState.description)
                     updateLabelUseCase(labelId, updatedLabel)
                 }
+                // [LOG_EVENT] [EVENT_TYPE: LabelSaveSuccess] [DATA: { "labelName": "${uiState.name}", "isNew": ${labelId == null} }]
                 uiState = uiState.copy(isSaved = true)
             } catch (e: Exception) {
+                // [LOG_EVENT] [EVENT_TYPE: LabelSaveFailure] [ERROR: "${e.message}"] [DATA: { "labelName": "${uiState.name}", "isNew": ${labelId == null} }]
                 uiState = uiState.copy(error = e.message, isLoading = false)
             } finally {
                 uiState = uiState.copy(isLoading = false)
             }
         }
     }
-
     private fun loadLabelDetails(id: String) {
         viewModelScope.launch {
             uiState = uiState.copy(isLoading = true, error = null)
             try {
+                // [LOG_EVENT] [EVENT_TYPE: LabelDetailsFetchAttempt] [DATA: { "labelId": "$id" }]
                 val label = getLabelDetailsUseCase(id)
+                // [LOG_EVENT] [EVENT_TYPE: LabelDetailsFetchSuccess] [DATA: { "labelId": "$id", "labelName": "${label.name}" }]
                 uiState = uiState.copy(
                     name = label.name,
                     color = label.color,
-                    isLoading = false
+                    description = label.description,
+                    isLoading = false,
+                    originalLabel = label
                 )
             } catch (e: Exception) {
+                // [LOG_EVENT] [EVENT_TYPE: LabelDetailsFetchFailure] [ERROR: "${e.message}"] [DATA: { "labelId": "$id" }]
                 uiState = uiState.copy(error = e.message, isLoading = false)
             }
         }
@@ -104,6 +113,7 @@ class LabelEditViewModel @Inject constructor(
  */
 data class LabelEditUiState(
     val name: String = "",
+    val description: String? = null,
     val color: String = "#FFFFFF", // Default color
     val nameError: String? = null,
     val isLoading: Boolean = false,

app/src/main/java/com/homebox/lens/ui/screen/labelslist/LabelsListScreen.kt

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.ui.screen.labelslist
 // [FILE] LabelsListScreen.kt
-// [SEMANTICS] ui, labels_list, state_management, compose, dialog
+// [SEMANTICS] app, ui, screen, list, label
 package com.homebox.lens.ui.screen.labelslist
 
 // [IMPORTS]
@@ -17,24 +16,18 @@ import androidx.compose.material.icons.Icons
 import androidx.compose.material.icons.automirrored.filled.ArrowBack
 import androidx.compose.material.icons.automirrored.filled.Label
 import androidx.compose.material.icons.filled.Add
-import androidx.compose.material3.AlertDialog
 import androidx.compose.material3.CircularProgressIndicator
 import androidx.compose.material3.ExperimentalMaterial3Api
 import androidx.compose.material3.FloatingActionButton
 import androidx.compose.material3.Icon
 import androidx.compose.material3.IconButton
 import androidx.compose.material3.ListItem
-import androidx.compose.material3.OutlinedTextField
 import androidx.compose.material3.Scaffold
 import androidx.compose.material3.Text
-import androidx.compose.material3.TextButton
 import androidx.compose.material3.TopAppBar
 import androidx.compose.runtime.Composable
 import androidx.compose.runtime.collectAsState
 import androidx.compose.runtime.getValue
-import androidx.compose.runtime.mutableStateOf
-import androidx.compose.runtime.remember
-import androidx.compose.runtime.setValue
 import androidx.compose.ui.Alignment
 import androidx.compose.ui.Modifier
 import androidx.compose.ui.res.stringResource
@@ -52,10 +45,12 @@ import timber.log.Timber
 // [RELATION: Function('LabelsListScreen')] -> [DEPENDS_ON] -> [ViewModel('LabelsListViewModel')]
 // [RELATION: Function('LabelsListScreen')] -> [DEPENDS_ON] -> [Framework('NavController')]
 /**
- * @summary Отображает экран со списком всех меток.
- * @param navController Контроллер навигации для перемещения между экранами.
- * @param viewModel ViewModel, предоставляющая состояние UI для экрана меток.
+ * @summary Displays the screen with a list of all labels.
+ * @param currentRoute The current navigation route.
+ * @param navigationActions The object containing navigation actions.
+ * @param viewModel The ViewModel providing the UI state for the labels screen.
  */
+@OptIn(ExperimentalMaterial3Api::class)
 @Composable
 fun LabelsListScreen(
     currentRoute: String?,
@@ -90,19 +85,19 @@ fun LabelsListScreen(
                 .padding(innerPaddingValues), // Use innerPaddingValues here
             contentAlignment = Alignment.Center
         ) {
-            when (currentState) {
+            when (val state = uiState) {
                 is LabelsListUiState.Loading -> {
                     CircularProgressIndicator()
                 }
                 is LabelsListUiState.Error -> {
-                    Text(text = currentState.message)
+                    Text(text = state.message)
                 }
                 is LabelsListUiState.Success -> {
-                    if (currentState.labels.isEmpty()) {
+                    if (state.labels.isEmpty()) {
                         Text(text = stringResource(id = R.string.no_labels_found))
                     } else {
                         LabelsList(
-                            labels = currentState.labels,
+                            labels = state.labels,
                             onLabelClick = { label ->
                                 Timber.i("[INFO][ACTION][navigate_to_label_edit] Label clicked: ${label.id}. Navigating to label edit screen.")
                                 navigationActions.navigateToLabelEdit(label.id)
@@ -120,10 +115,10 @@ fun LabelsListScreen(
 // [ENTITY: Function('LabelsList')]
 // [RELATION: Function('LabelsList')] -> [DEPENDS_ON] -> [DataClass('Label')]
 /**
- * @summary Composable-функция для отображения списка меток.
- * @param labels Список объектов `Label` для отображения.
- * @param onLabelClick Лямбда-функция, вызываемая при нажатии на элемент списка.
- * @param modifier Модификатор для настройки внешнего вида.
+ * @summary Composable function for displaying a list of labels.
+ * @param labels The list of `Label` objects to display.
+ * @param onLabelClick A lambda function called when a list item is clicked.
+ * @param modifier A modifier for customizing the appearance.
  */
 @Composable
 private fun LabelsList(
@@ -149,9 +144,9 @@ private fun LabelsList(
 // [ENTITY: Function('LabelListItem')]
 // [RELATION: Function('LabelListItem')] -> [DEPENDS_ON] -> [DataClass('Label')]
 /**
- * @summary Composable-функция для отображения одного элемента в списке меток.
- * @param label Объект `Label`, который нужно отобразить.
- * @param onClick Лямбда-функция, вызываемая при нажатии на элемент.
+ * @summary Composable function for displaying a single item in the list of labels.
+ * @param label The `Label` object to display.
+ * @param onClick A lambda function called when the item is clicked.
  */
 @Composable
 private fun LabelListItem(

app/src/main/java/com/homebox/lens/ui/screen/labelslist/LabelsListUiState.kt

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.ui.screen.labelslist
 // [FILE] LabelsListUiState.kt
-// [SEMANTICS] ui_state, sealed_interface, contract
+// [SEMANTICS] app, ui, state, list, label
 package com.homebox.lens.ui.screen.labelslist
 
 // [IMPORTS]
@@ -9,17 +8,17 @@ import com.homebox.lens.domain.model.Label
 
 // [ENTITY: SealedInterface('LabelsListUiState')]
 /**
- * @summary Определяет все возможные состояния для UI экрана со списком меток.
- * @description Использование sealed-интерфейса позволяет исчерпывающе обрабатывать все состояния в Composable-функциях.
+ * @summary Defines all possible states for the UI of the screen with a list of labels.
+ * @description Using a sealed interface allows for exhaustive handling of all states in Composable functions.
  */
 sealed interface LabelsListUiState {
     // [ENTITY: DataClass('Success')]
     // [RELATION: DataClass('Success')] -> [DEPENDS_ON] -> [DataClass('Label')]
     /**
-     * @summary Состояние успеха, содержит список меток и состояние диалога.
-     * @param labels Список меток для отображения.
-     * @param isShowingCreateDialog Флаг, показывающий, должен ли быть отображен диалог создания метки.
-     * @invariant labels не может быть null.
+     * @summary The success state, contains the list of labels and the state of the dialog.
+     * @param labels The list of labels to display.
+     * @param isShowingCreateDialog A flag indicating whether the label creation dialog should be displayed.
+     * @invariant labels cannot be null.
      */
     data class Success(
         val labels: List<Label>,
@@ -29,17 +28,17 @@ sealed interface LabelsListUiState {
 
     // [ENTITY: DataClass('Error')]
     /**
-     * @summary Состояние ошибки.
-     * @param message Текст ошибки для отображения пользователю.
-     * @invariant message не может быть пустой.
+     * @summary The error state.
+     * @param message The error text to display to the user.
+     * @invariant message cannot be empty.
      */
     data class Error(val message: String) : LabelsListUiState
     // [END_ENTITY: DataClass('Error')]
 
     // [ENTITY: Object('Loading')]
     /**
-     * @summary Состояние загрузки данных.
-     * @description Указывает, что идет процесс загрузки меток.
+     * @summary The data loading state.
+     * @description Indicates that the process of loading labels is in progress.
      */
     data object Loading : LabelsListUiState
     // [END_ENTITY: Object('Loading')]

app/src/main/java/com/homebox/lens/ui/screen/labelslist/LabelsListViewModel.kt

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.ui.screen.labelslist
 // [FILE] LabelsListViewModel.kt
-// [SEMANTICS] ui_logic, labels_list, state_management, dialog_management
+// [SEMANTICS] app, ui, viewmodel, list, label
 package com.homebox.lens.ui.screen.labelslist
 
 // [IMPORTS]
@@ -21,9 +20,9 @@ import javax.inject.Inject
 // [RELATION: ViewModel('LabelsListViewModel')] -> [DEPENDS_ON] -> [UseCase('GetAllLabelsUseCase')]
 // [RELATION: ViewModel('LabelsListViewModel')] -> [EMITS_STATE] -> [SealedInterface('LabelsListUiState')]
 /**
- * @summary ViewModel для экрана со списком меток.
- * @description Управляет состоянием экрана, загружает список меток, обрабатывает ошибки и управляет диалогом создания новой метки.
- * @invariant `uiState` всегда является одним из состояний, определенных в `LabelsListUiState`.
+ * @summary ViewModel for the screen with a list of labels.
+ * @description Manages the screen state, loads the list of labels, handles errors, and manages the dialog for creating a new label.
+ * @invariant `uiState` is always one of the states defined in `LabelsListUiState`.
  */
 @HiltViewModel
 class LabelsListViewModel @Inject constructor(
@@ -39,10 +38,10 @@ class LabelsListViewModel @Inject constructor(
 
     // [ENTITY: Function('loadLabels')]
     /**
-     * @summary Загружает список меток.
-     * @description Выполняет `GetAllLabelsUseCase` и обновляет UI, переключая его
-     * между состояниями `Loading`, `Success` и `Error`.
-     * @sideeffect Асинхронно обновляет `_uiState`.
+     * @summary Loads the list of labels.
+     * @description Executes `GetAllLabelsUseCase` and updates the UI by switching it
+     * between the `Loading`, `Success`, and `Error` states.
+     * @sideeffect Asynchronously updates `_uiState`.
      */
     fun loadLabels() {
         viewModelScope.launch {
@@ -77,9 +76,9 @@ class LabelsListViewModel @Inject constructor(
 
     // [ENTITY: Function('onShowCreateDialog')]
     /**
-     * @summary Инициирует отображение диалога для создания метки.
-     * @description Обновляет состояние `uiState`, устанавливая `isShowingCreateDialog` в `true`.
-     * @sideeffect Обновляет `_uiState`.
+     * @summary Initiates the display of the dialog for creating a label.
+     * @description Updates the `uiState` by setting `isShowingCreateDialog` to `true`.
+     * @sideeffect Updates `_uiState`.
      */
     fun onShowCreateDialog() {
         Timber.i("[INFO][ACTION][show_create_dialog] Show create label dialog requested.")
@@ -93,9 +92,9 @@ class LabelsListViewModel @Inject constructor(
 
     // [ENTITY: Function('onDismissCreateDialog')]
     /**
-     * @summary Скрывает диалог создания метки.
-     * @description Обновляет состояние `uiState`, устанавливая `isShowingCreateDialog` в `false`.
-     * @sideeffect Обновляет `_uiState`.
+     * @summary Hides the label creation dialog.
+     * @description Updates the `uiState` by setting `isShowingCreateDialog` to `false`.
+     * @sideeffect Updates `_uiState`.
      */
     fun onDismissCreateDialog() {
         Timber.i("[INFO][ACTION][dismiss_create_dialog] Dismiss create label dialog requested.")
@@ -109,12 +108,12 @@ class LabelsListViewModel @Inject constructor(
 
     // [ENTITY: Function('createLabel')]
     /**
-     * @summary Создает новую метку. [MVP_SCOPE] ЗАГЛУШКА.
-     * @description В текущей реализации (План Б, Этап 1), эта функция только логирует действие
-     * и скрывает диалог. Реальная логика сохранения будет добавлена на следующем этапе.
-     * @param name Название новой метки.
-     * @precondition `name` не должен быть пустым.
-     * @sideeffect Логирует действие, обновляет `_uiState`, чтобы скрыть диалог.
+     * @summary Creates a new label. [MVP_SCOPE] STUB.
+     * @description In the current implementation (Plan B, Stage 1), this function only logs the action
+     * and hides the dialog. The actual save logic will be added in the next stage.
+     * @param name The name of the new label.
+     * @precondition `name` must not be blank.
+     * @sideeffect Logs the action, updates `_uiState` to hide the dialog.
      */
     fun createLabel(name: String) {
         require(name.isNotBlank()) { "[CONTRACT_VIOLATION] Label name cannot be blank." }

app/src/main/java/com/homebox/lens/ui/screen/locationedit/LocationEditScreen.kt

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.ui.screen.locationedit
 // [FILE] LocationEditScreen.kt
-// [SEMANTICS] ui, screen, location, edit
+// [SEMANTICS] app, ui, screen, edit, location
 
 package com.homebox.lens.ui.screen.locationedit
 
@@ -19,8 +18,8 @@ import com.homebox.lens.R
 
 // [ENTITY: Function('LocationEditScreen')]
 /**
- * @summary Composable-функция для экрана "Редактирование местоположения".
- * @param locationId ID местоположения для редактирования или "new" для создания.
+ * @summary Composable function for the "Edit Location" screen.
+ * @param locationId The ID of the location to edit, or "new" to create one.
  */
 @Composable
 fun LocationEditScreen(

app/src/main/java/com/homebox/lens/ui/screen/locationslist/LocationsListScreen.kt

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.ui.screen.locationslist
 // [FILE] LocationsListScreen.kt
-// [SEMANTICS] ui, screen, locations, list
+// [SEMANTICS] app, ui, screen, list, location
 
 package com.homebox.lens.ui.screen.locationslist
 
@@ -56,12 +55,12 @@ import com.homebox.lens.ui.theme.HomeboxLensTheme
 // [RELATION: Function('LocationsListScreen')] -> [DEPENDS_ON] -> [Class('NavigationActions')]
 // [RELATION: Function('LocationsListScreen')] -> [CALLS] -> [Function('MainScaffold')]
 /**
- * @summary Composable-функция для экрана "Список местоположений".
- * @param currentRoute Текущий маршрут для подсветки активного элемента в Drawer.
- * @param navigationActions Объект с навигационными действиями.
- * @param onLocationClick Лямбда-обработчик нажатия на местоположение.
- * @param onAddNewLocationClick Лямбда-обработчик нажатия на кнопку добавления нового местоположения.
- * @param viewModel ViewModel для этого экрана.
+ * @summary Composable function for the "List of Locations" screen.
+ * @param currentRoute The current route to highlight the active item in the Drawer.
+ * @param navigationActions The object with navigation actions.
+ * @param onLocationClick A lambda handler for clicking on a location.
+ * @param onAddNewLocationClick A lambda handler for clicking the button to add a new location.
+ * @param viewModel The ViewModel for this screen.
  */
 @Composable
 fun LocationsListScreen(
@@ -104,12 +103,12 @@ fun LocationsListScreen(
 // [ENTITY: Function('LocationsListContent')]
 // [RELATION: Function('LocationsListContent')] -> [CONSUMES_STATE] -> [SealedInterface('LocationsListUiState')]
 /**
- * @summary Отображает основной контент экрана в зависимости от `uiState`.
- * @param modifier Модификатор для стилизации.
- * @param uiState Текущее состояние UI.
- * @param onLocationClick Лямбда-обработчик нажатия на местоположение.
- * @param onEditLocation Лямбда-обработчик для редактирования местоположения.
- * @param onDeleteLocation Лямбда-обработчик для удаления местоположения.
+ * @summary Displays the main content of the screen depending on the `uiState`.
+ * @param modifier A modifier for styling.
+ * @param uiState The current UI state.
+ * @param onLocationClick A lambda handler for clicking on a location.
+ * @param onEditLocation A lambda handler for editing a location.
+ * @param onDeleteLocation A lambda handler for deleting a location.
  */
 @Composable
 private fun LocationsListContent(
@@ -167,11 +166,11 @@ private fun LocationsListContent(
 // [ENTITY: Function('LocationCard')]
 // [RELATION: Function('LocationCard')] -> [DEPENDS_ON] -> [DataClass('LocationOutCount')]
 /**
- * @summary Карточка для отображения одного местоположения.
- * @param location Данные о местоположении.
- * @param onClick Лямбда-обработчик нажатия на карточку.
- * @param onEditClick Лямбда-обработчик нажатия на "Редактировать".
- * @param onDeleteClick Лямбда-обработчик нажатия на "Удалить".
+ * @summary Card for displaying a single location.
+ * @param location The data about the location.
+ * @param onClick A lambda handler for clicking on the card.
+ * @param onEditClick A lambda handler for clicking "Edit".
+ * @param onDeleteClick A lambda handler for clicking "Delete".
  */
 @Composable
 private fun LocationCard(

app/src/main/java/com/homebox/lens/ui/screen/locationslist/LocationsListUiState.kt

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.ui.screen.locationslist
 // [FILE] LocationsListUiState.kt
-// [SEMANTICS] ui, state, locations
+// [SEMANTICS] app, ui, state, list, location
 
 package com.homebox.lens.ui.screen.locationslist
 
@@ -10,30 +9,30 @@ import com.homebox.lens.domain.model.LocationOutCount
 
 // [ENTITY: SealedInterface('LocationsListUiState')]
 /**
- * @summary Определяет возможные состояния UI для экрана списка местоположений.
+ * @summary Defines the possible UI states for the list of locations screen.
  * @see LocationsListViewModel
  */
 sealed interface LocationsListUiState {
     // [ENTITY: DataClass('Success')]
     // [RELATION: DataClass('Success')] -> [DEPENDS_ON] -> [DataClass('LocationOutCount')]
     /**
-     * @summary Состояние успешной загрузки данных.
-     * @param locations Список местоположений для отображения.
+     * @summary The state of a successful data load.
+     * @param locations The list of locations to display.
      */
     data class Success(val locations: List<LocationOutCount>) : LocationsListUiState
     // [END_ENTITY: DataClass('Success')]
 
     // [ENTITY: DataClass('Error')]
     /**
-     * @summary Состояние ошибки.
-     * @param message Сообщение об ошибке.
+     * @summary The error state.
+     * @param message The error message.
      */
     data class Error(val message: String) : LocationsListUiState
     // [END_ENTITY: DataClass('Error')]
 
     // [ENTITY: Object('Loading')]
     /**
-     * @summary Состояние загрузки данных.
+     * @summary The data loading state.
      */
     object Loading : LocationsListUiState
     // [END_ENTITY: Object('Loading')]

app/src/main/java/com/homebox/lens/ui/screen/locationslist/LocationsListViewModel.kt

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.ui.screen.locationslist
 // [FILE] LocationsListViewModel.kt
-// [SEMANTICS] ui, viewmodel, locations, hilt
+// [SEMANTICS] app, ui, viewmodel, list, location
 
 package com.homebox.lens.ui.screen.locationslist
 
@@ -21,10 +20,10 @@ import javax.inject.Inject
 // [RELATION: ViewModel('LocationsListViewModel')] -> [DEPENDS_ON] -> [UseCase('GetAllLocationsUseCase')]
 // [RELATION: ViewModel('LocationsListViewModel')] -> [EMITS_STATE] -> [SealedInterface('LocationsListUiState')]
 /**
- * @summary ViewModel для экрана списка местоположений.
- * @param getAllLocationsUseCase Use case для получения всех местоположений.
- * @property uiState Поток, содержащий текущее состояние UI.
- * @invariant `uiState` всегда отражает результат последней операции загрузки.
+ * @summary ViewModel for the list of locations screen.
+ * @param getAllLocationsUseCase Use case for getting all locations.
+ * @property uiState A flow containing the current UI state.
+ * @invariant `uiState` always reflects the result of the last load operation.
  */
 @HiltViewModel
 class LocationsListViewModel @Inject constructor(
@@ -40,8 +39,8 @@ class LocationsListViewModel @Inject constructor(
 
     // [ENTITY: Function('loadLocations')]
     /**
-     * @summary Загружает список местоположений из репозитория.
-     * @sideeffect Обновляет `_uiState` в зависимости от результата: Loading -> Success/Error.
+     * @summary Loads the list of locations from the repository.
+     * @sideeffect Updates `_uiState` depending on the result: Loading -> Success/Error.
      */
     fun loadLocations() {
         Timber.d("[DEBUG][ENTRYPOINT][loading_locations] Starting to load locations.")

app/src/main/java/com/homebox/lens/ui/screen/search/SearchScreen.kt

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.ui.screen.search
 // [FILE] SearchScreen.kt
-// [SEMANTICS] ui, screen, search
+// [SEMANTICS] app, ui, screen, search
 
 package com.homebox.lens.ui.screen.search
 
@@ -17,9 +16,9 @@ import com.homebox.lens.ui.common.MainScaffold
 // [RELATION: Function('SearchScreen')] -> [DEPENDS_ON] -> [Class('NavigationActions')]
 // [RELATION: Function('SearchScreen')] -> [CALLS] -> [Function('MainScaffold')]
 /**
- * @summary Composable-функция для экрана "Поиск".
- * @param currentRoute Текущий маршрут для подсветки активного элемента в Drawer.
- * @param navigationActions Объект с навигационными действиями.
+ * @summary Composable function for the "Search" screen.
+ * @param currentRoute The current route to highlight the active item in the Drawer.
+ * @param navigationActions The object with navigation actions.
  */
 @Composable
 fun SearchScreen(

app/src/main/java/com/homebox/lens/ui/screen/search/SearchViewModel.kt

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.ui.screen.search
 // [FILE] SearchViewModel.kt
-// [SEMANTICS] ui, viewmodel, search
+// [SEMANTICS] app, ui, viewmodel, search
 package com.homebox.lens.ui.screen.search
 
 // [IMPORTS]

app/src/main/java/com/homebox/lens/ui/screen/settings/SettingsScreen.kt

@@ -0,0 +1,52 @@
+// [FILE] SettingsScreen.kt
+// [SEMANTICS] app, ui, screen, settings
+
+package com.homebox.lens.ui.screen.settings
+
+// [IMPORTS]
+import androidx.compose.foundation.layout.Box
+import androidx.compose.foundation.layout.fillMaxSize
+import androidx.compose.foundation.layout.padding
+import androidx.compose.material3.ExperimentalMaterial3Api
+import androidx.compose.material3.Scaffold
+import androidx.compose.material3.Text
+import androidx.compose.material3.TopAppBar
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.Alignment
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.res.stringResource
+import com.homebox.lens.R
+import com.homebox.lens.navigation.NavigationActions
+import com.homebox.lens.ui.common.MainScaffold
+// [END_IMPORTS]
+
+// [ENTITY: Function('SettingsScreen')]
+// [RELATION: Function('SettingsScreen')] -> [DEPENDS_ON] -> [Class('NavigationActions')]
+/**
+ * @summary Composable function for the settings screen.
+ * @param currentRoute The current navigation route.
+ * @param navigationActions The object containing navigation actions.
+ */
+@OptIn(ExperimentalMaterial3Api::class)
+@Composable
+fun SettingsScreen(
+    currentRoute: String?,
+    navigationActions: NavigationActions
+) {
+    MainScaffold(
+        topBarTitle = stringResource(id = R.string.screen_title_settings),
+        currentRoute = currentRoute,
+        navigationActions = navigationActions
+    ) { paddingValues ->
+        Box(
+            modifier = Modifier
+                .fillMaxSize()
+                .padding(paddingValues),
+            contentAlignment = Alignment.Center
+        ) {
+            Text(text = "Settings Screen (Under Construction)")
+        }
+    }
+}
+// [END_ENTITY: Function('SettingsScreen')]
+// [END_FILE_SettingsScreen.kt]

app/src/main/java/com/homebox/lens/ui/screen/setup/SetupScreen.kt

@@ -1,23 +1,27 @@
-// [PACKAGE] com.homebox.lens.ui.screen.setup
 // [FILE] SetupScreen.kt
-// [SEMANTICS] ui, screen, setup, compose
+// [SEMANTICS] app, ui, screen, setup
 
 @file:OptIn(ExperimentalMaterial3Api::class)
 
 package com.homebox.lens.ui.screen.setup
 
 // [IMPORTS]
+import androidx.compose.foundation.Image
 import androidx.compose.foundation.layout.*
+import androidx.compose.material.icons.Icons
+import androidx.compose.material.icons.filled.Lock
 import androidx.compose.material3.*
 import androidx.compose.runtime.Composable
 import androidx.compose.runtime.collectAsState
 import androidx.compose.runtime.getValue
 import androidx.compose.ui.Alignment
 import androidx.compose.ui.Modifier
+import androidx.compose.ui.res.painterResource
 import androidx.compose.ui.res.stringResource
 import androidx.compose.ui.text.input.PasswordVisualTransformation
 import androidx.compose.ui.tooling.preview.Preview
 import androidx.compose.ui.unit.dp
+import androidx.compose.ui.unit.sp
 import androidx.hilt.navigation.compose.hiltViewModel
 import com.homebox.lens.R
 // [END_IMPORTS]
@@ -26,10 +30,10 @@ import com.homebox.lens.R
 // [RELATION: Function('SetupScreen')] -> [DEPENDS_ON] -> [ViewModel('SetupViewModel')]
 // [RELATION: Function('SetupScreen')] -> [CALLS] -> [Function('SetupScreenContent')]
 /**
- * @summary Главная Composable-функция для экрана настройки соединения с сервером.
- * @param viewModel ViewModel для этого экрана, предоставляется через Hilt.
- * @param onSetupComplete Лямбда, вызываемая после успешной настройки и входа.
- * @sideeffect Вызывает `onSetupComplete` при изменении `uiState.isSetupComplete`.
+ * @summary The main Composable function for the server connection setup screen.
+ * @param viewModel The ViewModel for this screen, provided by Hilt.
+ * @param onSetupComplete A lambda invoked after successful setup and login.
+ * @sideeffect Calls `onSetupComplete` when `uiState.isSetupComplete` changes.
  */
 @Composable
 fun SetupScreen(
@@ -55,12 +59,12 @@ fun SetupScreen(
 // [ENTITY: Function('SetupScreenContent')]
 // [RELATION: Function('SetupScreenContent')] -> [CONSUMES_STATE] -> [DataClass('SetupUiState')]
 /**
- * @summary Отображает контент экрана настройки: поля ввода и кнопку.
- * @param uiState Текущее состояние UI.
- * @param onServerUrlChange Лямбда-обработчик изменения URL сервера.
- * @param onUsernameChange Лямбда-обработчик изменения имени пользователя.
- * @param onPasswordChange Лямбда-обработчик изменения пароля.
- * @param onConnectClick Лямбда-обработчик нажатия на кнопку "Подключиться".
+ * @summary Displays the content of the setup screen: input fields and a button.
+ * @param uiState The current UI state.
+ * @param onServerUrlChange A lambda handler for changing the server URL.
+ * @param onUsernameChange A lambda handler for changing the username.
+ * @param onPasswordChange A lambda handler for changing the password.
+ * @param onConnectClick A lambda handler for clicking the "Connect" button.
  */
 @Composable
 private fun SetupScreenContent(
@@ -70,11 +74,7 @@ private fun SetupScreenContent(
     onPasswordChange: (String) -> Unit,
     onConnectClick: () -> Unit
 ) {
-    Scaffold(
-        topBar = {
-            TopAppBar(title = { Text(stringResource(id = R.string.setup_title)) })
-        }
-    ) { paddingValues ->
+    Scaffold { paddingValues ->
         Column(
             modifier = Modifier
                 .fillMaxSize()
@@ -83,42 +83,76 @@ private fun SetupScreenContent(
             verticalArrangement = Arrangement.Center,
             horizontalAlignment = Alignment.CenterHorizontally
         ) {
-            OutlinedTextField(
-                value = uiState.serverUrl,
-                onValueChange = onServerUrlChange,
-                label = { Text(stringResource(id = R.string.setup_server_url_label)) },
-                modifier = Modifier.fillMaxWidth()
-            )
-            Spacer(modifier = Modifier.height(8.dp))
-            OutlinedTextField(
-                value = uiState.username,
-                onValueChange = onUsernameChange,
-                label = { Text(stringResource(id = R.string.setup_username_label)) },
-                modifier = Modifier.fillMaxWidth()
-            )
-            Spacer(modifier = Modifier.height(8.dp))
-            OutlinedTextField(
-                value = uiState.password,
-                onValueChange = onPasswordChange,
-                label = { Text(stringResource(id = R.string.setup_password_label)) },
-                visualTransformation = PasswordVisualTransformation(),
-                modifier = Modifier.fillMaxWidth()
+            Image(
+                imageVector = Icons.Default.Lock,
+                contentDescription = stringResource(id = R.string.app_name),
+                modifier = Modifier.size(128.dp)
             )
             Spacer(modifier = Modifier.height(16.dp))
+            Text(
+                text = stringResource(id = R.string.setup_title),
+                style = MaterialTheme.typography.headlineLarge
+            )
+            Spacer(modifier = Modifier.height(8.dp))
+            Text(
+                text = "Enter your Homebox server details to connect.",
+                style = MaterialTheme.typography.bodyMedium
+            )
+            Spacer(modifier = Modifier.height(24.dp))
+
+            Card(
+                modifier = Modifier.fillMaxWidth(),
+                elevation = CardDefaults.cardElevation(defaultElevation = 4.dp)
+            ) {
+                Column(
+                    modifier = Modifier.padding(16.dp)
+                ) {
+                    OutlinedTextField(
+                        value = uiState.serverUrl,
+                        onValueChange = onServerUrlChange,
+                        label = { Text(stringResource(id = R.string.setup_server_url_label)) },
+                        modifier = Modifier.fillMaxWidth()
+                    )
+                    Spacer(modifier = Modifier.height(8.dp))
+                    OutlinedTextField(
+                        value = uiState.username,
+                        onValueChange = onUsernameChange,
+                        label = { Text(stringResource(id = R.string.setup_username_label)) },
+                        modifier = Modifier.fillMaxWidth()
+                    )
+                    Spacer(modifier = Modifier.height(8.dp))
+                    OutlinedTextField(
+                        value = uiState.password,
+                        onValueChange = onPasswordChange,
+                        label = { Text(stringResource(id = R.string.setup_password_label)) },
+                        visualTransformation = PasswordVisualTransformation(),
+                        modifier = Modifier.fillMaxWidth()
+                    )
+                }
+            }
+            Spacer(modifier = Modifier.height(24.dp))
             Button(
                 onClick = onConnectClick,
                 enabled = !uiState.isLoading,
-                modifier = Modifier.fillMaxWidth()
+                modifier = Modifier
+                    .fillMaxWidth()
+                    .height(50.dp)
             ) {
                 if (uiState.isLoading) {
-                    CircularProgressIndicator(modifier = Modifier.size(24.dp))
+                    CircularProgressIndicator(
+                        modifier = Modifier.size(24.dp),
+                        color = MaterialTheme.colorScheme.onPrimary
+                    )
                 } else {
                     Text(stringResource(id = R.string.setup_connect_button))
                 }
             }
             uiState.error?.let {
                 Spacer(modifier = Modifier.height(8.dp))
-                Text(text = it, color = MaterialTheme.colorScheme.error)
+                Text(
+                    text = it,
+                    color = MaterialTheme.colorScheme.error
+                )
             }
         }
     }

app/src/main/java/com/homebox/lens/ui/screen/setup/SetupUiState.kt

@@ -1,4 +1,3 @@
-// [PACKAGE] com.homebox.lens.ui.screen.setup
 // [FILE] SetupUiState.kt
 // [SEMANTICS] ui_state, data_model, immutable
 

app/src/main/java/com/homebox/lens/ui/screen/setup/SetupViewModel.kt

@@ -1,4 +1,3 @@
-// [PACKAGE] com.homebox.lens.ui.screen.setup
 // [FILE] SetupViewModel.kt
 // [SEMANTICS] ui_logic, viewmodel, state_management, user_setup, authentication_flow
 package com.homebox.lens.ui.screen.setup
@@ -74,40 +73,61 @@ class SetupViewModel @Inject constructor(
     // [END_ENTITY: Function('onUsernameChange')]
 
     // [ENTITY: Function('onPasswordChange')]
+    /**
+     * @summary Updates the password in the UI state.
+     * @param newPassword The new password.
+     * @sideeffect Updates the `password` in `_uiState`.
+     */
     fun onPasswordChange(newPassword: String) {
         _uiState.update { it.copy(password = newPassword) }
     }
     // [END_ENTITY: Function('onPasswordChange')]
 
-    // [ENTITY: Function('connect')]
-    fun connect() {
-        Timber.d("[DEBUG][ENTRYPOINT][connecting] Starting connection process.")
-        viewModelScope.launch {
-            _uiState.update { it.copy(isLoading = true, error = null) }
+   // [ENTITY: Function('areCredentialsSaved')]
+   /**
+    * @summary Checks synchronously if credentials are saved.
+    * @return true if credentials are saved, false otherwise.
+    * @sideeffect None.
+    */
+   fun areCredentialsSaved(): Boolean {
+       Timber.d("[DEBUG][ENTRYPOINT][checking_credentials_saved] Checking if credentials are saved.")
+       return credentialsRepository.areCredentialsSavedSync()
+   }
+   // [END_ENTITY: Function('areCredentialsSaved')]
 
-            val credentials = Credentials(
-                serverUrl = _uiState.value.serverUrl.trim(),
-                username = _uiState.value.username.trim(),
-                password = _uiState.value.password
-            )
+   // [ENTITY: Function('connect')]
+   /**
+    * @summary Initiates the connection process, saving credentials and attempting to log in.
+    * @sideeffect Updates `_uiState` with loading, error, and completion states.
+    */
+   fun connect() {
+       Timber.d("[DEBUG][ENTRYPOINT][connecting] Starting connection process.")
+       viewModelScope.launch {
+           _uiState.update { it.copy(isLoading = true, error = null) }
 
-            Timber.d("[DEBUG][ACTION][saving_credentials] Saving credentials.")
-            credentialsRepository.saveCredentials(credentials)
+           val credentials = Credentials(
+               serverUrl = _uiState.value.serverUrl.trim(),
+               username = _uiState.value.username.trim(),
+               password = _uiState.value.password
+           )
 
-            Timber.d("[DEBUG][ACTION][executing_login] Executing login use case.")
-            loginUseCase(credentials).fold(
-                onSuccess = {
-                    Timber.d("[DEBUG][SUCCESS][login_successful] Login successful.")
-                    _uiState.update { it.copy(isLoading = false, isSetupComplete = true) }
-                },
-                onFailure = { exception ->
-                    Timber.e(exception, "[ERROR][EXCEPTION][login_failed] Login failed.")
-                    _uiState.update { it.copy(isLoading = false, error = exception.message ?: "Login failed") }
-                }
-            )
-        }
-    }
-    // [END_ENTITY: Function('connect')]
+           Timber.d("[DEBUG][ACTION][saving_credentials] Saving credentials.")
+           credentialsRepository.saveCredentials(credentials)
+
+           Timber.d("[DEBUG][ACTION][executing_login] Executing login use case.")
+           loginUseCase(credentials).fold(
+               onSuccess = {
+                   Timber.d("[DEBUG][SUCCESS][login_successful] Login successful.")
+                   _uiState.update { it.copy(isLoading = false, isSetupComplete = true) }
+               },
+               onFailure = { exception ->
+                   Timber.e(exception, "[ERROR][EXCEPTION][login_failed] Login failed.")
+                   _uiState.update { it.copy(isLoading = false, error = exception.message ?: "Login failed") }
+               }
+           )
+       }
+   }
+   // [END_ENTITY: Function('connect')]
 }
 // [END_ENTITY: ViewModel('SetupViewModel')]
 // [END_FILE_SetupViewModel.kt]

app/src/main/java/com/homebox/lens/ui/screen/splash/SplashScreen.kt

@@ -0,0 +1,58 @@
+// [FILE] SplashScreen.kt
+// [SEMANTICS] app, ui, screen, splash
+package com.homebox.lens.ui.screen.splash
+
+// [IMPORTS]
+import androidx.compose.foundation.layout.Box
+import androidx.compose.foundation.layout.fillMaxSize
+import androidx.compose.material3.CircularProgressIndicator
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.LaunchedEffect
+import androidx.compose.ui.Alignment
+import androidx.compose.ui.Modifier
+import androidx.hilt.navigation.compose.hiltViewModel
+import androidx.navigation.NavController
+import com.homebox.lens.navigation.Screen
+import com.homebox.lens.ui.screen.setup.SetupViewModel
+import timber.log.Timber
+// [END_IMPORTS]
+
+// [ENTITY: Composable('SplashScreen')]
+// [RELATION: Composable('SplashScreen')] -> [DEPENDS_ON] -> [Framework('NavController')]
+// [RELATION: Composable('SplashScreen')] -> [DEPENDS_ON] -> [ViewModel('SetupViewModel')]
+/**
+ * @summary A splash screen that checks for saved credentials and navigates accordingly.
+ * @param navController The navigation controller for navigating to the next screen.
+ * @param viewModel The view model for checking credentials.
+ * @sideeffect Navigates to either the Setup or Dashboard screen.
+ */
+@Composable
+fun SplashScreen(
+    navController: NavController,
+    viewModel: SetupViewModel = hiltViewModel()
+) {
+    Box(
+        modifier = Modifier.fillMaxSize(),
+        contentAlignment = Alignment.Center
+    ) {
+        CircularProgressIndicator()
+    }
+
+    LaunchedEffect(Unit) {
+        Timber.d("[DEBUG][ACTION][checking_credentials] Checking for saved credentials on splash screen.")
+        val areCredentialsSaved = viewModel.areCredentialsSaved()
+        val destination = if (areCredentialsSaved) {
+            Timber.d("[DEBUG][SUCCESS][credentials_found] Credentials found, navigating to Dashboard.")
+            Screen.Dashboard.route
+        } else {
+            Timber.d("[DEBUG][FALLBACK][no_credentials] No credentials found, navigating to Setup.")
+            Screen.Setup.route
+        }
+
+        navController.navigate(destination) {
+            popUpTo(Screen.Splash.route) { inclusive = true }
+        }
+    }
+}
+// [END_ENTITY: Composable('SplashScreen')]
+// [END_FILE_SplashScreen.kt]

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

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.ui.theme
 // [FILE] Color.kt
-// [SEMANTICS] ui, theme, color
+// [SEMANTICS] app, ui, theme, color
 package com.homebox.lens.ui.theme
 
 // [IMPORTS]

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

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.ui.theme
 // [FILE] Theme.kt
-// [SEMANTICS] ui, theme
+// [SEMANTICS] app, ui, theme
 package com.homebox.lens.ui.theme
 
 // [IMPORTS]

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

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.ui.theme
 // [FILE] Typography.kt
-// [SEMANTICS] ui, theme, typography
+// [SEMANTICS] app, ui, theme, typography
 package com.homebox.lens.ui.theme
 
 // [IMPORTS]

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

@@ -13,6 +13,7 @@
 
     <!-- Content Descriptions -->
     <string name="cd_open_navigation_drawer">Открыть боковое меню</string>
+    <string name="setup_subtitle">Enter your Homebox server details to connect.</string>
     <string name="cd_scan_qr_code">Сканировать QR-код</string>
     <string name="cd_navigate_back">Вернуться назад</string>
     <string name="cd_add_new_location">Добавить новую локацию</string>
@@ -35,7 +36,6 @@
     <string name="item_edit_title_create">Создать элемент</string>
     <string name="content_desc_save_item">Сохранить элемент</string>
     <string name="label_name">Название</string>
-    <string name="label_description">Описание</string>
 
     <!-- Search Screen -->
     <string name="placeholder_search_items">Поиск элементов...</string>
@@ -70,6 +70,36 @@
     <string name="item_name">Название</string>
     <string name="item_description">Описание</string>
     <string name="item_quantity">Количество</string>
+    <string name="item_edit_general_information">General Information</string>
+    <string name="item_edit_location">Location</string>
+    <string name="item_edit_select_location">Select Location</string>
+    <string name="item_edit_labels">Labels</string>
+    <string name="item_edit_select_labels">Select Labels</string>
+    <string name="item_edit_purchase_information">Purchase Information</string>
+    <string name="item_edit_purchase_price">Purchase Price</string>
+    <string name="item_edit_purchase_from">Purchase From</string>
+    <string name="item_edit_purchase_time">Purchase Date</string>
+    <string name="item_edit_select_date">Select Date</string>
+    <string name="dialog_ok">OK</string>
+    <string name="dialog_cancel">Cancel</string>
+    <string name="item_edit_warranty_information">Warranty Information</string>
+    <string name="item_edit_lifetime_warranty">Lifetime Warranty</string>
+    <string name="item_edit_warranty_details">Warranty Details</string>
+    <string name="item_edit_warranty_expires">Warranty Expires</string>
+    <string name="item_edit_identification">Identification</string>
+    <string name="item_edit_asset_id">Asset ID</string>
+    <string name="item_edit_serial_number">Serial Number</string>
+    <string name="item_edit_manufacturer">Manufacturer</string>
+    <string name="item_edit_model_number">Model Number</string>
+    <string name="item_edit_status_notes">Status &amp; Notes</string>
+    <string name="item_edit_archived">Archived</string>
+    <string name="item_edit_insured">Insured</string>
+    <string name="item_edit_notes">Notes</string>
+    <string name="item_edit_sold_information">Sold Information</string>
+    <string name="item_edit_sold_price">Sold Price</string>
+    <string name="item_edit_sold_to">Sold To</string>
+    <string name="item_edit_sold_notes">Sold Notes</string>
+    <string name="item_edit_sold_time">Sold Date</string>
 
     <!-- Location Edit Screen -->
     <string name="location_edit_title_create">Создать локацию</string>
@@ -90,6 +120,8 @@
 
     <!-- Labels List Screen -->
     <string name="screen_title_labels">Метки</string>
+    <!-- Settings Screen -->
+    <string name="screen_title_settings">Настройки</string>
     <string name="content_desc_navigate_back" translatable="false">Вернуться назад</string>
     <string name="content_desc_create_label">Создать новую метку</string>
     <string name="content_desc_label_icon">Иконка метки</string>
@@ -103,6 +135,7 @@
     <string name="label_edit_title_create">Создать метку</string>
     <string name="label_edit_title_edit">Редактировать метку</string>
     <string name="label_name_edit">Название метки</string>
+    <string name="label_description">Описание</string>
 
     <!-- Common Actions -->
     <string name="back">Назад</string>

app/src/test/java/com/homebox/lens/ui/screen/itemedit/ItemEditViewModelTest.kt

@@ -1,126 +0,0 @@
-
-package com.homebox.lens.ui.screen.itemedit
-
-import app.cash.turbine.test
-import com.homebox.lens.domain.model.Item
-import com.homebox.lens.domain.model.ItemCreate
-import com.homebox.lens.domain.model.ItemOut
-import com.homebox.lens.domain.model.ItemSummary
-import com.homebox.lens.domain.usecase.CreateItemUseCase
-import com.homebox.lens.domain.usecase.GetItemDetailsUseCase
-import com.homebox.lens.domain.usecase.UpdateItemUseCase
-import io.mockk.coEvery
-import io.mockk.mockk
-import kotlinx.coroutines.Dispatchers
-import kotlinx.coroutines.ExperimentalCoroutinesApi
-import kotlinx.coroutines.test.StandardTestDispatcher
-import kotlinx.coroutines.test.resetMain
-import kotlinx.coroutines.test.runTest
-import kotlinx.coroutines.test.setMain
-import org.junit.After
-import org.junit.Assert.assertEquals
-import org.junit.Assert.assertFalse
-import org.junit.Assert.assertNotNull
-import org.junit.Assert.assertTrue
-import org.junit.Before
-import org.junit.Test
-import java.util.UUID
-
-@ExperimentalCoroutinesApi
-class ItemEditViewModelTest {
-
-    private val testDispatcher = StandardTestDispatcher()
-
-    private lateinit var createItemUseCase: CreateItemUseCase
-    private lateinit var updateItemUseCase: UpdateItemUseCase
-    private lateinit var getItemDetailsUseCase: GetItemDetailsUseCase
-    private lateinit var viewModel: ItemEditViewModel
-
-    @Before
-    fun setUp() {
-        Dispatchers.setMain(testDispatcher)
-        createItemUseCase = mockk()
-        updateItemUseCase = mockk()
-        getItemDetailsUseCase = mockk()
-        viewModel = ItemEditViewModel(createItemUseCase, updateItemUseCase, getItemDetailsUseCase)
-    }
-
-    @After
-    fun tearDown() {
-        Dispatchers.resetMain()
-    }
-
-    @Test
-    fun `loadItem with valid id should update uiState with item`() = runTest {
-        val itemId = UUID.randomUUID().toString()
-        val itemOut = ItemOut(id = itemId, name = "Test Item", description = "Description", quantity = 1, images = emptyList(), location = null, labels = emptyList(), value = 10.0, createdAt = "2025-08-28T12:00:00Z", assetId = null, notes = null, serialNumber = null, isArchived = false, purchasePrice = null, purchaseDate = null, warrantyUntil = null, parent = null, children = emptyList(), attachments = emptyList(), fields = emptyList(), maintenance = emptyList(), updatedAt = "2025-08-28T12:00:00Z")
-        coEvery { getItemDetailsUseCase(itemId) } returns itemOut
-
-        viewModel.loadItem(itemId)
-        testDispatcher.scheduler.advanceUntilIdle()
-
-        val uiState = viewModel.uiState.value
-        assertFalse(uiState.isLoading)
-        assertNotNull(uiState.item)
-        assertEquals(itemId, uiState.item?.id)
-        assertEquals("Test Item", uiState.item?.name)
-    }
-
-    @Test
-    fun `loadItem with null id should prepare a new item`() = runTest {
-        viewModel.loadItem(null)
-        testDispatcher.scheduler.advanceUntilIdle()
-
-        val uiState = viewModel.uiState.value
-        assertFalse(uiState.isLoading)
-        assertNotNull(uiState.item)
-        assertEquals("", uiState.item?.id)
-        assertEquals("", uiState.item?.name)
-    }
-
-    @Test
-    fun `saveItem should call createItemUseCase for new item`() = runTest {
-        val createdItemSummary = ItemSummary(id = UUID.randomUUID().toString(), name = "New Item", assetId = null, image = null, isArchived = false, labels = emptyList(), location = null, value = 0.0, createdAt = "2025-08-28T12:00:00Z", updatedAt = "2025-08-28T12:00:00Z")
-        coEvery { createItemUseCase(any()) } returns createdItemSummary
-
-        viewModel.loadItem(null)
-        testDispatcher.scheduler.advanceUntilIdle()
-        viewModel.updateName("New Item")
-        viewModel.updateDescription("New Description")
-        viewModel.updateQuantity(2)
-        testDispatcher.scheduler.advanceUntilIdle()
-
-        viewModel.saveItem()
-        testDispatcher.scheduler.advanceUntilIdle()
-
-        val uiState = viewModel.uiState.value
-        assertFalse(uiState.isLoading)
-        assertNotNull(uiState.item)
-        assertEquals(createdItemSummary.id, uiState.item?.id)
-    }
-
-    @Test
-    fun `saveItem should call updateItemUseCase for existing item`() = runTest {
-        val itemId = UUID.randomUUID().toString()
-        val updatedItemOut = ItemOut(id = itemId, name = "Updated Item", description = "Updated Description", quantity = 4, images = emptyList(), location = null, labels = emptyList(), value = 12.0, createdAt = "2025-08-28T12:00:00Z", assetId = null, notes = null, serialNumber = null, isArchived = false, purchasePrice = null, purchaseDate = null, warrantyUntil = null, parent = null, children = emptyList(), attachments = emptyList(), fields = emptyList(), maintenance = emptyList(), updatedAt = "2025-08-28T12:00:00Z")
-        coEvery { getItemDetailsUseCase(itemId) } returns ItemOut(id = itemId, name = "Existing Item", description = "Existing Description", quantity = 3, images = emptyList(), location = null, labels = emptyList(), value = 10.0, createdAt = "2025-08-28T12:00:00Z", assetId = null, notes = null, serialNumber = null, isArchived = false, purchasePrice = null, purchaseDate = null, warrantyUntil = null, parent = null, children = emptyList(), attachments = emptyList(), fields = emptyList(), maintenance = emptyList(), updatedAt = "2025-08-28T12:00:00Z")
-        coEvery { updateItemUseCase(any()) } returns updatedItemOut
-
-        viewModel.loadItem(itemId)
-        testDispatcher.scheduler.advanceUntilIdle()
-        viewModel.updateName("Updated Item")
-        viewModel.updateDescription("Updated Description")
-        viewModel.updateQuantity(4)
-        testDispatcher.scheduler.advanceUntilIdle()
-
-        viewModel.saveItem()
-        testDispatcher.scheduler.advanceUntilIdle()
-
-        val uiState = viewModel.uiState.value
-        assertFalse(uiState.isLoading)
-        assertNotNull(uiState.item)
-        assertEquals(itemId, uiState.item?.id)
-        assertEquals("Updated Item", uiState.item?.name)
-        assertEquals(4, uiState.item?.quantity)
-    }
-}

build.gradle.kts

@@ -3,7 +3,7 @@
 
 plugins {
     // [PLUGIN] Android Application plugin
-    id("com.android.application") version "8.12.2" apply false
+    id("com.android.application") version "8.13.0" apply false
     // [PLUGIN] Kotlin Android plugin
     id("org.jetbrains.kotlin.android") version "1.9.22" apply false
     // [PLUGIN] Hilt Android plugin

data/semantic-ktlint-rules/src/androidTest/java/com/busya/ktlint/rules/ExampleInstrumentedTest.kt

@@ -1,3 +1,6 @@
+// [FILE] ExampleInstrumentedTest.kt
+// [SEMANTICS] testing, android, ktlint, rules
+
 package com.busya.ktlint.rules
 
 import androidx.test.platform.app.InstrumentationRegistry

data/semantic-ktlint-rules/src/main/java/com/busya/ktlint/rules/CustomRuleSetProvider.kt

@@ -1,4 +1,5 @@
-// Путь: data/semantic-ktlint-rules/src/main/java/com/busya/ktlint/rules/CustomRuleSetProvider.kt
+// [FILE] CustomRuleSetProvider.kt
+// [SEMANTICS] ktlint, rules, provider
 package com.busya.ktlint.rules
 
 import com.pinterest.ktlint.rule.engine.core.api.RuleProvider

data/semantic-ktlint-rules/src/main/java/com/busya/ktlint/rules/FileHeaderRule.kt

@@ -1,4 +1,5 @@
-// Путь: data/semantic-ktlint-rules/src/main/java/com/busya/ktlint/rules/FileHeaderRule.kt
+// [FILE] FileHeaderRule.kt
+// [SEMANTICS] ktlint, rules, file_header
 package com.busya.ktlint.rules
 
 import com.pinterest.ktlint.rule.engine.core.api.ElementType

data/semantic-ktlint-rules/src/main/java/com/busya/ktlint/rules/MandatoryEntityDeclarationRule.kt

@@ -1,4 +1,5 @@
-// Путь: data/semantic-ktlint-rules/src/main/java/com/busya/ktlint/rules/MandatoryEntityDeclarationRule.kt
+// [FILE] MandatoryEntityDeclarationRule.kt
+// [SEMANTICS] ktlint, rules, entity_declaration
 package com.busya.ktlint.rules
 
 import com.pinterest.ktlint.rule.engine.core.api.ElementType

data/semantic-ktlint-rules/src/main/java/com/busya/ktlint/rules/NoStrayCommentsRule.kt

@@ -1,4 +1,5 @@
-// Путь: data/semantic-ktlint-rules/src/main/java/com/busya/ktlint/rules/NoStrayCommentsRule.kt
+// [FILE] NoStrayCommentsRule.kt
+// [SEMANTICS] ktlint, rules, comments
 package com.busya.ktlint.rules
 
 import com.pinterest.ktlint.rule.engine.core.api.ElementType

data/semantic-ktlint-rules/src/test/java/com/busya/ktlint/rules/ExampleUnitTest.kt

@@ -1,3 +1,6 @@
+// [FILE] ExampleUnitTest.kt
+// [SEMANTICS] testing, ktlint, rules
+
 package com.busya.ktlint.rules
 
 import com.pinterest.ktlint.test.KtLintAssertThat.Companion.assertThatRule

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

@@ -1,4 +1,3 @@
-// [PACKAGE] com.homebox.lens.data.api
 // [FILE] HomeboxApiService.kt
 // [SEMANTICS] data, api, retrofit
 package com.homebox.lens.data.api
@@ -11,7 +10,7 @@ import retrofit2.http.*
 
 // [ENTITY: Interface('HomeboxApiService')]
 /**
- * @summary Определяет эндпоинты для взаимодействия с Homebox API, используя DTO.
+ * @summary Defines the endpoints for interacting with the Homebox API using DTOs.
  */
 interface HomeboxApiService {
 

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

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.data.api.dto
 // [FILE] CustomFieldDto.kt
-// [SEMANTICS] data_transfer_object, custom_field
+// [SEMANTICS] data, dto, custom_field
 
 package com.homebox.lens.data.api.dto
 
@@ -12,7 +11,7 @@ import com.homebox.lens.domain.model.CustomField
 
 // [ENTITY: DataClass('CustomFieldDto')]
 /**
- * @summary DTO для кастомного поля.
+ * @summary DTO for a custom field.
  */
 @JsonClass(generateAdapter = true)
 data class CustomFieldDto(
@@ -25,7 +24,7 @@ data class CustomFieldDto(
 // [ENTITY: Function('toDomain')]
 // [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('CustomField')]
 /**
- * @summary Маппер из CustomFieldDto в доменную модель CustomField.
+ * @summary Mapper from CustomFieldDto to the CustomField domain model.
  */
 fun CustomFieldDto.toDomain(): CustomField {
     return CustomField(

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

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.data.api.dto
 // [FILE] GroupStatisticsDto.kt
-// [SEMANTICS] data_transfer_object, statistics
+// [SEMANTICS] data, dto, statistics
 
 package com.homebox.lens.data.api.dto
 
@@ -12,7 +11,7 @@ import com.homebox.lens.domain.model.GroupStatistics
 
 // [ENTITY: DataClass('GroupStatisticsDto')]
 /**
- * @summary DTO для статистики.
+ * @summary DTO for statistics.
  */
 @JsonClass(generateAdapter = true)
 data class GroupStatisticsDto(
@@ -28,7 +27,7 @@ data class GroupStatisticsDto(
 // [ENTITY: Function('toDomain')]
 // [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('GroupStatistics')]
 /**
- * @summary Маппер из GroupStatisticsDto в доменную модель GroupStatistics.
+ * @summary Mapper from GroupStatisticsDto to the GroupStatistics domain model.
  */
 fun GroupStatisticsDto.toDomain(): GroupStatistics {
     return GroupStatistics(

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

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.data.api.dto
 // [FILE] ImageDto.kt
-// [SEMANTICS] data_transfer_object, image
+// [SEMANTICS] data, dto, image
 
 package com.homebox.lens.data.api.dto
 
@@ -12,10 +11,10 @@ import com.homebox.lens.domain.model.Image
 
 // [ENTITY: DataClass('ImageDto')]
 /**
- * @summary DTO для изображения.
- * @param id Уникальный идентификатор.
- * @param path Путь к файлу.
- * @param isPrimary Является ли основным.
+ * @summary DTO for an image.
+ * @param id The unique identifier.
+ * @param path The path to the file.
+ * @param isPrimary Whether it is the primary image.
  */
 @JsonClass(generateAdapter = true)
 data class ImageDto(
@@ -28,7 +27,7 @@ data class ImageDto(
 // [ENTITY: Function('toDomain')]
 // [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('Image')]
 /**
- * @summary Маппер из ImageDto в доменную модель Image.
+ * @summary Mapper from ImageDto to the Image domain model.
  */
 fun ImageDto.toDomain(): Image {
     return Image(

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

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.data.api.dto
 // [FILE] ItemAttachmentDto.kt
-// [SEMANTICS] data_transfer_object, attachment
+// [SEMANTICS] data, dto, attachment
 
 package com.homebox.lens.data.api.dto
 
@@ -12,7 +11,7 @@ import com.homebox.lens.domain.model.ItemAttachment
 
 // [ENTITY: DataClass('ItemAttachmentDto')]
 /**
- * @summary DTO для вложения.
+ * @summary DTO for an attachment.
  */
 @JsonClass(generateAdapter = true)
 data class ItemAttachmentDto(
@@ -28,7 +27,7 @@ data class ItemAttachmentDto(
 // [ENTITY: Function('toDomain')]
 // [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('ItemAttachment')]
 /**
- * @summary Маппер из ItemAttachmentDto в доменную модель ItemAttachment.
+ * @summary Mapper from ItemAttachmentDto to the ItemAttachment domain model.
  */
 fun ItemAttachmentDto.toDomain(): ItemAttachment {
     return ItemAttachment(

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

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.data.api.dto
 // [FILE] ItemCreateDto.kt
-// [SEMANTICS] data_transfer_object, item_creation
+// [SEMANTICS] data, dto, item_creation
 
 package com.homebox.lens.data.api.dto
 
@@ -12,22 +11,33 @@ import com.homebox.lens.domain.model.ItemCreate
 
 // [ENTITY: DataClass('ItemCreateDto')]
 /**
- * @summary DTO для создания вещи.
+ * @summary DTO for creating an item.
  */
 @JsonClass(generateAdapter = true)
 data class ItemCreateDto(
     @Json(name = "name") val name: String,
-    @Json(name = "assetId") val assetId: String?,
     @Json(name = "description") val description: String?,
-    @Json(name = "notes") val notes: String?,
-    @Json(name = "serialNumber") val serialNumber: String?,
     @Json(name = "quantity") val quantity: Int?,
-    @Json(name = "value") val value: Double?,
-    @Json(name = "purchasePrice") val purchasePrice: Double?,
-    @Json(name = "purchaseDate") val purchaseDate: String?,
-    @Json(name = "warrantyUntil") val warrantyUntil: String?,
-    @Json(name = "locationId") val locationId: String?,
+    @Json(name = "archived") val archived: Boolean?,
+    @Json(name = "assetId") val assetId: 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 = "notes") val notes: String?,
     @Json(name = "parentId") val parentId: String?,
+    @Json(name = "purchaseFrom") val purchaseFrom: String?,
+    @Json(name = "purchasePrice") val purchasePrice: Double?,
+    @Json(name = "purchaseTime") val purchaseTime: String?,
+    @Json(name = "serialNumber") val serialNumber: 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?,
+    @Json(name = "warrantyExpires") val warrantyExpires: String?,
+    @Json(name = "locationId") val locationId: String?,
     @Json(name = "labelIds") val labelIds: List<String>?
 )
 // [END_ENTITY: DataClass('ItemCreateDto')]
@@ -35,22 +45,33 @@ data class ItemCreateDto(
 // [ENTITY: Function('toDto')]
 // [RELATION: Function('toDto')] -> [RETURNS] -> [DataClass('ItemCreateDto')]
 /**
- * @summary Маппер из доменной модели ItemCreate в ItemCreateDto.
+ * @summary Mapper from the ItemCreate domain model to ItemCreateDto.
  */
-fun ItemCreate.toDto(): ItemCreateDto {
+fun ItemCreate.toItemCreateDto(): ItemCreateDto {
     return ItemCreateDto(
         name = this.name,
-        assetId = this.assetId,
         description = this.description,
-        notes = this.notes,
-        serialNumber = this.serialNumber,
         quantity = this.quantity,
-        value = this.value,
-        purchasePrice = this.purchasePrice,
-        purchaseDate = this.purchaseDate,
-        warrantyUntil = this.warrantyUntil,
-        locationId = this.locationId,
+        archived = this.archived,
+        assetId = this.assetId,
+        insured = this.insured,
+        lifetimeWarranty = this.lifetimeWarranty,
+        manufacturer = this.manufacturer,
+        modelNumber = this.modelNumber,
+        notes = this.notes,
         parentId = this.parentId,
+        purchaseFrom = this.purchaseFrom,
+        purchasePrice = this.purchasePrice,
+        purchaseTime = this.purchaseTime,
+        serialNumber = this.serialNumber,
+        soldNotes = this.soldNotes,
+        soldPrice = this.soldPrice,
+        soldTime = this.soldTime,
+        soldTo = this.soldTo,
+        syncChildItemsLocations = this.syncChildItemsLocations,
+        warrantyDetails = this.warrantyDetails,
+        warrantyExpires = this.warrantyExpires,
+        locationId = this.locationId,
         labelIds = this.labelIds
     )
 }

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

@@ -1,74 +0,0 @@
-// [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]
-
-// [ENTITY: DataClass('ItemOut')]
-// [RELATION: DataClass('ItemOut')] -> [DEPENDS_ON] -> [DataClass('LocationOut')]
-// [RELATION: DataClass('ItemOut')] -> [DEPENDS_ON] -> [DataClass('LabelOutDto')]
-/**
- * @summary DTO для полной информации о вещи (GET /v1/items/{id}).
- */
-@JsonClass(generateAdapter = true)
-data class ItemOut(
-    @Json(name = "id") val id: String,
-    @Json(name = "name") val name: String,
-    @Json(name = "description") val description: String?,
-    @Json(name = "image") val image: String?,
-    @Json(name = "location") val location: LocationOut?,
-    @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')]
-/**
- * @summary DTO для краткой информации о вещи в списках (GET /v1/items).
- */
-@JsonClass(generateAdapter = true)
-data class ItemSummary(
-    @Json(name = "id") val id: String,
-    @Json(name = "name") val name: String,
-    @Json(name = "image") val image: String?,
-    @Json(name = "location") val location: LocationOut?,
-    @Json(name = "createdAt") val createdAt: String?
-)
-// [END_ENTITY: DataClass('ItemSummary')]
-
-// [ENTITY: DataClass('ItemCreate')]
-/**
- * @summary DTO для создания новой вещи (POST /v1/items).
- */
-@JsonClass(generateAdapter = true)
-data class ItemCreate(
-    @Json(name = "name") val name: String,
-    @Json(name = "description") val description: String?,
-    @Json(name = "locationId") val locationId: String?,
-    @Json(name = "labelIds") val labelIds: List<String>?,
-    @Json(name = "value") val value: BigDecimal?
-)
-// [END_ENTITY: DataClass('ItemCreate')]
-
-// [ENTITY: DataClass('ItemUpdate')]
-/**
- * @summary DTO для обновления вещи (PUT /v1/items/{id}).
- */
-@JsonClass(generateAdapter = true)
-data class ItemUpdate(
-    @Json(name = "name") val name: String,
-    @Json(name = "description") val description: String?,
-    @Json(name = "locationId") val locationId: String?,
-    @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

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.data.api.dto
 // [FILE] ItemOutDto.kt
-// [SEMANTICS] data_transfer_object, item_detailed
+// [SEMANTICS] data, dto, item_detailed
 
 package com.homebox.lens.data.api.dto
 
@@ -24,10 +23,20 @@ data class ItemOutDto(
     @Json(name = "serialNumber") val serialNumber: String?,
     @Json(name = "quantity") val quantity: Int,
     @Json(name = "isArchived") val isArchived: Boolean,
-    @Json(name = "value") val value: Double,
     @Json(name = "purchasePrice") val purchasePrice: Double?,
-    @Json(name = "purchaseDate") val purchaseDate: String?,
-    @Json(name = "warrantyUntil") val warrantyUntil: String?,
+    @Json(name = "purchaseTime") val purchaseTime: String?,
+    @Json(name = "purchaseFrom") val purchaseFrom: String?,
+    @Json(name = "warrantyExpires") val warrantyExpires: String?,
+    @Json(name = "warrantyDetails") val warrantyDetails: String?,
+    @Json(name = "lifetimeWarranty") val lifetimeWarranty: Boolean?,
+    @Json(name = "insured") val insured: Boolean?,
+    @Json(name = "manufacturer") val manufacturer: String?,
+    @Json(name = "modelNumber") val modelNumber: String?,
+    @Json(name = "soldPrice") val soldPrice: Double?,
+    @Json(name = "soldTime") val soldTime: String?,
+    @Json(name = "soldTo") val soldTo: String?,
+    @Json(name = "soldNotes") val soldNotes: String?,
+    @Json(name = "syncChildItemsLocations") val syncChildItemsLocations: Boolean?,
     @Json(name = "location") val location: LocationOutDto?,
     @Json(name = "parent") val parent: ItemSummaryDto?,
     @Json(name = "children") val children: List<ItemSummaryDto>,
@@ -44,7 +53,7 @@ data class ItemOutDto(
 // [ENTITY: Function('toDomain')]
 // [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('ItemOut')]
 /**
- * @summary Маппер из ItemOutDto в доменную модель ItemOut.
+ * @summary Mapper from ItemOutDto to the ItemOut domain model.
  */
 fun ItemOutDto.toDomain(): ItemOut {
     return ItemOut(
@@ -56,10 +65,20 @@ fun ItemOutDto.toDomain(): ItemOut {
         serialNumber = this.serialNumber,
         quantity = this.quantity,
         isArchived = this.isArchived,
-        value = this.value,
         purchasePrice = this.purchasePrice,
-        purchaseDate = this.purchaseDate,
-        warrantyUntil = this.warrantyUntil,
+        purchaseTime = this.purchaseTime,
+        purchaseFrom = this.purchaseFrom,
+        warrantyExpires = this.warrantyExpires,
+        warrantyDetails = this.warrantyDetails,
+        lifetimeWarranty = this.lifetimeWarranty,
+        insured = this.insured,
+        manufacturer = this.manufacturer,
+        modelNumber = this.modelNumber,
+        soldPrice = this.soldPrice,
+        soldTime = this.soldTime,
+        soldTo = this.soldTo,
+        soldNotes = this.soldNotes,
+        syncChildItemsLocations = this.syncChildItemsLocations,
         location = this.location?.toDomain(),
         parent = this.parent?.toDomain(),
         children = this.children.map { it.toDomain() },
@@ -72,4 +91,4 @@ fun ItemOutDto.toDomain(): ItemOut {
         updatedAt = this.updatedAt
     )
 }
-// [END_ENTITY: Function('toDomain')]
+// [END_ENTITY: Function('toDomain')]

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

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.data.api.dto
 // [FILE] ItemSummaryDto.kt
-// [SEMANTICS] data_transfer_object, item_summary
+// [SEMANTICS] data, dto, item_summary
 
 package com.homebox.lens.data.api.dto
 
@@ -32,7 +31,7 @@ data class ItemSummaryDto(
 // [ENTITY: Function('toDomain')]
 // [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('ItemSummary')]
 /**
- * @summary Маппер из ItemSummaryDto в доменную модель ItemSummary.
+ * @summary Mapper from ItemSummaryDto to the ItemSummary domain model.
  */
 fun ItemSummaryDto.toDomain(): ItemSummary {
     return ItemSummary(
@@ -48,4 +47,4 @@ fun ItemSummaryDto.toDomain(): ItemSummary {
         updatedAt = this.updatedAt
     )
 }
-// [END_ENTITY: Function('toDomain')]
+// [END_ENTITY: Function('toDomain')]

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

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.data.api.dto
 // [FILE] ItemUpdateDto.kt
-// [SEMANTICS] data_transfer_object, item_update
+// [SEMANTICS] data, dto, item_update
 
 package com.homebox.lens.data.api.dto
 
@@ -17,18 +16,28 @@ import com.homebox.lens.domain.model.ItemUpdate
 @JsonClass(generateAdapter = true)
 data class ItemUpdateDto(
     @Json(name = "name") val name: String?,
-    @Json(name = "assetId") val assetId: String?,
     @Json(name = "description") val description: String?,
-    @Json(name = "notes") val notes: String?,
-    @Json(name = "serialNumber") val serialNumber: String?,
     @Json(name = "quantity") val quantity: Int?,
-    @Json(name = "isArchived") val isArchived: Boolean?,
-    @Json(name = "value") val value: Double?,
-    @Json(name = "purchasePrice") val purchasePrice: Double?,
-    @Json(name = "purchaseDate") val purchaseDate: String?,
-    @Json(name = "warrantyUntil") val warrantyUntil: String?,
-    @Json(name = "locationId") val locationId: String?,
+    @Json(name = "archived") val archived: Boolean?,
+    @Json(name = "assetId") val assetId: 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 = "notes") val notes: String?,
     @Json(name = "parentId") val parentId: String?,
+    @Json(name = "purchaseFrom") val purchaseFrom: String?,
+    @Json(name = "purchasePrice") val purchasePrice: Double?,
+    @Json(name = "purchaseTime") val purchaseTime: String?,
+    @Json(name = "serialNumber") val serialNumber: 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?,
+    @Json(name = "warrantyExpires") val warrantyExpires: String?,
+    @Json(name = "locationId") val locationId: String?,
     @Json(name = "labelIds") val labelIds: List<String>?
 )
 // [END_ENTITY: DataClass('ItemUpdateDto')]
@@ -38,21 +47,31 @@ data class ItemUpdateDto(
 /**
  * @summary Маппер из доменной модели ItemUpdate в ItemUpdateDto.
  */
-fun ItemUpdate.toDto(): ItemUpdateDto {
+fun ItemUpdate.toItemUpdateDto(): ItemUpdateDto {
     return ItemUpdateDto(
         name = this.name,
-        assetId = this.assetId,
         description = this.description,
-        notes = this.notes,
-        serialNumber = this.serialNumber,
         quantity = this.quantity,
-        isArchived = this.isArchived,
-        value = this.value,
-        purchasePrice = this.purchasePrice,
-        purchaseDate = this.purchaseDate,
-        warrantyUntil = this.warrantyUntil,
-        locationId = this.locationId,
+        archived = this.archived,
+        assetId = this.assetId,
+        insured = this.insured,
+        lifetimeWarranty = this.lifetimeWarranty,
+        manufacturer = this.manufacturer,
+        modelNumber = this.modelNumber,
+        notes = this.notes,
         parentId = this.parentId,
+        purchaseFrom = this.purchaseFrom,
+        purchasePrice = this.purchasePrice,
+        purchaseTime = this.purchaseTime,
+        serialNumber = this.serialNumber,
+        soldNotes = this.soldNotes,
+        soldPrice = this.soldPrice,
+        soldTime = this.soldTime,
+        soldTo = this.soldTo,
+        syncChildItemsLocations = this.syncChildItemsLocations,
+        warrantyDetails = this.warrantyDetails,
+        warrantyExpires = this.warrantyExpires,
+        locationId = this.locationId,
         labelIds = this.labelIds
     )
 }

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

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.data.api.dto
 // [FILE] LabelCreateDto.kt
-// [SEMANTICS] data_transfer_object, label, create, api
+// [SEMANTICS] data, dto, label, create
 package com.homebox.lens.data.api.dto
 
 // [IMPORTS]

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

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.data.api.dto
 // [FILE] LabelOutDto.kt
-// [SEMANTICS] data_transfer_object, label
+// [SEMANTICS] data, dto, label
 
 package com.homebox.lens.data.api.dto
 
@@ -29,13 +28,14 @@ data class LabelOutDto(
 // [ENTITY: Function('toDomain')]
 // [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('LabelOut')]
 /**
- * @summary Маппер из LabelOutDto в доменную модель LabelOut.
+ * @summary Mapper from LabelOutDto to the LabelOut domain model.
  */
 fun LabelOutDto.toDomain(): LabelOut {
     return LabelOut(
         id = this.id,
         name = this.name,
-        color = this.color ?: "",
+        description = this.description,
+        color = this.color ?: "#000000",
         isArchived = this.isArchived ?: false,
         createdAt = this.createdAt,
         updatedAt = this.updatedAt

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

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.data.api.dto
 // [FILE] LabelSummaryDto.kt
-// [SEMANTICS] data_transfer_object, label, summary, api, mapper
+// [SEMANTICS] data, dto, label, summary
 package com.homebox.lens.data.api.dto
 
 // [IMPORTS]
@@ -35,7 +34,8 @@ data class LabelSummaryDto(
 fun LabelSummaryDto.toDomain(): LabelSummary {
     return LabelSummary(
         id = this.id,
-        name = this.name
+        name = this.name,
+        color = this.color ?: ""
     )
 }
 // [END_ENTITY: Function('toDomain')]

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

@@ -1,31 +1,24 @@
-// [PACKAGE] com.homebox.lens.data.api.dto
 // [FILE] LabelUpdateDto.kt
-// [SEMANTICS] data_transfer_object, label, update
+// [SEMANTICS] data, dto, 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')]
+/**
+ * @summary DTO for updating a label.
+ */
 @JsonClass(generateAdapter = true)
 data class LabelUpdateDto(
     @Json(name = "name")
     val name: String?,
     @Json(name = "color")
-    val color: String?
+    val color: String?,
+    @Json(name = "description")
+    val description: 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

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

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

@@ -1,34 +0,0 @@
-// [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]
-
-// [ENTITY: DataClass('LocationOut')]
-/**
- * @summary 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')]
-/**
- * @summary DTO для информации о местоположении со счетчиком вещей.
- */
-@JsonClass(generateAdapter = true)
-data class LocationOutCount(
-    @Json(name = "id") val id: String,
-    @Json(name = "name") val name: String,
-    @Json(name = "itemCount") val itemCount: Int
-)
-// [END_ENTITY: DataClass('LocationOutCount')]
-
-// [END_FILE_LocationDto.kt]

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

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.data.api.dto
 // [FILE] LocationOutCountDto.kt
-// [SEMANTICS] data_transfer_object, location, count
+// [SEMANTICS] data, dto, location, count
 
 package com.homebox.lens.data.api.dto
 
@@ -12,7 +11,7 @@ import com.homebox.lens.domain.model.LocationOutCount
 
 // [ENTITY: DataClass('LocationOutCountDto')]
 /**
- * @summary DTO для местоположения со счетчиком.
+ * @summary DTO for a location with an item count.
  */
 @JsonClass(generateAdapter = true)
 data class LocationOutCountDto(
@@ -30,13 +29,13 @@ data class LocationOutCountDto(
 // [ENTITY: Function('toDomain')]
 // [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('LocationOutCount')]
 /**
- * @summary Маппер из LocationOutCountDto в доменную модель LocationOutCount.
+ * @summary Mapper from LocationOutCountDto to the LocationOutCount domain model.
  */
 fun LocationOutCountDto.toDomain(): LocationOutCount {
     return LocationOutCount(
         id = this.id,
         name = this.name,
-        color = this.color ?: "",
+        color = this.color ?: "#000000",
         isArchived = this.isArchived ?: false,
         itemCount = this.itemCount,
         createdAt = this.createdAt,

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

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.data.api.dto
 // [FILE] LocationOutDto.kt
-// [SEMANTICS] data_transfer_object, location, output
+// [SEMANTICS] data, dto, location
 package com.homebox.lens.data.api.dto
 
 // [IMPORTS]
@@ -29,6 +28,9 @@ data class LocationOutDto(
 
 // [ENTITY: Function('toDomain')]
 // [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('LocationOut')]
+/**
+ * @summary Mapper from LocationOutDto to the LocationOut domain model.
+ */
 fun LocationOutDto.toDomain(): LocationOut {
     return LocationOut(
         id = this.id,

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

@@ -1,31 +1,25 @@
-// [PACKAGE] com.homebox.lens.data.api.dto
 // [FILE] LocationUpdateDto.kt
-// [SEMANTICS] data_transfer_object, location, update
+// [SEMANTICS] data, dto, 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')]
+/**
+ * @summary DTO for updating a location.
+ */
 @JsonClass(generateAdapter = true)
 data class LocationUpdateDto(
     @Json(name = "name")
     val name: String?,
     @Json(name = "color")
-    val color: String?
+    val color: String?,
+    @Json(name = "description")
+    val description: 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

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.data.api.dto
 // [FILE] LoginFormDto.kt
-// [SEMANTICS] data, dto, api, login
+// [SEMANTICS] data, dto, login
 package com.homebox.lens.data.api.dto
 
 // [IMPORTS]
@@ -9,6 +8,9 @@ import com.squareup.moshi.JsonClass
 // [END_IMPORTS]
 
 // [ENTITY: DataClass('LoginFormDto')]
+/**
+ * @summary DTO for the login form.
+ */
 @JsonClass(generateAdapter = true)
 data class LoginFormDto(
     @Json(name = "username") val username: String,

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

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.data.api.dto
 // [FILE] MaintenanceEntryDto.kt
-// [SEMANTICS] data_transfer_object, maintenance
+// [SEMANTICS] data, dto, maintenance
 
 package com.homebox.lens.data.api.dto
 
@@ -12,7 +11,7 @@ import com.homebox.lens.domain.model.MaintenanceEntry
 
 // [ENTITY: DataClass('MaintenanceEntryDto')]
 /**
- * @summary DTO для записи об обслуживании.
+ * @summary DTO for a maintenance entry.
  */
 @JsonClass(generateAdapter = true)
 data class MaintenanceEntryDto(
@@ -30,7 +29,7 @@ data class MaintenanceEntryDto(
 // [ENTITY: Function('toDomain')]
 // [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('MaintenanceEntry')]
 /**
- * @summary Маппер из MaintenanceEntryDto в доменную модель MaintenanceEntry.
+ * @summary Mapper from MaintenanceEntryDto to the MaintenanceEntry domain model.
  */
 fun MaintenanceEntryDto.toDomain(): MaintenanceEntry {
     return MaintenanceEntry(

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

@@ -1,25 +0,0 @@
-// [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]
-
-// [ENTITY: DataClass('PaginationResult')]
-/**
- * @summary DTO для пагинированных результатов от API.
- */
-@JsonClass(generateAdapter = true)
-data class PaginationResult<T>(
-    @Json(name = "items") val items: List<T>,
-    @Json(name = "page") val page: Int,
-    @Json(name = "pages") val pages: Int,
-    @Json(name = "total") val total: Int,
-    @Json(name = "pageSize") val pageSize: Int
-)
-// [END_ENTITY: DataClass('PaginationResult')]
-
-// [END_FILE_PaginationDto.kt]

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

@@ -1,6 +1,5 @@
-// [PACKAGE] com.homebox.lens.data.api.dto
 // [FILE] PaginationResultDto.kt
-// [SEMANTICS] data_transfer_object, pagination
+// [SEMANTICS] data, dto, pagination
 
 package com.homebox.lens.data.api.dto
 
@@ -26,15 +25,14 @@ data class PaginationResultDto<T>(
 // [ENTITY: Function('toDomain')]
 // [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('PaginationResult')]
 /**
- * @summary Маппер из PaginationResultDto в доменную модель PaginationResult.
- * @param transform Функция для преобразования каждого элемента из DTO в доменную модель.
+ * @summary Mapper from PaginationResultDto to the PaginationResult domain model.
  */
-fun <T, R> PaginationResultDto<T>.toDomain(transform: (T) -> R): PaginationResult<R> {
+fun <T, R> PaginationResultDto<T>.toDomain(mapper: (T) -> R): PaginationResult<R> {
     return PaginationResult(
-        items = this.items.map(transform),
+        items = this.items.map(mapper),
         page = this.page,
         pageSize = this.pageSize,
         total = this.total
     )
 }
-// [END_ENTITY: Function('toDomain')]
+// [END_ENTITY: Function('toDomain')]

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

@@ -1,25 +0,0 @@
-// [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]
-
-// [ENTITY: DataClass('GroupStatistics')]
-/**
- * @summary DTO для статистической информации.
- */
-@JsonClass(generateAdapter = true)
-data class GroupStatistics(
-    @Json(name = "totalValue") val totalValue: BigDecimal,
-    @Json(name = "totalItems") val totalItems: Int,
-    @Json(name = "locations") val locations: Int,
-    @Json(name = "labels") val labels: Int
-)
-// [END_ENTITY: DataClass('GroupStatistics')]
-
-// [END_FILE_StatisticsDto.kt]

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

@@ -1,14 +1,17 @@
-// [PACKAGE] com.homebox.lens.data.api.dto
 // [FILE] TokenResponseDto.kt
-// [SEMANTICS] data, dto, api, token
+// [SEMANTICS] data, dto, token
 package com.homebox.lens.data.api.dto
 
 // [IMPORTS]
+import com.homebox.lens.domain.model.TokenResponse
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 // [END_IMPORTS]
 
 // [ENTITY: DataClass('TokenResponseDto')]
+/**
+ * @summary DTO for the token response.
+ */
 @JsonClass(generateAdapter = true)
 data class TokenResponseDto(
     @Json(name = "token") val token: String,
@@ -16,4 +19,18 @@ data class TokenResponseDto(
     @Json(name = "expiresAt") val expiresAt: String
 )
 // [END_ENTITY: DataClass('TokenResponseDto')]
+
+// [ENTITY: Function('toDomain')]
+// [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('TokenResponse')]
+/**
+ * @summary Mapper from TokenResponseDto to the TokenResponse domain model.
+ */
+fun TokenResponseDto.toDomain(): TokenResponse {
+    return TokenResponse(
+        token = this.token,
+        attachmentToken = this.attachmentToken,
+        expiresAt = this.expiresAt
+    )
+}
+// [END_ENTITY: Function('toDomain')]
 // [END_FILE_TokenResponseDto.kt]

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

@@ -1,30 +0,0 @@
-// [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

@@ -1,19 +1,19 @@
-// [PACKAGE] com.homebox.lens.data.api.model
 // [FILE] LoginRequest.kt
-// [SEMANTICS] dto, network, serialization, authentication
+// [SEMANTICS] data, dto, login
 
 package com.homebox.lens.data.api.model
 
+// [IMPORTS]
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
+// [END_IMPORTS]
 
+// [ENTITY: DataClass('LoginRequest')]
 /**
- * [ENTITY: DataClass('LoginRequest')]
- * [CONTRACT]
- * DTO (Data Transfer Object) для запроса на аутентификацию.
- * @property username Имя пользователя.
- * @property password Пароль пользователя.
- * @invariant Свойства не должны быть пустыми.
+ * @summary DTO for the authentication request.
+ * @property username The user's name.
+ * @property password The user's password.
+ * @invariant The properties must not be blank.
  */
 @JsonClass(generateAdapter = true)
 data class LoginRequest(
@@ -21,9 +21,9 @@ data class LoginRequest(
     @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." }
+        require(username.isNotBlank()) { "Username cannot be blank." }
+        require(password.isNotBlank()) { "Password cannot be blank." }
     }
 }
+// [END_ENTITY: DataClass('LoginRequest')]
 // [END_FILE_LoginRequest.kt]

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

@@ -1,4 +1,3 @@
-// [PACKAGE] com.homebox.lens.data.db
 // [FILE] Converters.kt
 // [SEMANTICS] data, database, room, converter
 package com.homebox.lens.data.db
@@ -10,7 +9,7 @@ import java.math.BigDecimal
 
 // [ENTITY: Class('Converters')]
 /**
- * @summary Предоставляет TypeConverters для Room для типов, не поддерживаемых по умолчанию.
+ * @summary Provides TypeConverters for Room for types not supported by default.
  */
 class Converters {
     // [ENTITY: Function('fromString')]

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

@@ -1,4 +1,3 @@
-// [PACKAGE] com.homebox.lens.data.db
 // [FILE] HomeboxDatabase.kt
 // [SEMANTICS] data, database, room
 package com.homebox.lens.data.db
@@ -15,7 +14,7 @@ import com.homebox.lens.data.db.entity.*
 
 // [ENTITY: Database('HomeboxDatabase')]
 /**
- * @summary Основной класс для работы с локальной базой данных Room.
+ * @summary The main class for working with the local Room database.
  */
 @Database(
     entities = [
@@ -24,7 +23,7 @@ import com.homebox.lens.data.db.entity.*
         LocationEntity::class,
         ItemLabelCrossRef::class
     ],
-    version = 1,
+    version = 2,
     exportSchema = false
 )
 @TypeConverters(Converters::class)

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

@@ -1,4 +1,3 @@
-// [PACKAGE] com.homebox.lens.data.db.dao
 // [FILE] ItemDao.kt
 // [SEMANTICS] data, database, dao, item
 package com.homebox.lens.data.db.dao
@@ -13,7 +12,7 @@ import kotlinx.coroutines.flow.Flow
 
 // [ENTITY: Interface('ItemDao')]
 /**
- * @summary Предоставляет методы для работы с 'items' в локальной БД.
+ * @summary Provides methods for working with 'items' in the local DB.
  */
 @Dao
 interface ItemDao {

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

@@ -1,4 +1,3 @@
-// [PACKAGE] com.homebox.lens.data.db.dao
 // [FILE] LabelDao.kt
 // [SEMANTICS] data, database, dao, label
 package com.homebox.lens.data.db.dao
@@ -13,7 +12,7 @@ import com.homebox.lens.data.db.entity.LabelEntity
 
 // [ENTITY: Interface('LabelDao')]
 /**
- * @summary Предоставляет методы для работы с 'labels' в локальной БД.
+ * @summary Provides methods for working with 'labels' in the local DB.
  */
 @Dao
 interface LabelDao {

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

@@ -1,4 +1,3 @@
-// [PACKAGE] com.homebox.lens.data.db.dao
 // [FILE] LocationDao.kt
 // [SEMANTICS] data, database, dao, location
 package com.homebox.lens.data.db.dao
@@ -13,7 +12,7 @@ import com.homebox.lens.data.db.entity.LocationEntity
 
 // [ENTITY: Interface('LocationDao')]
 /**
- * @summary Предоставляет методы для работы с 'locations' в локальной БД.
+ * @summary Provides methods for working with 'locations' in the local DB.
  */
 @Dao
 interface LocationDao {

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

@@ -1,4 +1,3 @@
-// [PACKAGE] com.homebox.lens.data.db.entity
 // [FILE] ItemEntity.kt
 // [SEMANTICS] data, database, entity, item
 package com.homebox.lens.data.db.entity
@@ -6,22 +5,40 @@ package com.homebox.lens.data.db.entity
 // [IMPORTS]
 import androidx.room.Entity
 import androidx.room.PrimaryKey
-import java.math.BigDecimal
 // [END_IMPORTS]
 
 // [ENTITY: DatabaseTable('ItemEntity')]
 /**
- * @summary Представляет собой строку в таблице 'items' в локальной БД.
+ * @summary Represents a row in the 'items' table in the local DB.
  */
 @Entity(tableName = "items")
 data class ItemEntity(
     @PrimaryKey val id: String,
     val name: String,
     val description: String?,
+    val quantity: Int,
     val image: String?,
     val locationId: String?,
-    val value: BigDecimal?,
-    val createdAt: String?
+    val purchasePrice: Double?,
+    val createdAt: String?,
+    val archived: Boolean,
+    val assetId: String?,
+    val insured: Boolean,
+    val lifetimeWarranty: Boolean,
+    val manufacturer: String?,
+    val modelNumber: String?,
+    val notes: String?,
+    val parentId: String?,
+    val purchaseFrom: String?,
+    val purchaseTime: String?,
+    val serialNumber: String?,
+    val soldNotes: String?,
+    val soldPrice: Double?,
+    val soldTime: String?,
+    val soldTo: String?,
+    val syncChildItemsLocations: Boolean,
+    val warrantyDetails: String?,
+    val warrantyExpires: String?
 )
 // [END_ENTITY: DatabaseTable('ItemEntity')]
 

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

@@ -1,4 +1,3 @@
-// [PACKAGE] com.homebox.lens.data.db.entity
 // [FILE] ItemLabelCrossRef.kt
 // [SEMANTICS] data, database, entity, relation
 package com.homebox.lens.data.db.entity
@@ -10,7 +9,7 @@ import androidx.room.Index
 
 // [ENTITY: DatabaseTable('ItemLabelCrossRef')]
 /**
- * @summary Таблица для связи "многие-ко-многим" между ItemEntity и LabelEntity.
+ * @summary Table for the many-to-many relationship between ItemEntity and LabelEntity.
  */
 @Entity(
     primaryKeys = ["itemId", "labelId"],

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

@@ -1,4 +1,3 @@
-// [PACKAGE] com.homebox.lens.data.db.entity
 // [FILE] ItemWithLabels.kt
 // [SEMANTICS] data, database, entity, relation
 package com.homebox.lens.data.db.entity
@@ -13,7 +12,7 @@ import androidx.room.Relation
 // [RELATION: DataClass('ItemWithLabels')] -> [DEPENDS_ON] -> [DatabaseTable('ItemEntity')]
 // [RELATION: DataClass('ItemWithLabels')] -> [DEPENDS_ON] -> [DatabaseTable('LabelEntity')]
 /**
- * @summary POJO для получения ItemEntity вместе со связанными LabelEntity.
+ * @summary POJO for retrieving an ItemEntity with its associated LabelEntity objects.
  */
 data class ItemWithLabels(
     @Embedded val item: ItemEntity,

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

@@ -1,4 +1,3 @@
-// [PACKAGE] com.homebox.lens.data.db.entity
 // [FILE] LabelEntity.kt
 // [SEMANTICS] data, database, entity, label
 package com.homebox.lens.data.db.entity
@@ -10,7 +9,7 @@ import androidx.room.PrimaryKey
 
 // [ENTITY: DatabaseTable('LabelEntity')]
 /**
- * @summary Представляет собой строку в таблице 'labels' в локальной БД.
+ * @summary Represents a row in the 'labels' table in the local DB.
  */
 @Entity(tableName = "labels")
 data class LabelEntity(

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

@@ -1,4 +1,3 @@
-// [PACKAGE] com.homebox.lens.data.db.entity
 // [FILE] LocationEntity.kt
 // [SEMANTICS] data, database, entity, location
 package com.homebox.lens.data.db.entity
@@ -10,7 +9,7 @@ import androidx.room.PrimaryKey
 
 // [ENTITY: DatabaseTable('LocationEntity')]
 /**
- * @summary Представляет собой строку в таблице 'locations' в локальной БД.
+ * @summary Represents a row in the 'locations' table in the local DB.
  */
 @Entity(tableName = "locations")
 data class LocationEntity(

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

@@ -1,49 +1,175 @@
-// [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
+import com.homebox.lens.data.mapper.toDomain
+import com.homebox.lens.domain.model.*
 // [END_IMPORTS]
 
-// [ENTITY: Function('toDomain')]
-// [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('ItemSummary')]
+// [ENTITY: Function('ItemWithLabels.toDomainItemSummary')]
+// [RELATION: Function('ItemWithLabels.toDomainItemSummary')] -> [RETURNS] -> [DataClass('ItemSummary')]
 /**
- * @summary Преобразует [ItemWithLabels] (сущность БД) в [ItemSummary] (доменную модель).
+ * @summary Converts [ItemWithLabels] (DB entity) to [ItemSummary] (domain model).
  */
-fun ItemWithLabels.toDomain(): ItemSummary {
+fun ItemWithLabels.toDomainItemSummary(): 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,
+        labels = this.labels.map { it.toDomainLabelOut() },
+        assetId = this.item.assetId,
+        isArchived = this.item.archived,
+        value = this.item.purchasePrice ?: 0.0,
         createdAt = this.item.createdAt ?: "",
-        updatedAt = ""
+        updatedAt = "" // ItemEntity does not have updatedAt
     )
 }
-// [END_ENTITY: Function('toDomain')]
+// [END_ENTITY: Function('ItemWithLabels.toDomainItemSummary')]
 
-// [ENTITY: Function('toDomain')]
-// [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('LabelOut')]
+// [ENTITY: Function('ItemEntity.toDomainItem')]
+// [RELATION: Function('ItemEntity.toDomainItem')] -> [RETURNS] -> [DataClass('Item')]
 /**
- * @summary Преобразует [LabelEntity] (сущность БД) в [LabelOut] (доменную модель).
+ * @summary Converts [ItemEntity] (DB entity) to [Item] (domain model).
  */
-fun LabelEntity.toDomain(): LabelOut {
+fun ItemEntity.toDomainItem(): Item {
+    return Item(
+        id = this.id,
+        name = this.name,
+        description = this.description,
+        quantity = this.quantity,
+        image = this.image,
+        location = this.locationId?.let { Location(it, "") }, // Simplified, name is not in ItemEntity
+        labels = emptyList(), // Labels are handled via ItemWithLabels
+        purchasePrice = this.purchasePrice,
+        createdAt = this.createdAt,
+        archived = this.archived,
+        assetId = this.assetId,
+        fields = emptyList(), // Custom fields are not stored in ItemEntity
+        insured = this.insured,
+        lifetimeWarranty = this.lifetimeWarranty,
+        manufacturer = this.manufacturer,
+        modelNumber = this.modelNumber,
+        notes = this.notes,
+        parentId = this.parentId,
+        purchaseFrom = this.purchaseFrom,
+        purchaseTime = this.purchaseTime,
+        serialNumber = this.serialNumber,
+        soldNotes = this.soldNotes,
+        soldPrice = this.soldPrice,
+        soldTime = this.soldTime,
+        soldTo = this.soldTo,
+        syncChildItemsLocations = this.syncChildItemsLocations,
+        warrantyDetails = this.warrantyDetails,
+        warrantyExpires = this.warrantyExpires
+    )
+}
+// [END_ENTITY: Function('ItemEntity.toDomainItem')]
+
+// [ENTITY: Function('Item.toItemEntity')]
+// [RELATION: Function('Item.toItemEntity')] -> [RETURNS] -> [DataClass('ItemEntity')]
+/**
+ * @summary Converts [Item] (domain model) to [ItemEntity] (DB entity).
+ */
+fun Item.toItemEntity(): ItemEntity {
+    return ItemEntity(
+        id = this.id,
+        name = this.name,
+        description = this.description,
+        quantity = this.quantity,
+        image = this.image,
+        locationId = this.location?.id,
+        purchasePrice = this.purchasePrice,
+        createdAt = this.createdAt,
+        archived = this.archived,
+        assetId = this.assetId,
+        insured = this.insured,
+        lifetimeWarranty = this.lifetimeWarranty,
+        manufacturer = this.manufacturer,
+        modelNumber = this.modelNumber,
+        notes = this.notes,
+        parentId = this.parentId,
+        purchaseFrom = this.purchaseFrom,
+        purchaseTime = this.purchaseTime,
+        serialNumber = this.serialNumber,
+        soldNotes = this.soldNotes,
+        soldPrice = this.soldPrice,
+        soldTime = this.soldTime,
+        soldTo = this.soldTo,
+        syncChildItemsLocations = this.syncChildItemsLocations,
+        warrantyDetails = this.warrantyDetails,
+        warrantyExpires = this.warrantyExpires
+    )
+}
+// [END_ENTITY: Function('Item.toItemEntity')]
+
+// [ENTITY: Function('ItemOut.toItemEntity')]
+// [RELATION: Function('ItemOut.toItemEntity')] -> [RETURNS] -> [DataClass('ItemEntity')]
+fun ItemOut.toItemEntity(): ItemEntity {
+    return ItemEntity(
+        id = this.id,
+        name = this.name,
+        description = this.description,
+        quantity = this.quantity,
+        image = this.images.firstOrNull()?.path,
+        locationId = this.location?.id,
+        purchasePrice = this.purchasePrice,
+        createdAt = this.createdAt,
+        archived = this.isArchived,
+        assetId = this.assetId,
+        insured = this.insured ?: false,
+        lifetimeWarranty = this.lifetimeWarranty ?: false,
+        manufacturer = this.manufacturer,
+        modelNumber = this.modelNumber,
+        notes = this.notes,
+        parentId = this.parent?.id,
+        purchaseFrom = this.purchaseFrom,
+        purchaseTime = this.purchaseTime,
+        serialNumber = this.serialNumber,
+        soldNotes = this.soldNotes,
+        soldPrice = this.soldPrice,
+        soldTime = this.soldTime,
+        soldTo = this.soldTo,
+        syncChildItemsLocations = this.syncChildItemsLocations ?: false,
+        warrantyDetails = this.warrantyDetails,
+        warrantyExpires = this.warrantyExpires
+    )
+}
+// [END_ENTITY: Function('ItemOut.toItemEntity')]
+
+// [ENTITY: Function('LabelEntity.toDomain')]
+// [RELATION: Function('LabelEntity.toDomain')] -> [RETURNS] -> [DataClass('Label')]
+fun LabelEntity.toDomain(): Label {
+    return Label(
+        id = this.id,
+        name = this.name
+    )
+}
+// [END_ENTITY: Function('LabelEntity.toDomain')]
+
+// [ENTITY: Function('LabelEntity.toDomainLabelOut')]
+// [RELATION: Function('LabelEntity.toDomainLabelOut')] -> [RETURNS] -> [DataClass('LabelOut')]
+fun LabelEntity.toDomainLabelOut(): LabelOut {
     return LabelOut(
         id = this.id,
         name = this.name,
-        color = "#CCCCCC",
-        isArchived = false,
-        createdAt = "",
-        updatedAt = ""
+        description = null, // Not available in LabelEntity
+        color = "", // Not available in LabelEntity
+        isArchived = false, // Not available in LabelEntity
+        createdAt = "", // Not available in LabelEntity
+        updatedAt = "" // Not available in LabelEntity
     )
 }
-// [END_ENTITY: Function('toDomain')]
+// [END_ENTITY: Function('LabelEntity.toDomainLabelOut')]
+
+// [ENTITY: Function('Label.toEntity')]
+// [RELATION: Function('Label.toEntity')] -> [RETURNS] -> [DataClass('LabelEntity')]
+fun Label.toEntity(): LabelEntity {
+    return LabelEntity(
+        id = this.id,
+        name = this.name
+    )
+}
+// [END_ENTITY: Function('Label.toEntity')]
+// [END_FILE_Mapper.kt]