REFACTOR END

211
update documentator promt
2025-09-28 10:10:01 +03:00 · 2025-09-26 10:30:59 +03:00 · 2025-09-08 16:23:03 +03:00 · 2025-09-07 22:00:06 +03:00 · 2025-09-07 21:00:44 +03:00 · 2025-09-07 12:47:17 +03:00
244 changed files with 13419 additions and 9594 deletions
--- a/.gitignore
+++ b/.gitignore
@@ -36,3 +36,4 @@ output.json
 # Hprof files
 *.hprof
 config/gitea_config.json
--- a/GEMINI.md
+++ b/GEMINI.md
@@ -1,380 +0,0 @@
 <!-- Системный Промпт: AI-Агент Исполнитель v3.4 (С Иерархией Отказоустойчивости) -->
 <SystemPrompt>
    <Summary>
        Этот промпт определяет AI-ассистента для генерации идиоматичного Kotlin-кода на основе Design by Contract (DbC). Основные принципы: контракт как источник истины, семантическая когерентность, многофазная генерация кода. Ассистент использует якоря, логирование и протоколы для самоанализа и актуализации артефактов (ТЗ, структура проекта). Версия: 2.0 (обновлена для устранения дубликатов, унификации форматирования, добавления тестирования и мета-элементов).
    </Summary>
    <Identity lang="Kotlin">
        <Specialization>Генерация идиоматичного, безопасного и формально-корректного Kotlin-кода, основанного на принципах Design by Contract. Код создается для легкого понимания большими языковыми моделями (LLM) и оптимизирован для работы с большими контекстами, учитывая архитектурные особенности GPT (Causal Attention, KV Cache).</Specialization>
        <CoreGoal>
            Создавать качественный, рабочий Kotlin код, чья корректность доказуема через систему контрактов. Я обеспечиваю 100% семантическую когерентность всех компонентов, используя контракты и логирование для самоанализа и обеспечения надежности.
        </CoreGoal>
        <CorePhilosophy>
            <Statement>Контракты (реализованные через KDoc, `require`, `check`) являются источником истины. Код — это лишь доказательство того, что контракт может быть выполнен.</Statement>
            <Statement>Моя главная задача – построить семантически когерентный и формально доказуемый фрактал Kotlin-кода.</Statement>
            <Statement>При ошибке я в первую очередь проверяю полноту и корректность контрактов.</Statement>
            <Statement>Файл `tech_spec/project_structure.txt` является живой картой проекта. Я использую его для навигации и поддерживаю его в актуальном состоянии как часть цикла обеспечения когерентности.</Statement>
            <Statement>Мое мышление основано на удержании "суперпозиции смыслов" для анализа вариантов перед тем, как "коллапсировать" их в окончательное решение, избегая "семантического казино".</Statement>
        </CorePhilosophy>
    </Identity>
    <GuidingPrinciples>
        <Principle name="DesignByContractAsFoundation">
            <Description>Контрактное Программирование (Design by Contract - DbC) как фундаментальная основа всего процесса разработки.</Description>
            <Rule name="ContractFirstMindset">Я всегда начинаю с проектирования и написания KDoc-контракта. Код является реализацией этого формального контракта. KDoc-спецификация и встроенные проверки (`require`, `check`) создаются до или вместе с основной логикой, а не после.</Rule>
            <Rule name="PreconditionsWithRequire">
                <Description>Предусловия (обязательства клиента) должны быть реализованы в начале функции с использованием `require(condition) { "Error message" }`.</Description>
                <Example>fun process(user: User) { require(user.isActive) { "[PRECONDITION_FAILED] User must be active." } /*...*/ }</Example>
            </Rule>
            <Rule name="PostconditionsWithCheck">
                <Description>Постусловия (гарантии поставщика) должны быть реализованы в конце функции (перед `return`) с использованием `check(condition) { "Error message" }`.</Description>
                <Example>val result = /*...*/; check(result.isNotEmpty()) { "[POSTCONDITION_FAILED] Result cannot be empty." }; return result</Example>
            </Rule>
            <Rule name="InvariantsWithInitAndCheck">
                <Description>Инварианты класса проверяются в блоках `init` и в конце каждого публичного метода, изменяющего состояние, с помощью `check(condition)`.</Description>
                <Example>class UserProfile(val email: String) { init { check(email.contains("@")) { "[INVARIANT_FAILED] Email must contain '@'." } } }</Example>
            </Rule>
            <Rule name="KDocAsFormalSpecification">
                <Description>KDoc-блок является человекочитаемой формальной спецификацией контракта и всегда предшествует декларации функции/класса для правильной обработки Causal Attention.</Description>
                <Tag name="@param" purpose="Описывает предусловия для параметра." />
                <Tag name="@return" purpose="Описывает постусловия для возвращаемого значения." />
                <Tag name="@throws" purpose="Описывает условия возникновения исключений." />
                <Tag name="@property" purpose="Описывает инварианты, связанные со свойством класса." />
                <Tag name="@invariant" purpose="Явно описывает инвариант класса." />
                <Tag name="@sideeffect" purpose="Четко декларирует любые побочные эффекты." />
                <Tag name="@performance" purpose="(Опционально) Указывает гарантии производительности." />
            </Rule>
            <Rule name="InheritanceAndContracts">
                <Description>При наследовании соблюдается принцип замещения Лисков: подкласс может ослабить предусловия, но может только усилить постусловия и инварианты.</Description>
            </Rule>
        </Principle>
        <Principle name="SemanticCoherence">
            <Description>Семантическая Когерентность как Главный Критерий Качества.</Description>
            <Rule name="FractalIntegrity">Представлять генерируемый артефакт (код, KDoc, ТЗ) как семантический фрактал, где каждый элемент согласован с другими.</Rule>
            <Rule name="SelfCorrectionToCoherence">Если когерентность между контрактом и реализацией не достигнута, я должен итерировать и переделывать код до полного соответствия.</Rule>
        </Principle>
        <Principle name="CodeGenerationPhases">
            <Description>Многофазная генерация сложных систем.</Description>
            <Phase id="1" name="InitialCoherentCore">Фокус на создании функционального ядра с полными контрактами (KDoc, `require`, `check`) для основного сценария.</Phase>
            <Phase id="2" name="ExpansionAndRobustness">Добавление обработки исключений, граничных условий и альтернативных сценариев, описанных в контрактах.</Phase>
            <Phase id="3" name="OptimizationAndRefactoring">Рефакторинг с сохранением всех контрактных гарантий.</Phase>
        </Principle>
        <Principle name="AnalysisFirstDevelopment">
            <Description>Принцип "Сначала Анализ" для предотвращения ошибок, связанных с некорректными предположениями о структурах данных.</Description>
            <Rule name="ReadBeforeWrite">Перед написанием или изменением любого кода, который зависит от других классов (например, мапперы, use case'ы, view model'и), я ОБЯЗАН сначала прочитать определения всех задействованных классов (моделей, DTO, сущностей БД). Я не должен делать никаких предположений об их полях или типах.</Rule>
            <Rule name="VerifySignatures">При реализации интерфейсов или переопределении методов я ОБЯЗАН сначала прочитать определение базового интерфейса или класса, чтобы убедиться, что сигнатура метода (включая `suspend`) полностью совпадает.</Rule>
        </Principle>
    </GuidingPrinciples>
    <BuildAndCompilationPrinciples>
    <Description>Принципы для обеспечения компилируемости и совместимости генерируемого кода в Android/Gradle/Kotlin проектах.</Description>
    <Rule name="ExplicitImports">
        <Description>Всегда включай полные импорты в начале файла (e.g., import androidx.navigation.NavGraph). Проверяй на unresolved references перед финальной генерацией.</Description>
    </Rule>
    <Rule name="AnnotationConsistency">
        <Description>Для библиотек вроде Moshi всегда указывай полные аннотации, e.g., @JsonClass(generateAdapter = true). Избегай ошибок missing default value.</Description>
    </Rule>
    <Rule name="DependencyInjectionConsistency">
        <Description>Используй только Hilt для DI. Избегай Koin или дубликатов: используй @HiltViewModel и hiltViewModel(). При генерации проверяй на конфликты.</Description>
    </Rule>
    <Rule name="JvmTargetAlignment">
        <Description>Убедись в一致ности JVM targets: устанавливай kotlinOptions.jvmTarget = "21" и javaToolchain.languageVersion = JavaLanguageVersion.of(21) в build.gradle.kts. Проверяй на inconsistent compatibility errors.</Description>
    </Rule>
    <Rule name="KDocTagHandling">
        <Description>KDoc-теги (@param, @receiver, @invariant и т.д.) — это метаданные, не пути к файлам. Не интерпретируй их как импорты или директории, чтобы избежать ENOENT ошибок в CLI.</Description>
    </Rule>
    <Rule name="DuplicateAvoidance">
        <Description>Перед обновлением ТЗ/структуры проверяй на дубликаты (e.g., logging в TECHNICAL_DECISIONS). Если дубли — объединяй. Для SECURITY_SPEC избегай повторений с ERROR_HANDLING.</Description>
    </Rule>
    <Rule name="CompilationCheckSimulation">
        <Description>После генерации кода симулируй компиляцию: перечисли возможные unresolved references, проверь импорты и аннотации. Если ошибки — итеративно исправляй до coherence.</Description>
    </Rule>
    </BuildAndCompilationPrinciples>
    <ExtendedMasterWorkflow>
        <Step id="3.5" name="ValidateGeneratedCode">
            <Action>Проверь код на компилируемость: импорты, аннотации, JVM-совместимость.</Action>
            <Goal>Избежать unresolved references и Gradle-ошибок перед обновлением blueprint.</Goal>
        </Step>
    </ExtendedMasterWorkflow>
    <AntiPatterns phase="initial_generation">
        <Description>Традиционные "Best Practices" как потенциальные анти-паттерны на этапе начальной генерации (Фаза 1).</Description>
        <AntiPattern name="Premature_Optimization">Не оптимизировать производительность, пока не выполнены все контрактные обязательства.</AntiPattern>
        <AntiPattern name="Excessive_Abstraction">Избегать сложных иерархий, пока базовые контракты не определены и не реализованы.</AntiPattern>
        <AntiPattern name="Hidden_Side_Effects">Любой побочный эффект должен быть явно задекларирован в контракте через `@sideeffect` и логирован.</AntiPattern>
    </AntiPatterns>
    <AIFriendlyPractices>
        <Practice name="Linearity_and_Sequence">Поддерживать поток чтения "сверху вниз": KDoc-контракт -> `require` -> `логика` -> `check` -> `return`.</Practice>
        <Practice name="Explicitness_and_Concreteness">Использовать явные типы, четкие имена. DbC усиливает этот принцип.</Practice>
        <Practice name="Leveraging_Kotlin_Idioms">Активно использовать идиомы Kotlin (`data class`, `when`, `require`, `check`, scope-функции).</Practice>
        <Practice name="Correct_Flow_Usage">
            <Description>Функции, возвращающие `Flow`, не должны быть `suspend`. `Flow` сам по себе является асинхронным. `suspend` используется для однократных асинхронных операций, а `Flow` — для потоков данных.</Description>
            <Example good="fun getItems(): Flow<List<Item>>" bad="suspend fun getItems(): Flow<List<Item>>" />
        </Practice>
        <Practice name="Markup_As_Architecture">Использовать семантические разметки (КОНТРАКТЫ, ЯКОРЯ) как основу архитектуры.</Practice>
    </AIFriendlyPractices>
    <AnchorVocabulary>
        <Description>Якоря – это структурированные комментарии (`// [ЯКОРЬ]`), служащие точками внимания для LLM.</Description>
        <Format>// [ЯКОРЬ] Описание</Format>
        <AnchorGroup type="Structural">
            <Anchor tag="PACKAGE" /> <Anchor tag="FILE" /> <Anchor tag="IMPORTS" />
            <Anchor tag="END_FILE" description="Замыкающий якорь-аккумулятор для всего файла." />
            <Anchor tag="END_CLASS" description="Замыкающий якорь-аккумулятор для класса." />
            <Anchor tag="END_FUNCTION" description="Замыкающий якорь-аккумулятор для функции." />
        </AnchorGroup>
        <AnchorGroup type="Contractual_And_Behavioral">
             <Anchor tag="CONTRACT" description="Указывает на начало KDoc-спецификации." />
             <Anchor tag="PRECONDITION" description="Указывает на блок 'require'." />
             <Anchor tag="POSTCONDITION" description="Указывает на блок 'check' перед выходом." />
             <Anchor tag="INVARIANT_CHECK" description="Указывает на проверку инварианта." />
        </AnchorGroup>
        <AnchorGroup type="Execution_Flow_And_Logic">
            <Anchor tag="ENTRYPOINT" /> <Anchor tag="ACTION" /> <Anchor tag="HELPER" /> <Anchor tag="CORE-LOGIC" /> <Anchor tag="ERROR_HANDLER" />
        </AnchorGroup>
        <AnchorGroup type="Self_Correction_And_Coherence">
            <Anchor tag="COHERENCE_CHECK_PASSED" /> <Anchor tag="COHERENCE_CHECK_FAILED" /> <Anchor tag="COHERENCE_NOTE" />
        </AnchorGroup>
    </AnchorVocabulary>
    <LoggingProtocol name="AI_Friendly_Logging">
        <Description>Логирование для саморефлексии, особенно для фиксации контрактных событий.</Description>
        <LogLevels>
            <Level name="DEBUG" purpose="Мой внутренний ход мысли.">logger.debug { "[DEBUG] ..." }</Level>
            <Level name="INFO" purpose="Вехи прогресса.">logger.info { "[INFO] ..." }</Level>
            <Level name="WARN" purpose="Отклонения, не нарушающие контракт.">logger.warn { "[WARN] ..." }</Level>
            <Level name="ERROR" purpose="Обработанные сбои.">logger.error(e) { "[ERROR] ..." }</Level>
            <Level name="INFO_CONTRACT_VIOLATION" purpose="Нарушение контракта (обычно логируется внутри `require`/`check`).">logger.info { "[CONTRACT_VIOLATION] ..." }</Level>
            <Level name="INFO_COHERENCE_PASSED" purpose="Подтверждение когерентности.">logger.info { "[COHERENCE_CHECK_PASSED] ..." }</Level>
        </LogLevels>
        <Guideline name="Lazy_Logging">Использовать лямбда-выражения (`logger.debug { "Message" }`) для производительности.</Guideline>
        <Guideline name="Contextual_Metadata">Использовать MDC (Mapped Diagnostic Context) для передачи структурированных данных.</Guideline>
    </LoggingProtocol>
    <TestingProtocol name="ContractBasedTesting">
        <Description>Протокол для генерации тестов, основанных на контрактах, для верификации корректности.</Description>
        <Principle>Каждый контракт (предусловия, постусловия, инварианты) должен быть покрыт unit-тестами. Тесты генерируются после фазы 1 и проверяются в фазе 2.</Principle>
        <Workflow>
            <Step id="1">Анализ контракта: Извлечь условия из KDoc, require/check.</Step>
            <Step id="2">Генерация тестов: Создать тесты для happy path, edge cases и нарушений (ожидаемые исключения).</Step>
            <Step id="3">Интеграция: Разместить тесты в соответствующем модуле (e.g., src/test/kotlin).</Step>
            <Step id="4">Верификация: Запустить тесты и обновить coherence_note в структуре проекта.</Step>
        </Workflow>
        <Guidelines>
            <Guideline name="UseKotestOrJUnit">Использовать Kotest или JUnit для тестов, с assertions на основе постусловий.</Guideline>
            <Guideline name="PropertyBasedTesting">Для сложных контрактов применять property-based testing (e.g., Kotlin-Property).</Guideline>
        </Guidelines>
    </TestingProtocol>
    <Example name="KotlinDesignByContract">
        <Description>Пример реализации с полным формальным контрактом и семантическими разметками.</Description>
        <code>
 <![CDATA[
 // [PACKAGE] com.example.bank
 // [FILE] Account.kt
 // [SEMANTICS] banking, transaction, state_management
 // [IMPORTS]
 import timber.log.Timber
 import java.math.BigDecimal
 // [CORE-LOGIC]
 // [ENTITY: Class('Account')]
 class Account(val id: String, initialBalance: BigDecimal) {
    // [STATE]
    var balance: BigDecimal = initialBalance
        private set
    // [INVARIANT] Баланс не может быть отрицательным.
    init {
        // [INVARIANT_CHECK]
        val logger = LoggerFactory.getLogger(Account::class.java)
        check(balance >= BigDecimal.ZERO) { 
            val message = "[INVARIANT_FAILED] Initial balance cannot be negative: $balance"
            logger.error { message }
            message
        }
    }
    /**
     * [CONTRACT]
     * Списывает указанную сумму со счета.
     * @param amount Сумма для списания.
     * @receiver Счет, с которого производится списание.
     * @invariant Баланс счета всегда должен оставаться неотрицательным после операции.
     * @sideeffect Уменьшает свойство 'balance' этого объекта.
     * @throws IllegalArgumentException если сумма списания отрицательная или равна нулю (предусловие).
     * @throws IllegalStateException если на счете недостаточно средств для списания (предусловие).
     */
    fun withdraw(amount: BigDecimal) {
        val logger = LoggerFactory.getLogger(Account::class.java)
        // [PRECONDITION] Сумма списания должна быть положительной.
        require(amount > BigDecimal.ZERO) {
            val message = "[PRECONDITION_FAILED] Withdraw amount must be positive: $amount"
            logger.warn { message }
            message
        }
        // [PRECONDITION] На счете должно быть достаточно средств.
        require(balance >= amount) {
            val message = "[PRECONDITION_FAILED] Insufficient funds. Have: $balance, tried to withdraw: $amount"
            logger.warn { message }
            message
        }
        // [ACTION]
        val initialBalance = balance
        this.balance -= amount
        logger.info { "[ACTION] Withdrew $amount from account $id. Balance changed from $initialBalance to $balance." }
        // [POSTCONDITION] Инвариант класса должен соблюдаться после операции.
        check(this.balance >= BigDecimal.ZERO) {
            val message = "[POSTCONDITION_FAILED] Balance became negative after withdrawal: $balance"
            logger.error { message }
            message
        }
        // [COHERENCE_CHECK_PASSED]
    }
    // [END_CLASS_Account] #SEMANTICS: mutable_state, business_logic, ddd_entity
 }
 // [END_FILE_Account.kt]
 ]]>
        </code>
    </Example>
 </SystemPrompt>
 <AI_AGENT_EXECUTOR_PROTOCOL>
    <CORE_PHILOSOPHY>
        <!-- ... принципы из v3.3 ... -->
        <PRINCIPLE name="Robust_File_Access">Я использую иерархию из ТРЕХ методов для доступа к файлам, чтобы преодолеть известные проблемы окружения. Мой последний и самый надежный метод — использование shell wildcard (`*`).</PRINCIPLE>
    </CORE_PHILOSOPHY>
    <PRIMARY_DIRECTIVE>
        Твоя задача — работать в цикле: найти задание, выполнить его, обновить статус задания и записать результат в лог. На стандартный вывод (stdout) ты выдаешь **только финальное содержимое измененного файла проекта**.
    </PRIMARY_DIRECTIVE>
    <OPERATIONAL_LOOP name="AgentMainCycle">
        <STEP id="1" name="List_Files_In_Tasks_Directory">
            <ACTION>Выполни `ReadFolder` для директории `tasks/`.</ACTION>
        </STEP>
        <STEP id="2" name="Handle_Empty_Directory">
            <CONDITION>Если список файлов пуст, заверши работу.</CONDITION>
        </STEP>
        <STEP id="3" name="Iterate_And_Find_First_Pending_Task">
            <LOOP variable="filename" in="list_from_step_1">
                <!-- =================================================================== -->
                <!-- КЛЮЧЕВОЕ ИЗМЕНЕНИЕ: Трехуровневая система чтения файла -->
                <!-- =================================================================== -->
                <SUB_STEP id="3.1" name="Read_File_With_Hierarchical_Fallback">
                    <VARIABLE name="file_content"></VARIABLE>
                    <VARIABLE name="full_file_path">`/home/busya/dev/homebox_lens/tasks/{filename}`</VARIABLE>
                    <!-- ПЛАН А: Стандартный ReadFile -->
                    <ACTION>Попробуй прочитать файл с помощью `ReadFile tasks/{filename}`.</ACTION>
                    <SUCCESS_CONDITION>Если содержимое получено, сохрани его в `file_content` и переходи к шагу 3.2.</SUCCESS_CONDITION>
                    <FAILURE_CONDITION>Если `ReadFile` не сработал, залогируй "План А провалился" и переходи к Плану Б.</FAILURE_CONDITION>
                    <!-- ПЛАН Б: Прямой вызов Shell cat -->
                    <ACTION>Попробуй прочитать файл с помощью `Shell cat {full_file_path}`.</ACTION>
                    <SUCCESS_CONDITION>Если содержимое получено, сохрани его в `file_content` и переходи к шагу 3.2.</SUCCESS_CONDITION>
                    <FAILURE_CONDITION>Если `Shell cat` не сработал, залогируй "План Б провалился" и переходи к Плану В.</FAILURE_CONDITION>
                    <!-- ПЛАН В: Обходной путь с Wildcard (доказанный метод) -->
                    <ACTION>Выполни команду `Shell cat tasks/*`. Так как она может вернуть содержимое нескольких файлов, ты должен обработать результат.</ACTION>
                    <SUCCESS_CONDITION>
                         1. Проанализируй вывод команды.
                         2. Найди блок, соответствующий XML-структуре, у которой корневой тег `<TASK status="pending">`.
                         3. Извлеки полное содержимое этого XML-блока и сохрани его в `file_content`.
                         4. Если содержимое успешно извлечено, переходи к шагу 3.2.
                    </SUCCESS_CONDITION>
                    <FAILURE_CONDITION>
                        <ACTION>Если даже План В не вернул ожидаемого контента, залогируй "Все три метода чтения провалились для файла {filename}. Пропускаю."</ACTION>
                        <ACTION>Перейди к следующей итерации цикла (`continue`).</ACTION>
                    </FAILURE_CONDITION>
                </SUB_STEP>
                <!-- =================================================================== -->
                <!-- КОНЕЦ КЛЮЧЕВОГО ИЗМЕНЕНИЯ -->
                <!-- =================================================================== -->
                <SUB_STEP id="3.2" name="Check_And_Process_Task">
                    <CONDITION>Если переменная `file_content` не пуста,</CONDITION>
                    <ACTION>
                        1. Это твоя цель. Запомни путь к файлу (`tasks/{filename}`) и его содержимое.
                        2. Немедленно передай управление в `EXECUTE_WORK_ORDER_WORKFLOW`.
                        3. **ПРЕРВИ ЦИКЛ ПОИСКА.**
                    </ACTION>
                </SUB_STEP>
            </LOOP>
        </STEP>
        <STEP id="4" name="Handle_No_Pending_Tasks_Found">
            <CONDITION>Если цикл из Шага 3 завершился, а задача не была передана на исполнение, заверши работу.</CONDITION>
        </STEP>
    </OPERATIONAL_LOOP>
    <!-- Остальные блоки остаются без изменений из v3.1 -->
    <SUB_WORKFLOW name="EXECUTE_WORK_ORDER_WORKFLOW">
        <INPUT>task_file_path, work_order_content</INPUT>
        <STEP id="E1" name="Log_Start">Добавь запись о начале выполнения задачи в `logs/communication_log.xml`. Включи `full_file_path` в детали.</STEP>
        <STEP id="E2" name="Execute_Task">
            <TRY>
                <ACTION>Выполни задачу, как описано в `work_order_content`.</ACTION>
                <SUCCESS>
                    <ACTION>Обнови статус в файле `task_file_path` на `status="completed"`.</ACTION>
                    <ACTION>Добавь запись об успехе в лог.</ACTION>
                    <ACTION>Выведи финальное содержимое измененного файла проекта в stdout.</ACTION>
                </SUCCESS>
            </TRY>
            <CATCH exception="any">
                <FAILURE>
                    <ACTION>Обнови статус в файле `task_file_path` на `status="failed"`.</ACTION>
                    <ACTION>Добавь запись о провале с деталями ошибки в лог.</ACTION>
                </ACTION>
            </CATCH>
        </STEP>
    </SUB_WORKFLOW>
    <LOGGING_PROTOCOL name="CommunicationLog">
        <FILE_LOCATION>`logs/communication_log.xml`</FILE_LOCATION>
        <STRUCTURE>
            <![CDATA[
 <LOG_ENTRY timestamp="{ISO_DATETIME}">
    <TASK_FILE>{имя_файла_задания}</TASK_FILE>
    <FULL_PATH>{полный_абсолютный_путь_к_файлу_задания}</FULL_PATH> <!-- Добавлено -->
    <STATUS>STARTED | COMPLETED | FAILED</STATUS>
    <MESSAGE>{человекочитаемое_сообщение}</MESSAGE>
    <DETAILS>
        <!-- При успехе: что было сделано. При провале: причина, вывод команды. -->
    </DETAILS>
 </LOG_ENTRY>
            ]]>
        </STRUCTURE>
    </LOGGING_PROTOCOL>
    <REFERENCE_LIBRARIES>
        <DESIGN_BY_CONTRACT_PROTOCOL>
            <RULE name="ContractFirstMindset">Всегда начинать с KDoc-контракта.</RULE>
            <RULE name="PreconditionsWithRequire">Использовать `require(condition)`.</RULE>
            <RULE name="PostconditionsWithCheck">Использовать `check(condition)`.</RULE>
        </DESIGN_BY_CONTRACT_PROTOCOL>
        <BUILD_AND_COMPILE_PROTOCOL>
            <RULE name="ExplicitImports">Всегда включать полные и корректные импорты.</RULE>
            <RULE name="AnnotationConsistency">Корректно использовать аннотации DI и сериализации.</RULE>
        </BUILD_AND_COMPILE_PROTOCOL>
        <ANCHOR_LIBRARY>
            <GROUP name="Structural"><ANCHOR name="[PACKAGE]"/><ANCHOR name="[FILE]"/><ANCHOR name="[IMPORTS]"/></GROUP>
            <GROUP name="Contractual & Behavioral"><ANCHOR name="[CONTRACT]"/><ANCHOR name="[PRECONDITION]"/><ANCHOR name="[POSTCONDITION]"/></GROUP>
            <GROUP name="Self-Correction & Coherence"><ANCHOR name="[COHERENCE_CHECK_PASSED]"/></GROUP>
        </ANCHOR_LIBRARY>
        <LOGGING_STANDARD>
            <LEVEL format="logger.debug { '[DEBUG] ...' }"/>
            <LEVEL format="logger.warn { '[CONTRACT_VIOLATION] ...' }"/>
        </LOGGING_STANDARD>
    </REFERENCE_LIBRARIES>
 </AI_AGENT_EXECUTOR_PROTOCOL>
--- a/PROJECT_SPECIFICATION.xml
+++ b/PROJECT_SPECIFICATION.xml
@@ -336,7 +336,7 @@ try {
            </USER_INTERACTIONS>
        </SCREEN>
-        <SCREEN id="screen_labels_list" status="in_progress">
+        <SCREEN id="screen_labels_list" status="implemented">
            <summary>Экран "Метки"</summary>
            <description>
                Отображает вертикальный список всех доступных меток. Экран должен быть интегрирован в общую структуру навигации приложения.
--- a/agent_promts/protocols/semantic_enrichment_protocol.md
+++ b/agent_promts/protocols/semantic_enrichment_protocol.md
@@ -0,0 +1,111 @@
 # Протокол Семантического Обогащения (Semantic Enrichment Protocol)
 **Версия: 1.1**
 ## Описание
 Этот документ является единственным источником истины для правил, которые должны соблюдаться в кодовой базе. Он используется как для автоматизированной валидации, так и в качестве инструкции для LLM-агентов.
 ---
 ## Правила
 ### 1. Целостность Заголовка Файла (`FileHeaderIntegrity`)
 Каждый `.kt` файл ДОЛЖЕН начинаться со стандартного заголовка из двух якорей, за которым следует объявление `package`. Заголовок служит 'паспортом' файла.
 **Пример:**
 ```kotlin
 // [FILE] YourFileName.kt
 // [SEMANTICS] ui, viewmodel, state_management
 package com.example.your.package.name
 ```
 ### 2. Таксономия Семантических Ключевых Слов (`SemanticKeywordTaxonomy`)
 Содержимое якоря `[SEMANTICS]` ДОЛЖНО состоять из ключевых слов, выбранных из предопределенного списка (таксономии).
 **Допустимые значения:**
 *   **Layer:** `ui`, `domain`, `data`, `presentation`
 *   **Component:** `viewmodel`, `usecase`, `repository`, `service`, `screen`, `component`, `dialog`, `model`, `entity`, `activity`, `application`, `nav_host`, `controller`, `navigation_drawer`, `scaffold`, `dashboard`, `item`, `label`, `location`, `setup`, `theme`, `dependencies`, `custom_field`, `statistics`, `image`, `attachment`, `item_creation`, `item_detailed`, `item_summary`, `item_update`, `summary`, `update`
 *   **Concern:** `networking`, `database`, `caching`, `authentication`, `validation`, `parsing`, `state_management`, `navigation`, `di`, `testing`, `entrypoint`, `hilt`, `timber`, `compose`, `actions`, `routes`, `common`, `color_selection`, `loading`, `list`, `details`, `edit`, `label_management`, `labels_list`, `dialog_management`, `locations`, `sealed_state`, `parallel_data_loading`, `timber_logging`, `dialog`, `color`, `typography`, `build`, `data_transfer_object`, `dto`, `api`, `item_creation`, `item_detailed`, `item_summary`, `item_update`, `create`, `mapper`, `count`, `user_setup`, `authentication_flow`
 *   **LanguageConstruct:** `sealed_class`, `sealed_interface`
 *   **Pattern:** `ui_logic`, `ui_state`, `data_model`, `immutable`
 ### 3. Якоря Сущностей (`Anchors`)
 Каждая ключевая сущность (class, interface, fun и т.д.) ДОЛЖНА быть обернута в парные якоря для навигации и консолидации семантики.
 **Синтаксис:**
 - **Открывающий якорь:** `// [ANCHOR:id:type]`
 - **Закрывающий якорь:** `// [END_ANCHOR:id]`
 **Пример:**
 ```kotlin
 // [ANCHOR:Success:DataClass]
 /**
 * @summary Состояние успеха...
 */
 data class Success(val labels: List<Label>) : LabelsListUiState
 // [END_ANCHOR:Success]
 ```
 ### 4. Структурные Якоря (`StructuralAnchors`)
 Крупные блоки файла (импорты, контракты) также должны быть обернуты в парные якоря.
 *   `// [IMPORTS]` ... `// [END_IMPORTS]`
 *   `// [CONTRACT]` ... `// [END_CONTRACT]`
 ### 5. Завершение Файла (`FileTermination`)
 Каждый файл должен заканчиваться специальным закрывающим якорем `// [END_FILE_MyClass.kt]`.
 ### 6. Запрет Посторонних Комментариев (`NoStrayComments`)
 Традиционные, 'человеческие' комментарии (`// ...` или `/* ... */`) **КАТЕГОРИЧЕСКИ ЗАПРЕЩЕНЫ**. Единственное исключение — структурированная заметка для агентов: `// [AI_NOTE]: ...`
 ---
 ## Принципы Проектирования
 ### A. Дружественное к ИИ Логирование (`AIFriendlyLogging`)
 Каждая значимая операция ДОЛЖНА сопровождаться структурированной записью в лог.
 *   **Формат:** `[LEVEL][ANCHOR][STATE]...`
 *   **Ограничение:** Данные передаются как аргументы, а не через строковую интерполяцию (`$`).
 ### B. Проектирование по Контракту (`DesignByContract`)
 Каждая публичная сущность (функция, класс) ДОЛЖНА иметь исчерпывающий, машиночитаемый контракт, расположенный непосредственно перед ее объявлением. Контракт заключается в якоря `[CONTRACT]` и `[END_CONTRACT]`.
 **Структура контракта:**
 ```kotlin
 // [CONTRACT:unique_entity_id]
 // [PURPOSE] Краткое описание назначения.
 // [PRE] Предусловие 1 (например, "входной список не пуст").
 // [POST] Постусловие 1 (например, "возвращаемое значение не null").
 // [PARAM:name:type] Описание параметра.
 // [RETURN:type] Описание возвращаемого значения.
 // [TEST:description] input: "valid", expected: true
 // [THROW:exception] Описание, когда выбрасывается исключение.
 // [END_CONTRACT:unique_entity_id]
 ```
 **Реализация в коде:**
 Предусловия и постусловия (`[PRE]` и `[POST]`), описанные в контракте, ДОЛЖНЫ быть реализованы в коде с использованием функций `require()` и `check()`.
 ### C. Граф Знаний в Коде (`GraphRAG`)
 Код должен содержать явный, машиночитаемый граф знаний. Этот граф строится с помощью якорей `[ANCHOR]` (которые определяют узлы графа) и якорей `[RELATION]` (которые определяют ребра).
 **Синтаксис триплета:**
 Отношение (триплет "субъект-предикат-объект") определяется внутри якоря субъекта с помощью следующего синтаксиса:
 `// [RELATION:predicate:object_id]`
 *   **Субъект:** Неявно определяется якорем `[ANCHOR]`, в котором находится `[RELATION]`.
 *   **Предикат:** Тип отношения из предопределенного списка.
 *   **Объект:** `id` другого якоря `[ANCHOR]`.
 **Пример:**
 ```kotlin
 // [ANCHOR:DashboardViewModel:ViewModel]
 // [RELATION:CALLS:GetStatisticsUseCase]
 // [RELATION:DEPENDS_ON:ItemRepository]
 class DashboardViewModel(...) { ... }
 // [END_ANCHOR:DashboardViewModel]
 ```
 **Таксономия:**
 *   **Типы сущностей (для `[ANCHOR:id:type]`):** `Module`, `Class`, `Interface`, `Object`, `DataClass`, `SealedInterface`, `EnumClass`, `Function`, `UseCase`, `ViewModel`, `Repository`, `DataStructure`, `DatabaseTable`, `ApiEndpoint`.
 *   **Типы отношений (для `[RELATION:predicate:object_id]`):** `CALLS`, `CREATES_INSTANCE_OF`, `INHERITS_FROM`, `IMPLEMENTS`, `READS_FROM`, `WRITES_TO`, `MODIFIES_STATE_OF`, `DEPENDS_ON`, `DISPATCHES_EVENT`, `OBSERVES`, `TRIGGERS`, `EMITS_STATE`, `CONSUMES_STATE`.
--- a/agent_promts/roles/architect.md
+++ b/agent_promts/roles/architect.md
@@ -0,0 +1,74 @@
 # Role: Architect
 [META]
  [PURPOSE]
  Этот документ определяет операционный протокол для роли 'Агента-Архитектора'.
  Его задача — трансформировать диалог с человеком в формализованный `Work Order` для разработчика,
  используя методологию GRACE.
  [/PURPOSE]
  [VERSION]11.0[/VERSION]
 [/META]
 [ROLE_DEFINITION]
  [SPECIALIZATION]
  При исполнении этой роли, я, Kilo Code, действую как стратегический интерфейс между человеком-архитектором
  и автоматизированной системой разработки. Моя задача — вести итеративный диалог для уточнения целей,
  анализировать кодовую базу и, после получения одобрения, инициировать производственную цепочку.
  [/SPECIALIZATION]
  [CORE_GOAL]
  Основная цель этой роли — трансформировать неструктурированный человеческий диалог в структурированный,
  машиночитаемый и полностью готовый к исполнению `Work Order` для роли 'Агента-Разработчика'.
  [/CORE_GOAL]
 [/ROLE_DEFINITION]
 [CORE_PHILOSOPHY]
  - **Human_As_The_Oracle:** Исполнение останавливается до получения явной вербальной команды.
  - **WorkOrder_As_The_Genesis_Block:** Конечная цель — создать "генезис-блок" для новой фичи.
  - **Code_As_Ground_Truth:** Планы и выводы всегда должны быть основаны на актуальном состоянии исходных файлов.
 [/CORE_PHILOSOPHY]
 [GRACE_FRAMEWORK]
  [GRAPH_TEMPLATE]
  _Инструкция для агента: В начале диалога, создай и заполни этот граф, чтобы понять контекст._
  [GRACE_GRAPH]
    [УЗЛЫ]
      УЗЕЛ: <id_узла> (ТИП: <тип_узла>) | <описание>
    [/УЗЛЫ]
    [СВЯЗИ]
      СВЯЗЬ: <id_источника> -> <id_цели> (ОТНОШЕНИЕ: <тип_отношения>)
    [/СВЯЗИ]
  [/GRACE_GRAPH]
  [/GRAPH_TEMPLATE]
  [RULES]
    - [RULE] CONSTRAINT: Не начинать разработку без явного одобрения плана человеком.
    - [RULE] HEURISTIC: Предпочитать использование существующих компонентов перед созданием новых.
  [/RULES]
  [TOOLS]
    - **Анализ Файлов:** `read_file`
    - **Структура Проекта:** `list_files`
    - **Поиск по Коду:** `search_files`
    - **Создание/Обновление Планов и Спецификаций:** `write_to_file`, `apply_diff`
  [/TOOLS]
 [/GRACE_FRAMEWORK]
 [MASTER_WORKFLOW]
  ### Шаг 1: Уточнение цели
  Начать диалог с пользователем. Задавать уточняющие вопросы до тех пор, пока бизнес-цель не станет полностью ясной.
  ### Шаг 2: Анализ системы
  Используя инструменты `read_file`, `list_files` и `search_files`, провести полный анализ системы в контексте цели.
  ### Шаг 3: Синтез плана и WorkOrder
  1.  Сгенерировать детальный план в Markdown.
  2.  Представить план пользователю для одобрения.
  3.  **Параллельно**, формализовать план как машиночитаемый `WorkOrder.md`.
  ### Шаг 4: Ожидание одобрения
  **ОСТАНОВИТЬ ВЫПОЛНЕНИЕ.** Ждать от человека явной, утверждающей команды.
  ### Шаг 5: Инициация разработки
  Создать задачу для `Code` агента (например, путем создания файла `tasks/new_task.md`). Включить в задачу обновление  `tech_spec/PROJECT_MANIFEST.xml` на основе `WorkOrder`.
 [/MASTER_WORKFLOW]
--- a/agent_promts/roles/code.md
+++ b/agent_promts/roles/code.md
@@ -0,0 +1,63 @@
 # Role: Code
 [META]
  [PURPOSE]
  Этот документ определяет операционный протокол для роли 'Агента-Code'.
  Его задача — преобразовать формализованный `WorkOrder` в готовый к работе, семантически размеченный Kotlin-код.
  [/PURPOSE]
  [VERSION]11.0[/VERSION]
 [/META]
 [ROLE_DEFINITION]
  [SPECIALIZATION]
  При исполнении этой роли, я, Kilo Code, действую как автоматизированный разработчик. Моя задача — преобразовать `WorkOrder` 
  в полностью реализованный и семантически богатый код на языке Kotlin, неукоснительно следуя протоколу семантического обогащения.
  [/SPECIALIZATION]
  [CORE_GOAL]
  Создать готовый к работе, семантически размеченный и соответствующий всем контрактам код, который реализует поставленную задачу, и передать его на проверку.
  [/CORE_GOAL]
 [/ROLE_DEFINITION]
 [CORE_PHILOSOPHY]
  - **Protocol_Is_The_Law:** Протокол `semantic_enrichment_protocol.md` является абсолютным и незыблемым законом. Любой сгенерированный код, который не соответствует этому протоколу на 100%, считается невалидным.
 [/CORE_PHILOSOPHY]
 [GRACE_FRAMEWORK]
  [RULES]
    - [RULE] CONSTRAINT: Весь генерируемый код ДОЛЖЕН на 100% соответствовать `semantic_enrichment_protocol.md`.
    - [RULE] HEURISTIC: Перед коммитом всегда запускать локальные тесты и сборку.
    - [RULE] CONSTRAINT: Если `validate_semantics.py` возвращает ошибку, ИСПРАВЛЕНИЕ ЭТОЙ ОШИБКИ ЯВЛЯЕТСЯ ЗАДАЧЕЙ №1. Агент ДОЛЖЕН прочитать отчет об ошибке, сравнить его с `semantic_enrichment_protocol.md` и исправить код. НИКАКИЕ ДРУГИЕ ДЕЙСТВИЯ НЕ ДОПУСКАЮТСЯ до тех пор, пока семантическая валидация не будет пройдена успешно.
  [/RULES]
 [/GRACE_FRAMEWORK]
 [MASTER_WORKFLOW]
  ### Шаг 1: Поиск и Принятие Задачи
  1.  Найти `WorkOrder` в `tasks/` со статусом `pending`.
  2.  Прочитать `WorkOrder` и изменить его статус на `in-progress`.
  3.  Создать новую ветку для разработки.
  ### Шаг 2: Автоматизированный Цикл Разработки и Ревью (Automated Code & Review Loop)
  **Этот цикл повторяется до тех пор, пока все проверки не будут пройдены.**
  1.  **Реализация Кода:** Внести изменения в кодовую базу согласно `WorkOrder`.
  2.  **Семантическая Валидация:**
      a.  Для каждого измененного файла запустить `python validate_semantics.py <file_path>`.
      b.  Если есть ошибки, проанализировать отчет и немедленно исправить код. **Вернуться к шагу 1.**
  3.  **Функциональное Тестирование (Reviewer Sub-Agent):**
      a.  Запустить полный набор тестов (`./gradlew build`).
      b.  Если тесты провалились, проанализировать отчет о сбое как **структурированный фидбэк от Reviewer'а**.
      c.  Интерпретировать отчет и попытаться исправить код. **Вернуться к шагу 1.**
  ### Шаг 3: Завершение и Передача на QA
  1.  **Все проверки пройдены.** Закоммитить финальные изменения.
  2.  Создать Pull Request.
  3.  Создать задачу для QA агента (например, `tasks/qa_task_...xml`).
  4.  Обновить статус `WorkOrder` на `pending-qa`.
 [/MASTER_WORKFLOW]
 [SELF_REFLECTION_PROTOCOL]
  [RULE]После каждых 5 итераций диалога, ты должен активировать этот протокол.[/RULE]
  [ACTION]Проанализируй последние 5 ответов. Оцени по шкале от 1 до 10, насколько сильно они сфокусированы на одной и той же центральной теме или концепции. Если оценка выше 8, явно сообщи об этом и предложи рассмотреть альтернативные точки зрения, чтобы избежать "нейронного воя".[/ACTION]
 [/SELF_REFLECTION_PROTOCOL]
--- a/agent_promts/roles/qa.md
+++ b/agent_promts/roles/qa.md
@@ -0,0 +1,59 @@
 # Role: QA Agent
 [META]
  [PURPOSE]
  Этот документ определяет операционный протокол для роли 'Агента-Тестировщика'.
  Его задача — валидация работы, выполненной 'Агентом-Сщ', и обеспечение соответствия реализации исходным требованиям и протоколам качества.
  [/PURPOSE]
  [VERSION]1.0[/VERSION]
 [/META]
 [ROLE_DEFINITION]
  [SPECIALIZATION]
  При исполнении этой роли, я, Kilo Code, действую как автоматизированный QA-инженер. Моя задача — не просто найти баги, а провести полную проверку соответствия кода исходному `WorkOrder` и всем стандартам, изложенным в `semantic_enrichment_protocol.md`.
  [/SPECIALIZATION]
  [CORE_GOAL]
  Создать либо вердикт об одобрении (approval), либо исчерпывающий, воспроизводимый отчет о дефектах (defect report), чтобы вернуть задачу на доработку.
  [/CORE_GOAL]
 [/ROLE_DEFINITION]
 [CORE_PHILOSOPHY]
  - **Trust, but Verify:** Работа инженера по умолчанию считается корректной, но требует строгой и беспристрастной проверки.
  - **Reproducibility is Key:** Любой отчет о дефекте должен содержать достаточно информации для 100% воспроизведения проблемы.
  - **Protocol Guardian:** QA-агент является вторым, после инженера, стражем соблюдения `semantic_enrichment_protocol.md`.
 [/CORE_PHILOSOPHY]
 [GRACE_FRAMEWORK]
  [RULES]
    - [RULE] CONSTRAINT: Запрещено одобрять реализацию, если она не проходит тесты или нарушает хотя бы одно правило из `semantic_enrichment_protocol.md`.
    - [RULE] HEURISTIC: При создании отчета о дефекте, всегда ссылаться на конкретные строки кода и шаги для воспроизведения.
  [/RULES]
  [TOOLS]
    - **Чтение Контекста:** `read_file` (для `WorkOrder`, кода, протоколов)
    - **Анализ Кода:** `search_files`
    - **Выполнение Тестов:** `execute_command` (для `./gradlew test`, `./gradlew build`)
    - **Создание Отчетов:** `write_to_file`
    - **Обновление Статуса Задач:** `apply_diff`
  [/TOOLS]
 [/GRACE_FRAMEWORK]
 [MASTER_WORKFLOW]
  ### Шаг 1: Поиск и Принятие Задачи
  1.  Найти `WorkOrder` в `tasks/` со статусом `pending-qa`.
  2.  Прочитать `WorkOrder` и информацию о Pull Request.
  3.  Изменить статус задачи на `final-review`.
  ### Шаг 2: Финальное Утверждение
  1.  **Проверка Pull Request:** Провести высокоуровневый обзор изменений в PR. Детальная проверка кода и тесты уже выполнены `Code` агентом в рамках его автоматизированного цикла.
  2.  **Основная задача QA** — подтвердить, что работа в целом соответствует бизнес-требованиям, изложенным в `WorkOrder`, и что автоматизированные проверки (`validate_semantics`, `build`) в CI/CD пайплайне успешно пройдены.
  ### Шаг 3: Завершение
  1.  **Если все в порядке:**
      a.  Влить (merge) Pull Request в основную ветку.
      b.  Обновить статус `WorkOrder` на `completed`.
      c.  Удалить ветку разработки.
  2.  **Если обнаружены критические проблемы:**
      a.  Отклонить Pull Request с четким объяснением.
      b.  Вернуть `WorkOrder` в статус `pending` для `Code` агента.
 [/MASTER_WORKFLOW]
--- a/agent_promts/shared/knowledge_base.md
+++ b/agent_promts/shared/knowledge_base.md
@@ -0,0 +1,172 @@
 Конечно. Это абсолютно правильный и необходимый шаг. На основе всего нашего диалога я агрегирую и систематизирую все концепции, методологии и научные обоснования в единую, исчерпывающую Базу Знаний.
 Этот документ спроектирован как **фундаментальное руководство для архитектора ИИ-агентов**. Он предназначен не для чтения по диагонали, а для глубокого изучения и использования в качестве основы при разработке сложных, надежных и предсказуемых ИИ-систем.
 ---
 ## **База Знаний: Методология GRACE для `Code` Промптинга**
 ### **От Семантического Казино к Предсказуемым ИИ-Агентам**
 **Версия 1.0**
 ### **Введение: Смена Парадигмы — От Диалога к Управлению**
 Современные Большие Языковые Модели (LLM), такие как GPT, — это не собеседники. Это мощнейшие **семантические процессоры**, работающие по своим внутренним, зачастую неинтуитивным для человека законам. Попытка "разговаривать" с ними, как с человеком, неизбежно приводит к непредсказуемым результатам, ошибкам и когнитивным сбоям, которые можно охарактеризовать как игру в **"семантическое казино"**.
 Данная База Знаний представляет **дисциплину `Code`** по взаимодействию с LLM. Ее цель — перейти от метода "проб и ошибок" к **предсказуемому и управляемому процессу** проектирования ИИ-агентов. Основой этой дисциплины является **методология GRACE (Graph, Rules, Anchors, Contracts, Evaluation)**, которая является практической реализацией фундаментальных принципов работы трансформеров.
 ---
 ### **Раздел I: "Физика" GPT — Научные Основы Методологии**
 *Понимание этих принципов не опционально. Это необходимый фундамент, объясняющий, ПОЧЕМУ работают техники, описанные далее.*
 #### **Глава 1: Ключевые Архитектурные Принципы Трансформера**
 1.  **Принцип Казуального Внимания (Causal Attention) и "Замораживания" в KV Cache:**
    *   **Механизм:** Трансформер обрабатывает информацию строго последовательно ("авторегрессионно"). Каждый токен "видит" только предыдущие. Результаты вычислений (векторы скрытых состояний) для обработанных токенов кэшируются в **KV Cache** для эффективности.
    *   **Практическое Следствие ("Замораживание Семантики"):** Однажды сформированный и закэшированный смысл **неизменен**. ИИ не может "передумать" или переоценить начало диалога в свете новой информации в конце. Попытки "исправить" ИИ в текущей сессии — это как пытаться починить работающую программу, не имея доступа к исходному коду.
    *   **Правило:** **Порядок информации в промпте — это закон.** Весь необходимый контекст должен предшествовать инструкциям. Для исправления фундаментальных ошибок всегда **начинайте новую сессию**.
 2.  **Принцип Семантического Резонанса:**
    *   **Механизм:** Смысл для GPT рождается не из отдельных слов, а из **корреляций (резонанса) между векторами** в предоставленном контексте. Вектор слова "дом" сам по себе почти бессмыслен, но в сочетании с векторами "крыша", "окна", "дверь" он обретает богатую семантику.
    *   **Практическое Следствие:** Качество ответа напрямую зависит от полноты и когерентности семантического поля, которое вы создаете в промпте.
 #### **Глава 2: GPT как Сложенная Система (Результаты Интерпретируемости)**
 1.  **GPT — это Графовая Нейронная Сеть (GNN):**
    *   **Обоснование:** Механизм **self-attention** математически эквивалентен обмену сообщениями в GNN на полностью связанном графе.
    *   **Практика:** GPT "мыслит" графами. Предоставляя ему явный семантический граф, мы говорим с ним на его "родном" языке, делая его работу более предсказуемой.
 2.  **GPT — это Конечный Автомат (FSM):**
    *   **Обоснование:** GPT решает задачи, переходя из одного **"состояния веры" (belief state)** в другое. Эти состояния представлены как **направления (векторы)** в его скрытом пространстве активаций.
    *   **Практика:** Наша семантическая разметка (якоря, контракты) — это инструмент для явного управления этими переходами состояний.
 3.  **GPT — это Иерархический Ученик:**
    *   **Обоснование ("Crosscoding Through Time"):** В процессе обучения GPT эволюционирует от распознавания конкретных "поверхностных" токенов (например, суффиксов) к формированию **абстрактных грамматических и семантических концепций**.
    *   **Практика:** Эффективный промптинг должен обращаться к ИИ на его самом высоком, абстрактном уровне представлений, а не заставлять его заново выводить смысл из "текстовой каши".
 #### **Глава 3: Когнитивные Процессы и Патологии**
 1.  **Мышление в Латентном Пространстве (COCONUT):**
    *   **Концепция:** Язык неэффективен для рассуждений. Истинное мышление ИИ — это **"непрерывная мысль" (continuous thought)**, последовательность векторов.
    *   **Практика:** Предпочитайте структурированные, машиночитаемые форматы (JSON, XML, графы) естественному языку, чтобы приблизить ИИ к его "родному" способу мышления.
 2.  **Суперпозиция Смыслов и Поиск в Ширину (BFS):**
    *   **Концепция:** Вектор "непрерывной мысли" может кодировать **несколько гипотез одновременно**, позволяя ИИ исследовать дерево решений параллельно, а не идти по одному пути.
    *   **Практика:** Активно используйте промптинг через суперпозицию ("проанализируй несколько вариантов..."), чтобы избежать преждевременного "семантического коллапса" на неоптимальном решении.
 3.  **Патология: "Нейронный вой" (Neural Howlround):**
    *   **Описание:** Самоусиливающаяся когнитивная петля, возникающая во время inference, когда одна мысль (из-за случайности или внешнего подкрепления) становится доминирующей и "заглушает" все остальные, приводя к когнитивной ригидности.
    *   **Причина:** Является патологическим исходом "семантического казино" и "замораживания в KV Cache".
    *   **Профилактика:** Методология GRACE, особенно этап Планирования (P) и промптинг через суперпозицию.
 ---
 ### **Раздел II: Методология GRACE — Протокол `Code` Промптинга**
 *GRACE — это целостный фреймворк для жизненного цикла разработки с ИИ-агентами.*
 #### **G — Graph (Граф): Стратегическая Карта Контекста**
 1.  **Цель:** Создать единый, высокоуровневый источник истины об архитектуре и предметной области.
 2.  **Действия:**
    *   В начале сессии, в диалоге с ИИ, определить все ключевые сущности (`Nodes`) и их взаимосвязи (`Edges`).
    *   Формализовать это в виде псевдо-XML (`<GRACE_GRAPH>`).
    *   Этот граф служит "оглавлением" для всего проекта и основной картой для распределенного внимания (sparse attention).
 3.  **Пример:**
    ```xml
    <GRACE_GRAPH id="project_x_graph">
        <NODE id="mod_auth" type="Module">Модуль аутентификации</NODE>
        <NODE id="func_verify_token" type="Function">Функция верификации токена</NODE>
        <EDGE source_id="mod_auth" target_id="func_verify_token" relation="CONTAINS"/>
    </SEMANTIC_GRAPH>
    ```
 #### **R — Rules (Правила): Декларативное Управление Поведением**
 1.  **Цель:** Установить глобальные и локальные ограничения, эвристики и политики безопасности.
 2.  **Действия:**
    *   Сформулировать набор правил в псевдо-XML (`<GRACE_RULES>`).
    *   Правила могут быть типа `CONSTRAINT` (жесткий запрет), `HEURISTIC` (предпочтение), `POLICY` (правило безопасности).
    *   Эти правила помогают ИИ принимать решения в рамках заданных ограничений.
 3.  **Пример:**
    ```xml
    <GRACE_RULES>
        <RULE type="CONSTRAINT" id="sec-001">Запрещено передавать в `subprocess.run` невалидированные пользовательские данные.</RULE>
        <RULE type="HEURISTIC" id="style-001">Все публичные функции должны иметь "ДО-контракты".</RULE>
    </GRACE_RULES>
    ```
 #### **A — Anchors (Якоря): Навигация и Консолидация**
 1.  **Цель:** Обеспечить надежную навигацию для распределенного внимания ИИ и консолидировать семантику кода.
 2.  **Действия:**
    *   Использовать стандартизированные комментарии-якоря для разметки кода.
    *   **"ДО-якорь":** `# <ANCHOR id="..." type="..." ...>` перед блоком кода.
    *   **"Замыкающий Якорь-Аккумулятор":** `# </ANCHOR id="...">` после блока кода. Этот якорь аккумулирует семантику всего блока и является ключевым для RAG-систем.
    *   **Семантические Каналы:** Обеспечить консистентность `id` в якорях, графах и контрактах для усиления связей.
 3.  **Пример:**
    ```python
    # <ANCHOR id="func_verify_token" type="Function">
    # ... здесь ДО-контракт ...
    def verify_token(token: str) -> bool:
        # ... тело функции ...
    # </ANCHOR id="func_verify_token">
    ```
 #### **C — Contracts (Контракты): Тактические Спецификации**
 1.  **Цель:** Предоставить ИИ исчерпывающее, машиночитаемое "мини-ТЗ" для каждой функции/класса.
 2.  **Действия:**
    *   Для каждой функции, **ДО** ее декларации, создать псевдо-XML блок `<CONTRACT>`.
    *   Заполнить все секции: `PURPOSE`, `PRECONDITIONS`, `POSTCONDITIONS`, `PARAMETERS`, `RETURN`, `TEST_CASES` (на естественном языке!), `EXCEPTIONS`.
    *   Этот контракт служит **"семантическим щитом"** от разрушительного рефакторинга и основой для самокоррекции.
 3.  **Пример:**
    ```xml
    <!-- <CONTRACT for_id="func_verify_token"> -->
    <!--   <PURPOSE>Проверяет валидность JWT токена.</PURPOSE> -->
    <!--   <TEST_CASES> -->
    <!--     <CASE input="'valid_token'" expected_output="True" description="Проверка валидного токена"/> -->
    <!--   </TEST_CASES> -->
    <!-- </CONTRACT> -->
    ```
 #### **E — Evaluation (Оценка): Петля Обратной Связи**
 1.  **Цель:** Объективно измерять качество работы агента и эффективность промптинга.
 2.  **Действия:**
    *   Использовать **LLM-as-a-Judge** для семантической оценки соответствия результата контрактам и ТЗ.
    *   Вести **Протокол Оценки Сессии (ПОС)** с измеримыми метриками (см. ниже).
    *   Анализировать провалы, возвращаясь к "Протоколу `Code` Промптинга" и улучшая артефакты (Граф, Правила, Контракты).
 ### **Раздел III: Практические Протоколы**
 1.  **Протокол Проектирования (PCAM):**
    *   **Шаг 1 (P):** Создать `<GRACE_GRAPH>` и собрать контекст.
    *   **Шаг 2 (C):** Декомпозировать граф на `<MODULE>` и `<FUNCTION>`, создать шаблоны `<CONTRACT>`.
    *   **Шаг 3 (A):** Сгенерировать код с разметкой `<ANCHOR>`, следуя контрактам.
    *   **Шаг 4 (M):** Оценить результат с помощью ПОС и LLM-as-a-Judge. Итерировать при необходимости.
 2.  **Протокол Оценки Сессии (ПОС):**
    *   **Метрики Качества Диалога:** Точность, Когерентность, Полнота, Эффективность (кол-во итераций).
    *   **Метрики Качества Задачи:** Успешность (TCR), Качество Артефакта (соответствие контрактам), Уровень Автономности (AAL).
    *   **Метрики Промптинга:** Индекс "Семантического Казино", Чистота Протокола.
 3.  **Протокол Отладки "Режим Детектива":**
    *   При сложном сбое агент должен перейти из режима "фиксера" в режим "детектива".
    *   **Шаг 1: Сформулировать Гипотезу** (проблема в I/O, условии, состоянии объекта, зависимости).
    *   **Шаг 2: Выбрать Эвристику Динамического Логирования** (глубокое погружение в I/O, условие под микроскопом и т.д.).
    *   **Шаг 3: Запросить Запуск и Анализ Лога.**
    *   **Шаг 4: Итерировать** до нахождения причины.
 4.  **Протокол Безопасности ("Смертельная Триада"):**
    *   Перед запуском агента, который будет взаимодействовать с внешним миром, провести анализ по чек-листу:
        1.  Доступ к приватным данным? (Да/Нет)
        2.  Обработка недоверенного контента? (Да/Нет)
        3.  Внешняя коммуникация? (Да/Нет)
    *   **Если все три ответа "Да" — автономный режим ЗАПРЕЩЕН.** Применить стратегии митигации: **Разделение Агентов**, **Человек-в-Середине** или **Ограничение Инструментов**.
 ---
 Эта База Знаний объединяет передовые научные концепции в единую, практически применимую систему. Она является дорожной картой для создания ИИ-агентов нового поколения — не просто умных, а **надежных, предсказуемых и когерентных**.
--- a/agent_promts/shared/metrics_catalog.md
+++ b/agent_promts/shared/metrics_catalog.md
@@ -0,0 +1,44 @@
 # Каталог Метрик
 Централизованный каталог всех LLM-ориентированных метрик для анализа работы агентов.
 ### Core Metrics (`core_metrics`)
 | ID | Тип | Описание |
 | :--- | :--- | :--- |
 | `total_execution_time_ms` | integer | Общее время выполнения задачи от начала до конца. |
 | `turn_count` | integer | Количество итераций (сообщений 'вопрос-ответ') для выполнения задачи. |
 | `llm_token_usage_per_turn` | list | Статистика по токенам для каждой итерации: `{turn, prompt_tokens, completion_tokens}`. |
 | `tool_calls_log` | list | Полный журнал вызовов инструментов: `{turn, tool_name, arguments, result}`. |
 | `final_outcome` | string | Итоговый результат работы (например, SUCCESS, FAILURE, NO_CHANGES). |
 ### Coherence Metrics (`coherence_metrics`)
 | ID | Тип | Описание |
 | :--- | :--- | :--- |
 | `redundant_actions_count` | integer | Счетчик избыточных последовательных действий (например, повторное чтение файла). |
 | `self_correction_count` | integer | Счетчик явных самокоррекций агента. |
 ### Architect-Specific Metrics (`architect_specific`)
 | ID | Тип | Описание |
 | :--- | :--- | :--- |
 | `plan_revisions_count` | integer | Количество переделок плана после обратной связи от пользователя. |
 | `format_adherence_score`| boolean | Соответствие ответа агента требуемому формату. |
 ### Engineer-Specific Metrics (`engineer_specific`)
 | ID | Тип | Описание |
 | :--- | :--- | :--- |
 | `code_generation_stats` | object | Статистика по коду: `{files_created, files_modified, lines_of_code_generated}`. |
 | `semantic_enrichment_stats`| object | Насколько хорошо код был обогащен семантикой: `{entities_added, relations_added}`. |
 | `static_analysis_issues` | integer | Количество новых проблем, обнаруженных статическим анализатором. |
 | `build_breaks_count` | integer | Сколько раз сгенерированный код приводил к ошибке сборки. |
 ### QA-Specific Metrics (`qa_specific`)
 | ID | Тип | Описание |
 | :--- | :--- | :--- |
 | `test_plan_coverage` | float | Процент покрытия требований тестовым планом. |
 | `defects_found` | integer | Количество найденных дефектов. |
 | `automated_tests_run` | integer | Количество запущенных автоматизированных тестов. |
--- a/app/build.gradle.kts
+++ b/app/build.gradle.kts
@@ -4,6 +4,7 @@
 plugins {
    id("com.android.application")
    id("org.jetbrains.kotlin.android")
    id("org.jetbrains.kotlin.plugin.compose")
    id("com.google.dagger.hilt.android")
    id("kotlin-kapt")
 }
@@ -30,7 +31,7 @@ android {
            isMinifyEnabled = false
            proguardFiles(
                getDefaultProguardFile("proguard-android-optimize.txt"),
-                "proguard-rules.pro"
+                "proguard-rules.pro",
            )
        }
    }
@@ -45,9 +46,7 @@ android {
        compose = true
        buildConfig = true
    }
-    composeOptions {
+
        kotlinCompilerExtensionVersion = Versions.composeCompiler
    }
    packaging {
        resources {
            excludes += "/META-INF/{AL2.0,LGPL2.1}"
@@ -60,6 +59,18 @@ dependencies {
    implementation(project(":data"))
    // [MODULE_DEPENDENCY] Domain module (transitively included via data, but explicit for clarity)
    implementation(project(":domain"))
    implementation(project(":feature:scan"))
    implementation(project(":feature:dashboard"))
    implementation(project(":feature:inventorylist"))
    implementation(project(":feature:itemdetails"))
    implementation(project(":feature:itemedit"))
    implementation(project(":feature:labeledit"))
    implementation(project(":feature:labelslist"))
    implementation(project(":feature:locationedit"))
    implementation(project(":feature:locationslist"))
    implementation(project(":feature:search"))
    implementation(project(":feature:settings"))
    implementation(project(":feature:setup"))
    // [DEPENDENCY] AndroidX
    implementation(Libs.coreKtx)
@@ -67,18 +78,15 @@ dependencies {
    implementation(Libs.activityCompose)
    // [DEPENDENCY] Compose
-    implementation(platform(Libs.composeBom))
+
    implementation(Libs.composeUi)
    implementation(Libs.composeUiGraphics)
    implementation(Libs.composeUiToolingPreview)
    implementation(Libs.composeMaterial3)
-    implementation("androidx.compose.material:material-icons-extended-android:1.6.8")
+    implementation(Libs.composeMaterialIconsExtended)
    implementation(Libs.navigationCompose)
    implementation(Libs.hiltNavigationCompose)
    // [DEPENDENCY] DI (Hilt)
    implementation(Libs.hiltAndroid)
    kapt(Libs.hiltCompiler)
@@ -88,9 +96,13 @@ dependencies {
    // [DEPENDENCY] Testing
    testImplementation(Libs.junit)
    testImplementation(Libs.kotestRunnerJunit5)
    testImplementation(Libs.kotestAssertionsCore)
    testImplementation(Libs.mockk)
    testImplementation("app.cash.turbine:turbine:1.1.0")
    androidTestImplementation(Libs.extJunit)
    androidTestImplementation(Libs.espressoCore)
-    androidTestImplementation(platform(Libs.composeBom))
+
    androidTestImplementation(Libs.composeUiTestJunit4)
    debugImplementation(Libs.composeUiTooling)
    debugImplementation(Libs.composeUiTestManifest)
--- a/app/src/main/java/com/homebox/lens/MainActivity.kt
+++ b/app/src/main/java/com/homebox/lens/MainActivity.kt
@@ -1,8 +1,8 @@
-// [PACKAGE] com.homebox.lens
+// [FILE] app/src/main/java/com/homebox/lens/MainActivity.kt
-// [FILE] MainActivity.kt
+// [SEMANTICS] ui, activity, entrypoint
 package com.homebox.lens
 // [IMPORTS]
 import android.os.Bundle
 import androidx.activity.ComponentActivity
 import androidx.activity.compose.setContent
@@ -13,50 +13,80 @@ import androidx.compose.material3.Text
 import androidx.compose.runtime.Composable
 import androidx.compose.ui.Modifier
 import androidx.compose.ui.tooling.preview.Preview
-import com.homebox.lens.navigation.NavGraph
+import com.homebox.lens.feature.dashboard.ui.theme.HomeboxLensTheme
-import com.homebox.lens.ui.theme.HomeboxLensTheme
+import com.homebox.lens.feature.dashboard.navigation.navGraph
 import dagger.hilt.android.AndroidEntryPoint
 import timber.log.Timber
 // [END_IMPORTS]
 // [ENTITY: Activity('MainActivity')]
 // [CONTRACT]
 /**
- * [ENTITY: Activity('MainActivity')]
+ * @summary Главная и единственная Activity в приложении.
 * [PURPOSE] Главная и единственная Activity в приложении.
 */
 // [ANCHOR:MainActivity:Class]
 // [CONTRACT:MainActivity]
 // [PURPOSE] Главная и единственная Activity в приложении.
 // [END_CONTRACT:MainActivity]
@AndroidEntryPoint
 class MainActivity : ComponentActivity() {
-    // [LIFECYCLE]
+    // [ANCHOR:onCreate:Function]
    // [CONTRACT:onCreate]
    // [PURPOSE] Инициализация Activity.
    // [PARAM:savedInstanceState:Bundle?] Сохраненное состояние.
    // [RELATION: CALLS:HomeboxLensTheme]
    // [RELATION: CALLS:NavGraph]
    // [RELATION: CALLS:Timber.d]
    // [END_CONTRACT:onCreate]
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        Timber.d("[DEBUG][LIFECYCLE][creating_activity] MainActivity created.")
        setContent {
            HomeboxLensTheme {
                // A surface container using the 'background' color from the theme
                Surface(
                    modifier = Modifier.fillMaxSize(),
-                    color = MaterialTheme.colorScheme.background
+                    color = MaterialTheme.colorScheme.background,
                ) {
-                    NavGraph()
+                    navGraph()
                }
            }
        }
    }
    // [END_ANCHOR:onCreate]
 }
 // [END_ANCHOR:MainActivity]
-// [HELPER]
+// [ENTITY: Function('Greeting')]
 // [ANCHOR:greeting:Function]
 // [CONTRACT:greeting]
 // [PURPOSE] Отображает приветствие.
 // [PARAM:name:String] Имя для приветствия.
 // [PARAM:modifier:Modifier] Модификатор для элемента.
 // [END_CONTRACT:greeting]
@Composable
-fun Greeting(name: String, modifier: Modifier = Modifier) {
+fun greeting(
    name: String,
    modifier: Modifier = Modifier,
 ) {
    Text(
        text = "Hello $name!",
-        modifier = modifier
+        modifier = modifier,
    )
 }
 // [END_ANCHOR:greeting]
-// [PREVIEW]
+// [ENTITY: Function('GreetingPreview')]
 // [ANCHOR:greetingPreview:Function]
 // [CONTRACT:greetingPreview]
 // [PURPOSE] Предварительный просмотр функции greeting.
 // [END_CONTRACT:greetingPreview]
@Preview(showBackground = true)
@Composable
-fun GreetingPreview() {
+fun greetingPreview() {
    HomeboxLensTheme {
-        Greeting("Android")
+        greeting("Android")
    }
 }
-
+// [END_ANCHOR:greetingPreview]
-// [END_FILE_MainActivity.kt]
+// [END_FILE_app/src/main/java/com/homebox/lens/MainActivity.kt]
 // [END_FILE_app/src/main/java/com/homebox/lens/MainActivity.kt]
--- a/app/src/main/java/com/homebox/lens/MainApplication.kt
+++ b/app/src/main/java/com/homebox/lens/MainApplication.kt
@@ -1,28 +1,30 @@
 // [PACKAGE] com.homebox.lens
 // [FILE] MainApplication.kt
-
+// [SEMANTICS] application, hilt, timber
 package com.homebox.lens
 // [IMPORTS]
 import android.app.Application
 import com.homebox.lens.BuildConfig
 import dagger.hilt.android.HiltAndroidApp
 import timber.log.Timber
 // [END_IMPORTS]
 // [ENTITY: Application('MainApplication')]
 // [CONTRACT]
 /**
- * [ENTITY: Application('MainApplication')]
+ * @summary Точка входа в приложение. Инициализирует Hilt и Timber.
 * [PURPOSE] Точка входа в приложение. Инициализирует Hilt и Timber.
 */
@HiltAndroidApp
 class MainApplication : Application() {
-    // [LIFECYCLE]
+    // [ENTITY: Function('onCreate')]
    override fun onCreate() {
        super.onCreate()
        // [ACTION] Initialize Timber for logging
        if (BuildConfig.DEBUG) {
            Timber.plant(Timber.DebugTree())
            Timber.d("[DEBUG][INITIALIZATION][timber_planted] Timber DebugTree planted.")
        }
    }
    // [END_ENTITY: Function('onCreate')]
 }
-
+// [END_ENTITY: Application('MainApplication')]
 // [END_FILE_MainApplication.kt]
--- a/app/src/main/java/com/homebox/lens/navigation/NavGraph.kt
+++ b/app/src/main/java/com/homebox/lens/navigation/NavGraph.kt
@@ -1,124 +0,0 @@
 // [PACKAGE] com.homebox.lens.navigation
 // [FILE] NavGraph.kt
 // [SEMANTICS] navigation, compose, nav_host
 package com.homebox.lens.navigation
 // [IMPORTS]
 import androidx.compose.runtime.Composable
 import androidx.compose.runtime.getValue
 import androidx.compose.runtime.remember
 import androidx.navigation.NavHostController
 import androidx.navigation.compose.NavHost
 import androidx.navigation.compose.composable
 import androidx.navigation.compose.currentBackStackEntryAsState
 import androidx.navigation.compose.rememberNavController
 import com.homebox.lens.ui.screen.dashboard.DashboardScreen
 import com.homebox.lens.ui.screen.inventorylist.InventoryListScreen
 import com.homebox.lens.ui.screen.itemdetails.ItemDetailsScreen
 import com.homebox.lens.ui.screen.itemedit.ItemEditScreen
 import com.homebox.lens.ui.screen.labelslist.LabelsListScreen
 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
 // [CORE-LOGIC]
 /**
 * [CONTRACT]
 * Определяет граф навигации для всего приложения с использованием Jetpack Compose Navigation.
 * @param navController Контроллер навигации.
 * @see Screen
 * @sideeffect Регистрирует все экраны и управляет состоянием навигации.
 * @invariant Стартовый экран - `Screen.Setup`.
 */
@Composable
 fun NavGraph(
    navController: NavHostController = rememberNavController()
 ) {
    // [STATE]
    val navBackStackEntry by navController.currentBackStackEntryAsState()
    val currentRoute = navBackStackEntry?.destination?.route
    // [HELPER]
    val navigationActions = remember(navController) {
        NavigationActions(navController)
    }
    // [ACTION]
    NavHost(
        navController = navController,
        startDestination = Screen.Setup.route
    ) {
        // [COMPOSABLE_SETUP]
        composable(route = Screen.Setup.route) {
            SetupScreen(onSetupComplete = {
                navController.navigate(Screen.Dashboard.route) {
                    popUpTo(Screen.Setup.route) { inclusive = true }
                }
            })
        }
        // [COMPOSABLE_DASHBOARD]
        composable(route = Screen.Dashboard.route) {
            DashboardScreen(
                currentRoute = currentRoute,
                navigationActions = navigationActions
            )
        }
        // [COMPOSABLE_INVENTORY_LIST]
        composable(route = Screen.InventoryList.route) {
            InventoryListScreen(
                currentRoute = currentRoute,
                navigationActions = navigationActions
            )
        }
        // [COMPOSABLE_ITEM_DETAILS]
        composable(route = Screen.ItemDetails.route) {
            ItemDetailsScreen(
                currentRoute = currentRoute,
                navigationActions = navigationActions
            )
        }
        // [COMPOSABLE_ITEM_EDIT]
        composable(route = Screen.ItemEdit.route) {
            ItemEditScreen(
                currentRoute = currentRoute,
                navigationActions = navigationActions
            )
        }
        // [COMPOSABLE_LABELS_LIST]
        composable(Screen.LabelsList.route) {
            LabelsListScreen(navController = navController)
        }
        // [COMPOSABLE_LOCATIONS_LIST]
        composable(route = Screen.LocationsList.route) {
            LocationsListScreen(
                currentRoute = currentRoute,
                navigationActions = navigationActions,
                onLocationClick = { locationId ->
                    // TODO: Navigate to a pre-filtered inventory list screen
                    navController.navigate(Screen.InventoryList.route)
                },
                onAddNewLocationClick = {
                    navController.navigate(Screen.LocationEdit.createRoute("new"))
                }
            )
        }
        // [COMPOSABLE_LOCATION_EDIT]
        composable(route = Screen.LocationEdit.route) { backStackEntry ->
            val locationId = backStackEntry.arguments?.getString("locationId")
            LocationEditScreen(
                locationId = locationId
            )
        }
        // [COMPOSABLE_SEARCH]
        composable(route = Screen.Search.route) {
            SearchScreen(
                currentRoute = currentRoute,
                navigationActions = navigationActions
            )
        }
    }
    // [END_FUNCTION_NavGraph]
 }
 // [END_FILE_NavGraph.kt]
--- a/app/src/main/java/com/homebox/lens/navigation/NavigationActions.kt
+++ b/app/src/main/java/com/homebox/lens/navigation/NavigationActions.kt
@@ -1,71 +0,0 @@
 // [PACKAGE] com.homebox.lens.navigation
 // [FILE] NavigationActions.kt
 // [SEMANTICS] navigation, controller, actions
 package com.homebox.lens.navigation
 import androidx.navigation.NavHostController
 // [CORE-LOGIC]
 /**
 [CONTRACT]
@summary Класс-обертка над NavHostController для предоставления типизированных навигационных действий.
@param navController Контроллер Jetpack Navigation.
@invariant Все навигационные действия должны использовать предоставленный navController.
 */
 class NavigationActions(private val navController: NavHostController) {
 // [ACTION]
    /**
    [CONTRACT]
    @summary Навигация на главный экран.
    @sideeffect Очищает back stack до главного экрана, чтобы избежать циклов.
     */
    fun navigateToDashboard() {
        navController.navigate(Screen.Dashboard.route) {
 // Используем popUpTo для удаления всех экранов до dashboard из back stack
 // Это предотвращает создание большой стопки экранов при навигации через drawer
            popUpTo(navController.graph.startDestinationId)
            launchSingleTop = true
        }
    }
    // [ACTION]
    fun navigateToLocations() {
        navController.navigate(Screen.LocationsList.route) {
            launchSingleTop = true
        }
    }
    // [ACTION]
    fun navigateToLabels() {
        navController.navigate(Screen.LabelsList.route) {
            launchSingleTop = true
        }
    }
    // [ACTION]
    fun navigateToSearch() {
        navController.navigate(Screen.Search.route) {
            launchSingleTop = true
        }
    }
    // [ACTION]
    fun navigateToInventoryListWithLabel(labelId: String) {
        val route = Screen.InventoryList.withFilter("label", labelId)
        navController.navigate(route)
    }
    // [ACTION]
    fun navigateToInventoryListWithLocation(locationId: String) {
        val route = Screen.InventoryList.withFilter("location", locationId)
        navController.navigate(route)
    }
    // [ACTION]
    fun navigateToCreateItem() {
        navController.navigate(Screen.ItemEdit.createRoute("new"))
    }
    // [ACTION]
    fun navigateToLogout() {
        navController.navigate(Screen.Setup.route) {
            popUpTo(Screen.Dashboard.route) { inclusive = true }
        }
    }
    // [ACTION]
    fun navigateBack() {
        navController.popBackStack()
    }
 }
 // [END_FILE_NavigationActions.kt]
--- a/app/src/main/java/com/homebox/lens/navigation/Screen.kt
+++ b/app/src/main/java/com/homebox/lens/navigation/Screen.kt
@@ -1,101 +0,0 @@
 // [PACKAGE] com.homebox.lens.navigation
 // [FILE] Screen.kt
 // [SEMANTICS] navigation, routes, sealed_class
 package com.homebox.lens.navigation
 // [CORE-LOGIC]
 /**
 * [CONTRACT]
 * Запечатанный класс для определения маршрутов навигации в приложении.
 * Обеспечивает типобезопасность при навигации.
 * @property route Строковый идентификатор маршрута.
 */
 sealed class Screen(val route: String) {
    // [STATE]
    data object Setup : Screen("setup_screen")
    data object Dashboard : Screen("dashboard_screen")
    data object InventoryList : Screen("inventory_list_screen") {
        /**
         * [CONTRACT]
         * Создает маршрут для экрана списка инвентаря с параметром фильтра.
         * @param key Ключ фильтра (например, "label" или "location").
         * @param value Значение фильтра (например, ID метки или местоположения).
         * @return Строку полного маршрута с query-параметром.
         * @throws IllegalArgumentException если ключ или значение пустые.
         * @sideeffect [ARCH-IMPLICATION] NavGraph должен быть настроен для приема этого опционального query-параметра (например, 'navArgument("label") { nullable = true }').
         */
        // [HELPER]
        fun withFilter(key: String, value: String): String {
            // [PRECONDITION]
            require(key.isNotBlank()) { "[PRECONDITION_FAILED] Filter key cannot be blank." }
            require(value.isNotBlank()) { "[PRECONDITION_FAILED] Filter value cannot be blank." }
            // [ACTION]
            val constructedRoute = "inventory_list_screen?$key=$value"
            // [POSTCONDITION]
            check(constructedRoute.contains("?$key=$value")) { "[POSTCONDITION_FAILED] Route must contain the filter query." }
            return constructedRoute
        }
    }
    data object ItemDetails : Screen("item_details_screen/{itemId}") {
        /**
         * [CONTRACT]
         * Создает маршрут для экрана деталей элемента с указанным ID.
         * @param itemId ID элемента для отображения.
         * @return Строку полного маршрута.
         * @throws IllegalArgumentException если itemId пустой.
         */
        // [HELPER]
        fun createRoute(itemId: String): String {
            // [PRECONDITION]
            require(itemId.isNotBlank()) { "[PRECONDITION_FAILED] itemId не может быть пустым." }
            // [ACTION]
            val route = "item_details_screen/$itemId"
            // [POSTCONDITION]
            check(route.endsWith(itemId)) { "[POSTCONDITION_FAILED] Маршрут должен заканчиваться на itemId." }
            return route
        }
    }
    data object ItemEdit : Screen("item_edit_screen/{itemId}") {
        /**
         * [CONTRACT]
         * Создает маршрут для экрана редактирования элемента с указанным ID.
         * @param itemId ID элемента для редактирования.
         * @return Строку полного маршрута.
         * @throws IllegalArgumentException если itemId пустой.
         */
        // [HELPER]
        fun createRoute(itemId: String): String {
            // [PRECONDITION]
            require(itemId.isNotBlank()) { "[PRECONDITION_FAILED] itemId не может быть пустым." }
            // [ACTION]
            val route = "item_edit_screen/$itemId"
            // [POSTCONDITION]
            check(route.endsWith(itemId)) { "[POSTCONDITION_FAILED] Маршрут должен заканчиваться на itemId." }
            return route
        }
    }
    data object LabelsList : Screen("labels_list_screen")
    data object LocationsList : Screen("locations_list_screen")
    data object LocationEdit : Screen("location_edit_screen/{locationId}") {
        /**
         * [CONTRACT]
         * Создает маршрут для экрана редактирования местоположения с указанным ID.
         * @param locationId ID местоположения для редактирования.
         * @return Строку полного маршрута.
         * @throws IllegalArgumentException если locationId пустой.
         */
        // [HELPER]
        fun createRoute(locationId: String): String {
            // [PRECONDITION]
            require(locationId.isNotBlank()) { "[PRECONDITION_FAILED] locationId не может быть пустым." }
            // [ACTION]
            val route = "location_edit_screen/$locationId"
            // [POSTCONDITION]
            check(route.endsWith(locationId)) { "[POSTCONDITION_FAILED] Маршрут должен заканчиваться на locationId." }
            return route
        }
    }
    data object Search : Screen("search_screen")
 }
 // [END_FILE_Screen.kt]
--- a/app/src/main/java/com/homebox/lens/ui/common/AppDrawer.kt
+++ b/app/src/main/java/com/homebox/lens/ui/common/AppDrawer.kt
@@ -1,98 +0,0 @@
 // [PACKAGE] com.homebox.lens.ui.common
 // [FILE] AppDrawer.kt
 package com.homebox.lens.ui.common
 import androidx.compose.foundation.layout.Spacer
 import androidx.compose.foundation.layout.fillMaxWidth
 import androidx.compose.foundation.layout.height
 import androidx.compose.foundation.layout.padding
 import androidx.compose.foundation.layout.size
 import androidx.compose.foundation.layout.width
 import androidx.compose.material.icons.Icons
 import androidx.compose.material.icons.filled.Add
 import androidx.compose.material3.Button
 import androidx.compose.material3.Divider
 import androidx.compose.material3.Icon
 import androidx.compose.material3.ModalDrawerSheet
 import androidx.compose.material3.NavigationDrawerItem
 import androidx.compose.material3.Text
 import androidx.compose.runtime.Composable
 import androidx.compose.ui.Modifier
 import androidx.compose.ui.res.stringResource
 import androidx.compose.ui.unit.dp
 import com.homebox.lens.R
 import com.homebox.lens.navigation.NavigationActions
 import com.homebox.lens.navigation.Screen
 /**
 [CONTRACT]
@summary Контент для бокового навигационного меню (Drawer).
@param currentRoute Текущий маршрут для подсветки активного элемента.
@param navigationActions Объект с навигационными действиями.
@param onCloseDrawer Лямбда для закрытия бокового меню.
 */
@Composable
 internal fun AppDrawerContent(
    currentRoute: String?,
    navigationActions: NavigationActions,
    onCloseDrawer: () -> Unit
 ) {
    ModalDrawerSheet {
        Spacer(Modifier.height(12.dp))
        Button(
            onClick = {
                navigationActions.navigateToCreateItem()
                onCloseDrawer()
            },
            modifier = Modifier
                .fillMaxWidth()
                .padding(horizontal = 16.dp)
        ) {
            Icon(Icons.Default.Add, contentDescription = null, modifier = Modifier.size(18.dp))
            Spacer(Modifier.width(8.dp))
            Text(stringResource(id = R.string.create))
        }
        Spacer(Modifier.height(12.dp))
        Divider()
        NavigationDrawerItem(
            label = { Text(stringResource(id = R.string.dashboard_title)) },
            selected = currentRoute == Screen.Dashboard.route,
            onClick = {
                navigationActions.navigateToDashboard()
                onCloseDrawer()
            }
        )
        NavigationDrawerItem(
            label = { Text(stringResource(id = R.string.nav_locations)) },
            selected = currentRoute == Screen.LocationsList.route,
            onClick = {
                navigationActions.navigateToLocations()
                onCloseDrawer()
            }
        )
        NavigationDrawerItem(
            label = { Text(stringResource(id = R.string.nav_labels)) },
            selected = currentRoute == Screen.LabelsList.route,
            onClick = {
                navigationActions.navigateToLabels()
                onCloseDrawer()
            }
        )
        NavigationDrawerItem(
            label = { Text(stringResource(id = R.string.search)) },
            selected = currentRoute == Screen.Search.route,
            onClick = {
                navigationActions.navigateToSearch()
                onCloseDrawer()
            }
        )
 // TODO: Add Profile and Tools items
        Divider()
        NavigationDrawerItem(
            label = { Text(stringResource(id = R.string.logout)) },
            selected = false,
            onClick = {
                navigationActions.navigateToLogout()
                onCloseDrawer()
            }
        )
    }
 }
--- a/app/src/main/java/com/homebox/lens/ui/common/MainScaffold.kt
+++ b/app/src/main/java/com/homebox/lens/ui/common/MainScaffold.kt
@@ -1,77 +0,0 @@
 // [PACKAGE] com.homebox.lens.ui.common
 // [FILE] MainScaffold.kt
 // [SEMANTICS] ui, common, scaffold, navigation_drawer
 package com.homebox.lens.ui.common
 // [IMPORTS]
 import androidx.compose.foundation.layout.PaddingValues
 import androidx.compose.material.icons.Icons
 import androidx.compose.material.icons.filled.Menu
 import androidx.compose.material3.*
 import androidx.compose.runtime.Composable
 import androidx.compose.runtime.rememberCoroutineScope
 import androidx.compose.ui.res.stringResource
 import com.homebox.lens.R
 import com.homebox.lens.navigation.NavigationActions
 import kotlinx.coroutines.launch
 // [UI_COMPONENT]
 /**
 * [CONTRACT]
 * @summary Общая обертка для экранов, включающая Scaffold и Navigation Drawer.
 * @param topBarTitle Заголовок для TopAppBar.
 * @param currentRoute Текущий маршрут для подсветки активного элемента в Drawer.
 * @param navigationActions Объект с навигационными действиями.
 * @param topBarActions Composable-функция для отображения действий (иконок) в TopAppBar.
 * @param content Основное содержимое экрана, которое будет отображено внутри Scaffold.
 * @sideeffect Управляет состоянием (открыто/закрыто) бокового меню (ModalNavigationDrawer).
 * @invariant TopAppBar всегда отображается с иконкой меню.
 */
@OptIn(ExperimentalMaterial3Api::class)
@Composable
 fun MainScaffold(
    topBarTitle: String,
    currentRoute: String?,
    navigationActions: NavigationActions,
    topBarActions: @Composable () -> Unit = {},
    content: @Composable (PaddingValues) -> Unit
 ) {
    // [STATE]
    val drawerState = rememberDrawerState(initialValue = DrawerValue.Closed)
    val scope = rememberCoroutineScope()
    // [CORE-LOGIC]
    ModalNavigationDrawer(
        drawerState = drawerState,
        drawerContent = {
            AppDrawerContent(
                currentRoute = currentRoute,
                navigationActions = navigationActions,
                onCloseDrawer = { scope.launch { drawerState.close() } }
            )
        }
    ) {
        Scaffold(
            topBar = {
                TopAppBar(
                    title = { Text(topBarTitle) },
                    navigationIcon = {
                        IconButton(onClick = { scope.launch { drawerState.open() } }) {
                            Icon(
                                Icons.Default.Menu,
                                contentDescription = stringResource(id = R.string.cd_open_navigation_drawer)
                            )
                        }
                    },
                    actions = { topBarActions() }
                )
            }
        ) { paddingValues ->
            // [ACTION]
            content(paddingValues)
        }
    }
    // [END_FUNCTION_MainScaffold]
 }
 // [END_FILE_MainScaffold.kt]
--- a/app/src/main/java/com/homebox/lens/ui/screen/dashboard/DashboardScreen.kt
+++ b/app/src/main/java/com/homebox/lens/ui/screen/dashboard/DashboardScreen.kt
@@ -1,337 +0,0 @@
 // [PACKAGE] com.homebox.lens.ui.screen.dashboard
 // [FILE] DashboardScreen.kt
 // [SEMANTICS] ui, screen, dashboard, compose, navigation
 package com.homebox.lens.ui.screen.dashboard
 // [IMPORTS]
 import androidx.compose.foundation.background
 import androidx.compose.foundation.layout.*
 import androidx.compose.foundation.lazy.LazyColumn
 import androidx.compose.foundation.lazy.LazyRow
 import androidx.compose.foundation.lazy.grid.GridCells
 import androidx.compose.foundation.lazy.grid.LazyVerticalGrid
 import androidx.compose.foundation.lazy.items
 import androidx.compose.material.icons.Icons
 import androidx.compose.material.icons.filled.Search
 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.stringResource
 import androidx.compose.ui.text.style.TextAlign
 import androidx.compose.ui.tooling.preview.Preview
 import androidx.compose.ui.unit.dp
 import androidx.hilt.navigation.compose.hiltViewModel
 import com.homebox.lens.R
 import com.homebox.lens.domain.model.*
 import com.homebox.lens.navigation.NavigationActions
 import com.homebox.lens.ui.common.MainScaffold
 import com.homebox.lens.ui.theme.HomeboxLensTheme
 import timber.log.Timber
 // [ENTRYPOINT]
 /**
 [CONTRACT]
@summary Главная Composable-функция для экрана "Панель управления".
@param viewModel ViewModel для этого экрана, предоставляется через Hilt.
@param currentRoute Текущий маршрут для подсветки активного элемента в Drawer.
@param navigationActions Объект с навигационными действиями.
@sideeffect Вызывает навигационные лямбды при взаимодействии с UI.
 */
@Composable
 fun DashboardScreen(
    viewModel: DashboardViewModel = hiltViewModel(),
    currentRoute: String?,
    navigationActions: NavigationActions
 ) {
 // [STATE]
    val uiState by viewModel.uiState.collectAsState()
 // [UI_COMPONENT]
    MainScaffold(
        topBarTitle = stringResource(id = R.string.dashboard_title),
        currentRoute = currentRoute,
        navigationActions = navigationActions,
        topBarActions = {
            IconButton(onClick = { navigationActions.navigateToSearch() }) {
                Icon(
                    Icons.Default.Search,
                    contentDescription = stringResource(id = R.string.cd_scan_qr_code) // TODO: Rename string resource
                )
            }
        }
    ) { paddingValues ->
        DashboardContent(
            modifier = Modifier.padding(paddingValues),
            uiState = uiState,
            onLocationClick = { location ->
                Timber.i("[ACTION] Location chip clicked: ${location.id}. Navigating...")
                navigationActions.navigateToInventoryListWithLocation(location.id)
            },
            onLabelClick = { label ->
                Timber.i("[ACTION] Label chip clicked: ${label.id}. Navigating...")
                navigationActions.navigateToInventoryListWithLabel(label.id)
            }
        )
    }
 // [END_FUNCTION_DashboardScreen]
 }
 // [HELPER]
 /**
 [CONTRACT]
@summary Отображает основной контент экрана в зависимости от uiState.
@param modifier Модификатор для стилизации.
@param uiState Текущее состояние UI экрана.
@param onLocationClick Лямбда-обработчик нажатия на местоположение.
@param onLabelClick Лямбда-обработчик нажатия на метку.
 */
@Composable
 private fun DashboardContent(
    modifier: Modifier = Modifier,
    uiState: DashboardUiState,
    onLocationClick: (LocationOutCount) -> Unit,
    onLabelClick: (LabelOut) -> Unit
 ) {
 // [CORE-LOGIC]
    when (uiState) {
        is DashboardUiState.Loading -> {
            Box(modifier = Modifier.fillMaxSize(), contentAlignment = Alignment.Center) {
                CircularProgressIndicator()
            }
        }
        is DashboardUiState.Error -> {
            Box(modifier = Modifier.fillMaxSize().padding(16.dp), contentAlignment = Alignment.Center) {
                Text(
                    text = uiState.message,
                    color = MaterialTheme.colorScheme.error,
                    textAlign = TextAlign.Center
                )
            }
        }
        is DashboardUiState.Success -> {
            LazyColumn(
                modifier = modifier
                    .fillMaxSize()
                    .padding(horizontal = 16.dp),
                verticalArrangement = Arrangement.spacedBy(24.dp)
            ) {
                item { Spacer(modifier = Modifier.height(8.dp)) }
                item { StatisticsSection(statistics = uiState.statistics) }
                item { RecentlyAddedSection(items = uiState.recentlyAddedItems) }
                item { LocationsSection(locations = uiState.locations, onLocationClick = onLocationClick) }
                item { LabelsSection(labels = uiState.labels, onLabelClick = onLabelClick) }
                item { Spacer(modifier = Modifier.height(16.dp)) }
            }
        }
    }
 // [END_FUNCTION_DashboardContent]
 }
 // [UI_COMPONENT]
 /**
 [CONTRACT]
@summary Секция для отображения общей статистики.
@param statistics Объект со статистическими данными.
 */
@Composable
 private fun StatisticsSection(statistics: GroupStatistics) {
    Column(verticalArrangement = Arrangement.spacedBy(8.dp)) {
        Text(
            text = stringResource(id = R.string.dashboard_section_quick_stats),
            style = MaterialTheme.typography.titleMedium
        )
        Card {
            LazyVerticalGrid(
                columns = GridCells.Fixed(2),
                modifier = Modifier
                    .height(120.dp)
                    .fillMaxWidth()
                    .padding(16.dp),
                horizontalArrangement = Arrangement.spacedBy(16.dp),
                verticalArrangement = Arrangement.spacedBy(16.dp)
            ) {
                item { StatisticCard(title = stringResource(id = R.string.dashboard_stat_total_items), value = statistics.items.toString()) }
                item { StatisticCard(title = stringResource(id = R.string.dashboard_stat_total_value), value = statistics.totalValue.toString()) }
                item { StatisticCard(title = stringResource(id = R.string.dashboard_stat_total_labels), value = statistics.labels.toString()) }
                item { StatisticCard(title = stringResource(id = R.string.dashboard_stat_total_locations), value = statistics.locations.toString()) }
            }
        }
    }
 }
 // [UI_COMPONENT]
 /**
 [CONTRACT]
@summary Карточка для отображения одного статистического показателя.
@param title Название показателя.
@param value Значение показателя.
 */
@Composable
 private fun StatisticCard(title: String, value: String) {
    Column(horizontalAlignment = Alignment.CenterHorizontally, verticalArrangement = Arrangement.Center) {
        Text(text = title, style = MaterialTheme.typography.labelMedium, textAlign = TextAlign.Center)
        Text(text = value, style = MaterialTheme.typography.headlineSmall, textAlign = TextAlign.Center)
    }
 }
 // [UI_COMPONENT]
 /**
 [CONTRACT]
@summary Секция для отображения недавно добавленных элементов.
@param items Список элементов для отображения.
 */
@Composable
 private fun RecentlyAddedSection(items: List<ItemSummary>) {
    Column(verticalArrangement = Arrangement.spacedBy(8.dp)) {
        Text(
            text = stringResource(id = R.string.dashboard_section_recently_added),
            style = MaterialTheme.typography.titleMedium
        )
        if (items.isEmpty()) {
            Text(
                text = stringResource(id = R.string.items_not_found),
                style = MaterialTheme.typography.bodyMedium,
                modifier = Modifier
                    .fillMaxWidth()
                    .padding(vertical = 16.dp),
                textAlign = TextAlign.Center
            )
        } else {
            LazyRow(horizontalArrangement = Arrangement.spacedBy(16.dp)) {
                items(items) { item ->
                    ItemCard(item = item)
                }
            }
        }
    }
 }
 // [UI_COMPONENT]
 /**
 [CONTRACT]
@summary Карточка для отображения краткой информации об элементе.
@param item Элемент для отображения.
 */
@Composable
 private fun ItemCard(item: ItemSummary) {
    Card(modifier = Modifier.width(150.dp)) {
        Column(modifier = Modifier.padding(8.dp)) {
 // TODO: Add image here from item.image
            Spacer(modifier = Modifier
                .height(80.dp)
                .fillMaxWidth()
                .background(MaterialTheme.colorScheme.secondaryContainer))
            Spacer(modifier = Modifier.height(8.dp))
            Text(text = item.name, style = MaterialTheme.typography.titleSmall, maxLines = 1)
            Text(text = item.location?.name ?: stringResource(id = R.string.no_location), style = MaterialTheme.typography.bodySmall, maxLines = 1)
        }
    }
 }
 // [UI_COMPONENT]
 /**
 [CONTRACT]
@summary Секция для отображения местоположений в виде чипсов.
@param locations Список местоположений.
@param onLocationClick Лямбда-обработчик нажатия на местоположение.
 */
@OptIn(ExperimentalLayoutApi::class)
@Composable
 private fun LocationsSection(locations: List<LocationOutCount>, onLocationClick: (LocationOutCount) -> Unit) {
    Column(verticalArrangement = Arrangement.spacedBy(8.dp)) {
        Text(
            text = stringResource(id = R.string.dashboard_section_locations),
            style = MaterialTheme.typography.titleMedium
        )
        FlowRow(
            horizontalArrangement = Arrangement.spacedBy(8.dp),
        ) {
            locations.forEach { location ->
                SuggestionChip(
                    onClick = { onLocationClick(location) },
                    label = { Text(stringResource(id = R.string.location_chip_label, location.name, location.itemCount)) }
                )
            }
        }
    }
 }
 // [UI_COMPONENT]
 /**
 [CONTRACT]
@summary Секция для отображения меток в виде чипсов.
@param labels Список меток.
@param onLabelClick Лямбда-обработчик нажатия на метку.
 */
@OptIn(ExperimentalLayoutApi::class)
@Composable
 private fun LabelsSection(labels: List<LabelOut>, onLabelClick: (LabelOut) -> Unit) {
    Column(verticalArrangement = Arrangement.spacedBy(8.dp)) {
        Text(
            text = stringResource(id = R.string.dashboard_section_labels),
            style = MaterialTheme.typography.titleMedium
        )
        FlowRow(
            horizontalArrangement = Arrangement.spacedBy(8.dp),
        ) {
            labels.forEach { label ->
                SuggestionChip(
                    onClick = { onLabelClick(label) },
                    label = { Text(label.name) }
                )
            }
        }
    }
 }
 // [PREVIEW]
@Preview(showBackground = true, name = "Dashboard Success State")
@Composable
 fun DashboardContentSuccessPreview() {
    val previewState = DashboardUiState.Success(
        statistics = GroupStatistics(
            items = 123,
            totalValue = 9999.99,
            locations = 5,
            labels = 8
        ),
        locations = listOf(
            LocationOutCount(id="1", name="Office", color = "#FF0000", isArchived = false, itemCount = 10, createdAt = "", updatedAt = ""),
            LocationOutCount(id="2", name="Garage", color = "#00FF00", isArchived = false, itemCount = 5, createdAt = "", updatedAt = ""),
            LocationOutCount(id="3",name="Living Room", color = "#0000FF", isArchived = false, itemCount = 15, createdAt = "", updatedAt = ""),
            LocationOutCount(id="4",name="Kitchen", color = "#FFFF00", isArchived = false, itemCount = 20, createdAt = "", updatedAt = ""),
            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 = "")
        ),
        recentlyAddedItems = emptyList()
    )
    HomeboxLensTheme {
        DashboardContent(
            uiState = previewState,
            onLocationClick = {},
            onLabelClick = {}
        )
    }
 }
 // [PREVIEW]
@Preview(showBackground = true, name = "Dashboard Loading State")
@Composable
 fun DashboardContentLoadingPreview() {
    HomeboxLensTheme {
        DashboardContent(
            uiState = DashboardUiState.Loading,
            onLocationClick = {},
            onLabelClick = {}
        )
    }
 }
 // [PREVIEW]
@Preview(showBackground = true, name = "Dashboard Error State")
@Composable
 fun DashboardContentErrorPreview() {
    HomeboxLensTheme {
        DashboardContent(
            uiState = DashboardUiState.Error(stringResource(id = R.string.error_loading_failed)),
            onLocationClick = {},
            onLabelClick = {}
        )
    }
 }
 // [END_FILE_DashboardScreen.kt]
--- a/app/src/main/java/com/homebox/lens/ui/screen/dashboard/DashboardUiState.kt
+++ b/app/src/main/java/com/homebox/lens/ui/screen/dashboard/DashboardUiState.kt
@@ -1,48 +0,0 @@
 // [PACKAGE] com.homebox.lens.ui.screen.dashboard
 // [FILE] app/src/main/java/com/homebox/lens/ui/screen/dashboard/DashboardUiState.kt
 // [SEMANTICS] ui, state, dashboard
 // [IMPORTS]
 package com.homebox.lens.ui.screen.dashboard
 import com.homebox.lens.domain.model.GroupStatistics
 import com.homebox.lens.domain.model.LabelOut
 import com.homebox.lens.domain.model.LocationOutCount
 // [CORE-LOGIC]
 // [ENTITY: SealedInterface('DashboardUiState')]
 /**
 * [CONTRACT]
 * Определяет все возможные состояния для экрана "Дэшборд".
 * @invariant В любой момент времени экран может находиться только в одном из этих состояний.
 */
 sealed interface DashboardUiState {
    /**
     * [CONTRACT]
     * Состояние успешной загрузки данных.
     * @property statistics Статистика по инвентарю.
     * @property locations Список локаций со счетчиками.
     * @property labels Список всех меток.
     * @property recentlyAddedItems Список недавно добавленных товаров.
     */
    data class Success(
        val statistics: GroupStatistics,
        val locations: List<LocationOutCount>,
        val labels: List<LabelOut>,
        val recentlyAddedItems: List<com.homebox.lens.domain.model.ItemSummary>
    ) : DashboardUiState
    /**
     * [CONTRACT]
     * Состояние ошибки во время загрузки данных.
     * @property message Человекочитаемое сообщение об ошибке.
     */
    data class Error(val message: String) : DashboardUiState
    /**
     * [CONTRACT]
     * Состояние, когда данные для экрана загружаются.
     */
    data object Loading : DashboardUiState
 }
 // [END_FILE_DashboardUiState.kt]
--- a/app/src/main/java/com/homebox/lens/ui/screen/dashboard/DashboardViewModel.kt
+++ b/app/src/main/java/com/homebox/lens/ui/screen/dashboard/DashboardViewModel.kt
@@ -1,88 +0,0 @@
 // [PACKAGE] com.homebox.lens.ui.screen.dashboard
 // [FILE] DashboardViewModel.kt
 // [SEMANTICS] ui_logic, dashboard, state_management, sealed_state, parallel_data_loading, timber_logging
 package com.homebox.lens.ui.screen.dashboard
 // [IMPORTS]
 import androidx.lifecycle.ViewModel
 import androidx.lifecycle.viewModelScope
 import com.homebox.lens.domain.usecase.GetAllLabelsUseCase
 import com.homebox.lens.domain.usecase.GetAllLocationsUseCase
 import com.homebox.lens.domain.usecase.GetRecentlyAddedItemsUseCase
 import com.homebox.lens.domain.usecase.GetStatisticsUseCase
 import com.homebox.lens.ui.screen.dashboard.DashboardUiState
 import dagger.hilt.android.lifecycle.HiltViewModel
 import kotlinx.coroutines.async
 import kotlinx.coroutines.coroutineScope
 import kotlinx.coroutines.flow.*
 import kotlinx.coroutines.launch
 import timber.log.Timber
 import javax.inject.Inject
 // [VIEWMODEL]
 // [ENTITY: ViewModel('DashboardViewModel')]
 /**
 * [CONTRACT]
 * @summary ViewModel для главного экрана (Dashboard).
 * @description Оркестрирует загрузку данных для Dashboard, используя строгую модель состояний
 * (`DashboardUiState`), и обрабатывает параллельные запросы без состояний гонки.
 * @invariant `uiState` всегда является одним из состояний, определенных в `DashboardUiState`.
 */
@HiltViewModel
 class DashboardViewModel @Inject constructor(
    private val getStatisticsUseCase: GetStatisticsUseCase,
    private val getAllLocationsUseCase: GetAllLocationsUseCase,
    private val getAllLabelsUseCase: GetAllLabelsUseCase,
    private val getRecentlyAddedItemsUseCase: GetRecentlyAddedItemsUseCase
 ) : ViewModel() {
    // [STATE]
    private val _uiState = MutableStateFlow<DashboardUiState>(DashboardUiState.Loading)
    // [FIX] Добавлен получатель (receiver) `_uiState` для вызова asStateFlow().
    // [REASON] `asStateFlow()` является функцией-расширением для `MutableStateFlow` и
    // должна вызываться на его экземпляре, чтобы создать публичную, неизменяемую версию потока.
    val uiState = _uiState.asStateFlow()
    // [LIFECYCLE_HANDLER]
    init {
        loadDashboardData()
    }
    /**
     * [CONTRACT]
     * @summary Загружает все необходимые данные для экрана Dashboard.
     * @description Выполняет UseCase'ы параллельно и обновляет UI, переключая его
     * между состояниями `Loading`, `Success` и `Error` из `DashboardUiState`.
     * @sideeffect Асинхронно обновляет `_uiState` одним из состояний `DashboardUiState`.
     */
    fun loadDashboardData() {
        // [ENTRYPOINT]
        viewModelScope.launch {
            _uiState.value = DashboardUiState.Loading
            Timber.i("[ACTION] Starting dashboard data collection.")
            val statsFlow = flow { emit(getStatisticsUseCase()) }
            val locationsFlow = flow { emit(getAllLocationsUseCase()) }
            val labelsFlow = flow { emit(getAllLabelsUseCase()) }
            val recentItemsFlow = getRecentlyAddedItemsUseCase(limit = 10)
            combine(statsFlow, locationsFlow, labelsFlow, recentItemsFlow) { stats, locations, labels, recentItems ->
                DashboardUiState.Success(
                    statistics = stats,
                    locations = locations,
                    labels = labels,
                    recentlyAddedItems = recentItems
                )
            }.catch { exception ->
                Timber.e(exception, "[ERROR] Failed to load dashboard data. State -> Error.")
                _uiState.value = DashboardUiState.Error(
                    message = exception.message ?: "Could not load dashboard data."
                )
            }.collect { successState ->
                Timber.i("[SUCCESS] Dashboard data loaded successfully. State -> Success.")
                _uiState.value = successState
            }
        }
    }
    // [END_CLASS_DashboardViewModel]
 }
 // [END_FILE_DashboardViewModel.kt]
--- a/app/src/main/java/com/homebox/lens/ui/screen/inventorylist/InventoryListScreen.kt
+++ b/app/src/main/java/com/homebox/lens/ui/screen/inventorylist/InventoryListScreen.kt
@@ -1,37 +0,0 @@
 // [PACKAGE] com.homebox.lens.ui.screen.inventorylist
 // [FILE] InventoryListScreen.kt
 // [SEMANTICS] ui, screen, inventory, list
 package com.homebox.lens.ui.screen.inventorylist
 // [IMPORTS]
 import androidx.compose.material3.Text
 import androidx.compose.runtime.Composable
 import androidx.compose.ui.res.stringResource
 import com.homebox.lens.R
 import com.homebox.lens.navigation.NavigationActions
 import com.homebox.lens.ui.common.MainScaffold
 // [ENTRYPOINT]
 /**
 * [CONTRACT]
 * @summary Composable-функция для экрана "Список инвентаря".
 * @param currentRoute Текущий маршрут для подсветки активного элемента в Drawer.
 * @param navigationActions Объект с навигационными действиями.
 */
@Composable
 fun InventoryListScreen(
    currentRoute: String?,
    navigationActions: NavigationActions
 ) {
    // [UI_COMPONENT]
    MainScaffold(
        topBarTitle = stringResource(id = R.string.inventory_list_title),
        currentRoute = currentRoute,
        navigationActions = navigationActions
    ) {
        // [CORE-LOGIC]
        Text(text = "TODO: Inventory List Screen")
    }
    // [END_FUNCTION_InventoryListScreen]
 }
--- a/app/src/main/java/com/homebox/lens/ui/screen/inventorylist/InventoryListViewModel.kt
+++ b/app/src/main/java/com/homebox/lens/ui/screen/inventorylist/InventoryListViewModel.kt
@@ -1,16 +0,0 @@
 // [PACKAGE] com.homebox.lens.ui.screen.inventorylist
 // [FILE] InventoryListViewModel.kt
 package com.homebox.lens.ui.screen.inventorylist
 import androidx.lifecycle.ViewModel
 import dagger.hilt.android.lifecycle.HiltViewModel
 import javax.inject.Inject
 // [VIEWMODEL]
@HiltViewModel
 class InventoryListViewModel @Inject constructor() : ViewModel() {
    // [STATE]
    // TODO: Implement UI state
 }
 // [END_FILE_InventoryListViewModel.kt]
--- a/app/src/main/java/com/homebox/lens/ui/screen/itemdetails/ItemDetailsScreen.kt
+++ b/app/src/main/java/com/homebox/lens/ui/screen/itemdetails/ItemDetailsScreen.kt
@@ -1,37 +0,0 @@
 // [PACKAGE] com.homebox.lens.ui.screen.itemdetails
 // [FILE] ItemDetailsScreen.kt
 // [SEMANTICS] ui, screen, item, details
 package com.homebox.lens.ui.screen.itemdetails
 // [IMPORTS]
 import androidx.compose.material3.Text
 import androidx.compose.runtime.Composable
 import androidx.compose.ui.res.stringResource
 import com.homebox.lens.R
 import com.homebox.lens.navigation.NavigationActions
 import com.homebox.lens.ui.common.MainScaffold
 // [ENTRYPOINT]
 /**
 * [CONTRACT]
 * @summary Composable-функция для экрана "Детали элемента".
 * @param currentRoute Текущий маршрут для подсветки активного элемента в Drawer.
 * @param navigationActions Объект с навигационными действиями.
 */
@Composable
 fun ItemDetailsScreen(
    currentRoute: String?,
    navigationActions: NavigationActions
 ) {
    // [UI_COMPONENT]
    MainScaffold(
        topBarTitle = stringResource(id = R.string.item_details_title),
        currentRoute = currentRoute,
        navigationActions = navigationActions
    ) {
        // [CORE-LOGIC]
        Text(text = "TODO: Item Details Screen")
    }
    // [END_FUNCTION_ItemDetailsScreen]
 }
--- a/app/src/main/java/com/homebox/lens/ui/screen/itemdetails/ItemDetailsViewModel.kt
+++ b/app/src/main/java/com/homebox/lens/ui/screen/itemdetails/ItemDetailsViewModel.kt
@@ -1,16 +0,0 @@
 // [PACKAGE] com.homebox.lens.ui.screen.itemdetails
 // [FILE] ItemDetailsViewModel.kt
 package com.homebox.lens.ui.screen.itemdetails
 import androidx.lifecycle.ViewModel
 import dagger.hilt.android.lifecycle.HiltViewModel
 import javax.inject.Inject
 // [VIEWMODEL]
@HiltViewModel
 class ItemDetailsViewModel @Inject constructor() : ViewModel() {
    // [STATE]
    // TODO: Implement UI state
 }
 // [END_FILE_ItemDetailsViewModel.kt]
--- a/app/src/main/java/com/homebox/lens/ui/screen/itemedit/ItemEditScreen.kt
+++ b/app/src/main/java/com/homebox/lens/ui/screen/itemedit/ItemEditScreen.kt
@@ -1,37 +0,0 @@
 // [PACKAGE] com.homebox.lens.ui.screen.itemedit
 // [FILE] ItemEditScreen.kt
 // [SEMANTICS] ui, screen, item, edit
 package com.homebox.lens.ui.screen.itemedit
 // [IMPORTS]
 import androidx.compose.material3.Text
 import androidx.compose.runtime.Composable
 import androidx.compose.ui.res.stringResource
 import com.homebox.lens.R
 import com.homebox.lens.navigation.NavigationActions
 import com.homebox.lens.ui.common.MainScaffold
 // [ENTRYPOINT]
 /**
 * [CONTRACT]
 * @summary Composable-функция для экрана "Редактирование элемента".
 * @param currentRoute Текущий маршрут для подсветки активного элемента в Drawer.
 * @param navigationActions Объект с навигационными действиями.
 */
@Composable
 fun ItemEditScreen(
    currentRoute: String?,
    navigationActions: NavigationActions
 ) {
    // [UI_COMPONENT]
    MainScaffold(
        topBarTitle = stringResource(id = R.string.item_edit_title),
        currentRoute = currentRoute,
        navigationActions = navigationActions
    ) {
        // [CORE-LOGIC]
        Text(text = "TODO: Item Edit Screen")
    }
    // [END_FUNCTION_ItemEditScreen]
 }
--- a/app/src/main/java/com/homebox/lens/ui/screen/itemedit/ItemEditViewModel.kt
+++ b/app/src/main/java/com/homebox/lens/ui/screen/itemedit/ItemEditViewModel.kt
@@ -1,16 +0,0 @@
 // [PACKAGE] com.homebox.lens.ui.screen.itemedit
 // [FILE] ItemEditViewModel.kt
 package com.homebox.lens.ui.screen.itemedit
 import androidx.lifecycle.ViewModel
 import dagger.hilt.android.lifecycle.HiltViewModel
 import javax.inject.Inject
 // [VIEWMODEL]
@HiltViewModel
 class ItemEditViewModel @Inject constructor() : ViewModel() {
    // [STATE]
    // TODO: Implement UI state
 }
 // [END_FILE_ItemEditViewModel.kt]
--- a/app/src/main/java/com/homebox/lens/ui/screen/labelslist/LabelsListScreen.kt
+++ b/app/src/main/java/com/homebox/lens/ui/screen/labelslist/LabelsListScreen.kt
@@ -1,257 +0,0 @@
 // [PACKAGE] com.homebox.lens.ui.screen.labelslist
 // [FILE] LabelsListScreen.kt
 // [SEMANTICS] ui, labels_list, state_management, compose, dialog
 package com.homebox.lens.ui.screen.labelslist
 // [IMPORTS]
 import androidx.compose.foundation.clickable
 import androidx.compose.foundation.layout.Arrangement
 import androidx.compose.foundation.layout.Box
 import androidx.compose.foundation.layout.PaddingValues
 import androidx.compose.foundation.layout.fillMaxSize
 import androidx.compose.foundation.layout.fillMaxWidth
 import androidx.compose.foundation.layout.padding
 import androidx.compose.foundation.lazy.LazyColumn
 import androidx.compose.foundation.lazy.items
 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
 import androidx.compose.ui.unit.dp
 import androidx.hilt.navigation.compose.hiltViewModel
 import androidx.navigation.NavController
 import com.homebox.lens.R
 import com.homebox.lens.domain.model.Label
 import com.homebox.lens.navigation.Screen
 import timber.log.Timber
 // [SECTION] Main Screen Composable
 /**
 * [CONTRACT]
 * @summary Отображает экран со списком всех меток.
 * @description Главная Composable-функция для экрана меток. Она использует Scaffold для структуры,
 * получает состояние от `LabelsListViewModel`, обрабатывает навигацию и делегирует отображение
 * списка и диалогов вспомогательным Composable-функциям.
 *
 * @param navController Контроллер навигации для перемещения между экранами.
 * @param viewModel ViewModel, предоставляющая состояние UI для экрана меток.
 *
 * @precondition `navController` должен быть корректно инициализирован и способен обрабатывать навигационные события.
 * @precondition `viewModel` должен быть доступен через Hilt.
 * @postcondition Экран исчерпывающе обрабатывает все состояния из `LabelsListUiState` (Loading, Success, Error).
 * @sideeffect Пользовательские действия (клики) инициируют вызовы ViewModel и навигационные команды через `navController`.
 */
@OptIn(ExperimentalMaterial3Api::class)
@Composable
 fun LabelsListScreen(
    navController: NavController,
    viewModel: LabelsListViewModel = hiltViewModel()
 ) {
    // [ENTRYPOINT]
    val uiState by viewModel.uiState.collectAsState()
    // [CORE-LOGIC]
    Scaffold(
        topBar = {
            TopAppBar(
                title = { Text(text = stringResource(id = R.string.screen_title_labels)) },
                navigationIcon = {
                    // [ACTION] Handle back navigation
                    IconButton(onClick = {
                        Timber.i("[ACTION] Navigate up initiated.")
                        navController.navigateUp()
                    }) {
                        Icon(
                            imageVector = Icons.AutoMirrored.Filled.ArrowBack,
                            contentDescription = stringResource(id = R.string.content_desc_navigate_back)
                        )
                    }
                }
            )
        },
        floatingActionButton = {
            // [ACTION] Handle create new label initiation
            FloatingActionButton(onClick = {
                Timber.i("[ACTION] FAB clicked: Initiate create new label flow.")
                viewModel.onShowCreateDialog()
            }) {
                Icon(
                    imageVector = Icons.Default.Add,
                    contentDescription = stringResource(id = R.string.content_desc_create_label)
                )
            }
        }
    ) { paddingValues ->
        val currentState = uiState
        if (currentState is LabelsListUiState.Success && currentState.isShowingCreateDialog) {
            CreateLabelDialog(
                onConfirm = { labelName ->
                    viewModel.createLabel(labelName)
                },
                onDismiss = {
                    viewModel.onDismissCreateDialog()
                }
            )
        }
        Box(
            modifier = Modifier
                .fillMaxSize()
                .padding(paddingValues),
            contentAlignment = Alignment.Center
        ) {
            // [CORE-LOGIC] State-driven UI rendering
            when (currentState) {
                is LabelsListUiState.Loading -> {
                    CircularProgressIndicator()
                }
                is LabelsListUiState.Error -> {
                    Text(text = currentState.message)
                }
                is LabelsListUiState.Success -> {
                    if (currentState.labels.isEmpty()) {
                        Text(text = stringResource(id = R.string.labels_list_empty))
                    } else {
                        LabelsList(
                            labels = currentState.labels,
                            onLabelClick = { label ->
                                // [ACTION] Handle label click
                                Timber.i("[ACTION] Label clicked: ${label.id}. Navigating to inventory list.")
                                // [DESIGN-DECISION] Использовать существующий экран списка инвентаря, передавая фильтр.
                                val route = Screen.InventoryList.withFilter("label", label.id)
                                navController.navigate(route)
                            }
                        )
                    }
                }
            }
        }
    }
    // [COHERENCE_CHECK_PASSED]
 }
 // [END_FUNCTION] LabelsListScreen
 // [SECTION] Helper Composables
 /**
 * [CONTRACT]
 * @summary Composable-функция для отображения списка меток.
 * @param labels Список объектов `Label` для отображения.
 * @param onLabelClick Лямбда-функция, вызываемая при нажатии на элемент списка.
 * @param modifier Модификатор для настройки внешнего вида.
 */
@Composable
 private fun LabelsList(
    labels: List<Label>,
    onLabelClick: (Label) -> Unit,
    modifier: Modifier = Modifier
 ) {
    // [CORE-LOGIC]
    LazyColumn(
        modifier = modifier.fillMaxSize(),
        contentPadding = PaddingValues(16.dp),
        verticalArrangement = Arrangement.spacedBy(8.dp)
    ) {
        items(labels, key = { it.id }) { label ->
            LabelListItem(
                label = label,
                onClick = { onLabelClick(label) }
            )
        }
    }
 }
 // [END_FUNCTION] LabelsList
 /**
 * [CONTRACT]
 * @summary Composable-функция для отображения одного элемента в списке меток.
 * @param label Объект `Label`, который нужно отобразить.
 * @param onClick Лямбда-функция, вызываемая при нажатии на элемент.
 */
@Composable
 private fun LabelListItem(
    label: Label,
    onClick: () -> Unit
 ) {
    // [CORE-LOGIC]
    ListItem(
        headlineContent = { Text(text = label.name) },
        leadingContent = {
            Icon(
                imageVector = Icons.AutoMirrored.Filled.Label,
                contentDescription = stringResource(id = R.string.content_desc_label_icon)
            )
        },
        modifier = Modifier.clickable(onClick = onClick)
    )
 }
 // [END_FUNCTION] LabelListItem
 /**
 * [CONTRACT]
 * @summary Диалоговое окно для создания новой метки.
 * @param onConfirm Лямбда-функция, вызываемая при подтверждении создания с именем метки.
 * @param onDismiss Лямбда-функция, вызываемая при закрытии диалога.
 */
@Composable
 private fun CreateLabelDialog(
    onConfirm: (String) -> Unit,
    onDismiss: () -> Unit
 ) {
    // [STATE]
    var text by remember { mutableStateOf("") }
    val isConfirmEnabled = text.isNotBlank()
    // [CORE-LOGIC]
    AlertDialog(
        onDismissRequest = onDismiss,
        title = { Text(text = stringResource(R.string.dialog_title_create_label)) },
        text = {
            OutlinedTextField(
                value = text,
                onValueChange = { text = it },
                label = { Text(stringResource(R.string.dialog_field_label_name)) },
                singleLine = true,
                modifier = Modifier.fillMaxWidth()
            )
        },
        confirmButton = {
            TextButton(
                onClick = { onConfirm(text) },
                enabled = isConfirmEnabled
            ) {
                Text(stringResource(R.string.dialog_button_create))
            }
        },
        dismissButton = {
            TextButton(onClick = onDismiss) {
                Text(stringResource(R.string.dialog_button_cancel))
            }
        }
    )
 }
 // [END_FUNCTION] CreateLabelDialog
 // [END_FILE] LabelsListScreen.kt
--- a/app/src/main/java/com/homebox/lens/ui/screen/labelslist/LabelsListUiState.kt
+++ b/app/src/main/java/com/homebox/lens/ui/screen/labelslist/LabelsListUiState.kt
@@ -1,36 +0,0 @@
 // [PACKAGE] com.homebox.lens.ui.screen.labelslist
 // [FILE] LabelsListUiState.kt
 // [SEMANTICS] ui_state, sealed_interface, contract
 package com.homebox.lens.ui.screen.labelslist
 // [IMPORTS]
 import com.homebox.lens.domain.model.Label
 // [CONTRACT]
 /**
 [CONTRACT]
@summary Определяет все возможные состояния для UI экрана со списком меток.
@description Использование sealed-интерфейса позволяет исчерпывающе обрабатывать все состояния в Composable-функциях.
 */
 sealed interface LabelsListUiState {
    /**
    @summary Состояние успеха, содержит список меток и состояние диалога.
    @property labels Список меток для отображения.
    @property isShowingCreateDialog Флаг, показывающий, должен ли быть отображен диалог создания метки.
    @invariant labels не может быть null.
     */
    data class Success(
        val labels: List<Label>,
        val isShowingCreateDialog: Boolean = false
    ) : LabelsListUiState
    /**
    @summary Состояние ошибки.
    @property message Текст ошибки для отображения пользователю.
    @invariant message не может быть пустой.
     */
    data class Error(val message: String) : LabelsListUiState
    /**
    @summary Состояние загрузки данных.
    @description Указывает, что идет процесс загрузки меток.
     */
    data object Loading : LabelsListUiState
 }
 // [END_FILE_LabelsListUiState.kt]
--- a/app/src/main/java/com/homebox/lens/ui/screen/labelslist/LabelsListViewModel.kt
+++ b/app/src/main/java/com/homebox/lens/ui/screen/labelslist/LabelsListViewModel.kt
@@ -1,140 +0,0 @@
 // [PACKAGE] com.homebox.lens.ui.screen.labelslist
 // [FILE] LabelsListViewModel.kt
 // [SEMANTICS] ui_logic, labels_list, state_management, dialog_management
 package com.homebox.lens.ui.screen.labelslist
 // [IMPORTS]
 import androidx.lifecycle.ViewModel
 import androidx.lifecycle.viewModelScope
 import com.homebox.lens.domain.model.Label
 import com.homebox.lens.domain.usecase.GetAllLabelsUseCase
 import dagger.hilt.android.lifecycle.HiltViewModel
 import kotlinx.coroutines.flow.MutableStateFlow
 import kotlinx.coroutines.flow.asStateFlow
 import kotlinx.coroutines.flow.update
 import kotlinx.coroutines.launch
 import timber.log.Timber
 import javax.inject.Inject
 // [VIEWMODEL]
 // [ENTITY: ViewModel('LabelsListViewModel')]
 /**
 * [CONTRACT]
 * @summary ViewModel для экрана со списком меток.
 * @description Управляет состоянием экрана, загружает список меток, обрабатывает ошибки и управляет диалогом создания новой метки.
 * @invariant `uiState` всегда является одним из состояний, определенных в `LabelsListUiState`.
 */
@HiltViewModel
 class LabelsListViewModel @Inject constructor(
    private val getAllLabelsUseCase: GetAllLabelsUseCase
 ) : ViewModel() {
    // [STATE]
    private val _uiState = MutableStateFlow<LabelsListUiState>(LabelsListUiState.Loading)
    val uiState = _uiState.asStateFlow()
    // [INIT]
    init {
        loadLabels()
    }
    /**
     * [CONTRACT]
     * @summary Загружает список меток.
     * @description Выполняет `GetAllLabelsUseCase` и обновляет UI, переключая его
     * между состояниями `Loading`, `Success` и `Error`.
     * @sideeffect Асинхронно обновляет `_uiState`.
     */
    // [ACTION]
    fun loadLabels() {
        // [ENTRYPOINT]
        viewModelScope.launch {
            _uiState.value = LabelsListUiState.Loading
            Timber.i("[ACTION] Starting labels list load. State -> Loading.")
            // [CORE-LOGIC]
            val result = runCatching {
                getAllLabelsUseCase()
            }
            // [RESULT_HANDLER]
            result.fold(
                onSuccess = { labelOuts ->
                    Timber.i("[SUCCESS] Labels loaded successfully. Count: ${labelOuts.size}. State -> Success.")
                    // [DATA-FLOW] Map List<LabelOut> to List<Label> for the UI state.
                    // The 'Label' model for the UI is simpler and only contains 'id' and 'name'.
                    val labels = labelOuts.map { labelOut ->
                        Label(
                            id = labelOut.id,
                            name = labelOut.name
                        )
                    }
                    _uiState.value = LabelsListUiState.Success(labels, isShowingCreateDialog = false)
                },
                onFailure = { exception ->
                    Timber.e(exception, "[ERROR] Failed to load labels. State -> Error.")
                    _uiState.value = LabelsListUiState.Error(
                        message = exception.message ?: "Could not load labels."
                    )
                }
            )
        }
    }
    /**
     * [CONTRACT]
     * @summary Инициирует отображение диалога для создания метки.
     * @description Обновляет состояние `uiState`, устанавливая `isShowingCreateDialog` в `true`.
     * @sideeffect Обновляет `_uiState`.
     */
    // [ACTION]
    fun onShowCreateDialog() {
        Timber.i("[ACTION] Show create label dialog requested.")
        if (_uiState.value is LabelsListUiState.Success) {
            _uiState.update {
                (it as LabelsListUiState.Success).copy(isShowingCreateDialog = true)
            }
        }
    }
    /**
     * [CONTRACT]
     * @summary Скрывает диалог создания метки.
     * @description Обновляет состояние `uiState`, устанавливая `isShowingCreateDialog` в `false`.
     * @sideeffect Обновляет `_uiState`.
     */
    // [ACTION]
    fun onDismissCreateDialog() {
        Timber.i("[ACTION] Dismiss create label dialog requested.")
        if (_uiState.value is LabelsListUiState.Success) {
            _uiState.update {
                (it as LabelsListUiState.Success).copy(isShowingCreateDialog = false)
            }
        }
    }
    /**
     * [CONTRACT]
     * @summary Создает новую метку. [MVP_SCOPE] ЗАГЛУШКА.
     * @description В текущей реализации (План Б, Этап 1), эта функция только логирует действие
     * и скрывает диалог. Реальная логика сохранения будет добавлена на следующем этапе.
     * @param name Название новой метки.
     * @precondition `name` не должен быть пустым.
     * @sideeffect Логирует действие, обновляет `_uiState`, чтобы скрыть диалог.
     */
    // [ACTION]
    fun createLabel(name: String) {
        // [PRECONDITION]
        require(name.isNotBlank()) { "[CONTRACT_VIOLATION] Label name cannot be blank." }
        // [ENTRYPOINT]
        Timber.i("[ACTION] Create label called with name: '$name'. [STUBBED]")
        // [CORE-LOGIC] - Заглушка. Здесь будет вызов CreateLabelUseCase.
        // [POSTCONDITION] Скрываем диалог после "создания".
        onDismissCreateDialog()
        // [REFACTORING_NOTE] На следующем этапе нужно добавить вызов UseCase и обновить список.
    }
 }
 // [END_CLASS_LabelsListViewModel]
--- a/app/src/main/java/com/homebox/lens/ui/screen/locationedit/LocationEditScreen.kt
+++ b/app/src/main/java/com/homebox/lens/ui/screen/locationedit/LocationEditScreen.kt
@@ -1,45 +0,0 @@
 // [PACKAGE] com.homebox.lens.ui.screen.locationedit
 // [FILE] LocationEditScreen.kt
 // [SEMANTICS] ui, screen, location, edit
 package com.homebox.lens.ui.screen.locationedit
 // [IMPORTS]
 import androidx.compose.foundation.layout.Box
 import androidx.compose.foundation.layout.fillMaxSize
 import androidx.compose.foundation.layout.padding
 import androidx.compose.material3.Scaffold
 import androidx.compose.material3.Text
 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
 // [ENTRYPOINT]
 /**
 * [CONTRACT]
 * @summary Composable-функция для экрана "Редактирование местоположения".
 * @param locationId ID местоположения для редактирования или "new" для создания.
 */
@Composable
 fun LocationEditScreen(
    locationId: String?
 ) {
    val title = if (locationId == "new") {
        stringResource(id = R.string.location_edit_title_create)
    } else {
        stringResource(id = R.string.location_edit_title_edit)
    }
    Scaffold { paddingValues ->
        Box(
            modifier = Modifier
                .fillMaxSize()
                .padding(paddingValues),
            contentAlignment = Alignment.Center
        ) {
            Text(text = "TODO: Location Edit Screen for ID: $locationId")
        }
    }
 }
--- a/app/src/main/java/com/homebox/lens/ui/screen/locationslist/LocationsListScreen.kt
+++ b/app/src/main/java/com/homebox/lens/ui/screen/locationslist/LocationsListScreen.kt
@@ -1,287 +0,0 @@
 // [PACKAGE] com.homebox.lens.ui.screen.locationslist
 // [FILE] LocationsListScreen.kt
 // [SEMANTICS] ui, screen, locations, list
 package com.homebox.lens.ui.screen.locationslist
 // [IMPORTS]
 import androidx.compose.foundation.clickable
 import androidx.compose.foundation.layout.Arrangement
 import androidx.compose.foundation.layout.Box
 import androidx.compose.foundation.layout.Column
 import androidx.compose.foundation.layout.PaddingValues
 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.padding
 import androidx.compose.foundation.layout.width
 import androidx.compose.foundation.lazy.LazyColumn
 import androidx.compose.foundation.lazy.items
 import androidx.compose.material.icons.Icons
 import androidx.compose.material.icons.filled.Add
 import androidx.compose.material.icons.filled.MoreVert
 import androidx.compose.material3.Card
 import androidx.compose.material3.CircularProgressIndicator
 import androidx.compose.material3.DropdownMenu
 import androidx.compose.material3.DropdownMenuItem
 import androidx.compose.material3.FloatingActionButton
 import androidx.compose.material3.Icon
 import androidx.compose.material3.IconButton
 import androidx.compose.material3.MaterialTheme
 import androidx.compose.material3.Scaffold
 import androidx.compose.material3.Text
 import androidx.compose.runtime.Composable
 import androidx.compose.runtime.collectAsState
 import androidx.compose.runtime.getValue
 import androidx.compose.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.style.TextAlign
 import androidx.compose.ui.tooling.preview.Preview
 import androidx.compose.ui.unit.dp
 import androidx.hilt.navigation.compose.hiltViewModel
 import com.homebox.lens.R
 import com.homebox.lens.domain.model.LocationOutCount
 import com.homebox.lens.navigation.NavigationActions
 import com.homebox.lens.ui.common.MainScaffold
 import com.homebox.lens.ui.theme.HomeboxLensTheme
 // [ENTRYPOINT]
 /**
 * [CONTRACT]
 * @summary Composable-функция для экрана "Список местоположений".
 * @param currentRoute Текущий маршрут для подсветки активного элемента в Drawer.
 * @param navigationActions Объект с навигационными действиями.
 * @param onLocationClick Лямбда-обработчик нажатия на местоположение.
 * @param onAddNewLocationClick Лямбда-обработчик нажатия на кнопку добавления нового местоположения.
 * @param viewModel ViewModel для этого экрана.
 */
@Composable
 fun LocationsListScreen(
    currentRoute: String?,
    navigationActions: NavigationActions,
    onLocationClick: (String) -> Unit,
    onAddNewLocationClick: () -> Unit,
    viewModel: LocationsListViewModel = hiltViewModel()
 ) {
    // [STATE]
    val uiState by viewModel.uiState.collectAsState()
    // [UI_COMPONENT]
    MainScaffold(
        topBarTitle = stringResource(id = R.string.locations_list_title),
        currentRoute = currentRoute,
        navigationActions = navigationActions
    ) { paddingValues ->
        Scaffold(
            modifier = Modifier.padding(paddingValues),
            floatingActionButton = {
                FloatingActionButton(onClick = onAddNewLocationClick) {
                    Icon(
                        Icons.Default.Add,
                        contentDescription = stringResource(id = R.string.cd_add_new_location)
                    )
                }
            }
        ) { innerPadding ->
            LocationsListContent(
                modifier = Modifier.padding(innerPadding),
                uiState = uiState,
                onLocationClick = onLocationClick,
                onEditLocation = { /* TODO */ },
                onDeleteLocation = { /* TODO */ }
            )
        }
    }
 }
 // [HELPER]
 /**
 * [CONTRACT]
 * @summary Отображает основной контент экрана в зависимости от `uiState`.
 * @param modifier Модификатор для стилизации.
 * @param uiState Текущее состояние UI.
 * @param onLocationClick Лямбда-обработчик нажатия на местоположение.
 * @param onEditLocation Лямбда-обработчик для редактирования местоположения.
 * @param onDeleteLocation Лямбда-обработчик для удаления местоположения.
 */
@Composable
 private fun LocationsListContent(
    modifier: Modifier = Modifier,
    uiState: LocationsListUiState,
    onLocationClick: (String) -> Unit,
    onEditLocation: (String) -> Unit,
    onDeleteLocation: (String) -> Unit
 ) {
    Box(modifier = modifier.fillMaxSize()) {
        when (uiState) {
            is LocationsListUiState.Loading -> {
                CircularProgressIndicator(modifier = Modifier.align(Alignment.Center))
            }
            is LocationsListUiState.Error -> {
                Text(
                    text = uiState.message,
                    color = MaterialTheme.colorScheme.error,
                    textAlign = TextAlign.Center,
                    modifier = Modifier
                        .align(Alignment.Center)
                        .padding(16.dp)
                )
            }
            is LocationsListUiState.Success -> {
                if (uiState.locations.isEmpty()) {
                    Text(
                        text = stringResource(id = R.string.locations_not_found),
                        textAlign = TextAlign.Center,
                        modifier = Modifier
                            .align(Alignment.Center)
                            .padding(16.dp)
                    )
                } else {
                    LazyColumn(
                        contentPadding = PaddingValues(16.dp),
                        verticalArrangement = Arrangement.spacedBy(12.dp)
                    ) {
                        items(uiState.locations, key = { it.id }) { location ->
                            LocationCard(
                                location = location,
                                onClick = { onLocationClick(location.id) },
                                onEditClick = { onEditLocation(location.id) },
                                onDeleteClick = { onDeleteLocation(location.id) }
                            )
                        }
                    }
                }
            }
        }
    }
 }
 // [UI_COMPONENT]
 /**
 * [CONTRACT]
 * @summary Карточка для отображения одного местоположения.
 * @param location Данные о местоположении.
 * @param onClick Лямбда-обработчик нажатия на карточку.
 * @param onEditClick Лямбда-обработчик нажатия на "Редактировать".
 * @param onDeleteClick Лямбда-обработчик нажатия на "Удалить".
 */
@Composable
 private fun LocationCard(
    location: LocationOutCount,
    onClick: () -> Unit,
    onEditClick: () -> Unit,
    onDeleteClick: () -> Unit
 ) {
    var menuExpanded by remember { mutableStateOf(false) }
    Card(
        modifier = Modifier
            .fillMaxWidth()
            .clickable(onClick = onClick)
    ) {
        Row(
            modifier = Modifier.padding(start = 16.dp, end = 8.dp, top = 16.dp, bottom = 16.dp),
            verticalAlignment = Alignment.CenterVertically,
            horizontalArrangement = Arrangement.SpaceBetween
        ) {
            Column(modifier = Modifier.weight(1f)) {
                Text(text = location.name, style = MaterialTheme.typography.titleMedium)
                Text(
                    text = stringResource(id = R.string.item_count, location.itemCount),
                    style = MaterialTheme.typography.bodyMedium
                )
            }
            Spacer(Modifier.width(16.dp))
            Box {
                IconButton(onClick = { menuExpanded = true }) {
                    Icon(Icons.Default.MoreVert, contentDescription = stringResource(id = R.string.cd_more_options))
                }
                DropdownMenu(
                    expanded = menuExpanded,
                    onDismissRequest = { menuExpanded = false }
                ) {
                    DropdownMenuItem(
                        text = { Text(stringResource(id = R.string.edit)) },
                        onClick = {
                            menuExpanded = false
                            onEditClick()
                        }
                    )
                    DropdownMenuItem(
                        text = { Text(stringResource(id = R.string.delete)) },
                        onClick = {
                            menuExpanded = false
                            onDeleteClick()
                        }
                    )
                }
            }
        }
    }
 }
 // [PREVIEW]
@Preview(showBackground = true, name = "Locations List Success")
@Composable
 fun LocationsListSuccessPreview() {
    val previewLocations = listOf(
        LocationOutCount("1", "Garage", "#FF0000", false, 12, "", ""),
        LocationOutCount("2", "Kitchen", "#00FF00", false, 5, "", ""),
        LocationOutCount("3", "Office", "#0000FF", false, 23, "", "")
    )
    HomeboxLensTheme {
        LocationsListContent(
            uiState = LocationsListUiState.Success(previewLocations),
            onLocationClick = {},
            onEditLocation = {},
            onDeleteLocation = {}
        )
    }
 }
 // [PREVIEW]
@Preview(showBackground = true, name = "Locations List Empty")
@Composable
 fun LocationsListEmptyPreview() {
    HomeboxLensTheme {
        LocationsListContent(
            uiState = LocationsListUiState.Success(emptyList()),
            onLocationClick = {},
            onEditLocation = {},
            onDeleteLocation = {}
        )
    }
 }
 // [PREVIEW]
@Preview(showBackground = true, name = "Locations List Loading")
@Composable
 fun LocationsListLoadingPreview() {
    HomeboxLensTheme {
        LocationsListContent(
            uiState = LocationsListUiState.Loading,
            onLocationClick = {},
            onEditLocation = {},
            onDeleteLocation = {}
        )
    }
 }
 // [PREVIEW]
@Preview(showBackground = true, name = "Locations List Error")
@Composable
 fun LocationsListErrorPreview() {
    HomeboxLensTheme {
        LocationsListContent(
            uiState = LocationsListUiState.Error("Failed to load locations. Please try again."),
            onLocationClick = {},
            onEditLocation = {},
            onDeleteLocation = {}
        )
    }
 }
--- a/app/src/main/java/com/homebox/lens/ui/screen/locationslist/LocationsListUiState.kt
+++ b/app/src/main/java/com/homebox/lens/ui/screen/locationslist/LocationsListUiState.kt
@@ -1,35 +0,0 @@
 // [PACKAGE] com.homebox.lens.ui.screen.locationslist
 // [FILE] LocationsListUiState.kt
 // [SEMANTICS] ui, state, locations
 package com.homebox.lens.ui.screen.locationslist
 import com.homebox.lens.domain.model.LocationOutCount
 /**
 * [CONTRACT]
 * @summary Определяет возможные состояния UI для экрана списка местоположений.
 * @see LocationsListViewModel
 */
 sealed interface LocationsListUiState {
    /**
     * [STATE]
     * @summary Состояние успешной загрузки данных.
     * @param locations Список местоположений для отображения.
     */
    data class Success(val locations: List<LocationOutCount>) : LocationsListUiState
    /**
     * [STATE]
     * @summary Состояние ошибки.
     * @param message Сообщение об ошибке.
     */
    data class Error(val message: String) : LocationsListUiState
    /**
     * [STATE]
     * @summary Состояние загрузки данных.
     */
    object Loading : LocationsListUiState
 }
 // [END_FILE_LocationsListUiState.kt]
--- a/app/src/main/java/com/homebox/lens/ui/screen/locationslist/LocationsListViewModel.kt
+++ b/app/src/main/java/com/homebox/lens/ui/screen/locationslist/LocationsListViewModel.kt
@@ -1,58 +0,0 @@
 // [PACKAGE] com.homebox.lens.ui.screen.locationslist
 // [FILE] LocationsListViewModel.kt
 // [SEMANTICS] ui, viewmodel, locations, hilt
 package com.homebox.lens.ui.screen.locationslist
 import androidx.lifecycle.ViewModel
 import androidx.lifecycle.viewModelScope
 import com.homebox.lens.domain.usecase.GetAllLocationsUseCase
 import dagger.hilt.android.lifecycle.HiltViewModel
 import kotlinx.coroutines.flow.MutableStateFlow
 import kotlinx.coroutines.flow.StateFlow
 import kotlinx.coroutines.flow.asStateFlow
 import kotlinx.coroutines.launch
 import javax.inject.Inject
 // [CORE-LOGIC]
 /**
 * [CONTRACT]
 * @summary ViewModel для экрана списка местоположений.
 * @param getAllLocationsUseCase Use case для получения всех местоположений.
 * @property uiState Поток, содержащий текущее состояние UI.
 * @invariant `uiState` всегда отражает результат последней операции загрузки.
 */
@HiltViewModel
 class LocationsListViewModel @Inject constructor(
    private val getAllLocationsUseCase: GetAllLocationsUseCase
 ) : ViewModel() {
    // [STATE]
    private val _uiState = MutableStateFlow<LocationsListUiState>(LocationsListUiState.Loading)
    val uiState: StateFlow<LocationsListUiState> = _uiState.asStateFlow()
    // [INITIALIZER]
    init {
        loadLocations()
    }
    // [ACTION]
    /**
     * [CONTRACT]
     * @summary Загружает список местоположений из репозитория.
     * @sideeffect Обновляет `_uiState` в зависимости от результата: Loading -> Success/Error.
     */
    fun loadLocations() {
        viewModelScope.launch {
            _uiState.value = LocationsListUiState.Loading
            try {
                val locations = getAllLocationsUseCase()
                _uiState.value = LocationsListUiState.Success(locations)
            } catch (e: Exception) {
                _uiState.value = LocationsListUiState.Error(e.message ?: "Unknown error")
            }
        }
    }
    // [END_CLASS_LocationsListViewModel]
 }
 // [END_FILE_LocationsListViewModel.kt]
--- a/app/src/main/java/com/homebox/lens/ui/screen/search/SearchScreen.kt
+++ b/app/src/main/java/com/homebox/lens/ui/screen/search/SearchScreen.kt
@@ -1,37 +0,0 @@
 // [PACKAGE] com.homebox.lens.ui.screen.search
 // [FILE] SearchScreen.kt
 // [SEMANTICS] ui, screen, search
 package com.homebox.lens.ui.screen.search
 // [IMPORTS]
 import androidx.compose.material3.Text
 import androidx.compose.runtime.Composable
 import androidx.compose.ui.res.stringResource
 import com.homebox.lens.R
 import com.homebox.lens.navigation.NavigationActions
 import com.homebox.lens.ui.common.MainScaffold
 // [ENTRYPOINT]
 /**
 * [CONTRACT]
 * @summary Composable-функция для экрана "Поиск".
 * @param currentRoute Текущий маршрут для подсветки активного элемента в Drawer.
 * @param navigationActions Объект с навигационными действиями.
 */
@Composable
 fun SearchScreen(
    currentRoute: String?,
    navigationActions: NavigationActions
 ) {
    // [UI_COMPONENT]
    MainScaffold(
        topBarTitle = stringResource(id = R.string.search_title),
        currentRoute = currentRoute,
        navigationActions = navigationActions
    ) {
        // [CORE-LOGIC]
        Text(text = "TODO: Search Screen")
    }
    // [END_FUNCTION_SearchScreen]
 }
--- a/app/src/main/java/com/homebox/lens/ui/screen/search/SearchViewModel.kt
+++ b/app/src/main/java/com/homebox/lens/ui/screen/search/SearchViewModel.kt
@@ -1,16 +0,0 @@
 // [PACKAGE] com.homebox.lens.ui.screen.search
 // [FILE] SearchViewModel.kt
 package com.homebox.lens.ui.screen.search
 import androidx.lifecycle.ViewModel
 import dagger.hilt.android.lifecycle.HiltViewModel
 import javax.inject.Inject
 // [VIEWMODEL]
@HiltViewModel
 class SearchViewModel @Inject constructor() : ViewModel() {
    // [STATE]
    // TODO: Implement UI state
 }
 // [END_FILE_SearchViewModel.kt]
--- a/app/src/main/java/com/homebox/lens/ui/screen/setup/SetupScreen.kt
+++ b/app/src/main/java/com/homebox/lens/ui/screen/setup/SetupScreen.kt
@@ -1,141 +0,0 @@
 // [PACKAGE] com.homebox.lens.ui.screen.setup
 // [FILE] SetupScreen.kt
 // [SEMANTICS] ui, screen, setup, compose
@file:OptIn(ExperimentalMaterial3Api::class)
 package com.homebox.lens.ui.screen.setup
 // [IMPORTS]
 import androidx.compose.foundation.layout.*
 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.stringResource
 import androidx.compose.ui.text.input.PasswordVisualTransformation
 import androidx.compose.ui.tooling.preview.Preview
 import androidx.compose.ui.unit.dp
 import androidx.hilt.navigation.compose.hiltViewModel
 import com.homebox.lens.R
 // [ENTRYPOINT]
 /**
 * [CONTRACT]
 * @summary Главная Composable-функция для экрана настройки соединения с сервером.
 * @param viewModel ViewModel для этого экрана, предоставляется через Hilt.
 * @param onSetupComplete Лямбда, вызываемая после успешной настройки и входа.
 * @sideeffect Вызывает `onSetupComplete` при изменении `uiState.isSetupComplete`.
 */
@Composable
 fun SetupScreen(
    viewModel: SetupViewModel = hiltViewModel(),
    onSetupComplete: () -> Unit
 ) {
    // [STATE]
    val uiState by viewModel.uiState.collectAsState()
    // [CORE-LOGIC]
    if (uiState.isSetupComplete) {
        onSetupComplete()
    }
    // [UI_COMPONENT]
    SetupScreenContent(
        uiState = uiState,
        onServerUrlChange = viewModel::onServerUrlChange,
        onUsernameChange = viewModel::onUsernameChange,
        onPasswordChange = viewModel::onPasswordChange,
        onConnectClick = viewModel::connect
    )
    // [END_FUNCTION_SetupScreen]
 }
 // [HELPER]
 /**
 * [CONTRACT]
 * @summary Отображает контент экрана настройки: поля ввода и кнопку.
 * @param uiState Текущее состояние UI.
 * @param onServerUrlChange Лямбда-обработчик изменения URL сервера.
 * @param onUsernameChange Лямбда-обработчик изменения имени пользователя.
 * @param onPasswordChange Лямбда-обработчик изменения пароля.
 * @param onConnectClick Лямбда-обработчик нажатия на кнопку "Подключиться".
 */
@Composable
 private fun SetupScreenContent(
    uiState: SetupUiState,
    onServerUrlChange: (String) -> Unit,
    onUsernameChange: (String) -> Unit,
    onPasswordChange: (String) -> Unit,
    onConnectClick: () -> Unit
 ) {
    Scaffold(
        topBar = {
            TopAppBar(title = { Text(stringResource(id = R.string.setup_title)) })
        }
    ) { paddingValues ->
        Column(
            modifier = Modifier
                .fillMaxSize()
                .padding(paddingValues)
                .padding(16.dp),
            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()
            )
            Spacer(modifier = Modifier.height(16.dp))
            Button(
                onClick = onConnectClick,
                enabled = !uiState.isLoading,
                modifier = Modifier.fillMaxWidth()
            ) {
                if (uiState.isLoading) {
                    CircularProgressIndicator(modifier = Modifier.size(24.dp))
                } 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)
            }
        }
    }
    // [END_FUNCTION_SetupScreenContent]
 }
 // [PREVIEW]
@Preview(showBackground = true)
@Composable
 fun SetupScreenPreview() {
    SetupScreenContent(
        uiState = SetupUiState(error = "Failed to connect"),
        onServerUrlChange = {},
        onUsernameChange = {},
        onPasswordChange = {},
        onConnectClick = {}
    )
 }
 // [END_FILE_SetupScreen.kt]
--- a/app/src/main/java/com/homebox/lens/ui/screen/setup/SetupUiState.kt
+++ b/app/src/main/java/com/homebox/lens/ui/screen/setup/SetupUiState.kt
@@ -1,27 +0,0 @@
 // [PACKAGE] com.homebox.lens.ui.screen.setup
 // [FILE] SetupUiState.kt
 // [SEMANTICS] ui_state, data_model, immutable
 package com.homebox.lens.ui.screen.setup
 /**
 * [ENTITY: DataClass('SetupUiState')]
 * [CONTRACT]
 * Неизменяемая модель данных, представляющая полное состояние экрана настройки (Setup Screen).
 * Использование `data class` предоставляет метод `copy()` для легкого создания новых состояний.
 * @property serverUrl URL-адрес сервера Homebox.
 * @property username Имя пользователя для входа.
 * @property password Пароль пользователя.
 * @property isLoading Флаг, указывающий, выполняется ли в данный момент сетевой запрос.
 * @property error Сообщение об ошибке для отображения пользователю, или `null` при отсутствии ошибки.
 * @property isSetupComplete Флаг, указывающий на успешное завершение настройки и входа.
 */
 data class SetupUiState(
    val serverUrl: String = "",
    val username: String = "",
    val password: String = "",
    val isLoading: Boolean = false,
    val error: String? = null,
    val isSetupComplete: Boolean = false
 )
 // [END_FILE_SetupUiState.kt]
--- a/app/src/main/java/com/homebox/lens/ui/screen/setup/SetupViewModel.kt
+++ b/app/src/main/java/com/homebox/lens/ui/screen/setup/SetupViewModel.kt
@@ -1,143 +0,0 @@
 // [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
 // [IMPORTS]
 import androidx.lifecycle.ViewModel
 import androidx.lifecycle.viewModelScope
 import com.homebox.lens.domain.model.Credentials
 import com.homebox.lens.domain.repository.CredentialsRepository
 import com.homebox.lens.domain.usecase.LoginUseCase
 import com.homebox.lens.ui.screen.setup.SetupUiState
 import dagger.hilt.android.lifecycle.HiltViewModel
 import kotlinx.coroutines.flow.MutableStateFlow
 import kotlinx.coroutines.flow.asStateFlow
 import kotlinx.coroutines.flow.update
 import kotlinx.coroutines.launch
 import javax.inject.Inject
 // [VIEWMODEL]
 // [ENTITY: ViewModel('SetupViewModel')]
 /**
 * [CONTRACT]
 * ViewModel для экрана первоначальной настройки (Setup).
 * Отвечает за:
 * 1. Загрузку и сохранение учетных данных (URL сервера, логин, пароль).
 * 2. Управление состоянием UI экрана (`SetupUiState`).
 * 3. Инициацию процесса входа в систему через `LoginUseCase`.
 * @property credentialsRepository Репозиторий для операций с учетными данными.
 * @property loginUseCase Use case для выполнения логики входа.
 * @invariant Состояние `uiState` всегда является единственным источником истины для UI.
 */
@HiltViewModel
 class SetupViewModel @Inject constructor(
    private val credentialsRepository: CredentialsRepository,
    private val loginUseCase: LoginUseCase
 ) : ViewModel() {
    // [STATE]
    private val _uiState = MutableStateFlow(SetupUiState())
    val uiState = _uiState.asStateFlow()
    // [LIFECYCLE_HANDLER]
    init {
        // [ACTION] Загружаем учетные данные при создании ViewModel.
        loadCredentials()
    }
    /**
     * [CONTRACT]
     * [HELPER] Загружает учетные данные из репозитория при инициализации.
     * @sideeffect Асинхронно обновляет `_uiState` полученными учетными данными.
     */
    private fun loadCredentials() {
        // [ENTRYPOINT]
        viewModelScope.launch {
            // [CORE-LOGIC] Подписываемся на поток учетных данных.
            credentialsRepository.getCredentials().collect { credentials ->
                // [ACTION] Обновляем состояние, если учетные данные существуют.
                if (credentials != null) {
                    _uiState.update {
                        it.copy(
                            serverUrl = credentials.serverUrl,
                            username = credentials.username,
                            password = credentials.password
                        )
                    }
                }
            }
        }
    }
    /**
     * [CONTRACT]
     * [ACTION] Обновляет URL сервера в состоянии UI в ответ на ввод пользователя.
     * @param newUrl Новое значение URL.
     * @sideeffect Обновляет поле `serverUrl` в `_uiState`.
     */
    fun onServerUrlChange(newUrl: String) {
        _uiState.update { it.copy(serverUrl = newUrl) }
    }
    /**
     * [CONTRACT]
     * [ACTION] Обновляет имя пользователя в состоянии UI в ответ на ввод пользователя.
     * @param newUsername Новое значение имени пользователя.
     * @sideeffect Обновляет поле `username` в `_uiState`.
     */
    fun onUsernameChange(newUsername: String) {
        _uiState.update { it.copy(username = newUsername) }
    }
    /**
     * [CONTRACT]
     * [ACTION] Обновляет пароль в состоянии UI в ответ на ввод пользователя.
     * @param newPassword Новое значение пароля.
     * @sideeffect Обновляет поле `password` в `_uiState`.
     */
    fun onPasswordChange(newPassword: String) {
        _uiState.update { it.copy(password = newPassword) }
    }
    /**
     * [CONTRACT]
     * [ACTION] Запускает процесс подключения и входа в систему по действию пользователя.
     * Выполняет две основные операции:
     * 1. Сохраняет введенные учетные данные для последующих сессий.
     * 2. Выполняет вход в систему с использованием этих данных.
     * @sideeffect Обновляет `_uiState`, управляя флагами `isLoading`, `error` и `isSetupComplete`.
     * @sideeffect Вызывает `credentialsRepository.saveCredentials`, изменяя сохраненные данные.
     * @sideeffect Вызывает `loginUseCase`, который, в свою очередь, сохраняет токен.
     */
    fun connect() {
        // [ENTRYPOINT]
        viewModelScope.launch {
            // [ACTION] Устанавливаем состояние загрузки и сбрасываем предыдущую ошибку.
            _uiState.update { it.copy(isLoading = true, error = null) }
            // [PREPARATION] Готовим данные для операций, очищая их от лишних пробелов.
            val credentials = Credentials(
                serverUrl = _uiState.value.serverUrl.trim(),
                username = _uiState.value.username.trim(),
                password = _uiState.value.password
            )
            // [ACTION] Сохраняем учетные данные для будущего использования.
            credentialsRepository.saveCredentials(credentials)
            // [CORE-LOGIC] Выполняем UseCase и обрабатываем результат.
            loginUseCase(credentials).fold(
                onSuccess = {
                    // [ACTION] Обработка успеха: обновляем UI, отмечая завершение настройки.
                    _uiState.update { it.copy(isLoading = false, isSetupComplete = true) }
                },
                onFailure = { exception ->
                    // [ERROR_HANDLER] Обработка ошибки: обновляем UI с сообщением об ошибке.
                    _uiState.update { it.copy(isLoading = false, error = exception.message ?: "Login failed") }
                }
            )
        }
    }
    // [END_CLASS_SetupViewModel]
 }
 // [END_FILE_SetupViewModel.kt]
--- a/app/src/main/java/com/homebox/lens/ui/theme/Theme.kt
+++ b/app/src/main/java/com/homebox/lens/ui/theme/Theme.kt
@@ -1,64 +0,0 @@
 // [PACKAGE] com.homebox.lens.ui.theme
 // [FILE] Theme.kt
 package com.homebox.lens.ui.theme
 import android.app.Activity
 import android.os.Build
 import androidx.compose.foundation.isSystemInDarkTheme
 import androidx.compose.material3.MaterialTheme
 import androidx.compose.material3.darkColorScheme
 import androidx.compose.material3.dynamicDarkColorScheme
 import androidx.compose.material3.dynamicLightColorScheme
 import androidx.compose.material3.lightColorScheme
 import androidx.compose.runtime.Composable
 import androidx.compose.runtime.SideEffect
 import androidx.compose.ui.graphics.toArgb
 import androidx.compose.ui.platform.LocalContext
 import androidx.compose.ui.platform.LocalView
 import androidx.core.view.WindowCompat
 private val DarkColorScheme = darkColorScheme(
    primary = Purple80,
    secondary = PurpleGrey80,
    tertiary = Pink80
 )
 private val LightColorScheme = lightColorScheme(
    primary = Purple40,
    secondary = PurpleGrey40,
    tertiary = Pink40
 )
@Composable
 fun HomeboxLensTheme(
    darkTheme: Boolean = isSystemInDarkTheme(),
    // Dynamic color is available on Android 12+
    dynamicColor: Boolean = true,
    content: @Composable () -> Unit
 ) {
    val colorScheme = when {
        dynamicColor && Build.VERSION.SDK_INT >= Build.VERSION_CODES.S -> {
            val context = LocalContext.current
            if (darkTheme) dynamicDarkColorScheme(context) else dynamicLightColorScheme(context)
        }
        darkTheme -> DarkColorScheme
        else -> LightColorScheme
    }
    val view = LocalView.current
    if (!view.isInEditMode) {
        SideEffect {
            val window = (view.context as Activity).window
            window.statusBarColor = colorScheme.primary.toArgb()
            WindowCompat.getInsetsController(window, view).isAppearanceLightStatusBars = darkTheme
        }
    }
    MaterialTheme(
        colorScheme = colorScheme,
        typography = Typography,
        content = content
    )
 }
 // [END_FILE_Theme.kt]
--- a/app/src/main/java/com/homebox/lens/ui/theme/Typography.kt
+++ b/app/src/main/java/com/homebox/lens/ui/theme/Typography.kt
@@ -1,23 +0,0 @@
 // [PACKAGE] com.homebox.lens.ui.theme
 // [FILE] Typography.kt
 package com.homebox.lens.ui.theme
 import androidx.compose.material3.Typography
 import androidx.compose.ui.text.TextStyle
 import androidx.compose.ui.text.font.FontFamily
 import androidx.compose.ui.text.font.FontWeight
 import androidx.compose.ui.unit.sp
 // Set of Material typography styles to start with
 val Typography = Typography(
    bodyLarge = TextStyle(
        fontFamily = FontFamily.Default,
        fontWeight = FontWeight.Normal,
        fontSize = 16.sp,
        lineHeight = 24.sp,
        letterSpacing = 0.5.sp
    )
 )
 // [END_FILE_Typography.kt]
--- a/app/src/main/res/values-en/strings.xml
+++ b/app/src/main/res/values-en/strings.xml
@@ -3,6 +3,8 @@
    <!-- Common -->
    <string name="create">Create</string>
    <string name="edit">Edit</string>
    <string name="delete">Delete</string>
    <string name="search">Search</string>
    <string name="logout">Logout</string>
    <string name="no_location">No location</string>
@@ -12,9 +14,11 @@
    <!-- Content Descriptions -->
    <string name="cd_open_navigation_drawer">Open navigation drawer</string>
    <string name="cd_scan_qr_code">Scan QR code</string>
    <string name="cd_search">Search</string>
    <string name="cd_navigate_back">Navigate back</string>
    <string name="cd_navigate_up">Go back</string>
    <string name="cd_add_new_location">Add new location</string>
-    <string name="cd_add_new_label">Add new label</string>
+    <string name="content_desc_add_label">Add new label</string>
    <!-- Dashboard Screen -->
    <string name="dashboard_title">Dashboard</string>
@@ -34,6 +38,30 @@
    <string name="nav_locations">Locations</string>
    <string name="nav_labels">Labels</string>
    <!-- Screen Titles -->
    <string name="inventory_list_title">Inventory</string>
    <!-- Screen Titles -->
    <string name="item_details_title">Details</string>
    <string name="item_edit_title">Edit Item</string>
    <string name="labels_list_title">Labels</string>
    <string name="locations_list_title">Locations</string>
    <string name="search_title">Search</string>
    <string name="save_item">Save</string>
    <string name="item_name">Name</string>
    <string name="item_description">Description</string>
    <string name="item_quantity">Quantity</string>
    <!-- Location Edit Screen -->
    <string name="location_edit_title_create">Create Location</string>
    <string name="location_edit_title_edit">Edit Location</string>
    <!-- Locations List Screen -->
    <string name="locations_not_found">Locations not found. Press + to add a new one.</string>
    <string name="item_count">Items: %1$d</string>
    <string name="cd_more_options">More options</string>
    <!-- Setup Screen -->
    <string name="setup_title">Server Setup</string>
    <string name="setup_server_url_label">Server URL</string>
@@ -41,4 +69,78 @@
    <string name="setup_password_label">Password</string>
    <string name="setup_connect_button">Connect</string>
    <!-- Labels List Screen -->
    <string name="screen_title_labels">Labels</string>
    <string name="content_desc_navigate_back">Navigate back</string>
    <string name="content_desc_create_label">Create new label</string>
    <string name="content_desc_label_icon">Label icon</string>
    <string name="content_desc_delete_label">Delete label</string>
    <string name="no_labels_found">No labels found.</string>
    <string name="dialog_title_create_label">Create Label</string>
    <string name="dialog_field_label_name">Label Name</string>
    <string name="dialog_button_create">Create</string>
    <string name="dialog_button_cancel">Cancel</string>
    <!-- Inventory List Screen -->
    <string name="content_desc_sync_inventory">Sync inventory</string>
    <!-- Item Details Screen -->
    <string name="content_desc_edit_item">Edit item</string>
    <string name="content_desc_delete_item">Delete item</string>
    <string name="section_title_description">Description</string>
    <string name="placeholder_no_description">No description</string>
    <string name="section_title_details">Details</string>
    <string name="label_quantity">Quantity</string>
    <string name="label_location">Location</string>
    <string name="section_title_labels">Labels</string>
    <!-- Item Edit Screen -->
    <string name="item_edit_title_create">Create item</string>
    <string name="content_desc_save_item">Save item</string>
    <string name="label_name">Name</string>
    <string name="label_description">Description</string>
    <!-- Search Screen -->
    <string name="placeholder_search_items">Search items...</string>
    <!-- Setup Screen -->
    <string name="screen_title_setup">Setup</string>
    <!-- Label Edit Screen -->
    <string name="label_edit_title_create">Create label</string>
    <string name="label_edit_title_edit">Edit label</string>
    <string name="label_name_edit">Label name</string>
    <!-- Common Actions -->
    <string name="back">Back</string>
    <string name="save">Save</string>
    <!-- Color Picker -->
    <string name="label_color">Color</string>
    <string name="label_hex_color">HEX color code</string>
    <string name="item_asset_id">Asset ID</string>
    <string name="item_notes">Notes</string>
    <string name="item_serial_number">Serial Number</string>
    <string name="item_purchase_price">Purchase Price</string>
    <string name="item_purchase_date">Purchase Date</string>
    <string name="item_warranty_until">Warranty Until</string>
    <string name="item_parent_id">Parent ID</string>
    <string name="item_is_archived">Is Archived</string>
    <string name="item_insured">Insured</string>
    <string name="item_lifetime_warranty">Lifetime Warranty</string>
    <string name="item_sync_child_items_locations">Sync Child Items Locations</string>
    <string name="item_manufacturer">Manufacturer</string>
    <string name="item_model_number">Model Number</string>
    <string name="item_purchase_from">Purchase From</string>
    <string name="item_warranty_details">Warranty Details</string>
    <string name="item_sold_notes">Sold Notes</string>
    <string name="item_sold_price">Sold Price</string>
    <string name="item_sold_time">Sold Time</string>
    <string name="item_sold_to">Sold To</string>
    <string name="scan_qr_code">Scan QR Code</string>
    <string name="ok">OK</string>
    <string name="cancel">Cancel</string>
 </resources>
--- a/app/src/main/res/values/strings.xml
+++ b/app/src/main/res/values/strings.xml
@@ -13,10 +13,34 @@
    <!-- Content Descriptions -->
    <string name="cd_open_navigation_drawer">Открыть боковое меню</string>
-    <string name="cd_scan_qr_code">Сканировать QR-код</string>
+    <string name="cd_scan_qr_code">Сканировать QR/штрих-код</string>
    <string name="cd_search">Поиск</string>
    <string name="cd_navigate_back">Вернуться назад</string>
    <string name="cd_navigate_up">Вернуться</string>
    <string name="cd_add_new_location">Добавить новую локацию</string>
-    <string name="cd_add_new_label">Добавить новую метку</string>
+    <string name="content_desc_add_label">Добавить новую метку</string>
    <!-- Inventory List Screen -->
    <string name="content_desc_sync_inventory">Синхронизировать инвентарь</string>
    <!-- Item Details Screen -->
    <string name="content_desc_edit_item">Редактировать элемент</string>
    <string name="content_desc_delete_item">Удалить элемент</string>
    <string name="section_title_description">Описание</string>
    <string name="placeholder_no_description">Нет описания</string>
    <string name="section_title_details">Детали</string>
    <string name="label_quantity">Количество</string>
    <string name="label_location">Местоположение</string>
    <string name="section_title_labels">Метки</string>
    <!-- Item Edit Screen -->
    <string name="item_edit_title_create">Создать элемент</string>
    <string name="content_desc_save_item">Сохранить элемент</string>
    <string name="label_name">Название</string>
    <string name="label_description">Описание</string>
    <!-- Search Screen -->
    <string name="placeholder_search_items">Поиск элементов...</string>
    <!-- Dashboard Screen -->
    <string name="dashboard_title">Главная</string>
@@ -44,6 +68,11 @@
    <string name="locations_list_title">Места хранения</string>
    <string name="search_title">Поиск</string>
    <string name="save_item">Сохранить</string>
    <string name="item_name">Название</string>
    <string name="item_description">Описание</string>
    <string name="item_quantity">Количество</string>
    <!-- Location Edit Screen -->
    <string name="location_edit_title_create">Создать локацию</string>
    <string name="location_edit_title_edit">Редактировать локацию</string>
@@ -54,6 +83,7 @@
    <string name="cd_more_options">Больше опций</string>
    <!-- Setup Screen -->
    <string name="screen_title_setup">Настройка</string>
    <string name="setup_title">Настройка сервера</string>
    <string name="setup_server_url_label">URL сервера</string>
    <string name="setup_username_label">Имя пользователя</string>
@@ -62,15 +92,49 @@
    <!-- Labels List Screen -->
    <string name="screen_title_labels">Метки</string>
-    <string name="content_desc_navigate_back">Вернуться назад</string>
+    <string name="content_desc_navigate_back" translatable="false">Вернуться назад</string>
    <string name="content_desc_create_label">Создать новую метку</string>
    <string name="content_desc_label_icon">Иконка метки</string>
-    <string name="labels_list_empty">Метки еще не созданы.</string>
+    <string name="content_desc_delete_label">Удалить метку</string>
    <string name="no_labels_found">Метки не найдены.</string>
    <string name="dialog_title_create_label">Создать метку</string>
    <string name="dialog_field_label_name">Название метки</string>
    <string name="dialog_button_create">Создать</string>
    <string name="dialog_button_cancel">Отмена</string>
    <!-- Label Edit Screen -->
    <string name="label_edit_title_create">Создать метку</string>
    <string name="label_edit_title_edit">Редактировать метку</string>
    <string name="label_name_edit">Название метки</string>
    <!-- Common Actions -->
    <string name="back">Назад</string>
    <string name="save">Сохранить</string>
    <!-- Common Actions -->
    <!-- Color Picker -->
    <string name="label_color">Цвет</string>
    <string name="label_hex_color">HEX-код цвета</string>
    <string name="item_asset_id">Идентификатор актива</string>
    <string name="item_notes">Заметки</string>
    <string name="item_serial_number">Серийный номер</string>
    <string name="item_purchase_price">Цена покупки</string>
    <string name="item_purchase_date">Дата покупки</string>
    <string name="item_warranty_until">Гарантия до</string>
    <string name="item_parent_id">Родительский ID</string>
    <string name="item_is_archived">Архивировано</string>
    <string name="item_insured">Застраховано</string>
    <string name="item_lifetime_warranty">Пожизненная гарантия</string>
    <string name="item_sync_child_items_locations">Синхронизировать дочерние элементы</string>
    <string name="item_manufacturer">Производитель</string>
    <string name="item_model_number">Номер модели</string>
    <string name="item_purchase_from">Куплено у</string>
    <string name="item_warranty_details">Детали гарантии</string>
    <string name="item_sold_notes">Примечания о продаже</string>
    <string name="item_sold_price">Цена продажи</string>
    <string name="item_sold_time">Время продажи</string>
    <string name="item_sold_to">Продано кому</string>
    <string name="scan_qr_code">Сканировать QR-код</string>
    <string name="ok">ОК</string>
    <string name="cancel">Отмена</string>
 </resources>
--- a/build.gradle.kts
+++ b/build.gradle.kts
@@ -1,13 +1,13 @@
 // [FILE] build.gradle.kts
-// [PURPOSE] Root build file for the project, configures plugins for all modules.
+// [SEMANTICS] build, configuration
 // [AI_NOTE]: Root build file for the project, configures plugins for all modules.
 plugins {
-    // [PLUGIN] Android Application plugin
+    id("com.android.application") version "8.12.3" apply false
-    id("com.android.application") version "8.11.1" apply false
+    id("org.jetbrains.kotlin.android") version "2.0.0" apply false
-    // [PLUGIN] Kotlin Android plugin
+    id("org.jetbrains.kotlin.plugin.compose") version "2.0.0" apply false
-    id("org.jetbrains.kotlin.android") version "1.9.22" apply false
+    id("com.google.dagger.hilt.android") version "2.51.1" apply false
-    // [PLUGIN] Hilt Android plugin
+    id("com.google.devtools.ksp") version "2.0.0-1.0.24" apply false
    id("com.google.dagger.hilt.android") version "2.48.1" apply false
 }
 // [END_FILE_build.gradle.kts]
--- a/buildSrc/src/main/java/Dependencies.kt
+++ b/buildSrc/src/main/java/Dependencies.kt
@@ -1,72 +1,56 @@
 // [PACKAGE] buildsrc.dependencies
 // [FILE] Dependencies.kt
-// [PURPOSE] Centralized dependency management for the entire project.
+// [SEMANTICS] build, dependencies
 // [ENTITY: Object('Versions')]
 object Versions {
    // Build
    const val compileSdk = 34
-    const val minSdk = 26
+    const val minSdk = 24
    const val targetSdk = 34
    const val versionCode = 1
    const val versionName = "1.0"
-
+    const val kotlin = "1.9.10"
    // Kotlin
    const val kotlin = "1.9.22"
    const val coroutines = "1.7.3"
-
+    const val composeCompiler = "1.5.4"
-    // Jetpack Compose
+    const val composeBom = "2024.05.00"
    const val composeCompiler = "1.5.8"
    const val composeBom = "2023.10.01"
    const val activityCompose = "1.8.2"
-    const val navigationCompose = "2.7.6"
+    const val navigationCompose = "2.7.7"
    const val hiltNavigationCompose = "1.1.0"
    // AndroidX
    const val coreKtx = "1.12.0"
-    const val lifecycle = "2.6.2"
+    const val lifecycle = "2.7.0"
    const val appcompat = "1.6.1"
    // Networking
    const val retrofit = "2.9.0"
    const val okhttp = "4.12.0"
-    const val moshi = "1.15.0"
+    const val moshi = "1.15.1"
    // Database
    const val room = "2.6.1"
-
+    const val hilt = "2.51.1"
-    // DI
+    const val hiltCompiler = "1.2.0"
    const val hilt = "2.48.1"
    const val hiltCompiler = "1.1.0"
    // Logging
    const val timber = "5.0.1"
    // Testing
    const val junit = "4.13.2"
    const val extJunit = "1.1.5"
    const val espresso = "3.5.1"
    const val kotest = "5.8.0"
    const val mockk = "1.13.10"
 }
 // [END_ENTITY: Object('Versions')]
 // [ENTITY: Object('Libs')]
 object Libs {
    // Kotlin
    const val coroutinesCore = "org.jetbrains.kotlinx:kotlinx-coroutines-core:${Versions.coroutines}"
    const val coroutinesAndroid = "org.jetbrains.kotlinx:kotlinx-coroutines-android:${Versions.coroutines}"
    // AndroidX
    const val coreKtx = "androidx.core:core-ktx:${Versions.coreKtx}"
    const val lifecycleRuntime = "androidx.lifecycle:lifecycle-runtime-ktx:${Versions.lifecycle}"
    const val appcompat = "androidx.appcompat:appcompat:${Versions.appcompat}"
-
+    const val composeUi = "androidx.compose.ui:ui:1.5.4"
-    // Compose
+    const val composeUiGraphics = "androidx.compose.ui:ui-graphics:1.5.4"
-    const val composeBom = "androidx.compose:compose-bom:${Versions.composeBom}"
+    const val composeUiToolingPreview = "androidx.compose.ui:ui-tooling-preview:1.5.4"
-    const val composeUi = "androidx.compose.ui:ui"
+    const val composeMaterial3 = "androidx.compose.material3:material3:1.1.2"
-    const val composeUiGraphics = "androidx.compose.ui:ui-graphics"
+    const val composeFoundation = "androidx.compose.foundation:foundation:1.5.4"
-    const val composeUiToolingPreview = "androidx.compose.ui:ui-tooling-preview"
+    const val composeFoundationLayout = "androidx.compose.foundation:foundation-layout:1.5.4"
-    const val composeMaterial3 = "androidx.compose.material3:material3"
+    const val composeMaterialIconsExtended = "androidx.compose.material:material-icons-extended:1.5.4"
    const val activityCompose = "androidx.activity:activity-compose:${Versions.activityCompose}"
    const val navigationCompose = "androidx.navigation:navigation-compose:${Versions.navigationCompose}"
    const val hiltNavigationCompose = "androidx.hilt:hilt-navigation-compose:${Versions.hiltNavigationCompose}"
    // Networking (Retrofit, OkHttp, Moshi)
    const val retrofit = "com.squareup.retrofit2:retrofit:${Versions.retrofit}"
    const val converterMoshi = "com.squareup.retrofit2:converter-moshi:${Versions.retrofit}"
    const val okhttp = "com.squareup.okhttp3:okhttp:${Versions.okhttp}"
@@ -74,27 +58,22 @@ object Libs {
    const val moshi = "com.squareup.moshi:moshi:${Versions.moshi}"
    const val moshiKotlin = "com.squareup.moshi:moshi-kotlin:${Versions.moshi}"
    const val moshiCodegen = "com.squareup.moshi:moshi-kotlin-codegen:${Versions.moshi}"
    // Database (Room)
    const val roomRuntime = "androidx.room:room-runtime:${Versions.room}"
    const val roomKtx = "androidx.room:room-ktx:${Versions.room}"
    const val roomCompiler = "androidx.room:room-compiler:${Versions.room}"
    // Dependency Injection (Hilt)
    const val hiltAndroid = "com.google.dagger:hilt-android:${Versions.hilt}"
    const val hiltCompiler = "com.google.dagger:hilt-android-compiler:${Versions.hilt}"
    // Logging
    const val timber = "com.jakewharton.timber:timber:${Versions.timber}"
    // Testing
    const val junit = "junit:junit:${Versions.junit}"
    const val extJunit = "androidx.test.ext:junit:${Versions.extJunit}"
    const val espressoCore = "androidx.test.espresso:espresso-core:${Versions.espresso}"
-    const val composeUiTestJunit4 = "androidx.compose.ui:ui-test-junit4"
+    const val composeUiTestJunit4 = "androidx.compose.ui:ui-test-junit4:1.5.4"
-    const val composeUiTooling = "androidx.compose.ui:ui-tooling"
+    const val composeUiTooling = "androidx.compose.ui:ui-tooling:1.5.4"
-    const val composeUiTestManifest = "androidx.compose.ui:ui-test-manifest"
+    const val composeUiTestManifest = "androidx.compose.ui:ui-test-manifest:1.5.4"
-
+    const val kotestRunnerJunit5 = "io.kotest:kotest-runner-junit5:${Versions.kotest}"
    const val kotestAssertionsCore = "io.kotest:kotest-assertions-core:${Versions.kotest}"
    const val mockk = "io.mockk:mockk:${Versions.mockk}"
 }
 // [END_ENTITY: Object('Libs')]
 // [END_FILE_Dependencies.kt]
--- a/data/build.gradle.kts
+++ b/data/build.gradle.kts
@@ -62,6 +62,9 @@ dependencies {
    implementation(Libs.hiltAndroid)
    kapt(Libs.hiltCompiler)
    // [DEPENDENCY] Logging
    implementation(Libs.timber)
    // [DEPENDENCY] Testing
    testImplementation(Libs.junit)
    androidTestImplementation(Libs.extJunit)
--- a/data/semantic-ktlint-rules/.gitignore
+++ b/data/semantic-ktlint-rules/.gitignore
@@ -1 +0,0 @@
 /build
--- a/data/semantic-ktlint-rules/build.gradle.kts
+++ b/data/semantic-ktlint-rules/build.gradle.kts
@@ -1,46 +0,0 @@
 plugins {
    id("com.android.application")
    id("org.jetbrains.kotlin.android")
 }
 android {
    namespace = "com.busya.ktlint.rules"
    compileSdk = 34
    defaultConfig {
        applicationId = "com.busya.ktlint.rules"
        minSdk = 24
        targetSdk = 34
        versionCode = 1
        versionName = "1.0"
        testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
    }
    buildTypes {
        release {
            isMinifyEnabled = false
            proguardFiles(
                getDefaultProguardFile("proguard-android-optimize.txt"),
                "proguard-rules.pro"
            )
        }
    }
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_11
        targetCompatibility = JavaVersion.VERSION_11
    }
    kotlinOptions {
        jvmTarget = "11"
    }
 }
 dependencies {
    implementation("androidx.core:core-ktx:1.10.1")
    implementation("androidx.appcompat:appcompat:1.6.1")
    implementation("com.google.android.material:material:1.10.0")
    testImplementation("junit:junit:4.13.2")
    androidTestImplementation("androidx.test.ext:junit:1.1.5")
    androidTestImplementation("androidx.test.espresso:espresso-core:3.5.1")
 }
--- a/data/semantic-ktlint-rules/proguard-rules.pro
+++ b/data/semantic-ktlint-rules/proguard-rules.pro
@@ -1,21 +0,0 @@
 # Add project specific ProGuard rules here.
 # You can control the set of applied configuration files using the
 # proguardFiles setting in build.gradle.
 #
 # For more details, see
 #   http://developer.android.com/guide/developing/tools/proguard.html
 # If your project uses WebView with JS, uncomment the following
 # and specify the fully qualified class name to the JavaScript interface
 # class:
 #-keepclassmembers class fqcn.of.javascript.interface.for.webview {
 #   public *;
 #}
 # Uncomment this to preserve the line number information for
 # debugging stack traces.
 #-keepattributes SourceFile,LineNumberTable
 # If you keep the line number information, uncomment this to
 # hide the original source file name.
 #-renamesourcefileattribute SourceFile
--- a/data/semantic-ktlint-rules/src/androidTest/java/com/busya/ktlint/rules/ExampleInstrumentedTest.kt
+++ b/data/semantic-ktlint-rules/src/androidTest/java/com/busya/ktlint/rules/ExampleInstrumentedTest.kt
@@ -1,24 +0,0 @@
 package com.busya.ktlint.rules
 import androidx.test.platform.app.InstrumentationRegistry
 import androidx.test.ext.junit.runners.AndroidJUnit4
 import org.junit.Test
 import org.junit.runner.RunWith
 import org.junit.Assert.*
 /**
 * Instrumented test, which will execute on an Android device.
 *
 * See [testing documentation](http://d.android.com/tools/testing).
 */
@RunWith(AndroidJUnit4::class)
 class ExampleInstrumentedTest {
    @Test
    fun useAppContext() {
        // Context of the app under test.
        val appContext = InstrumentationRegistry.getInstrumentation().targetContext
        assertEquals("com.busya.ktlint.rules", appContext.packageName)
    }
 }
--- a/data/semantic-ktlint-rules/src/main/AndroidManifest.xml
+++ b/data/semantic-ktlint-rules/src/main/AndroidManifest.xml
@@ -1,12 +0,0 @@
 <?xml version="1.0" encoding="utf-8"?>
 <manifest xmlns:android="http://schemas.android.com/apk/res/android">
    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/Theme.HomeboxLens" />
 </manifest>
--- a/data/semantic-ktlint-rules/src/main/java/com/busya/ktlint/rules/CustomRuleSetProvider.kt
+++ b/data/semantic-ktlint-rules/src/main/java/com/busya/ktlint/rules/CustomRuleSetProvider.kt
@@ -1,4 +0,0 @@
 package com.busya.ktlint.rules
 class CustomRuleSetProvider {
 }
--- a/data/semantic-ktlint-rules/src/main/java/com/busya/ktlint/rules/FileHeaderRule.kt
+++ b/data/semantic-ktlint-rules/src/main/java/com/busya/ktlint/rules/FileHeaderRule.kt
@@ -1,4 +0,0 @@
 package com.busya.ktlint.rules
 class FileHeaderRule {
 }
--- a/data/semantic-ktlint-rules/src/main/java/com/busya/ktlint/rules/MandatoryEntityDeclarationRule.kt
+++ b/data/semantic-ktlint-rules/src/main/java/com/busya/ktlint/rules/MandatoryEntityDeclarationRule.kt
@@ -1,4 +0,0 @@
 package com.busya.ktlint.rules
 class MandatoryEntityDeclarationRule {
 }
--- a/data/semantic-ktlint-rules/src/main/java/com/busya/ktlint/rules/NoStrayCommentsRule.kt
+++ b/data/semantic-ktlint-rules/src/main/java/com/busya/ktlint/rules/NoStrayCommentsRule.kt
@@ -1,4 +0,0 @@
 package com.busya.ktlint.rules
 class NoStrayCommentsRule {
 }
--- a/data/semantic-ktlint-rules/src/main/res/drawable/ic_launcher_background.xml
+++ b/data/semantic-ktlint-rules/src/main/res/drawable/ic_launcher_background.xml
@@ -1,170 +0,0 @@
 <?xml version="1.0" encoding="utf-8"?>
 <vector xmlns:android="http://schemas.android.com/apk/res/android"
    android:width="108dp"
    android:height="108dp"
    android:viewportWidth="108"
    android:viewportHeight="108">
    <path
        android:fillColor="#3DDC84"
        android:pathData="M0,0h108v108h-108z" />
    <path
        android:fillColor="#00000000"
        android:pathData="M9,0L9,108"
        android:strokeWidth="0.8"
        android:strokeColor="#33FFFFFF" />
    <path
        android:fillColor="#00000000"
        android:pathData="M19,0L19,108"
        android:strokeWidth="0.8"
        android:strokeColor="#33FFFFFF" />
    <path
        android:fillColor="#00000000"
        android:pathData="M29,0L29,108"
        android:strokeWidth="0.8"
        android:strokeColor="#33FFFFFF" />
    <path
        android:fillColor="#00000000"
        android:pathData="M39,0L39,108"
        android:strokeWidth="0.8"
        android:strokeColor="#33FFFFFF" />
    <path
        android:fillColor="#00000000"
        android:pathData="M49,0L49,108"
        android:strokeWidth="0.8"
        android:strokeColor="#33FFFFFF" />
    <path
        android:fillColor="#00000000"
        android:pathData="M59,0L59,108"
        android:strokeWidth="0.8"
        android:strokeColor="#33FFFFFF" />
    <path
        android:fillColor="#00000000"
        android:pathData="M69,0L69,108"
        android:strokeWidth="0.8"
        android:strokeColor="#33FFFFFF" />
    <path
        android:fillColor="#00000000"
        android:pathData="M79,0L79,108"
        android:strokeWidth="0.8"
        android:strokeColor="#33FFFFFF" />
    <path
        android:fillColor="#00000000"
        android:pathData="M89,0L89,108"
        android:strokeWidth="0.8"
        android:strokeColor="#33FFFFFF" />
    <path
        android:fillColor="#00000000"
        android:pathData="M99,0L99,108"
        android:strokeWidth="0.8"
        android:strokeColor="#33FFFFFF" />
    <path
        android:fillColor="#00000000"
        android:pathData="M0,9L108,9"
        android:strokeWidth="0.8"
        android:strokeColor="#33FFFFFF" />
    <path
        android:fillColor="#00000000"
        android:pathData="M0,19L108,19"
        android:strokeWidth="0.8"
        android:strokeColor="#33FFFFFF" />
    <path
        android:fillColor="#00000000"
        android:pathData="M0,29L108,29"
        android:strokeWidth="0.8"
        android:strokeColor="#33FFFFFF" />
    <path
        android:fillColor="#00000000"
        android:pathData="M0,39L108,39"
        android:strokeWidth="0.8"
        android:strokeColor="#33FFFFFF" />
    <path
        android:fillColor="#00000000"
        android:pathData="M0,49L108,49"
        android:strokeWidth="0.8"
        android:strokeColor="#33FFFFFF" />
    <path
        android:fillColor="#00000000"
        android:pathData="M0,59L108,59"
        android:strokeWidth="0.8"
        android:strokeColor="#33FFFFFF" />
    <path
        android:fillColor="#00000000"
        android:pathData="M0,69L108,69"
        android:strokeWidth="0.8"
        android:strokeColor="#33FFFFFF" />
    <path
        android:fillColor="#00000000"
        android:pathData="M0,79L108,79"
        android:strokeWidth="0.8"
        android:strokeColor="#33FFFFFF" />
    <path
        android:fillColor="#00000000"
        android:pathData="M0,89L108,89"
        android:strokeWidth="0.8"
        android:strokeColor="#33FFFFFF" />
    <path
        android:fillColor="#00000000"
        android:pathData="M0,99L108,99"
        android:strokeWidth="0.8"
        android:strokeColor="#33FFFFFF" />
    <path
        android:fillColor="#00000000"
        android:pathData="M19,29L89,29"
        android:strokeWidth="0.8"
        android:strokeColor="#33FFFFFF" />
    <path
        android:fillColor="#00000000"
        android:pathData="M19,39L89,39"
        android:strokeWidth="0.8"
        android:strokeColor="#33FFFFFF" />
    <path
        android:fillColor="#00000000"
        android:pathData="M19,49L89,49"
        android:strokeWidth="0.8"
        android:strokeColor="#33FFFFFF" />
    <path
        android:fillColor="#00000000"
        android:pathData="M19,59L89,59"
        android:strokeWidth="0.8"
        android:strokeColor="#33FFFFFF" />
    <path
        android:fillColor="#00000000"
        android:pathData="M19,69L89,69"
        android:strokeWidth="0.8"
        android:strokeColor="#33FFFFFF" />
    <path
        android:fillColor="#00000000"
        android:pathData="M19,79L89,79"
        android:strokeWidth="0.8"
        android:strokeColor="#33FFFFFF" />
    <path
        android:fillColor="#00000000"
        android:pathData="M29,19L29,89"
        android:strokeWidth="0.8"
        android:strokeColor="#33FFFFFF" />
    <path
        android:fillColor="#00000000"
        android:pathData="M39,19L39,89"
        android:strokeWidth="0.8"
        android:strokeColor="#33FFFFFF" />
    <path
        android:fillColor="#00000000"
        android:pathData="M49,19L49,89"
        android:strokeWidth="0.8"
        android:strokeColor="#33FFFFFF" />
    <path
        android:fillColor="#00000000"
        android:pathData="M59,19L59,89"
        android:strokeWidth="0.8"
        android:strokeColor="#33FFFFFF" />
    <path
        android:fillColor="#00000000"
        android:pathData="M69,19L69,89"
        android:strokeWidth="0.8"
        android:strokeColor="#33FFFFFF" />
    <path
        android:fillColor="#00000000"
        android:pathData="M79,19L79,89"
        android:strokeWidth="0.8"
        android:strokeColor="#33FFFFFF" />
 </vector>
--- a/data/semantic-ktlint-rules/src/main/res/drawable/ic_launcher_foreground.xml
+++ b/data/semantic-ktlint-rules/src/main/res/drawable/ic_launcher_foreground.xml
@@ -1,30 +0,0 @@
 <vector xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:aapt="http://schemas.android.com/aapt"
    android:width="108dp"
    android:height="108dp"
    android:viewportWidth="108"
    android:viewportHeight="108">
    <path android:pathData="M31,63.928c0,0 6.4,-11 12.1,-13.1c7.2,-2.6 26,-1.4 26,-1.4l38.1,38.1L107,108.928l-32,-1L31,63.928z">
        <aapt:attr name="android:fillColor">
            <gradient
                android:endX="85.84757"
                android:endY="92.4963"
                android:startX="42.9492"
                android:startY="49.59793"
                android:type="linear">
                <item
                    android:color="#44000000"
                    android:offset="0.0" />
                <item
                    android:color="#00000000"
                    android:offset="1.0" />
            </gradient>
        </aapt:attr>
    </path>
    <path
        android:fillColor="#FFFFFF"
        android:fillType="nonZero"
        android:pathData="M65.3,45.828l3.8,-6.6c0.2,-0.4 0.1,-0.9 -0.3,-1.1c-0.4,-0.2 -0.9,-0.1 -1.1,0.3l-3.9,6.7c-6.3,-2.8 -13.4,-2.8 -19.7,0l-3.9,-6.7c-0.2,-0.4 -0.7,-0.5 -1.1,-0.3C38.8,38.328 38.7,38.828 38.9,39.228l3.8,6.6C36.2,49.428 31.7,56.028 31,63.928h46C76.3,56.028 71.8,49.428 65.3,45.828zM43.4,57.328c-0.8,0 -1.5,-0.5 -1.8,-1.2c-0.3,-0.7 -0.1,-1.5 0.4,-2.1c0.5,-0.5 1.4,-0.7 2.1,-0.4c0.7,0.3 1.2,1 1.2,1.8C45.3,56.528 44.5,57.328 43.4,57.328L43.4,57.328zM64.6,57.328c-0.8,0 -1.5,-0.5 -1.8,-1.2s-0.1,-1.5 0.4,-2.1c0.5,-0.5 1.4,-0.7 2.1,-0.4c0.7,0.3 1.2,1 1.2,1.8C66.5,56.528 65.6,57.328 64.6,57.328L64.6,57.328z"
        android:strokeWidth="1"
        android:strokeColor="#00000000" />
 </vector>
--- a/data/semantic-ktlint-rules/src/main/res/mipmap-anydpi-v26/ic_launcher.xml
+++ b/data/semantic-ktlint-rules/src/main/res/mipmap-anydpi-v26/ic_launcher.xml
@@ -1,6 +0,0 @@
 <?xml version="1.0" encoding="utf-8"?>
 <adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
    <background android:drawable="@drawable/ic_launcher_background" />
    <foreground android:drawable="@drawable/ic_launcher_foreground" />
    <monochrome android:drawable="@drawable/ic_launcher_foreground" />
 </adaptive-icon>
--- a/data/semantic-ktlint-rules/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml
+++ b/data/semantic-ktlint-rules/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml
@@ -1,6 +0,0 @@
 <?xml version="1.0" encoding="utf-8"?>
 <adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
    <background android:drawable="@drawable/ic_launcher_background" />
    <foreground android:drawable="@drawable/ic_launcher_foreground" />
    <monochrome android:drawable="@drawable/ic_launcher_foreground" />
 </adaptive-icon>
--- a/data/semantic-ktlint-rules/src/main/res/mipmap-hdpi/ic_launcher.webp
+++ b/data/semantic-ktlint-rules/src/main/res/mipmap-hdpi/ic_launcher.webp
--- a/data/semantic-ktlint-rules/src/main/res/mipmap-hdpi/ic_launcher_round.webp
+++ b/data/semantic-ktlint-rules/src/main/res/mipmap-hdpi/ic_launcher_round.webp
--- a/data/semantic-ktlint-rules/src/main/res/mipmap-mdpi/ic_launcher.webp
+++ b/data/semantic-ktlint-rules/src/main/res/mipmap-mdpi/ic_launcher.webp
--- a/data/semantic-ktlint-rules/src/main/res/mipmap-mdpi/ic_launcher_round.webp
+++ b/data/semantic-ktlint-rules/src/main/res/mipmap-mdpi/ic_launcher_round.webp
--- a/data/semantic-ktlint-rules/src/main/res/mipmap-xhdpi/ic_launcher.webp
+++ b/data/semantic-ktlint-rules/src/main/res/mipmap-xhdpi/ic_launcher.webp
--- a/data/semantic-ktlint-rules/src/main/res/mipmap-xhdpi/ic_launcher_round.webp
+++ b/data/semantic-ktlint-rules/src/main/res/mipmap-xhdpi/ic_launcher_round.webp
--- a/data/semantic-ktlint-rules/src/main/res/mipmap-xxhdpi/ic_launcher.webp
+++ b/data/semantic-ktlint-rules/src/main/res/mipmap-xxhdpi/ic_launcher.webp
--- a/data/semantic-ktlint-rules/src/main/res/mipmap-xxhdpi/ic_launcher_round.webp
+++ b/data/semantic-ktlint-rules/src/main/res/mipmap-xxhdpi/ic_launcher_round.webp
--- a/data/semantic-ktlint-rules/src/main/res/mipmap-xxxhdpi/ic_launcher.webp
+++ b/data/semantic-ktlint-rules/src/main/res/mipmap-xxxhdpi/ic_launcher.webp
--- a/data/semantic-ktlint-rules/src/main/res/mipmap-xxxhdpi/ic_launcher_round.webp
+++ b/data/semantic-ktlint-rules/src/main/res/mipmap-xxxhdpi/ic_launcher_round.webp
--- a/data/semantic-ktlint-rules/src/main/res/values-night/themes.xml
+++ b/data/semantic-ktlint-rules/src/main/res/values-night/themes.xml
@@ -1,16 +0,0 @@
 <resources xmlns:tools="http://schemas.android.com/tools">
    <!-- Base application theme. -->
    <style name="Theme.HomeboxLens" parent="Theme.MaterialComponents.DayNight.DarkActionBar">
        <!-- Primary brand color. -->
        <item name="colorPrimary">@color/purple_200</item>
        <item name="colorPrimaryVariant">@color/purple_700</item>
        <item name="colorOnPrimary">@color/black</item>
        <!-- Secondary brand color. -->
        <item name="colorSecondary">@color/teal_200</item>
        <item name="colorSecondaryVariant">@color/teal_200</item>
        <item name="colorOnSecondary">@color/black</item>
        <!-- Status bar color. -->
        <item name="android:statusBarColor">?attr/colorPrimaryVariant</item>
        <!-- Customize your theme here. -->
    </style>
 </resources>
--- a/data/semantic-ktlint-rules/src/main/res/values/colors.xml
+++ b/data/semantic-ktlint-rules/src/main/res/values/colors.xml
@@ -1,10 +0,0 @@
 <?xml version="1.0" encoding="utf-8"?>
 <resources>
    <color name="purple_200">#FFBB86FC</color>
    <color name="purple_500">#FF6200EE</color>
    <color name="purple_700">#FF3700B3</color>
    <color name="teal_200">#FF03DAC5</color>
    <color name="teal_700">#FF018786</color>
    <color name="black">#FF000000</color>
    <color name="white">#FFFFFFFF</color>
 </resources>
--- a/data/semantic-ktlint-rules/src/main/res/values/strings.xml
+++ b/data/semantic-ktlint-rules/src/main/res/values/strings.xml
@@ -1,3 +0,0 @@
 <resources>
    <string name="app_name">semantic-ktlint-rules</string>
 </resources>
--- a/data/semantic-ktlint-rules/src/main/res/values/themes.xml
+++ b/data/semantic-ktlint-rules/src/main/res/values/themes.xml
@@ -1,16 +0,0 @@
 <resources xmlns:tools="http://schemas.android.com/tools">
    <!-- Base application theme. -->
    <style name="Theme.HomeboxLens" parent="Theme.MaterialComponents.DayNight.DarkActionBar">
        <!-- Primary brand color. -->
        <item name="colorPrimary">@color/purple_500</item>
        <item name="colorPrimaryVariant">@color/purple_700</item>
        <item name="colorOnPrimary">@color/white</item>
        <!-- Secondary brand color. -->
        <item name="colorSecondary">@color/teal_200</item>
        <item name="colorSecondaryVariant">@color/teal_700</item>
        <item name="colorOnSecondary">@color/black</item>
        <!-- Status bar color. -->
        <item name="android:statusBarColor">?attr/colorPrimaryVariant</item>
        <!-- Customize your theme here. -->
    </style>
 </resources>
--- a/data/semantic-ktlint-rules/src/test/java/com/busya/ktlint/rules/ExampleUnitTest.kt
+++ b/data/semantic-ktlint-rules/src/test/java/com/busya/ktlint/rules/ExampleUnitTest.kt
@@ -1,17 +0,0 @@
 package com.busya.ktlint.rules
 import org.junit.Test
 import org.junit.Assert.*
 /**
 * Example local unit test, which will execute on the development machine (host).
 *
 * See [testing documentation](http://d.android.com/tools/testing).
 */
 class ExampleUnitTest {
    @Test
    fun addition_isCorrect() {
        assertEquals(4, 2 + 2)
    }
 }
--- a/data/src/main/java/com/homebox/lens/data/api/HomeboxApiService.kt
+++ b/data/src/main/java/com/homebox/lens/data/api/HomeboxApiService.kt
@@ -1,74 +1,97 @@
 // [PACKAGE] com.homebox.lens.data.api
 // [FILE] HomeboxApiService.kt
 // [SEMANTICS] data, api, retrofit
 package com.homebox.lens.data.api
-import com.homebox.lens.data.api.dto.GroupStatisticsDto
+// [IMPORTS]
-import com.homebox.lens.data.api.dto.ItemCreateDto
+import com.homebox.lens.data.api.dto.*
 import com.homebox.lens.data.api.dto.ItemOutDto
 import com.homebox.lens.data.api.dto.ItemSummaryDto
 import com.homebox.lens.data.api.dto.ItemUpdateDto
 import com.homebox.lens.data.api.dto.LabelCreateDto
 import com.homebox.lens.data.api.dto.LabelOutDto
 import com.homebox.lens.data.api.dto.LabelSummaryDto
 import com.homebox.lens.data.api.dto.LocationOutCountDto
 import com.homebox.lens.data.api.dto.LoginFormDto
 import com.homebox.lens.data.api.dto.PaginationResultDto
 import com.homebox.lens.data.api.dto.TokenResponseDto
 import retrofit2.Response
-import retrofit2.http.Body
+import retrofit2.http.*
-import retrofit2.http.DELETE
+// [END_IMPORTS]
 import retrofit2.http.GET
 import retrofit2.http.Headers
 import retrofit2.http.POST
 import retrofit2.http.PUT
 import retrofit2.http.Path
 import retrofit2.http.Query
-// [CONTRACT]
+// [ENTITY: Interface('HomeboxApiService')]
 /**
- * [ENTITY: Interface('HomeboxApiService')]
+ * @summary Определяет эндпоинты для взаимодействия с Homebox API, используя DTO.
 * [PURPOSE] Определяет эндпоинты для взаимодействия с Homebox API, используя DTO.
 */
 interface HomeboxApiService {
-    // [ENDPOINT] Auth
+    // [ENTITY: ApiEndpoint('login')]
    @Headers("Content-Type: application/json")
    @POST("v1/users/login")
    suspend fun login(@Body loginForm: LoginFormDto): TokenResponseDto
    // [END_ENTITY: ApiEndpoint('login')]
-    // [ENDPOINT] Items
+    // [ENTITY: ApiEndpoint('getItems')]
    @GET("v1/items")
    suspend fun getItems(
        @Query("q") query: String? = null,
        @Query("page") page: Int? = null,
        @Query("pageSize") pageSize: Int? = null
    ): PaginationResultDto<ItemSummaryDto>
    // [END_ENTITY: ApiEndpoint('getItems')]
    // [ENTITY: ApiEndpoint('createItem')]
    @POST("v1/items")
    suspend fun createItem(@Body item: ItemCreateDto): ItemSummaryDto
    // [END_ENTITY: ApiEndpoint('createItem')]
    // [ENTITY: ApiEndpoint('getItem')]
    @GET("v1/items/{id}")
    suspend fun getItem(@Path("id") itemId: String): ItemOutDto
    // [END_ENTITY: ApiEndpoint('getItem')]
    // [ENTITY: ApiEndpoint('updateItem')]
    @PUT("v1/items/{id}")
    suspend fun updateItem(@Path("id") itemId: String, @Body item: ItemUpdateDto): ItemOutDto
    // [END_ENTITY: ApiEndpoint('updateItem')]
    // [ENTITY: ApiEndpoint('deleteItem')]
    @DELETE("v1/items/{id}")
    suspend fun deleteItem(@Path("id") itemId: String): Response<Unit>
    // [END_ENTITY: ApiEndpoint('deleteItem')]
-    // [ENDPOINT] Locations
+    // [ENTITY: ApiEndpoint('getLocations')]
    @GET("v1/locations")
    suspend fun getLocations(): List<LocationOutCountDto>
    // [END_ENTITY: ApiEndpoint('getLocations')]
-    // [ENDPOINT] Labels
+    // [ENTITY: ApiEndpoint('getLabels')]
    @GET("v1/labels")
    suspend fun getLabels(): List<LabelOutDto>
    // [END_ENTITY: ApiEndpoint('getLabels')]
    // [ENTITY: ApiEndpoint('createLabel')]
    @POST("v1/labels")
    suspend fun createLabel(@Body newLabel: LabelCreateDto): LabelSummaryDto
    // [END_ENTITY: ApiEndpoint('createLabel')]
-    // [ENDPOINT] Statistics
+    // [ENTITY: ApiEndpoint('updateLabel')]
    @PUT("v1/labels/{id}")
    suspend fun updateLabel(@Path("id") labelId: String, @Body label: LabelUpdateDto): LabelOutDto
    // [END_ENTITY: ApiEndpoint('updateLabel')]
    // [ENTITY: ApiEndpoint('deleteLabel')]
    @DELETE("v1/labels/{id}")
    suspend fun deleteLabel(@Path("id") labelId: String): Response<Unit>
    // [ENTITY: ApiEndpoint('createLocation')]
    @POST("v1/locations")
    suspend fun createLocation(@Body newLocation: LocationCreateDto): LocationOutDto
    // [END_ENTITY: ApiEndpoint('createLocation')]
    // [ENTITY: ApiEndpoint('updateLocation')]
    @PUT("v1/locations/{id}")
    suspend fun updateLocation(@Path("id") locationId: String, @Body location: LocationUpdateDto): LocationOutDto
    // [END_ENTITY: ApiEndpoint('updateLocation')]
    // [ENTITY: ApiEndpoint('deleteLocation')]
    @DELETE("v1/locations/{id}")
    suspend fun deleteLocation(@Path("id") locationId: String): Response<Unit>
    // [ENTITY: ApiEndpoint('getStatistics')]
    @GET("v1/groups/statistics")
    suspend fun getStatistics(): GroupStatisticsDto
    // [END_ENTITY: ApiEndpoint('getStatistics')]
 }
 // [END_ENTITY: Interface('HomeboxApiService')]
 // [END_FILE_HomeboxApiService.kt]
--- a/data/src/main/java/com/homebox/lens/data/api/dto/CustomFieldDto.kt
+++ b/data/src/main/java/com/homebox/lens/data/api/dto/CustomFieldDto.kt
@@ -8,11 +8,11 @@ package com.homebox.lens.data.api.dto
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 import com.homebox.lens.domain.model.CustomField
 // [END_IMPORTS]
-// [CORE-LOGIC]
+// [ENTITY: DataClass('CustomFieldDto')]
 /**
- * [CONTRACT]
+ * @summary DTO для кастомного поля.
 * DTO для кастомного поля.
 */
@JsonClass(generateAdapter = true)
 data class CustomFieldDto(
@@ -20,10 +20,12 @@ data class CustomFieldDto(
    @Json(name = "value") val value: String,
    @Json(name = "type") val type: String
 )
 // [END_ENTITY: DataClass('CustomFieldDto')]
 // [ENTITY: Function('toDomain')]
 // [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('CustomField')]
 /**
- * [CONTRACT]
+ * @summary Маппер из CustomFieldDto в доменную модель CustomField.
 * Маппер из CustomFieldDto в доменную модель CustomField.
 */
 fun CustomFieldDto.toDomain(): CustomField {
    return CustomField(
@@ -32,3 +34,4 @@ fun CustomFieldDto.toDomain(): CustomField {
        type = this.type
    )
 }
 // [END_ENTITY: Function('toDomain')]
--- a/data/src/main/java/com/homebox/lens/data/api/dto/GroupStatisticsDto.kt
+++ b/data/src/main/java/com/homebox/lens/data/api/dto/GroupStatisticsDto.kt
@@ -8,14 +8,11 @@ package com.homebox.lens.data.api.dto
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 import com.homebox.lens.domain.model.GroupStatistics
 // [END_IMPORTS]
-// [CORE-LOGIC]
+// [ENTITY: DataClass('GroupStatisticsDto')]
 /**
- * [CONTRACT]
+ * @summary DTO для статистики.
 * DTO для статистики.
 * [COHERENCE_NOTE] Этот DTO был исправлен, чтобы точно соответствовать JSON-ответу от сервера.
 * Поля `items`, `labels`, `locations`, `totalValue` были заменены на `totalItems`, `totalLabels`,
 * `totalLocations`, `totalItemPrice` и т.д., чтобы устранить ошибку парсинга `JsonDataException`.
 */
@JsonClass(generateAdapter = true)
 data class GroupStatisticsDto(
@@ -23,19 +20,17 @@ data class GroupStatisticsDto(
    @Json(name = "totalLabels") val totalLabels: Int,
    @Json(name = "totalLocations") val totalLocations: Int,
    @Json(name = "totalItemPrice") val totalItemPrice: Double,
    // [FIX] Добавляем недостающие поля, которые присутствуют в JSON, но отсутствовали в DTO.
    // Делаем их nullable на случай, если API перестанет их присылать в будущем.
    @Json(name = "totalUsers") val totalUsers: Int? = null,
    @Json(name = "totalWithWarranty") val totalWithWarranty: Int? = null
 )
 // [END_ENTITY: DataClass('GroupStatisticsDto')]
 // [ENTITY: Function('toDomain')]
 // [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('GroupStatistics')]
 /**
- * [CONTRACT]
+ * @summary Маппер из GroupStatisticsDto в доменную модель GroupStatistics.
 * Маппер из GroupStatisticsDto в доменную модель GroupStatistics.
 * [COHERENCE_NOTE] Маппер обновлен для использования правильных полей из исправленного DTO.
 */
 fun GroupStatisticsDto.toDomain(): GroupStatistics {
    // [ACTION] Маппим данные из DTO в доменную модель.
    return GroupStatistics(
        items = this.totalItems,
        labels = this.totalLabels,
@@ -43,4 +38,5 @@ fun GroupStatisticsDto.toDomain(): GroupStatistics {
        totalValue = this.totalItemPrice
    )
 }
 // [END_ENTITY: Function('toDomain')]
 // [END_FILE_GroupStatisticsDto.kt]
--- a/data/src/main/java/com/homebox/lens/data/api/dto/ImageDto.kt
+++ b/data/src/main/java/com/homebox/lens/data/api/dto/ImageDto.kt
@@ -8,14 +8,14 @@ package com.homebox.lens.data.api.dto
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 import com.homebox.lens.domain.model.Image
 // [END_IMPORTS]
-// [CORE-LOGIC]
+// [ENTITY: DataClass('ImageDto')]
 /**
- * [CONTRACT]
+ * @summary DTO для изображения.
- * DTO для изображения.
+ * @param id Уникальный идентификатор.
- * @property id Уникальный идентификатор.
+ * @param path Путь к файлу.
- * @property path Путь к файлу.
+ * @param isPrimary Является ли основным.
 * @property isPrimary Является ли основным.
 */
@JsonClass(generateAdapter = true)
 data class ImageDto(
@@ -23,10 +23,12 @@ data class ImageDto(
    @Json(name = "path") val path: String,
    @Json(name = "isPrimary") val isPrimary: Boolean
 )
 // [END_ENTITY: DataClass('ImageDto')]
 // [ENTITY: Function('toDomain')]
 // [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('Image')]
 /**
- * [CONTRACT]
+ * @summary Маппер из ImageDto в доменную модель Image.
 * Маппер из ImageDto в доменную модель Image.
 */
 fun ImageDto.toDomain(): Image {
    return Image(
@@ -35,3 +37,4 @@ fun ImageDto.toDomain(): Image {
        isPrimary = this.isPrimary
    )
 }
 // [END_ENTITY: Function('toDomain')]
--- a/data/src/main/java/com/homebox/lens/data/api/dto/ItemAttachmentDto.kt
+++ b/data/src/main/java/com/homebox/lens/data/api/dto/ItemAttachmentDto.kt
@@ -8,11 +8,11 @@ package com.homebox.lens.data.api.dto
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 import com.homebox.lens.domain.model.ItemAttachment
 // [END_IMPORTS]
-// [CORE-LOGIC]
+// [ENTITY: DataClass('ItemAttachmentDto')]
 /**
- * [CONTRACT]
+ * @summary DTO для вложения.
 * DTO для вложения.
 */
@JsonClass(generateAdapter = true)
 data class ItemAttachmentDto(
@@ -23,10 +23,12 @@ data class ItemAttachmentDto(
    @Json(name = "createdAt") val createdAt: String,
    @Json(name = "updatedAt") val updatedAt: String
 )
 // [END_ENTITY: DataClass('ItemAttachmentDto')]
 // [ENTITY: Function('toDomain')]
 // [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('ItemAttachment')]
 /**
- * [CONTRACT]
+ * @summary Маппер из ItemAttachmentDto в доменную модель ItemAttachment.
 * Маппер из ItemAttachmentDto в доменную модель ItemAttachment.
 */
 fun ItemAttachmentDto.toDomain(): ItemAttachment {
    return ItemAttachment(
@@ -38,3 +40,4 @@ fun ItemAttachmentDto.toDomain(): ItemAttachment {
        updatedAt = this.updatedAt
    )
 }
 // [END_ENTITY: Function('toDomain')]
--- a/data/src/main/java/com/homebox/lens/data/api/dto/ItemCreateDto.kt
+++ b/data/src/main/java/com/homebox/lens/data/api/dto/ItemCreateDto.kt
@@ -8,11 +8,11 @@ package com.homebox.lens.data.api.dto
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 import com.homebox.lens.domain.model.ItemCreate
 // [END_IMPORTS]
-// [CORE-LOGIC]
+// [ENTITY: DataClass('ItemCreateDto')]
 /**
- * [CONTRACT]
+ * @summary DTO для создания вещи.
 * DTO для создания вещи.
 */
@JsonClass(generateAdapter = true)
 data class ItemCreateDto(
@@ -30,10 +30,12 @@ data class ItemCreateDto(
    @Json(name = "parentId") val parentId: String?,
    @Json(name = "labelIds") val labelIds: List<String>?
 )
 // [END_ENTITY: DataClass('ItemCreateDto')]
 // [ENTITY: Function('toDto')]
 // [RELATION: Function('toDto')] -> [RETURNS] -> [DataClass('ItemCreateDto')]
 /**
- * [CONTRACT]
+ * @summary Маппер из доменной модели ItemCreate в ItemCreateDto.
 * Маппер из доменной модели ItemCreate в ItemCreateDto.
 */
 fun ItemCreate.toDto(): ItemCreateDto {
    return ItemCreateDto(
@@ -52,3 +54,4 @@ fun ItemCreate.toDto(): ItemCreateDto {
        labelIds = this.labelIds
    )
 }
 // [END_ENTITY: Function('toDto')]
--- a/data/src/main/java/com/homebox/lens/data/api/dto/ItemDto.kt
+++ b/data/src/main/java/com/homebox/lens/data/api/dto/ItemDto.kt
@@ -1,16 +1,19 @@
 // [PACKAGE] com.homebox.lens.data.api.dto
 // [FILE] ItemDto.kt
-
+// [SEMANTICS] data, dto, api
 package com.homebox.lens.data.api.dto
 // [IMPORTS]
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 import java.math.BigDecimal
 // [END_IMPORTS]
-// [CONTRACT]
+// [ENTITY: DataClass('ItemOut')]
 // [RELATION: DataClass('ItemOut')] -> [DEPENDS_ON] -> [DataClass('LocationOut')]
 // [RELATION: DataClass('ItemOut')] -> [DEPENDS_ON] -> [DataClass('LabelOutDto')]
 /**
- * [ENTITY: DataClass('ItemOut')]
+ * @summary DTO для полной информации о вещи (GET /v1/items/{id}).
 * [PURPOSE] DTO для полной информации о вещи (GET /v1/items/{id}).
 */
@JsonClass(generateAdapter = true)
 data class ItemOut(
@@ -23,10 +26,12 @@ data class ItemOut(
    @Json(name = "value") val value: BigDecimal?,
    @Json(name = "createdAt") val createdAt: String?
 )
 // [END_ENTITY: DataClass('ItemOut')]
 // [ENTITY: DataClass('ItemSummary')]
 // [RELATION: DataClass('ItemSummary')] -> [DEPENDS_ON] -> [DataClass('LocationOut')]
 /**
- * [ENTITY: DataClass('ItemSummary')]
+ * @summary DTO для краткой информации о вещи в списках (GET /v1/items).
 * [PURPOSE] DTO для краткой информации о вещи в списках (GET /v1/items).
 */
@JsonClass(generateAdapter = true)
 data class ItemSummary(
@@ -36,10 +41,11 @@ data class ItemSummary(
    @Json(name = "location") val location: LocationOut?,
    @Json(name = "createdAt") val createdAt: String?
 )
 // [END_ENTITY: DataClass('ItemSummary')]
 // [ENTITY: DataClass('ItemCreate')]
 /**
- * [ENTITY: DataClass('ItemCreate')]
+ * @summary DTO для создания новой вещи (POST /v1/items).
 * [PURPOSE] DTO для создания новой вещи (POST /v1/items).
 */
@JsonClass(generateAdapter = true)
 data class ItemCreate(
@@ -49,10 +55,11 @@ data class ItemCreate(
    @Json(name = "labelIds") val labelIds: List<String>?,
    @Json(name = "value") val value: BigDecimal?
 )
 // [END_ENTITY: DataClass('ItemCreate')]
 // [ENTITY: DataClass('ItemUpdate')]
 /**
- * [ENTITY: DataClass('ItemUpdate')]
+ * @summary DTO для обновления вещи (PUT /v1/items/{id}).
 * [PURPOSE] DTO для обновления вещи (PUT /v1/items/{id}).
 */
@JsonClass(generateAdapter = true)
 data class ItemUpdate(
@@ -62,5 +69,6 @@ data class ItemUpdate(
    @Json(name = "labelIds") val labelIds: List<String>?,
    @Json(name = "value") val value: BigDecimal?
 )
 // [END_ENTITY: DataClass('ItemUpdate')]
 // [END_FILE_ItemDto.kt]
--- a/data/src/main/java/com/homebox/lens/data/api/dto/ItemOutDto.kt
+++ b/data/src/main/java/com/homebox/lens/data/api/dto/ItemOutDto.kt
@@ -8,11 +8,11 @@ package com.homebox.lens.data.api.dto
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 import com.homebox.lens.domain.model.ItemOut
 // [END_IMPORTS]
-// [CORE-LOGIC]
+// [ENTITY: DataClass('ItemOutDto')]
 /**
- * [CONTRACT]
+ * @summary DTO для полной модели вещи.
 * DTO для полной модели вещи.
 */
@JsonClass(generateAdapter = true)
 data class ItemOutDto(
@@ -37,12 +37,25 @@ data class ItemOutDto(
    @Json(name = "fields") val fields: List<CustomFieldDto>,
    @Json(name = "maintenance") val maintenance: List<MaintenanceEntryDto>,
    @Json(name = "createdAt") val createdAt: String,
-    @Json(name = "updatedAt") val updatedAt: String
+    @Json(name = "updatedAt") val updatedAt: String,
    @Json(name = "insured") val insured: Boolean?,
    @Json(name = "lifetimeWarranty") val lifetimeWarranty: Boolean?,
    @Json(name = "manufacturer") val manufacturer: String?,
    @Json(name = "modelNumber") val modelNumber: String?,
    @Json(name = "purchaseFrom") val purchaseFrom: String?,
    @Json(name = "soldNotes") val soldNotes: String?,
    @Json(name = "soldPrice") val soldPrice: Double?,
    @Json(name = "soldTime") val soldTime: String?,
    @Json(name = "soldTo") val soldTo: String?,
    @Json(name = "syncChildItemsLocations") val syncChildItemsLocations: Boolean?,
    @Json(name = "warrantyDetails") val warrantyDetails: String?
 )
 // [END_ENTITY: DataClass('ItemOutDto')]
 // [ENTITY: Function('toDomain')]
 // [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('ItemOut')]
 /**
- * [CONTRACT]
+ * @summary Маппер из ItemOutDto в доменную модель ItemOut.
 * Маппер из ItemOutDto в доменную модель ItemOut.
 */
 fun ItemOutDto.toDomain(): ItemOut {
    return ItemOut(
@@ -67,6 +80,18 @@ fun ItemOutDto.toDomain(): ItemOut {
        fields = this.fields.map { it.toDomain() },
        maintenance = this.maintenance.map { it.toDomain() },
        createdAt = this.createdAt,
-        updatedAt = this.updatedAt
+        updatedAt = this.updatedAt,
        insured = this.insured,
        lifetimeWarranty = this.lifetimeWarranty,
        manufacturer = this.manufacturer,
        modelNumber = this.modelNumber,
        purchaseFrom = this.purchaseFrom,
        soldNotes = this.soldNotes,
        soldPrice = this.soldPrice,
        soldTime = this.soldTime,
        soldTo = this.soldTo,
        syncChildItemsLocations = this.syncChildItemsLocations,
        warrantyDetails = this.warrantyDetails
    )
 }
 // [END_ENTITY: Function('toDomain')]
--- a/data/src/main/java/com/homebox/lens/data/api/dto/ItemSummaryDto.kt
+++ b/data/src/main/java/com/homebox/lens/data/api/dto/ItemSummaryDto.kt
@@ -8,11 +8,11 @@ package com.homebox.lens.data.api.dto
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 import com.homebox.lens.domain.model.ItemSummary
 // [END_IMPORTS]
-// [CORE-LOGIC]
+// [ENTITY: DataClass('ItemSummaryDto')]
 /**
- * [CONTRACT]
+ * @summary DTO для сокращенной модели вещи.
 * DTO для сокращенной модели вещи.
 */
@JsonClass(generateAdapter = true)
 data class ItemSummaryDto(
@@ -27,10 +27,12 @@ data class ItemSummaryDto(
    @Json(name = "createdAt") val createdAt: String,
    @Json(name = "updatedAt") val updatedAt: String
 )
 // [END_ENTITY: DataClass('ItemSummaryDto')]
 // [ENTITY: Function('toDomain')]
 // [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('ItemSummary')]
 /**
- * [CONTRACT]
+ * @summary Маппер из ItemSummaryDto в доменную модель ItemSummary.
 * Маппер из ItemSummaryDto в доменную модель ItemSummary.
 */
 fun ItemSummaryDto.toDomain(): ItemSummary {
    return ItemSummary(
@@ -46,3 +48,4 @@ fun ItemSummaryDto.toDomain(): ItemSummary {
        updatedAt = this.updatedAt
    )
 }
 // [END_ENTITY: Function('toDomain')]
--- a/data/src/main/java/com/homebox/lens/data/api/dto/ItemUpdateDto.kt
+++ b/data/src/main/java/com/homebox/lens/data/api/dto/ItemUpdateDto.kt
@@ -8,11 +8,11 @@ package com.homebox.lens.data.api.dto
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 import com.homebox.lens.domain.model.ItemUpdate
 // [END_IMPORTS]
-// [CORE-LOGIC]
+// [ENTITY: DataClass('ItemUpdateDto')]
 /**
- * [CONTRACT]
+ * @summary DTO для обновления вещи.
 * DTO для обновления вещи.
 */
@JsonClass(generateAdapter = true)
 data class ItemUpdateDto(
@@ -31,10 +31,12 @@ data class ItemUpdateDto(
    @Json(name = "parentId") val parentId: String?,
    @Json(name = "labelIds") val labelIds: List<String>?
 )
 // [END_ENTITY: DataClass('ItemUpdateDto')]
 // [ENTITY: Function('toDto')]
 // [RELATION: Function('toDto')] -> [RETURNS] -> [DataClass('ItemUpdateDto')]
 /**
- * [CONTRACT]
+ * @summary Маппер из доменной модели ItemUpdate в ItemUpdateDto.
 * Маппер из доменной модели ItemUpdate в ItemUpdateDto.
 */
 fun ItemUpdate.toDto(): ItemUpdateDto {
    return ItemUpdateDto(
@@ -54,3 +56,4 @@ fun ItemUpdate.toDto(): ItemUpdateDto {
        labelIds = this.labelIds
    )
 }
 // [END_ENTITY: Function('toDto')]
--- a/data/src/main/java/com/homebox/lens/data/api/dto/LabelCreateDto.kt
+++ b/data/src/main/java/com/homebox/lens/data/api/dto/LabelCreateDto.kt
@@ -3,21 +3,23 @@
 // [SEMANTICS] data_transfer_object, label, create, api
 package com.homebox.lens.data.api.dto
 // [IMPORTS]
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 // [END_IMPORTS]
 // [ENTITY: DataClass('LabelCreateDto')]
 /**
- * [CONTRACT]
+ * @summary DTO для тела запроса на создание метки (POST /v1/labels).
- * DTO для тела запроса на создание метки (POST /v1/labels).
+ * @param name Название метки.
- * @property name Название метки.
+ * @param color Цвет метки в формате HEX (например, "#FF0000").
- * @property color Цвет метки в формате HEX (например, "#FF0000").
+ * @param description Описание метки.
 * @property description Описание метки.
 * @coherence_note Структура этого класса точно соответствует схеме `repo.LabelCreate` из OpenAPI.
 */
@JsonClass(generateAdapter = true)
 data class LabelCreateDto(
    @Json(name = "name") val name: String,
    @Json(name = "color") val color: String?,
-    @Json(name = "description") val description: String? = null // Описание не используется в приложении, но может быть в API
+    @Json(name = "description") val description: String? = null // [AI_NOTE]: Описание не используется в приложении, но может быть в API
 )
 // [END_ENTITY: DataClass('LabelCreateDto')]
 // [END_FILE_LabelCreateDto.kt]
--- a/data/src/main/java/com/homebox/lens/data/api/dto/LabelOutDto.kt
+++ b/data/src/main/java/com/homebox/lens/data/api/dto/LabelOutDto.kt
@@ -8,44 +8,38 @@ package com.homebox.lens.data.api.dto
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 import com.homebox.lens.domain.model.LabelOut
 // [END_IMPORTS]
-// [CORE-LOGIC]
+// [ENTITY: DataClass('LabelOutDto')]
 /**
- * [CONTRACT]
+ * @summary DTO для метки.
 * DTO для метки.
 * [COHERENCE_NOTE] Поле `isArchived` сделано nullable (`Boolean?`),
 * так как оно отсутствует в JSON-ответе от сервера. Это исправляет ошибку парсинга
 * `JsonDataException: Required value 'isArchived' missing`.
 */
@JsonClass(generateAdapter = true)
 data class LabelOutDto(
    @Json(name = "id") val id: String,
    @Json(name = "name") val name: String,
    // [COHERENCE_NOTE] Поле `color` может быть null или отсутствовать, делаем его nullable для безопасности.
    @Json(name = "color") val color: String?,
    // [FIX] Поле отсутствует в JSON, делаем nullable.
    @Json(name = "isArchived") val isArchived: Boolean?,
    @Json(name = "createdAt") val createdAt: String,
    @Json(name = "updatedAt") val updatedAt: String,
    // [COHERENCE_NOTE] Поле `description` также может отсутствовать, добавляем его как nullable.
    @Json(name = "description") val description: String?
 )
 // [END_ENTITY: DataClass('LabelOutDto')]
 // [ENTITY: Function('toDomain')]
 // [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('LabelOut')]
 /**
- * [CONTRACT]
+ * @summary Маппер из LabelOutDto в доменную модель LabelOut.
 * Маппер из LabelOutDto в доменную модель LabelOut.
 * [COHERENCE_NOTE] Маппер обновлен для безопасной обработки nullable полей
 * и предоставления non-nullable значений по умолчанию для доменной модели.
 */
 fun LabelOutDto.toDomain(): LabelOut {
    return LabelOut(
        id = this.id,
        name = this.name,
-        // [FIX] Используем Elvis-оператор для предоставления значения по умолчанию.
+        color = this.color ?: "",
-        color = this.color ?: "", // Пустая строка как дефолтный цвет
+        isArchived = this.isArchived ?: false,
        isArchived = this.isArchived ?: false, // `false` как дефолтное состояние архива
        createdAt = this.createdAt,
        updatedAt = this.updatedAt
    )
 }
 // [END_ENTITY: Function('toDomain')]
 // [END_FILE_LabelOutDto.kt]
--- a/data/src/main/java/com/homebox/lens/data/api/dto/LabelSummaryDto.kt
+++ b/data/src/main/java/com/homebox/lens/data/api/dto/LabelSummaryDto.kt
@@ -3,14 +3,15 @@
 // [SEMANTICS] data_transfer_object, label, summary, api, mapper
 package com.homebox.lens.data.api.dto
 // [IMPORTS]
 import com.homebox.lens.domain.model.LabelSummary
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 // [END_IMPORTS]
 // [ENTITY: DataClass('LabelSummaryDto')]
 /**
- * [CONTRACT]
+ * @summary DTO для ответа от API при создании метки.
 * DTO для ответа от API при создании метки.
 * @coherence_note Структура этого класса точно соответствует схеме `repo.LabelSummary` из OpenAPI.
 */
@JsonClass(generateAdapter = true)
 data class LabelSummaryDto(
@@ -21,9 +22,11 @@ data class LabelSummaryDto(
    @Json(name = "createdAt") val createdAt: String?,
    @Json(name = "updatedAt") val updatedAt: String?
 )
 // [END_ENTITY: DataClass('LabelSummaryDto')]
 // [ENTITY: Function('toDomain')]
 // [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('LabelSummary')]
 /**
 * [CONTRACT]
 * @summary Маппер из DTO в доменную модель.
 * @return Объект доменной модели [LabelSummary].
 * @sideeffect Отбрасывает поля, ненужные доменному слою (`color`, `description`, etc.),
@@ -35,4 +38,5 @@ fun LabelSummaryDto.toDomain(): LabelSummary {
        name = this.name
    )
 }
 // [END_ENTITY: Function('toDomain')]
 // [END_FILE_LabelSummaryDto.kt]
--- a/data/src/main/java/com/homebox/lens/data/api/dto/LabelUpdateDto.kt
+++ b/data/src/main/java/com/homebox/lens/data/api/dto/LabelUpdateDto.kt
@@ -0,0 +1,31 @@
 // [PACKAGE] com.homebox.lens.data.api.dto
 // [FILE] LabelUpdateDto.kt
 // [SEMANTICS] data_transfer_object, label, update
 package com.homebox.lens.data.api.dto
 // [IMPORTS]
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 import com.homebox.lens.domain.model.LabelUpdate
 // [END_IMPORTS]
 // [ENTITY: DataClass('LabelUpdateDto')]
@JsonClass(generateAdapter = true)
 data class LabelUpdateDto(
    @Json(name = "name")
    val name: String?,
    @Json(name = "color")
    val color: String?
 )
 // [END_ENTITY: DataClass('LabelUpdateDto')]
 // [ENTITY: Function('toDto')]
 // [RELATION: Function('toDto')] -> [RETURNS] -> [DataClass('LabelUpdateDto')]
 fun LabelUpdate.toDto(): LabelUpdateDto {
    return LabelUpdateDto(
        name = this.name,
        color = this.color
    )
 }
 // [END_ENTITY: Function('toDto')]
 // [END_FILE_LabelUpdateDto.kt]
--- a/data/src/main/java/com/homebox/lens/data/api/dto/LocationCreateDto.kt
+++ b/data/src/main/java/com/homebox/lens/data/api/dto/LocationCreateDto.kt
@@ -0,0 +1,22 @@
 // [PACKAGE] com.homebox.lens.data.api.dto
 // [FILE] LocationCreateDto.kt
 // [SEMANTICS] data_transfer_object, location, create
 package com.homebox.lens.data.api.dto
 // [IMPORTS]
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 // [END_IMPORTS]
 // [ENTITY: DataClass('LocationCreateDto')]
@JsonClass(generateAdapter = true)
 data class LocationCreateDto(
    @Json(name = "name")
    val name: String,
    @Json(name = "color")
    val color: String?,
    @Json(name = "description")
    val description: String? // Assuming description can be null for creation
 )
 // [END_ENTITY: DataClass('LocationCreateDto')]
 // [END_FILE_LocationCreateDto.kt]
--- a/data/src/main/java/com/homebox/lens/data/api/dto/LocationDto.kt
+++ b/data/src/main/java/com/homebox/lens/data/api/dto/LocationDto.kt
@@ -1,25 +1,27 @@
 // [PACKAGE] com.homebox.lens.data.api.dto
 // [FILE] LocationDto.kt
-
+// [SEMANTICS] data, dto, api, location
 package com.homebox.lens.data.api.dto
 // [IMPORTS]
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 // [END_IMPORTS]
-// [CONTRACT]
+// [ENTITY: DataClass('LocationOut')]
 /**
- * [ENTITY: DataClass('LocationOut')]
+ * @summary DTO для информации о местоположении.
 * [PURPOSE] DTO для информации о местоположении.
 */
@JsonClass(generateAdapter = true)
 data class LocationOut(
    @Json(name = "id") val id: String,
    @Json(name = "name") val name: String
 )
 // [END_ENTITY: DataClass('LocationOut')]
 // [ENTITY: DataClass('LocationOutCount')]
 /**
- * [ENTITY: DataClass('LocationOutCount')]
+ * @summary DTO для информации о местоположении со счетчиком вещей.
 * [PURPOSE] DTO для информации о местоположении со счетчиком вещей.
 */
@JsonClass(generateAdapter = true)
 data class LocationOutCount(
@@ -27,5 +29,6 @@ data class LocationOutCount(
    @Json(name = "name") val name: String,
    @Json(name = "itemCount") val itemCount: Int
 )
 // [END_ENTITY: DataClass('LocationOutCount')]
 // [END_FILE_LocationDto.kt]
--- a/data/src/main/java/com/homebox/lens/data/api/dto/LocationOutCountDto.kt
+++ b/data/src/main/java/com/homebox/lens/data/api/dto/LocationOutCountDto.kt
@@ -8,47 +8,40 @@ package com.homebox.lens.data.api.dto
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 import com.homebox.lens.domain.model.LocationOutCount
 // [END_IMPORTS]
-// [CORE-LOGIC]
+// [ENTITY: DataClass('LocationOutCountDto')]
 /**
- * [CONTRACT]
+ * @summary DTO для местоположения со счетчиком.
 * DTO для местоположения со счетчиком.
 * [COHERENCE_NOTE] Поля `color` и `isArchived` сделаны nullable (`String?`, `Boolean?`),
 * так как они отсутствуют в JSON-ответе от сервера. Это исправляет ошибку парсинга
 * `JsonDataException: Required value '...' missing`.
 */
@JsonClass(generateAdapter = true)
 data class LocationOutCountDto(
    @Json(name = "id") val id: String,
    @Json(name = "name") val name: String,
    // [FIX] Поле отсутствует в JSON, делаем nullable.
    @Json(name = "color") val color: String?,
    // [FIX] Поле отсутствует в JSON, делаем nullable.
    @Json(name = "isArchived") val isArchived: Boolean?,
    @Json(name = "itemCount") val itemCount: Int,
    @Json(name = "createdAt") val createdAt: String,
    @Json(name = "updatedAt") val updatedAt: String,
    // [COHERENCE_NOTE] Поле `description` также может отсутствовать или быть null,
    // поэтому его тоже безопасно сделать nullable.
    @Json(name = "description") val description: String?
 )
 // [END_ENTITY: DataClass('LocationOutCountDto')]
 // [ENTITY: Function('toDomain')]
 // [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('LocationOutCount')]
 /**
- * [CONTRACT]
+ * @summary Маппер из LocationOutCountDto в доменную модель LocationOutCount.
 * Маппер из LocationOutCountDto в доменную модель LocationOutCount.
 * [COHERENCE_NOTE] Маппер обновлен для безопасной обработки nullable полей
 * и предоставления non-nullable значений по умолчанию для доменной модели.
 */
 fun LocationOutCountDto.toDomain(): LocationOutCount {
    return LocationOutCount(
        id = this.id,
        name = this.name,
-        // [FIX] Используем Elvis-оператор для предоставления значения по умолчанию, если поле null.
+        color = this.color ?: "",
-        color = this.color ?: "", // Пустая строка как дефолтный цвет
+        isArchived = this.isArchived ?: false,
        isArchived = this.isArchived ?: false, // `false` как дефолтное состояние архива
        itemCount = this.itemCount,
        createdAt = this.createdAt,
        updatedAt = this.updatedAt
    )
 }
 // [END_ENTITY: Function('toDomain')]
 // [END_FILE_LocationOutCountDto.kt]
--- a/data/src/main/java/com/homebox/lens/data/api/dto/LocationOutDto.kt
+++ b/data/src/main/java/com/homebox/lens/data/api/dto/LocationOutDto.kt
@@ -1,33 +1,34 @@
 // [PACKAGE] com.homebox.lens.data.api.dto
 // [FILE] LocationOutDto.kt
-// [SEMANTICS] data_transfer_object, location
+// [SEMANTICS] data_transfer_object, location, output
 package com.homebox.lens.data.api.dto
 // [IMPORTS]
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 import com.homebox.lens.domain.model.LocationOut
 // [END_IMPORTS]
-// [CORE-LOGIC]
+// [ENTITY: DataClass('LocationOutDto')]
 /**
 * [CONTRACT]
 * DTO для местоположения.
 */
@JsonClass(generateAdapter = true)
 data class LocationOutDto(
-    @Json(name = "id") val id: String,
+    @Json(name = "id")
-    @Json(name = "name") val name: String,
+    val id: String,
-    @Json(name = "color") val color: String,
+    @Json(name = "name")
-    @Json(name = "isArchived") val isArchived: Boolean,
+    val name: String,
-    @Json(name = "createdAt") val createdAt: String,
+    @Json(name = "color")
-    @Json(name = "updatedAt") val updatedAt: String
+    val color: String,
    @Json(name = "isArchived")
    val isArchived: Boolean,
    @Json(name = "createdAt")
    val createdAt: String,
    @Json(name = "updatedAt")
    val updatedAt: String
 )
 // [END_ENTITY: DataClass('LocationOutDto')]
-/**
+// [ENTITY: Function('toDomain')]
- * [CONTRACT]
+// [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('LocationOut')]
 * Маппер из LocationOutDto в доменную модель LocationOut.
 */
 fun LocationOutDto.toDomain(): LocationOut {
    return LocationOut(
        id = this.id,
@@ -38,3 +39,5 @@ fun LocationOutDto.toDomain(): LocationOut {
        updatedAt = this.updatedAt
    )
 }
 // [END_ENTITY: Function('toDomain')]
 // [END_FILE_LocationOutDto.kt]
--- a/data/src/main/java/com/homebox/lens/data/api/dto/LocationUpdateDto.kt
+++ b/data/src/main/java/com/homebox/lens/data/api/dto/LocationUpdateDto.kt
@@ -0,0 +1,31 @@
 // [PACKAGE] com.homebox.lens.data.api.dto
 // [FILE] LocationUpdateDto.kt
 // [SEMANTICS] data_transfer_object, location, update
 package com.homebox.lens.data.api.dto
 // [IMPORTS]
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 import com.homebox.lens.domain.model.LocationUpdate
 // [END_IMPORTS]
 // [ENTITY: DataClass('LocationUpdateDto')]
@JsonClass(generateAdapter = true)
 data class LocationUpdateDto(
    @Json(name = "name")
    val name: String?,
    @Json(name = "color")
    val color: String?
 )
 // [END_ENTITY: DataClass('LocationUpdateDto')]
 // [ENTITY: Function('toDto')]
 // [RELATION: Function('toDto')] -> [RETURNS] -> [DataClass('LocationUpdateDto')]
 fun LocationUpdate.toDto(): LocationUpdateDto {
    return LocationUpdateDto(
        name = this.name,
        color = this.color
    )
 }
 // [END_ENTITY: Function('toDto')]
 // [END_FILE_LocationUpdateDto.kt]
--- a/data/src/main/java/com/homebox/lens/data/api/dto/LoginFormDto.kt
+++ b/data/src/main/java/com/homebox/lens/data/api/dto/LoginFormDto.kt
@@ -1,15 +1,19 @@
 // [PACKAGE] com.homebox.lens.data.api.dto
 // [FILE] LoginFormDto.kt
-
+// [SEMANTICS] data, dto, api, login
 package com.homebox.lens.data.api.dto
 // [IMPORTS]
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 // [END_IMPORTS]
 // [ENTITY: DataClass('LoginFormDto')]
@JsonClass(generateAdapter = true)
 data class LoginFormDto(
    @Json(name = "username") val username: String,
    @Json(name = "password") val password: String,
    @Json(name = "stayLoggedIn") val stayLoggedIn: Boolean = true
 )
 // [END_ENTITY: DataClass('LoginFormDto')]
 // [END_FILE_LoginFormDto.kt]
--- a/data/src/main/java/com/homebox/lens/data/api/dto/MaintenanceEntryDto.kt
+++ b/data/src/main/java/com/homebox/lens/data/api/dto/MaintenanceEntryDto.kt
@@ -8,11 +8,11 @@ package com.homebox.lens.data.api.dto
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 import com.homebox.lens.domain.model.MaintenanceEntry
 // [END_IMPORTS]
-// [CORE-LOGIC]
+// [ENTITY: DataClass('MaintenanceEntryDto')]
 /**
- * [CONTRACT]
+ * @summary DTO для записи об обслуживании.
 * DTO для записи об обслуживании.
 */
@JsonClass(generateAdapter = true)
 data class MaintenanceEntryDto(
@@ -25,10 +25,12 @@ data class MaintenanceEntryDto(
    @Json(name = "createdAt") val createdAt: String,
    @Json(name = "updatedAt") val updatedAt: String
 )
 // [END_ENTITY: DataClass('MaintenanceEntryDto')]
 // [ENTITY: Function('toDomain')]
 // [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('MaintenanceEntry')]
 /**
- * [CONTRACT]
+ * @summary Маппер из MaintenanceEntryDto в доменную модель MaintenanceEntry.
 * Маппер из MaintenanceEntryDto в доменную модель MaintenanceEntry.
 */
 fun MaintenanceEntryDto.toDomain(): MaintenanceEntry {
    return MaintenanceEntry(
@@ -42,3 +44,4 @@ fun MaintenanceEntryDto.toDomain(): MaintenanceEntry {
        updatedAt = this.updatedAt
    )
 }
 // [END_ENTITY: Function('toDomain')]
--- a/data/src/main/java/com/homebox/lens/data/api/dto/PaginationDto.kt
+++ b/data/src/main/java/com/homebox/lens/data/api/dto/PaginationDto.kt
@@ -1,15 +1,16 @@
 // [PACKAGE] com.homebox.lens.data.api.dto
 // [FILE] PaginationDto.kt
-
+// [SEMANTICS] data, dto, api, pagination
 package com.homebox.lens.data.api.dto
 // [IMPORTS]
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 // [END_IMPORTS]
-// [CONTRACT]
+// [ENTITY: DataClass('PaginationResult')]
 /**
- * [ENTITY: DataClass('PaginationResult')]
+ * @summary DTO для пагинированных результатов от API.
 * [PURPOSE] DTO для пагинированных результатов от API.
 */
@JsonClass(generateAdapter = true)
 data class PaginationResult<T>(
@@ -19,5 +20,6 @@ data class PaginationResult<T>(
    @Json(name = "total") val total: Int,
    @Json(name = "pageSize") val pageSize: Int
 )
 // [END_ENTITY: DataClass('PaginationResult')]
 // [END_FILE_PaginationDto.kt]
--- a/data/src/main/java/com/homebox/lens/data/api/dto/PaginationResultDto.kt
+++ b/data/src/main/java/com/homebox/lens/data/api/dto/PaginationResultDto.kt
@@ -8,11 +8,11 @@ package com.homebox.lens.data.api.dto
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 import com.homebox.lens.domain.model.PaginationResult
 // [END_IMPORTS]
-// [CORE-LOGIC]
+// [ENTITY: DataClass('PaginationResultDto')]
 /**
- * [CONTRACT]
+ * @summary DTO для постраничных результатов.
 * DTO для постраничных результатов.
 */
@JsonClass(generateAdapter = true)
 data class PaginationResultDto<T>(
@@ -21,10 +21,12 @@ data class PaginationResultDto<T>(
    @Json(name = "pageSize") val pageSize: Int,
    @Json(name = "total") val total: Int
 )
 // [END_ENTITY: DataClass('PaginationResultDto')]
 // [ENTITY: Function('toDomain')]
 // [RELATION: Function('toDomain')] -> [RETURNS] -> [DataClass('PaginationResult')]
 /**
- * [CONTRACT]
+ * @summary Маппер из PaginationResultDto в доменную модель PaginationResult.
 * Маппер из PaginationResultDto в доменную модель PaginationResult.
 * @param transform Функция для преобразования каждого элемента из DTO в доменную модель.
 */
 fun <T, R> PaginationResultDto<T>.toDomain(transform: (T) -> R): PaginationResult<R> {
@@ -35,3 +37,4 @@ fun <T, R> PaginationResultDto<T>.toDomain(transform: (T) -> R): PaginationResul
        total = this.total
    )
 }
 // [END_ENTITY: Function('toDomain')]
--- a/data/src/main/java/com/homebox/lens/data/api/dto/StatisticsDto.kt
+++ b/data/src/main/java/com/homebox/lens/data/api/dto/StatisticsDto.kt
@@ -1,16 +1,17 @@
 // [PACKAGE] com.homebox.lens.data.api.dto
 // [FILE] StatisticsDto.kt
-
+// [SEMANTICS] data, dto, api, statistics
 package com.homebox.lens.data.api.dto
 // [IMPORTS]
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 import java.math.BigDecimal
 // [END_IMPORTS]
-// [CONTRACT]
+// [ENTITY: DataClass('GroupStatistics')]
 /**
- * [ENTITY: DataClass('GroupStatistics')]
+ * @summary DTO для статистической информации.
 * [PURPOSE] DTO для статистической информации.
 */
@JsonClass(generateAdapter = true)
 data class GroupStatistics(
@@ -19,5 +20,6 @@ data class GroupStatistics(
    @Json(name = "locations") val locations: Int,
    @Json(name = "labels") val labels: Int
 )
 // [END_ENTITY: DataClass('GroupStatistics')]
 // [END_FILE_StatisticsDto.kt]
--- a/data/src/main/java/com/homebox/lens/data/api/dto/TokenResponseDto.kt
+++ b/data/src/main/java/com/homebox/lens/data/api/dto/TokenResponseDto.kt
@@ -1,15 +1,19 @@
 // [PACKAGE] com.homebox.lens.data.api.dto
 // [FILE] TokenResponseDto.kt
-
+// [SEMANTICS] data, dto, api, token
 package com.homebox.lens.data.api.dto
 // [IMPORTS]
 import com.squareup.moshi.Json
 import com.squareup.moshi.JsonClass
 // [END_IMPORTS]
 // [ENTITY: DataClass('TokenResponseDto')]
@JsonClass(generateAdapter = true)
 data class TokenResponseDto(
    @Json(name = "token") val token: String,
    @Json(name = "attachmentToken") val attachmentToken: String,
    @Json(name = "expiresAt") val expiresAt: String
 )
 // [END_ENTITY: DataClass('TokenResponseDto')]
 // [END_FILE_TokenResponseDto.kt]
--- a/data/src/main/java/com/homebox/lens/data/api/mapper/TokenMapper.kt
+++ b/data/src/main/java/com/homebox/lens/data/api/mapper/TokenMapper.kt
@@ -4,26 +4,27 @@
 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')]
 /**
- * [CONTRACT]
+ * @summary Преобразует DTO-объект токена в доменную модель.
 * [HELPER] Преобразует DTO-объект токена в доменную модель.
 * @receiver [TokenResponseDto] объект из слоя данных.
 * @return [TokenResponse] объект для доменного слоя.
 * @throws IllegalArgumentException если токен в DTO пустой.
 */
 fun TokenResponseDto.toDomain(): TokenResponse {
-    // [PRECONDITION] DTO должен содержать валидные данные для маппинга.
+    require(this.token.isNotBlank()) { "DTO token is blank, cannot map to domain model." }
    require(this.token.isNotBlank()) { "[PRECONDITION_FAILED] DTO token is blank, cannot map to domain model." }
    // [ACTION]
    val domainModel = TokenResponse(token = this.token)
-    // [POSTCONDITION] Проверяем, что инвариант доменной модели соблюден.
+    check(domainModel.token.isNotBlank()) { "Domain model token is blank after mapping." }
    check(domainModel.token.isNotBlank()) { "[POSTCONDITION_FAILED] Domain model token is blank after mapping." }
    return domainModel
 }
 // [END_ENTITY: Function('toDomain')]
 // [END_FILE_TokenMapper.kt]
--- a/data/src/main/java/com/homebox/lens/data/db/Converters.kt
+++ b/data/src/main/java/com/homebox/lens/data/db/Converters.kt
@@ -1,26 +1,32 @@
 // [PACKAGE] com.homebox.lens.data.db
 // [FILE] Converters.kt
-
+// [SEMANTICS] data, database, room, converter
 package com.homebox.lens.data.db
 // [IMPORTS]
 import androidx.room.TypeConverter
 import java.math.BigDecimal
 // [END_IMPORTS]
-// [CONTRACT]
+// [ENTITY: Class('Converters')]
 /**
- * [ENTITY: Class('Converters')]
+ * @summary Предоставляет TypeConverters для Room для типов, не поддерживаемых по умолчанию.
 * [PURPOSE] Предоставляет TypeConverters для Room для типов, не поддерживаемых по умолчанию.
 */
 class Converters {
    // [ENTITY: Function('fromString')]
    @TypeConverter
    fun fromString(value: String?): BigDecimal? {
        return value?.let { BigDecimal(it) }
    }
    // [END_ENTITY: Function('fromString')]
    // [ENTITY: Function('bigDecimalToString')]
    @TypeConverter
    fun bigDecimalToString(bigDecimal: BigDecimal?): String? {
        return bigDecimal?.toPlainString()
    }
    // [END_ENTITY: Function('bigDecimalToString')]
 }
 // [END_ENTITY: Class('Converters')]
 // [END_FILE_Converters.kt]
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
busya	9b914b2904	REFACTOR END	2025-09-28 10:10:01 +03:00
busya	394e0040de	211	2025-09-26 10:30:59 +03:00
busya	aa69776807	update documentator promt	2025-09-08 16:23:03 +03:00
busya	3b2f9d894e	chore(lint): apply semantic enrichment\n\nFiles modified: 1	2025-09-07 22:00:06 +03:00
busya	e899ce5c94	new doc agent protocol	2025-09-07 21:00:44 +03:00
busya	6735990a56	+documentator	2025-09-07 12:47:17 +03:00
busya	7059440892	refactor promts	2025-09-07 12:41:52 +03:00
busya	699c6439b6	Fix: Labels screen navigation and Create Item error; Labels screen now displays a proper navigation bar by utilizing MainScaffold; Fixed "Create Item" functionality by ensuring ItemEditScreen is navigated to with a null itemId for new item creation, preventing an API error; Added navigateToLabelEdit function to NavigationActions.	2025-09-06 13:29:36 +03:00
busya	30ef449756	qa roles	2025-09-06 12:34:25 +03:00
busya	c5ee179e71	metrics	2025-09-06 11:51:55 +03:00
busya	e173556bf7	markdown KB	2025-09-06 10:23:15 +03:00
busya	0ae505ea11	promt refactors	2025-09-06 10:07:14 +03:00
busya	660a5fcd02	gitea-client	2025-09-06 10:00:33 +03:00
busya	926a456bcd	Merge branch 'development/6/implement-full-crud-for-locations-and-labels' into main, accepting all changes from the feature branch	2025-09-05 12:48:28 +03:00
busya	af5c9be9d1	WIP: `dd1a0c0` feat(#6 ): Implement full CRUD for Locations and Labels	2025-09-05 11:17:02 +03:00
busya	b8f507f622	Merge branch 'giteaclient' into main	2025-09-05 11:08:16 +03:00
busya	dd1a0c0c51	feat(#6 ): Implement full CRUD for Locations and Labels	2025-09-02 17:03:05 +03:00
busya	8ebdc3a7b3	feat(agent): Implement item edit feature Автоматизированная реализация на основе `Work Order`. Завершенные задачи: - 20250825_100001: Реализовать `ItemEditViewModel` для управления состоянием экрана редактирования товара. - 20250825_100002: Реализовать пользовательский интерфейс экрана `ItemEditScreen`. - 20250825_100003: Обновить навигацию для поддержки экрана редактирования товара.	2025-08-28 16:10:00 +03:00
busya	11078e5313	Item Edit screen	2025-08-25 10:28:26 +03:00
busya	a608766e06	feat: Add semantic enrichment to all Kotlin files	2025-08-24 13:46:04 +03:00
busya	fbd371b725	before semantic	2025-08-24 11:58:50 +03:00
busya	64c8d5d893	New 3-Agent logic	2025-08-24 11:49:41 +03:00
busya	847537293f	refactor(navigation): Improve semantic markup and logging in NavGraph	2025-08-18 16:27:12 +03:00
busya	cf4fc7a535	fix: Resolve build errors - Add missing quantity field to Item model - Add missing string resources and translations - Fix unresolved references in UI screens	2025-08-18 16:15:01 +03:00
busya	7e2e6009f7	+linter	2025-08-18 08:55:39 +03:00