refactor(app): обновить структуру приложения и удалить устаревшие провайдеры (#44)

* refactor(app): обновить структуру приложения и удалить устаревшие провайдеры
* refactor(runner): упростить обработку ошибок и улучшить логирование времени инициализации
* refactor(runner): улучшить порядок инициализации приложения и обработку ошибок
* refactor(app): исправить контекст MediaQuery для предотвращения перерисовки
* refactor(pp): удалить главный виджет приложения и заменить его на AppRoot
* docs(copilot-instructions): уточнить правила проведения Code Review на русском языке
* refactor(linter): добавить правило avoid_catches_without_on_clauses для улучшения обработки исключений

---------

Co-authored-by: petrovyuri <petrovyuri@example.com>

.cursorrules

@@ -0,0 +1,389 @@
+# Правила разработки Flutter проекта
+
+Этот файл содержит правила и стандарты разработки для проекта. Все правила обязательны к соблюдению при написании кода.
+
+**ВАЖНО:** Перед каждым PR необходимо отформатировать код (`dart format .`) и проверить анализатор на отсутствие сообщений (`dart analyze`).
+
+---
+
+# Стиль кода
+
+## Именование
+
+### Интерфейсы
+
+Все интерфейсы в приложении должны начинаться с заглавной буквы "**I**".
+
+Примеры: **IAuthRepository**, **IProfileRepository**, **IMainRunner** и т.д.
+
+Таким образом, сразу видно, что работаешь с интерфейсом.
+
+Пример:
+
+```dart
+/// Интерфейс - **IUserRepository**
+abstract interface class IUserRepository {}
+
+/// Основная реализация (prod и stage окружения)
+class UserRepository implements IUserRepository {}
+
+/// Иная реализация (мок, локальное хранилище) должна содержать
+/// постфикс функциональности: 
+/// - Network - сетевое взаимодействие.
+/// - Local - локальное хранилище.
+/// - Mock - мок репозиторий.
+class UserRepositoryLocal implements IUserRepository {}
+```
+
+### Классы - Репозитории
+
+Репозитории должны содержать в конце название источника данных (если используется мок или локальное хранилище). Основная реализация не должна содержать постфикса.
+
+Примеры:
+- Интерфейс - **IAuthRepository**
+- Основная реализация (prod и stage окружения) - **AuthRepository**
+- Мок (мок данные) - **AuthRepositoryMock**
+- Локальное хранилище (например бд или просто имитация данных) - **AuthRepositoryLocal**
+
+### Файлы
+
+Используется snake_case. Название файла должно иметь следующую структуру: `[раздел]_[тип].dart`
+
+Примеры: `user_details_screen.dart`, `shop_entity.dart`
+
+### Классы
+
+Название классов UpperCamelCase. Для создания приватных классов используем префикс `_`. Название класса в конце должно содержать в себе тип.
+
+Примеры: **UserEntity**, **AdultDialog**
+
+## Методы
+
+Название метода в начале должно содержать в себе действие (глагол):
+
+- fetch
+- put
+- update
+- delete
+- и так далее
+
+Примеры:
+
+```dart
+int fetchFirstElement() {}
+```
+
+```dart
+void updateFirstElement() {}
+```
+
+**ВАЖНО:** Название метода не должно содержать в себе `And`/`Or`, и метод соответственно не должен выполнять подобную логику.
+
+## Переменные и константы
+
+Константы именуются также lowerCamelCase.
+
+Примеры:
+
+```dart
+const String carItem = 'default';
+```
+
+или
+
+```dart
+final String userName = 'default';
+
+## Виджеты
+
+Виджеты именуются UpperCamelCase. В названии виджетов не должно содержаться слово `widget`.
+
+### Экраны
+
+Экраны, используемые в роутинге, именуются с постфиксом `Screen`.
+
+Пример: **ShopListScreen**
+
+### Содержимое экрана
+
+Виджеты, отображающие содержимое экрана, именуются с постфиксом `View`.
+
+Пример: **ShopListView**
+
+### Глобальные виджеты
+
+Глобальные виджеты именуются с приставкой `App`.
+
+Пример: **AppButton**
+
+## Структура класса
+
+Объявления элементов класса должны располагаться в следующем порядке:
+
+1. **Constructors**
+   - constructors
+   - named-constructors
+   - factory-constructors
+2. **Static**
+   - public-static-methods
+   - private-static-methods
+   - public-static-const-fields
+   - private-static-const-fields
+   - public-static-final-fields
+   - private-static-final-fields
+   - public-static-fields
+   - private-static-fields
+3. **Fields**
+   - public-final-fields
+   - private-final-fields
+   - public-fields
+   - private-fields
+4. **Getters/Setters**
+   - public-getters-setters
+   - private-getters-setters
+5. **Methods**
+   - overridden-methods
+   - public-methods
+   - protected-methods
+   - private-methods
+
+---
+
+# Ведение документации и комментариев
+
+## Документация
+
+### Основные правила ведения документации в проекте
+
+- Документация оформляется над описываемым объектом с использованием `///`
+- Документацией необходимо покрывать все классы, конструкторы, поля, геттеры, сеттеры, методы, фабрики, все кастомные объекты
+- Документация должна:
+  - указывать на назначение объекта
+  - содержать исчерпывающее описание объекта
+  - быть краткой и емкой
+  - быть понятной для любого разработчика
+
+### Шаблоны и примеры документации объектов
+
+#### Документация классов
+
+```dart
+/// {@template new_class}
+/// Класс для {описание назначения и реализуемого функционала в классе}.
+/// {@endtemplate}
+class NewClass {}
+```
+
+Пример:
+
+```dart
+/// {@template app_button}
+/// Класс для реализации кастомизированной кнопки.
+/// {@endtemplate}
+class AppButton {}
+```
+
+#### Документация конструкторов и фабрик
+
+Если конструктор один, то достаточно указать `{@macro new_class}`. `{@macro new_class}` дублирует на конструктор указанную в рамках описания класса документацию, поэтому описание класса должно в таком случае включать все передаваемые в конструктор параметры.
+
+Если конструкторов несколько, описания должны отражать их отличия друг от друга. Фабрики описываются по такому же принципу.
+
+```dart
+/// {@macro new_class}
+const NewClass();
+
+/// Создает {описание создаваемого фабрикой объекта}.
+/// Принимает:
+/// - [json] - {описание параметра}
+factory NewClass.fromJson(Map<String, dynamic> json) {}
+```
+
+#### Документация полей классов
+
+В классе необходимо описывать каждое поле по отдельности. Если поле ссылается на другое поле или зависит от него, необходимо это указывать в описании.
+
+```dart
+/// Возраст пользователя.
+final int age;
+
+/// Индикатор совершеннолетия пользователя. Принимает значение true, когда [age] больше 18 лет.
+final bool isAdult;
+```
+
+#### Документация геттеров/сеттеров
+
+```dart
+/// Получения доступа к {описание данных, которые получает геттер}
+int get newGetter => ...
+
+/// Установка значения для {описание работы сеттера}
+set newSetter(int setterValue) => ...
+```
+
+#### Документация методов
+
+Методы должны описывать их основное назначение. Если метод сложный, требуется указывать дополнительное описание его работы ниже через пропущенную строку. Если метод принимает какие-либо параметры, каждый параметр должен быть описан по отдельности списком с прямой ссылкой. Если метод возвращает какие-либо значения, они должны быть описаны. Желательно указать, что вернет метод в случае возникновения ошибки.
+
+```dart
+/// Метод для {описание назначения метода}.
+/// {описание особенностей работы метода}.
+/// Принимает:
+/// - [param] - {описание назначения параметра}.
+void newMethod({required String param}) {
+    ...
+}
+```
+
+Пример:
+
+```dart
+/// Метод для расчета температуры.
+/// Принимает:
+/// - [grad] - параметр необходим для расчета температуры.
+/// Возвращает:
+/// - температуру в градусах.
+/// При ошибке расчета возвращается null.
+int? calcTemperature({required int grad}) {
+    // Реализация
+}
+```
+
+## Комментарии
+
+### Основные правила комментирования кода в проекте
+
+- Комментарии оформляются над описываемым участком кода с использованием `//`
+- Комментировать необходимо те участки кода, которые действительно нуждаются в дополнительном описании
+- Комментарий не должен повторять легко читаемые участки кода
+
+Примеры неправильного использования:
+
+```dart
+if (flag != true)  // не нужно описывать как "Если значение не равно true..."
+```
+
+Примеры правильного использования:
+
+```dart
+if (isAurora) {
+    // Так как Аврора не может открывать WebView,
+    // то заменяем на открытие внешнего браузера
+}
+```
+
+## TODO
+
+### Основные правила создания TODO в проекте
+
+- TODO оформляются согласно условиям форматирования линтера с указанием имени разработчика, кто находится в контексте проблемы и сможет ее прокомментировать
+- TODO необходимо оставлять на тех участках кода, которые требуют дальнейшей доработки
+- Если известно, в рамках какой задачи будет доработан помечаемый участок кода, ссылку на задачу необходимо оставить в скобках
+
+Пример:
+
+```dart
+// TODO(username): Оптимизировать алгоритм сортировки
+```
+
+---
+
+# Ведение проекта в git
+
+## Создание commits/pull-request
+
+- Язык описания PR - Русский
+- Описание должно отражать краткую суть изменений
+- Коммит/PR должен содержать:
+  - исчерпывающую информацию об изменениях
+  - ссылку на задачу в таск-трекер
+  - Перечисление deprecated-кода (если есть)
+
+### Типы коммитов согласно convention
+
+- **feat**: — новая функция
+- **fix**: — исправление ошибок
+- **refactor**: — Изменение кода, которое не исправляет ошибку и не добавляет функции (рефакторинг кода)
+- **build**: — изменения, влияющие на систему сборки или внешние зависимости (примеры областей (scope): android, ios, linux и так далее)
+- **docs**: — изменения только в документации
+- **chore**: — добавление/обновление/настройка инструментов и библиотек (пример: pubspec.yaml)
+- **test**: — добавление недостающих тестов или исправление существующих тестов
+- **ci**: — изменения в файлах конфигурации и скриптах CI (примеры областей: папка CI)
+
+# Структура проекта
+
+Рекомендуемая структура проекта (может отличаться в зависимости от проекта и согласований)
+
+- **/** - папка проекта
+- **/assets** - директория расположения графических ресурсов
+- **/tools/** - все необходимые инструменты для проекта
+  - **/docs** - документация проекта
+- **/env** - папка, с внешними переменными окружения
+- **/lib** - код на Dart, Flutter-приложение
+  - **/app** - содержит основные настройки нашего приложения
+    - **/data** - общие поставщики данных
+    - **/domain** - общий слой
+    - **/presentation** - общий слой
+  - **/di** - файлы конфигурации зависимостей
+  - **/router** - все, что касается роутинга
+  - **/features** - фичи приложения, для каждой фичи создается отдельная папка
+    - **/feature_name** - подробнее см в разделе Структура feature папок
+      - **/data**
+      - **/domain**
+      - **/presentation**
+  - **/gen** - для сгенерированных файлов
+  - **/targets** - таргеты для сборок
+    - **/prod.dart** - сборка для prod
+    - **/dev.dart** - сборка разработки на моковых репозиториях
+    - **/stage.dart** - сборка для stage окружения
+
+## Пример структуры feature папок
+
+- **/data** - слой данных
+  - **/dto** - реализация DTO (data transfer object)
+  - **/repository** - реализации репозиториев
+- **/domain** - слой бизнес логики
+  - **/entity** - модели которые используются для работы в domain/presentation слоях
+  - **/repository** - интерфейсы репозиториев, которые используются в domain слое
+  - **/state** - state-management
+  - **/service** - реализации сервисов
+- **/presentation** - слой представления
+  - **/screens** - все экраны должны заканчиваться на Screen, например UserProfileScreen
+  - **/components** - виджеты, которые необходимы для работы в presentation слое. Например: SuperButton, AppTextFields итд
+
+## Пояснение к структуре feature папок
+
+### Data (слой данных)
+
+Этот слой является поставщиком данных.
+
+- **Repository** - сущность, которая реализует внутри себя предоставление данных. Должен реализовывать какой либо интерфейс репозитория из domain слоя
+- **DTO** - Dto(Data Transfer Object) модели, и модели с которыми происходит работа в data слое. Например: UserDto
+
+### Domain (слой бизнес логики)
+
+- **Entity** - должны быть в максимально удобном виде для работы внутри Domain и Presentation. Например: UserEntity, ShopEntity
+- **State** - управления состоянием - state manager
+- **Service** - различные сервисы, для выполнения различных задач
+- **interfaces** - интерфейсы репозиториев, которые используются в domain слое
+
+### Presentation (слой представления)
+
+- **components** - widget'ы которые реализуют работу какого либо визуального компонента (Buttons, TextFields, Lists, итд). Например: ShopList, RateButton. Модальные окна
+- **screens** - widget'ы которые представляют собой экран приложения. Например: UserInfoScreen
+
+## Основные правила общения объектов между папками
+
+### В рамках всего приложения
+
+- Объекты внутри фичи должны быть инкапсулированы и не могут использоваться в других feature
+- Если есть необходимость использовать объект в нескольких feature, его нужно вынести в папку app и использовать как глобальный для всего приложения
+- Сервис, который должен быть использован в нескольких feature, создается как отдельная feature
+- Если создаваемый сервис является платформно-зависимым, его необходимо выносить в app_services. В приложении должен быть только интерфейс
+
+### В рамках одной feature
+
+- Объекты data слоя не должны ничего знать про объекты слоя presentation. Имеют доступ к объектам entity из domain слоя для преобразования DTO в Entity
+- Объекты domain слоя не должны ничего знать про объекты слоя data, используемый экземпляр репозитория передается в объекты domain слоя через интерфейс репозитория, расположенного в этом же domain слое
+- Объекты domain слоя не должны ничего знать про слой presentation, не должны использовать компоненты библиотек ui, material, cupertino, widget и прочих, не должны использовать context
+- Объекты presentation слоя не должны ничего знать про объекты слоя data, все взаимодействия непосредственно через объекты слоя domain

.github/copilot-instructions.md

@@ -0,0 +1,395 @@
+# Правила разработки Flutter проекта
+
+Этот файл содержит правила и стандарты разработки для проекта. Все правила обязательны к соблюдению при написании кода.
+
+**ВАЖНО:** Перед каждым PR необходимо отформатировать код (`dart format .`) и проверить анализатор на отсутствие сообщений (`dart analyze`).
+
+---
+
+# Правила проведения Code Review
+
+## Основные правила проведения Code Review
+**ВАЖНО:** - Комментарии, обзоры и описание Pull Request при проведении code review должны быть на РУССКОМ языке.
+
+# Стиль кода
+
+## Именование
+
+### Интерфейсы
+
+Все интерфейсы в приложении должны начинаться с заглавной буквы "**I**".
+
+Примеры: **IAuthRepository**, **IProfileRepository**, **IMainRunner** и т.д.
+
+Таким образом, сразу видно, что работаешь с интерфейсом.
+
+Пример:
+
+```dart
+/// Интерфейс - **IUserRepository**
+abstract interface class IUserRepository {}
+
+/// Основная реализация (prod и stage окружения)
+class UserRepository implements IUserRepository {}
+
+/// Иная реализация (мок, локальное хранилище) должна содержать
+/// постфикс функциональности: 
+/// - Network - сетевое взаимодействие.
+/// - Local - локальное хранилище.
+/// - Mock - мок репозиторий.
+class UserRepositoryLocal implements IUserRepository {}
+```
+
+### Классы - Репозитории
+
+Репозитории должны содержать в конце название источника данных (если используется мок или локальное хранилище). Основная реализация не должна содержать постфикса.
+
+Примеры:
+- Интерфейс - **IAuthRepository**
+- Основная реализация (prod и stage окружения) - **AuthRepository**
+- Мок (мок данные) - **AuthRepositoryMock**
+- Локальное хранилище (например бд или просто имитация данных) - **AuthRepositoryLocal**
+
+### Файлы
+
+Используется snake_case. Название файла должно иметь следующую структуру: `[раздел]_[тип].dart`
+
+Примеры: `user_details_screen.dart`, `shop_entity.dart`
+
+### Классы
+
+Название классов UpperCamelCase. Для создания приватных классов используем префикс `_`. Название класса в конце должно содержать в себе тип.
+
+Примеры: **UserEntity**, **AdultDialog**
+
+## Методы
+
+Название метода в начале должно содержать в себе действие (глагол):
+
+- fetch
+- put
+- update
+- delete
+- и так далее
+
+Примеры:
+
+```dart
+int fetchFirstElement() {}
+```
+
+```dart
+void updateFirstElement() {}
+```
+
+**ВАЖНО:** Название метода не должно содержать в себе `And`/`Or`, и метод соответственно не должен выполнять подобную логику.
+
+## Переменные и константы
+
+Константы именуются также lowerCamelCase.
+
+Примеры:
+
+```dart
+const String carItem = 'default';
+```
+
+или
+
+```dart
+final String userName = 'user';
+```
+
+## Виджеты
+
+Виджеты именуются UpperCamelCase. В названии виджетов не должно содержаться слово `widget`.
+
+### Экраны
+
+Экраны, используемые в роутинге, именуются с постфиксом `Screen`.
+
+Пример: **ShopListScreen**
+
+### Содержимое экрана
+
+Виджеты, отображающие содержимое экрана, именуются с постфиксом `View`.
+
+Пример: **ShopListView**
+
+### Глобальные виджеты
+
+Глобальные виджеты именуются с приставкой `App`.
+
+Пример: **AppButton**
+
+## Структура класса
+
+Объявления элементов класса должны располагаться в следующем порядке:
+
+1. **Constructors**
+   - constructors
+   - named-constructors
+   - factory-constructors
+2. **Static**
+   - public-static-methods
+   - private-static-methods
+   - public-static-const-fields
+   - private-static-const-fields
+   - public-static-final-fields
+   - private-static-final-fields
+   - public-static-fields
+   - private-static-fields
+3. **Fields**
+   - public-final-fields
+   - private-final-fields
+   - public-fields
+   - private-fields
+4. **Getters/Setters**
+   - public-getters-setters
+   - private-getters-setters
+5. **Methods**
+   - overridden-methods
+   - public-methods
+   - protected-methods
+   - private-methods
+
+---
+
+# Ведение документации и комментариев
+
+## Документация
+
+### Основные правила ведения документации в проекте
+
+- Документация оформляется над описываемым объектом с использованием `///`
+- Документацией необходимо покрывать все классы, конструкторы, поля, геттеры, сеттеры, методы, фабрики, все кастомные объекты
+- Документация должна:
+  - указывать на назначение объекта
+  - содержать исчерпывающее описание объекта
+  - быть краткой и емкой
+  - быть понятной для любого разработчика
+
+### Шаблоны и примеры документации объектов
+
+#### Документация классов
+
+```dart
+/// {@template new_class}
+/// Класс для {описание назначения и реализуемого функционала в классе}.
+/// {@endtemplate}
+class NewClass {}
+```
+
+Пример:
+
+```dart
+/// {@template app_button}
+/// Класс для реализации кастомизированной кнопки.
+/// {@endtemplate}
+class AppButton {}
+```
+
+#### Документация конструкторов и фабрик
+
+Если конструктор один, то достаточно указать `{@macro new_class}`. `{@macro new_class}` дублирует на конструктор указанную в рамках описания класса документацию, поэтому описание класса должно в таком случае включать все передаваемые в конструктор параметры.
+
+Если конструкторов несколько, описания должны отражать их отличия друг от друга. Фабрики описываются по такому же принципу.
+
+```dart
+/// {@macro new_class}
+const NewClass();
+
+/// Создает {описание создаваемого фабрикой объекта}.
+/// Принимает:
+/// - [json] - {описание параметра}
+factory NewClass.fromJson(Map<String, dynamic> json) {}
+```
+
+#### Документация полей классов
+
+В классе необходимо описывать каждое поле по отдельности. Если поле ссылается на другое поле или зависит от него, необходимо это указывать в описании.
+
+```dart
+/// Возраст пользователя.
+final int age;
+
+/// Индикатор совершеннолетия пользователя. Принимает значение true, когда [age] больше 18 лет.
+final bool isAdult;
+```
+
+#### Документация геттеров/сеттеров
+
+```dart
+/// Получения доступа к {описание данных, которые получает геттер}
+int get newGetter => ...
+
+/// Установка значения для {описание работы сеттера}
+set newSetter(int setterValue) => ...
+```
+
+#### Документация методов
+
+Методы должны описывать их основное назначение. Если метод сложный, требуется указывать дополнительное описание его работы ниже через пропущенную строку. Если метод принимает какие-либо параметры, каждый параметр должен быть описан по отдельности списком с прямой ссылкой. Если метод возвращает какие-либо значения, они должны быть описаны. Желательно указать, что вернет метод в случае возникновения ошибки.
+
+```dart
+/// Метод для {описание назначения метода}.
+/// {описание особенностей работы метода}.
+/// Принимает:
+/// - [param] - {описание назначения параметра}.
+void newMethod({required String param}) {
+    ...
+}
+```
+
+Пример:
+
+```dart
+/// Метод для расчета температуры.
+/// Принимает:
+/// - [grad] - параметр необходим для расчета температуры.
+/// Возвращает:
+/// - температуру в градусах.
+/// При ошибке расчета возвращается null.
+int? calcTemperature({required int grad}) {
+    // Реализация
+}
+```
+
+## Комментарии
+
+### Основные правила комментирования кода в проекте
+
+- Комментарии оформляются над описываемым участком кода с использованием `//`
+- Комментировать необходимо те участки кода, которые действительно нуждаются в дополнительном описании
+- Комментарий не должен повторять легко читаемые участки кода
+
+Примеры неправильного использования:
+
+```dart
+if (flag != true)  // не нужно описывать как "Если значение не равно true..."
+```
+
+Примеры правильного использования:
+
+```dart
+if (isAurora) {
+    // Так как Аврора не может открывать WebView,
+    // то заменяем на открытие внешнего браузера
+}
+```
+
+## TODO
+
+### Основные правила создания TODO в проекте
+
+- TODO оформляются согласно условиям форматирования линтера с указанием имени разработчика, кто находится в контексте проблемы и сможет ее прокомментировать
+- TODO необходимо оставлять на тех участках кода, которые требуют дальнейшей доработки
+- Если известно, в рамках какой задачи будет доработан помечаемый участок кода, ссылку на задачу необходимо оставить в скобках
+
+Пример:
+
+```dart
+// TODO(username): Оптимизировать алгоритм сортировки
+```
+
+---
+
+# Ведение проекта в git
+
+## Создание commits/pull-request
+
+- Язык описания PR - Русский
+- Описание должно отражать краткую суть изменений
+- Коммит/PR должен содержать:
+  - исчерпывающую информацию об изменениях
+  - ссылку на задачу в таск-трекер
+  - Перечисление deprecated-кода (если есть)
+
+### Типы коммитов согласно convention
+
+- **feat**: — новая функция
+- **fix**: — исправление ошибок
+- **refactor**: — Изменение кода, которое не исправляет ошибку и не добавляет функции (рефакторинг кода)
+- **build**: — изменения, влияющие на систему сборки или внешние зависимости (примеры областей (scope): android, ios, linux и так далее)
+- **docs**: — изменения только в документации
+- **chore**: — добавление/обновление/настройка инструментов и библиотек (пример: pubspec.yaml)
+- **test**: — добавление недостающих тестов или исправление существующих тестов
+- **ci**: — изменения в файлах конфигурации и скриптах CI (примеры областей: папка CI)
+
+# Структура проекта
+
+Рекомендуемая структура проекта (может отличаться в зависимости от проекта и согласований)
+
+- **/** - папка проекта
+- **/assets** - директория расположения графических ресурсов
+- **/tools/** - все необходимые инструменты для проекта
+  - **/docs** - документация проекта
+- **/env** - папка, с внешними переменными окружения
+- **/lib** - код на Dart, Flutter-приложение
+  - **/app** - содержит основные настройки нашего приложения
+    - **/data** - общие поставщики данных
+    - **/domain** - общий слой
+    - **/presentation** - общий слой
+  - **/di** - файлы конфигурации зависимостей
+  - **/router** - все, что касается роутинга
+  - **/features** - фичи приложения, для каждой фичи создается отдельная папка
+    - **/feature_name** - подробнее см в разделе Структура feature папок
+      - **/data**
+      - **/domain**
+      - **/presentation**
+  - **/gen** - для сгенерированных файлов
+  - **/targets** - таргеты для сборок
+    - **/prod.dart** - сборка для prod
+    - **/dev.dart** - сборка разработки на моковых репозиториях
+    - **/stage.dart** - сборка для stage окружения
+
+## Пример структуры feature папок
+
+- **/data** - слой данных
+  - **/dto** - реализация DTO (data transfer object)
+  - **/repository** - реализации репозиториев
+- **/domain** - слой бизнес логики
+  - **/entity** - модели которые используются для работы в domain/presentation слоях
+  - **/repository** - интерфейсы репозиториев, которые используются в domain слое
+  - **/state** - state-management
+  - **/service** - реализации сервисов
+- **/presentation** - слой представления
+  - **/screens** - все экраны должны заканчиваться на Screen, например UserProfileScreen
+  - **/components** - виджеты, которые необходимы для работы в presentation слое. Например: SuperButton, AppTextFields итд
+
+## Пояснение к структуре feature папок
+
+### Data (слой данных)
+
+Этот слой является поставщиком данных.
+
+- **Repository** - сущность, которая реализует внутри себя предоставление данных. Должен реализовывать какой либо интерфейс репозитория из domain слоя
+- **DTO** - Dto(Data Transfer Object) модели, и модели с которыми происходит работа в data слое. Например: UserDto
+
+### Domain (слой бизнес логики)
+
+- **Entity** - должны быть в максимально удобном виде для работы внутри Domain и Presentation. Например: UserEntity, ShopEntity
+- **State** - управления состоянием - state manager
+- **Service** - различные сервисы, для выполнения различных задач
+- **interfaces** - интерфейсы репозиториев, которые используются в domain слое
+
+### Presentation (слой представления)
+
+- **components** - widget'ы которые реализуют работу какого либо визуального компонента (Buttons, TextFields, Lists, итд). Например: ShopList, RateButton. Модальные окна
+- **screens** - widget'ы которые представляют собой экран приложения. Например: UserInfoScreen
+
+## Основные правила общения объектов между папками
+
+### В рамках всего приложения
+
+- Объекты внутри фичи должны быть инкапсулированы и не могут использоваться в других feature
+- Если есть необходимость использовать объект в нескольких feature, его нужно вынести в папку app и использовать как глобальный для всего приложения
+- Сервис, который должен быть использован в нескольких feature, создается как отдельная feature
+- Если создаваемый сервис является платформно-зависимым, его необходимо выносить в app_services. В приложении должен быть только интерфейс
+
+### В рамках одной feature
+
+- Объекты data слоя не должны ничего знать про объекты слоя presentation. Имеют доступ к объектам entity из domain слоя для преобразования DTO в Entity
+- Объекты domain слоя не должны ничего знать про объекты слоя data, используемый экземпляр репозитория передается в объекты domain слоя через интерфейс репозитория, расположенного в этом же domain слое
+- Объекты domain слоя не должны ничего знать про слой presentation, не должны использовать компоненты библиотек ui, material, cupertino, widget и прочих, не должны использовать context
+- Объекты presentation слоя не должны ничего знать про объекты слоя data, все взаимодействия непосредственно через объекты слоя domain

.github/pull_request_template.md

@@ -5,6 +5,7 @@
 <!--- Напишите здесь какую проблему решают изменения в этом запросе. -->
 
 ## Чек лист (обязательно)
+
 - [ ] Код соответствует рекомендациям и требованиям проекта.
 - [ ] Проверил анализатор на предмет ошибок и предупреждений.
 - [ ] Название ПР соответствует [требованиям проекта](../tools/rfc/RFC-documentation.md).
@@ -12,6 +13,7 @@
 - [ ] Добавлены необходимые тесты, если требуется.
 
 ## Скриншоты (желательно)
+
 <details>
   <summary>Показать</summary>
   

.gitignore

@@ -17,6 +17,9 @@ migrate_working_dir/
 *.ipr
 *.iws
 .idea/
+# Хранить конфигурации запуска
+!.idea/runConfigurations/
+!.idea/runConfigurations/**
 
 # The .vscode folder contains launch configuration and tasks you configure in
 # VS Code which you may wish to be included in version control, so this line

.idea/runConfigurations/DEV.xml

@@ -0,0 +1,6 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="DEV" type="FlutterRunConfigurationType" factoryName="Flutter">
+    <option name="filePath" value="$PROJECT_DIR$/lib/targets/dev.dart" />
+    <method v="2" />
+  </configuration>
+</component>

.idea/runConfigurations/PROD.xml

@@ -0,0 +1,6 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="PROD" type="FlutterRunConfigurationType" factoryName="Flutter">
+    <option name="filePath" value="$PROJECT_DIR$/lib/targets/prod.dart" />
+    <method v="2" />
+  </configuration>
+</component>

.idea/runConfigurations/STAGE.xml

@@ -0,0 +1,6 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="STAGE" type="FlutterRunConfigurationType" factoryName="Flutter">
+    <option name="filePath" value="$PROJECT_DIR$/lib/targets/stage.dart" />
+    <method v="2" />
+  </configuration>
+</component>

.idea/runConfigurations/main_dart.xml

@@ -0,0 +1,6 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="main.dart" type="FlutterRunConfigurationType" factoryName="Flutter">
+    <option name="filePath" value="$PROJECT_DIR$/lib/main.dart" />
+    <method />
+  </configuration>
+</component>

.vscode/dart.prime_snippets.code-snippets

@@ -14,5 +14,23 @@
 			"/// {@macro ${TM_FILENAME_BASE}}"
 		],
 		"description": "DartDoc короткая запись macro с именем файла"
-	}
+	},
+	"TODO": {
+		"prefix": "todo",
+		"body": [
+			"// TODO($1): $2"
+		],
+		"description": "Create todo"
+	},
+	"TRYCATCH": {
+		"prefix": "tryc",
+		"body": [
+			"try {",
+			"$1",
+			"} on Object catch (error,stackTrace) {",
+			"",
+			"}",
+		],
+		"description": "Create trycatch"
+	},
 }

.vscode/tasks.json

@@ -1,24 +1,12 @@
 {
     "version": "2.0.0",
     "tasks": [
-        {
-            "label": "fluttergen",
-            "type": "shell",
-            "command": "/Users/yura/.pub-cache/bin/fluttergen",
-            "group": {
-                "kind": "build",
-                "isDefault": true
-            },
-            "presentation": {
-                "reveal": "always"
-            },
-            "problemMatcher": []
-        },
         {
             "label": "build_runner --delete-conflicting-outputs",
             "type": "shell",
-            "command": "dart",
+            "command": "flutter",
             "args": [
+                "pub",
                 "run",
                 "build_runner",
                 "build",
@@ -62,6 +50,16 @@
             "type": "shell",
             "command": "./tools/switch_service.sh aurora",
             "problemMatcher": []
+        },
+        {
+            "label": "flutter gen-l10n",
+            "type": "shell",
+            "command": "flutter",
+            "args": [
+                "gen-l10n"
+            ],
+            "group": "build",
+            "problemMatcher": [],
         }
     ]
 }

CODEOWNERS

@@ -1 +1,29 @@
-Friflex LCC
+# Файл CODEOWNERS определяет владельцев кода для автоматического назначения ревьюеров
+
+# GitHub Actions и CI/CD
+.github/ @petrovyuri
+actions/ @petrovyuri
+
+# Конфигурация разработки и IDE
+.vscode/ @petrovyuri
+
+# Ресурсы и конфигурация приложения
+assets/ @petrovyuri
+env/ @petrovyuri
+tools/ @petrovyuri
+
+# Исходный код приложения
+lib/ @petrovyuri
+app_services/ @petrovyuri
+
+# Конфигурационные файлы проекта
+analysis_options.yaml @petrovyuri
+build.yaml @petrovyuri
+pubspec.yaml @petrovyuri
+
+# Документация
+CHANGELOG.md @petrovyuri
+README.md @petrovyuri
+
+# По умолчанию все остальные файлы
+* @petrovyuri

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Friflex
+Copyright (c) 2025 Friflex LLC
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -1,21 +1,14 @@
-<div align="center">
 
-# 🚀 Friflex Starter - Корпоративный шаблон
+# 🚀 Friflex Flutter Starter - Корпоративный шаблон
 
-</div>
-<div align="center">
-
-![Flutter](https://img.shields.io/badge/Flutter-3.32.0+-02569B?style=for-the-badge&logo=flutter&logoColor=white)
-![Dart](https://img.shields.io/badge/Dart-3.8.0+-0175C2?style=for-the-badge&logo=dart&logoColor=white)
-![Version](https://img.shields.io/badge/Version-v0.0.1-green?style=for-the-badge)
+![Flutter](https://img.shields.io/badge/Flutter-3.38.1+-02569B?style=for-the-badge&logo=flutter&logoColor=white)
+![Dart](https://img.shields.io/badge/Dart-3.10.0+-0175C2?style=for-the-badge&logo=dart&logoColor=white)
 ![License](https://img.shields.io/badge/License-MIT-blue?style=for-the-badge)
 
-**Корпоративный стартовый шаблон для разработки масштабируемых Flutter-приложений**
+Корпоративный стартовый шаблон для разработки масштабируемых Flutter-приложений
 
 [📋 Документация](#-документация) • [🏗️ Архитектура](#️-архитектура) • [🚀 Быстрый старт](#-быстрый-старт) • [🔧 Конфигурация](#-конфигурация)
 
-</div>
-
 ---
 
 ## 📖 Описание проекта
@@ -31,6 +24,7 @@
 - 🌍 Поддержка интернационализации
 - 🎨 UI Kit и система токенов дизайна
 - 🔍 Инструменты отладки и мониторинга
+- ⚡ Современный Dart 3.10+ с dot shorthands
 
 ## 🎯 Для чего нужен стартер
 
@@ -97,20 +91,27 @@ features/
 
 | Категория | Библиотека | Версия | Описание |
 |-----------|------------|--------|----------|
-| 🧭 **Навигация** | [go_router](https://pub.dev/packages/go_router) | `15.1.2` | Декларативный роутинг |
+| 🧭 **Навигация** | [go_router](https://pub.dev/packages/go_router) | `17.0.0` | Декларативный роутинг |
 | 🔄 **State Management** | [flutter_bloc](https://pub.dev/packages/flutter_bloc) | `9.1.1` | Управление состоянием |
 | 💉 **DI** | Custom InheritedWidget | - | Внедрение зависимостей |
-| 🎨 **Resources** | [flutter_gen](https://pub.dev/packages/flutter_gen) | `5.10.0` | Генерация ресурсов |
-| 🌐 **HTTP** | [dio](https://pub.dev/packages/dio) | `5.8.0+1` | HTTP клиент |
+| 🎨 **Resources** | [flutter_gen](https://pub.dev/packages/flutter_gen) | `5.12.0` | Генерация ресурсов |
+| 🌐 **HTTP** | [dio](https://pub.dev/packages/dio) | `5.9.0` | HTTP клиент |
+| 🎨 **SVG** | [flutter_svg](https://pub.dev/packages/flutter_svg) | `2.2.2` | Поддержка SVG |
+| 🎬 **Animation** | [lottie](https://pub.dev/packages/lottie) | `3.3.2` | Анимации Lottie |
 | 🔒 **Secure Storage** | [flutter_secure_storage](https://pub.dev/packages/flutter_secure_storage) | - | Защищенное хранилище |
-| 📊 **Logging** | [talker](https://pub.dev/packages/talker_flutter) | `4.8.0` | Логирование и отладка |
+| 📊 **Logging** | [talker](https://pub.dev/packages/talker_flutter) | `5.0.2` | Логирование и отладка |
+| 🎨 **Theme** | [theme_tailor](https://pub.dev/packages/theme_tailor) | `3.1.1` | Генерация тем |
+| ⚙️ **Environment** | [envied](https://pub.dev/packages/envied) | `1.3.1` | Управление переменными окружения |
 
 ### 🔧 Инструменты разработки
 
-- **📝 Линтинг**: корпоративные правила кода
-- **🏗️ Code Generation**: `build_runner` для генерации кода
-- **🌍 Локализация**: `flutter_localizations` + `intl`
-- **⚙️ Окружения**: `envied` для управления переменными
+| Инструмент | Версия | Описание |
+|-----------|--------|----------|
+| **📝 Линтинг** | `flutter_lints: 6.0.0` | Корпоративные правила кода |
+| **🏗️ Code Generation** | `build_runner: 2.10.3` | Генерация кода |
+| **🌍 Локализация** | `intl: 0.20.2` | Интернационализация |
+| **⚙️ Environment** | `envied: 1.3.1` + `envied_generator: 1.3.1` | Управление переменными окружения |
+| **🎨 Theme Generator** | `theme_tailor: 3.1.1` | Генерация тем |
 
 ## 🗂️ Структура проекта
 
@@ -162,33 +163,33 @@ enum AppEnv {
 
 ### 🛠️ Установка
 
-1. **Клонирование проекта**
+#### Клонирование проекта
 
 ```bash
 git clone https://github.com/smmarty/friflex_starter.git
 cd friflex_starter
 ```
 
-2. **Установка зависимостей**
+#### Установка зависимостей
 
 ```bash
 flutter pub get
 ```
 
-3. **Генерация файлов**
+#### Генерация файлов
 
 ```bash
 dart run build_runner build --delete-conflicting-outputs
 flutter packages pub run flutter_gen
 ```
 
-4. **Запуск приложения**
+#### Запуск приложения
 
 ```bash
 flutter run
 ```
 
-5. **Замените название пакета на ваш**
+#### Замените название пакета на ваш
 
 ### 🎯 Запуск с разными окружениями
 
@@ -262,6 +263,8 @@ dart run build_runner build --delete-conflicting-outputs
 | 🔄 [RFC-gitflow.md](./tools/rfc/RFC-gitflow.md) | Git workflow |
 | 🏗️ [RFC-projects_structure.md](./tools/rfc/RFC-projects_structure.md) | Структура проекта |
 | 📝 [RFC-documentation.md](./tools/rfc/RFC-documentation.md) | Правила документирования |
+| 🔧 [RFC-managing_generated_files.md](./tools/rfc/RFC-managing_generated_files.md) | Рекомендации по управлению сгенерированными файлами |
+| 🌐 [RFC-managing_pubspec_lock.md](./tools/rfc/RFC-managing_pubspec_lock.md) | Рекомендации по управлению pubspec.lock |
 
 ## 🎯 Особенности и нюансы
 
@@ -286,15 +289,10 @@ dart run build_runner build --delete-conflicting-outputs
 
 ## 📄 Лицензия
 
-Этот проект распространяется под лицензией MIT License. Подробности смотрите в файле [LICENSE](./LICENCE).
+Этот проект распространяется под лицензией MIT License. Подробности смотрите в файле [LICENSE](./LICENSE).
 
 Copyright © 2025 Friflex LLC. Все права защищены.
 
 ---
 
-
-<div align="right">
-
-*Разработано с любовью командой Friflex ❤️*
-
-</div>
+### Разработано с любовью командой Friflex ❤️

analysis_options.yaml

@@ -1,89 +1,135 @@
 include: package:flutter_lints/flutter.yaml
 
-# Включает правила из:
-# - package:lints/core.yaml: основные правила критических проблем
-# - package:lints/recommended.yaml: рекомендуемые правила для чистого кода
-# - package:flutter_lints/flutter.yaml: специфичные правила для Flutter
+# Персонализированные настройки анализатора и линтера.
+# Базовый набор flutter_lints + дополнительные ужесточения.
 
 analyzer:
   exclude:
-    - "android/**"
-    - "assets/**"
-    - "build/**"
-    - "config/**"
-    - "core/**"
-    - "res/**"
-    - "ios/**"
-    - "**/*.g.dart"
-    - "**/*.config.dart"
-    - "**/*.gen.dart"
-    - "**/*.freezed.dart"
-    - "**/generated/*"
-    - "**/*.gr.dart"
-    - "**/*.yaml"
-    - "app_services/aurora/**"
-    - "/app_services/aurora/**"
-    - "**/app_services/aurora/**"
-    - "**/*.lock.dart"
-errors:
-  # Переопределения уровней ошибок (error/warning/info)
-  avoid_dynamic_calls: error # Запрещает использование dynamic для вызовов методов
-  avoid_returning_null_for_future: error # Запрещает возврат null вместо Future
-  avoid_slow_async_io: warning # Предупреждает о медленных асинхронных операциях ввода/вывода
-  avoid_type_to_string: warning # Предупреждает о неправильном использовании toString() для типов
-  cancel_subscriptions: error # Требует отмены подписок, предотвращает утечки памяти
-  close_sinks: error # Требует закрытия sink-ов, предотвращает утечки ресурсов
-  comment_references: warning # Проверяет корректность ссылок в комментариях
-  always_declare_return_types: error # Требует явного указания возвращаемых типов методов
-  always_require_non_null_named_parameters: warning # Требует использования @required для ненулевых параметров
-  avoid_bool_literals_in_conditional_expressions: warning # Запрещает избыточные булевы литералы в условных выражениях
-  avoid_return_types_on_setters: warning # Запрещает возвращаемые типы для сеттеров
-  avoid_returning_null: error # Запрещает возврат null
-  avoid_setters_without_getters: error # Требует создания геттера при наличии сеттера
-  avoid_void_async: error # Запрещает использование void для асинхронных функций
-  constant_identifier_names: error # Проверяет правильность именования констант
-  unnecessary_new: warning # Запрещает избыточное использование ключевого слова new
-  use_decorated_box: warning # Рекомендует использовать DecoratedBox вместо Container
-  use_colored_box: warning # Рекомендует использовать ColoredBox вместо Container с цветом
+    - "build/**"                   # Исключаем артефакты сборки (генерируемый код, кэш, ресурсы)
+    - "android/**"                 # Платформенный код Android (Java/Kotlin, Gradle) не анализируем Dart линтером
+    - "ios/**"                     # Платформенный код iOS (Swift/ObjC) вне области Dart анализа
+    - "assets/**"                  # Статические ассеты (шрифты, изображения, json и др.)
+    - "**/*.g.dart"                # Сгенерированные файлы build_runner / json_serializable
+    - "**/*.freezed.dart"          # Сгенерированные модели пакетом freezed
+    - "**/*.gen.dart"              # Общий паттерн для доп. генераторов
+    - "**/*.gr.dart"               # Генерируемые маршруты (auto_route / другие)
+    - "**/*.config.dart"           # Сгенерированные конфигурационные файлы
+    - "**/generated/**"            # Папки с автогенерируемыми исходниками
+    - "**/*.lock"             # Временные/lock файлы генераторов (если создаются)
+    - "**/app_services/aurora/**"  # Внутренний сервисный код (предположительно внешняя интеграция) исключён
+  errors:
+    avoid_dynamic_calls: error              # Запрет неявных dynamic вызовов (типобезопасность)
+    avoid_returning_null_for_future: error  # Future не должен завершаться null без явной модели
+    avoid_slow_async_io: warning            # Подсказка о потенциально медленных IO операциях
+    avoid_type_to_string: warning           # Предупреждение против использования Type.toString для логики
+    cancel_subscriptions: error             # Требование отменять StreamSubscription для предотвращения утечек
+    close_sinks: error                      # Обязательное закрытие Sink (ресурсное управление)
+    comment_references: warning             # Проверка корректности ссылок в документационных комментариях
+    always_declare_return_types: error      # Явный тип возвращаемого значения повышает читаемость
+    avoid_bool_literals_in_conditional_expressions: warning # Избегать выражений вида condition ? true : false
+    avoid_return_types_on_setters: warning  # Сеттеры не должны объявлять тип возврата
+    avoid_returning_null: warning           # Предпочтительнее nullable типы / Option объекты вместо raw null
+    avoid_setters_without_getters: error    # Сеттер без геттера может скрывать состояние
+    avoid_void_async: error                 # async void нежелателен (трудно ловить ошибки)
+    constant_identifier_names: error        # Единый стиль именования констант (UPPER_CASE)
+    unnecessary_new: warning                # Снижение шума: new не нужен в современном Dart
+    use_decorated_box: warning              # Оптимизация: DecoratedBox вместо контейнера без лишних виджетов
+    use_colored_box: warning                # Оптимизация: ColoredBox для простого цвета фона
 
 linter:
   rules:
-    # Нестандартные правила или правила с измененными значениями
-    always_put_required_named_parameters_first: true # Требовать размещать обязательные именованные параметры первыми
-    avoid_catches_without_on_clauses: true # Избегать catch без указания типа исключения
-    avoid_catching_errors: true # Избегать перехвата ошибок типа Error
-    avoid_equals_and_hash_code_on_mutable_classes: true # Избегать equals и hashCode в изменяемых классах
-    avoid_escaping_inner_quotes: true # Избегать экранирования внутренних кавычек
-    avoid_field_initializers_in_const_classes: true # Избегать инициализаторов полей в константных классах
-    avoid_implementing_value_types: true # Избегать реализации интерфейсов значимых типов
-    avoid_multiple_declarations_per_line: false # Разрешать несколько объявлений в одной строке
-    avoid_positional_boolean_parameters: true # Избегать позиционных булевых параметров
-    avoid_private_typedef_functions: true # Избегать приватных typedef-функций
-    avoid_redundant_argument_values: true # Избегать избыточных значений аргументов
-    avoid_returning_this: true # Избегать возврата this
-    cascade_invocations: true # Использовать каскадные вызовы
-    deprecated_consistency: true # Поддерживать согласованность устаревших элементов
-    do_not_use_environment: false # Разрешить использование Environment
-    leading_newlines_in_multiline_strings: true # Начинать многострочные строки с новой строки
-    no_runtimeType_toString: true # Не использовать runtimeType.toString()
-    one_member_abstracts: false # Разрешать абстрактные классы с одним методом
-    only_throw_errors: true # Выбрасывать только объекты Error
-    parameter_assignments: true # Запрещать присваивание значений параметрам
-    prefer_asserts_with_message: true # Использовать сообщения с assert
-    prefer_constructors_over_static_methods: true # Предпочитать конструкторы статическим методам
-    prefer_final_in_for_each: true # Использовать final в for-each циклах
-    prefer_final_locals: true # Использовать final для локальных переменных
-    public_member_api_docs: false # Не требовать документацию для всех публичных членов
-    require_trailing_commas: true # Требовать запятые в конце для улучшения форматирования
-    sort_constructors_first: true # Требовать размещать конструкторы первыми
-    sort_pub_dependencies: false # Не требовать сортировки зависимостей в pubspec
-    sort_unnamed_constructors_first: false # Не требовать размещать безымянные конструкторы первыми
-    use_is_even_rather_than_modulo: true # Использовать isEven вместо % 2 == 0
-    use_late_for_private_fields_and_variables: false # Не требовать late для приватных полей
-    use_setters_to_change_properties: true # Использовать сеттеры для изменения свойств
-    use_string_buffers: true # Использовать StringBuffer для сложной конкатенации
-    use_to_and_as_if_applicable: true # Использовать методы to и as при применимости
-    no_literal_bool_comparisons: true # Запрещать сравнения с литералами true/false
-    use_key_in_widget_constructors: true # Обязательное указание ключа для stateful/stateless widgets
-    always_use_package_imports: true # Всегда использовать package: импорты
-    unawaited_futures: true # Требовать использование unawaited для неожидаемых Future
+    # === Именование и стиль ===
+    - always_put_required_named_parameters_first   # Обязательные именованные параметры первыми повышают читаемость
+    - always_use_package_imports                   # Единый стиль импортов через package: упрощает refactoring
+    - curly_braces_in_flow_control_structures      # Обязательные фигурные скобки в if/for/while для безопасности
+    - directives_ordering                          # Упорядочивание импортов (dart → package → relative)
+    - prefer_single_quotes                         # Единый стиль кавычек (одинарные быстрее печатать)
+    - slash_for_doc_comments                       # Использовать /// вместо /** */ для документации
+    - sort_constructors_first                      # Конструкторы в начале класса — быстрый обзор API
+    
+    # === Обработка ошибок и типобезопасность ===
+    - avoid_catching_errors                        # Не перехватывать Error (только Exception) — ошибки системные
+    - avoid_catches_without_on_clauses            # Требует явного указания типа исключения в catch (on Type catch)
+    - await_only_futures                           # await только для Future (ловит ошибки типизации)
+    - control_flow_in_finally                      # Запрет return/break/continue в finally блоках
+    - empty_catches                                # Предупреждение о пустых catch (скрытые баги)
+    - hash_and_equals                              # Требует переопределять hashCode и == вместе
+    - only_throw_errors                            # Бросать Error/Exception типы, а не произвольные объекты
+    - test_types_in_equals                         # Проверка типа в equals для безопасности
+    - unrelated_type_equality_checks               # Запрет сравнения несовместимых типов
+    - use_build_context_synchronously              # КРИТИЧНО: запрет BuildContext после async gap
+    - use_rethrow_when_possible                    # Использовать rethrow вместо throw e (сохраняет stacktrace)
+    - discarded_futures                            # Выявляет неожиданные Future без await
+    - unawaited_futures                            # Явно помечать намеренно не ожидаемые Future
+    
+    # === Иммутабельность и const ===
+    - avoid_equals_and_hash_code_on_mutable_classes # hashCode/== на изменяемых классах приводит к багам в коллекциях
+    - prefer_const_constructors                    # Константные конструкторы для производительности
+    - prefer_const_constructors_in_immutables      # Обязательные const в неизменяемых классах
+    - prefer_const_literals_to_create_immutables   # Константные литералы коллекций
+    - prefer_final_fields                          # final для полей где возможно
+    - prefer_final_in_for_each                     # final в forEach предотвращает случайные изменения
+    - prefer_final_locals                          # final локальные переменные — стремимся к иммутабельности
+    - parameter_assignments                        # Не переназначать параметры — вводит путаницу
+    
+    # === Flutter оптимизации ===
+    - avoid_unnecessary_containers                 # Убирает лишние Container виджеты
+    - sized_box_for_whitespace                     # SizedBox вместо Container для отступов
+    - sized_box_shrink_expand                      # Специализированные конструкторы SizedBox.shrink/expand
+    - sort_child_properties_last                   # child/children последними в виджетах
+    - use_colored_box                              # ColoredBox для простого цвета фона
+    - use_decorated_box                            # DecoratedBox вместо контейнера без лишних виджетов
+    - use_key_in_widget_constructors               # Ключ позволяет корректно применить дифф к дереву виджетов
+    
+    # === Современный Dart (2.17+, 3.x) ===
+    - use_super_parameters                         # super параметры для краткости
+    - combinators_ordering                         # Сортировка show/hide в импортах
+    - implicit_call_tearoffs                       # Разрешить неявные tearoffs
+    - matching_super_parameters                    # Автоматическое соответствие параметрам супер-конструктора
+    - use_enums                                    # Предпочитать enums вместо статических констант
+    
+    # === Читаемость кода ===
+    - avoid_escaping_inner_quotes                  # Предпочтительно менять тип кавычек вместо экранирования
+    - avoid_field_initializers_in_const_classes    # Инициализация в константных классах тяжеловесна/избыточна
+    - avoid_implementing_value_types               # Не реализовывать value-type интерфейсы вручную (риск несовпадений)
+    - avoid_positional_boolean_parameters          # Булевые позиционные параметры плохо читаются (использовать именованные)
+    - avoid_private_typedef_functions              # Приватные typedef затрудняют повторное использование / читаемость
+    - avoid_redundant_argument_values              # Удалять аргументы совпадающие с значениями по умолчанию
+    - avoid_returning_this                         # Возврат this усложняет fluent API и может скрывать ошибки
+    - cascade_invocations                          # Использовать каскады для последовательности операций над объектом
+    - deprecated_consistency                       # Единый стиль пометок @deprecated
+    - leading_newlines_in_multiline_strings        # Многострочные строки начинают с новой строки — чище diff
+    - no_literal_bool_comparisons                  # Исключить сравнения вида flag == true
+    - no_runtimeType_toString                      # runtimeType.toString нестабилен для логики (только отладка)
+    - prefer_asserts_with_message                  # Сообщение в assert облегчает диагностику
+    - prefer_constructors_over_static_methods      # Конструкторы лучше выражают создание экземпляра
+    - comment_references                           # Корректные ссылки в комментариях (небитые, видимые)
+    
+    # === Сахар и идиомы ===
+    - avoid_init_to_null                           # Не писать = null явно (по умолчанию)
+    - prefer_if_null_operators                     # ?? оператор вместо тернарника с null
+    - prefer_interpolation_to_compose_strings      # Интерполяция вместо конкатенации
+    - prefer_is_empty                              # .isEmpty вместо .length == 0
+    - prefer_is_not_empty                          # .isNotEmpty вместо .length > 0
+    - use_is_even_rather_than_modulo               # isEven более явно и может быть эффективнее
+    - use_setters_to_change_properties             # Изменение полей через сеттеры (инкапсуляция)
+    - use_string_buffers                           # StringBuffer эффективнее при конкатенации в циклах
+    - use_to_and_as_if_applicable                  # Использовать to*/as* если семантика преобразования доступна
+    
+    # === Удаление избыточности ===
+    - avoid_return_types_on_setters                # Сеттеры не должны объявлять тип возврата
+    - unnecessary_const                            # Убирает лишние const
+    - unnecessary_new                              # Убирает лишние new
+    - unnecessary_this                             # Убирает лишние this
+    - unnecessary_parenthesis                      # Лишние скобки
+    
+    # === Продакшн / отладка ===
+    - avoid_print                                  # Запрет print в продакшене (использовать logger)
+
+bloc:
+  rules:
+    - avoid_flutter_imports        # Логика блока должна быть платформенно независимой
+    - avoid_public_bloc_methods    # Публичные методы могут нарушать чистоту паттерна (использовать события)
+    - avoid_public_fields          # Публичные поля обходят инкапсуляцию; использовать состояние/события
+    - prefer_file_naming_conventions # Единообразие именования файлов блоков повышает навигацию
+    

app_services/aurora/app_services/README.md

@@ -1 +1 @@
-# Базовые сервисы для приложения
+# Реализация сервисов для Аврора OC

app_services/aurora/app_services/analysis_options.yaml

@@ -1,89 +1,135 @@
 include: package:flutter_lints/flutter.yaml
 
-# Включает правила из:
-# - package:lints/core.yaml: основные правила критических проблем
-# - package:lints/recommended.yaml: рекомендуемые правила для чистого кода
-# - package:flutter_lints/flutter.yaml: специфичные правила для Flutter
+# Персонализированные настройки анализатора и линтера.
+# Базовый набор flutter_lints + дополнительные ужесточения.
 
 analyzer:
   exclude:
-    - "android/**"
-    - "assets/**"
-    - "build/**"
-    - "config/**"
-    - "core/**"
-    - "res/**"
-    - "ios/**"
-    - "**/*.g.dart"
-    - "**/*.config.dart"
-    - "**/*.gen.dart"
-    - "**/*.freezed.dart"
-    - "**/generated/*"
-    - "**/*.gr.dart"
-    - "**/*.yaml"
-    - "app_services/aurora/**"
-    - "/app_services/aurora/**"
-    - "**/app_services/aurora/**"
-    - "**/*.lock.dart"
-errors:
-  # Переопределения уровней ошибок (error/warning/info)
-  avoid_dynamic_calls: error # Запрещает использование dynamic для вызовов методов
-  avoid_returning_null_for_future: error # Запрещает возврат null вместо Future
-  avoid_slow_async_io: warning # Предупреждает о медленных асинхронных операциях ввода/вывода
-  avoid_type_to_string: warning # Предупреждает о неправильном использовании toString() для типов
-  cancel_subscriptions: error # Требует отмены подписок, предотвращает утечки памяти
-  close_sinks: error # Требует закрытия sink-ов, предотвращает утечки ресурсов
-  comment_references: warning # Проверяет корректность ссылок в комментариях
-  always_declare_return_types: error # Требует явного указания возвращаемых типов методов
-  always_require_non_null_named_parameters: warning # Требует использования @required для ненулевых параметров
-  avoid_bool_literals_in_conditional_expressions: warning # Запрещает избыточные булевы литералы в условных выражениях
-  avoid_return_types_on_setters: warning # Запрещает возвращаемые типы для сеттеров
-  avoid_returning_null: error # Запрещает возврат null
-  avoid_setters_without_getters: error # Требует создания геттера при наличии сеттера
-  avoid_void_async: error # Запрещает использование void для асинхронных функций
-  constant_identifier_names: error # Проверяет правильность именования констант
-  unnecessary_new: warning # Запрещает избыточное использование ключевого слова new
-  use_decorated_box: warning # Рекомендует использовать DecoratedBox вместо Container
-  use_colored_box: warning # Рекомендует использовать ColoredBox вместо Container с цветом
+    - "build/**"                   # Исключаем артефакты сборки (генерируемый код, кэш, ресурсы)
+    - "android/**"                 # Платформенный код Android (Java/Kotlin, Gradle) не анализируем Dart линтером
+    - "ios/**"                     # Платформенный код iOS (Swift/ObjC) вне области Dart анализа
+    - "assets/**"                  # Статические ассеты (шрифты, изображения, json и др.)
+    - "**/*.g.dart"                # Сгенерированные файлы build_runner / json_serializable
+    - "**/*.freezed.dart"          # Сгенерированные модели пакетом freezed
+    - "**/*.gen.dart"              # Общий паттерн для доп. генераторов
+    - "**/*.gr.dart"               # Генерируемые маршруты (auto_route / другие)
+    - "**/*.config.dart"           # Сгенерированные конфигурационные файлы
+    - "**/generated/**"            # Папки с автогенерируемыми исходниками
+    - "**/*.lock"             # Временные/lock файлы генераторов (если создаются)
+    - "**/app_services/aurora/**"  # Внутренний сервисный код (предположительно внешняя интеграция) исключён
+  errors:
+    avoid_dynamic_calls: error              # Запрет неявных dynamic вызовов (типобезопасность)
+    avoid_returning_null_for_future: error  # Future не должен завершаться null без явной модели
+    avoid_slow_async_io: warning            # Подсказка о потенциально медленных IO операциях
+    avoid_type_to_string: warning           # Предупреждение против использования Type.toString для логики
+    cancel_subscriptions: error             # Требование отменять StreamSubscription для предотвращения утечек
+    close_sinks: error                      # Обязательное закрытие Sink (ресурсное управление)
+    comment_references: warning             # Проверка корректности ссылок в документационных комментариях
+    always_declare_return_types: error      # Явный тип возвращаемого значения повышает читаемость
+    avoid_bool_literals_in_conditional_expressions: warning # Избегать выражений вида condition ? true : false
+    avoid_return_types_on_setters: warning  # Сеттеры не должны объявлять тип возврата
+    avoid_returning_null: warning           # Предпочтительнее nullable типы / Option объекты вместо raw null
+    avoid_setters_without_getters: error    # Сеттер без геттера может скрывать состояние
+    avoid_void_async: error                 # async void нежелателен (трудно ловить ошибки)
+    constant_identifier_names: error        # Единый стиль именования констант (UPPER_CASE)
+    unnecessary_new: warning                # Снижение шума: new не нужен в современном Dart
+    use_decorated_box: warning              # Оптимизация: DecoratedBox вместо контейнера без лишних виджетов
+    use_colored_box: warning                # Оптимизация: ColoredBox для простого цвета фона
 
 linter:
   rules:
-    # Нестандартные правила или правила с измененными значениями
-    always_put_required_named_parameters_first: true # Требовать размещать обязательные именованные параметры первыми
-    avoid_catches_without_on_clauses: true # Избегать catch без указания типа исключения
-    avoid_catching_errors: true # Избегать перехвата ошибок типа Error
-    avoid_equals_and_hash_code_on_mutable_classes: true # Избегать equals и hashCode в изменяемых классах
-    avoid_escaping_inner_quotes: true # Избегать экранирования внутренних кавычек
-    avoid_field_initializers_in_const_classes: true # Избегать инициализаторов полей в константных классах
-    avoid_implementing_value_types: true # Избегать реализации интерфейсов значимых типов
-    avoid_multiple_declarations_per_line: false # Разрешать несколько объявлений в одной строке
-    avoid_positional_boolean_parameters: true # Избегать позиционных булевых параметров
-    avoid_private_typedef_functions: true # Избегать приватных typedef-функций
-    avoid_redundant_argument_values: true # Избегать избыточных значений аргументов
-    avoid_returning_this: true # Избегать возврата this
-    cascade_invocations: true # Использовать каскадные вызовы
-    deprecated_consistency: true # Поддерживать согласованность устаревших элементов
-    do_not_use_environment: false # Разрешить использование Environment
-    leading_newlines_in_multiline_strings: true # Начинать многострочные строки с новой строки
-    no_runtimeType_toString: true # Не использовать runtimeType.toString()
-    one_member_abstracts: false # Разрешать абстрактные классы с одним методом
-    only_throw_errors: true # Выбрасывать только объекты Error
-    parameter_assignments: true # Запрещать присваивание значений параметрам
-    prefer_asserts_with_message: true # Использовать сообщения с assert
-    prefer_constructors_over_static_methods: true # Предпочитать конструкторы статическим методам
-    prefer_final_in_for_each: true # Использовать final в for-each циклах
-    prefer_final_locals: true # Использовать final для локальных переменных
-    public_member_api_docs: false # Не требовать документацию для всех публичных членов
-    require_trailing_commas: true # Требовать запятые в конце для улучшения форматирования
-    sort_constructors_first: true # Требовать размещать конструкторы первыми
-    sort_pub_dependencies: false # Не требовать сортировки зависимостей в pubspec
-    sort_unnamed_constructors_first: false # Не требовать размещать безымянные конструкторы первыми
-    use_is_even_rather_than_modulo: true # Использовать isEven вместо % 2 == 0
-    use_late_for_private_fields_and_variables: false # Не требовать late для приватных полей
-    use_setters_to_change_properties: true # Использовать сеттеры для изменения свойств
-    use_string_buffers: true # Использовать StringBuffer для сложной конкатенации
-    use_to_and_as_if_applicable: true # Использовать методы to и as при применимости
-    no_literal_bool_comparisons: true # Запрещать сравнения с литералами true/false
-    use_key_in_widget_constructors: true # Обязательное указание ключа для stateful/stateless widgets
-    always_use_package_imports: true # Всегда использовать package: импорты
+    # === Именование и стиль ===
+    - always_put_required_named_parameters_first   # Обязательные именованные параметры первыми повышают читаемость
+    - always_use_package_imports                   # Единый стиль импортов через package: упрощает refactoring
+    - curly_braces_in_flow_control_structures      # Обязательные фигурные скобки в if/for/while для безопасности
+    - directives_ordering                          # Упорядочивание импортов (dart → package → relative)
+    - eol_at_end_of_file                           # Пустая строка в конце файла (POSIX standard)
+    - prefer_single_quotes                         # Единый стиль кавычек (одинарные быстрее печатать)
+    - slash_for_doc_comments                       # Использовать /// вместо /** */ для документации
+    - sort_constructors_first                      # Конструкторы в начале класса — быстрый обзор API
+    
+    # === Обработка ошибок и типобезопасность ===
+    - avoid_catching_errors                        # Не перехватывать Error (только Exception) — ошибки системные
+    - await_only_futures                           # await только для Future (ловит ошибки типизации)
+    - control_flow_in_finally                      # Запрет return/break/continue в finally блоках
+    - empty_catches                                # Предупреждение о пустых catch (скрытые баги)
+    - hash_and_equals                              # Требует переопределять hashCode и == вместе
+    - only_throw_errors                            # Бросать Error/Exception типы, а не произвольные объекты
+    - test_types_in_equals                         # Проверка типа в equals для безопасности
+    - unrelated_type_equality_checks               # Запрет сравнения несовместимых типов
+    - use_build_context_synchronously              # КРИТИЧНО: запрет BuildContext после async gap
+    - use_rethrow_when_possible                    # Использовать rethrow вместо throw e (сохраняет stacktrace)
+    - discarded_futures                            # Выявляет неожиданные Future без await
+    - unawaited_futures                            # Явно помечать намеренно не ожидаемые Future
+    
+    # === Иммутабельность и const ===
+    - avoid_equals_and_hash_code_on_mutable_classes # hashCode/== на изменяемых классах приводит к багам в коллекциях
+    - prefer_const_constructors                    # Константные конструкторы для производительности
+    - prefer_const_constructors_in_immutables      # Обязательные const в неизменяемых классах
+    - prefer_const_literals_to_create_immutables   # Константные литералы коллекций
+    - prefer_final_fields                          # final для полей где возможно
+    - prefer_final_in_for_each                     # final в forEach предотвращает случайные изменения
+    - prefer_final_locals                          # final локальные переменные — стремимся к иммутабельности
+    - parameter_assignments                        # Не переназначать параметры — вводит путаницу
+    
+    # === Flutter оптимизации ===
+    - avoid_unnecessary_containers                 # Убирает лишние Container виджеты
+    - sized_box_for_whitespace                     # SizedBox вместо Container для отступов
+    - sized_box_shrink_expand                      # Специализированные конструкторы SizedBox.shrink/expand
+    - sort_child_properties_last                   # child/children последними в виджетах
+    - use_colored_box                              # ColoredBox для простого цвета фона
+    - use_decorated_box                            # DecoratedBox вместо контейнера без лишних виджетов
+    - use_key_in_widget_constructors               # Ключ позволяет корректно применить дифф к дереву виджетов
+    
+    # === Современный Dart (2.17+, 3.x) ===
+    - use_super_parameters                         # super параметры для краткости
+    - combinators_ordering                         # Сортировка show/hide в импортах
+    - implicit_call_tearoffs                       # Разрешить неявные tearoffs
+    - matching_super_parameters                    # Автоматическое соответствие параметрам супер-конструктора
+    - use_enums                                    # Предпочитать enums вместо статических констант
+    
+    # === Читаемость кода ===
+    - avoid_escaping_inner_quotes                  # Предпочтительно менять тип кавычек вместо экранирования
+    - avoid_field_initializers_in_const_classes    # Инициализация в константных классах тяжеловесна/избыточна
+    - avoid_implementing_value_types               # Не реализовывать value-type интерфейсы вручную (риск несовпадений)
+    - avoid_positional_boolean_parameters          # Булевые позиционные параметры плохо читаются (использовать именованные)
+    - avoid_private_typedef_functions              # Приватные typedef затрудняют повторное использование / читаемость
+    - avoid_redundant_argument_values              # Удалять аргументы совпадающие с значениями по умолчанию
+    - avoid_returning_this                         # Возврат this усложняет fluent API и может скрывать ошибки
+    - cascade_invocations                          # Использовать каскады для последовательности операций над объектом
+    - deprecated_consistency                       # Единый стиль пометок @deprecated
+    - leading_newlines_in_multiline_strings        # Многострочные строки начинают с новой строки — чище diff
+    - no_literal_bool_comparisons                  # Исключить сравнения вида flag == true
+    - no_runtimeType_toString                      # runtimeType.toString нестабилен для логики (только отладка)
+    - prefer_asserts_with_message                  # Сообщение в assert облегчает диагностику
+    - prefer_constructors_over_static_methods      # Конструкторы лучше выражают создание экземпляра
+    - comment_references                           # Корректные ссылки в комментариях (небитые, видимые)
+    
+    # === Сахар и идиомы ===
+    - avoid_init_to_null                           # Не писать = null явно (по умолчанию)
+    - prefer_if_null_operators                     # ?? оператор вместо тернарника с null
+    - prefer_interpolation_to_compose_strings      # Интерполяция вместо конкатенации
+    - prefer_is_empty                              # .isEmpty вместо .length == 0
+    - prefer_is_not_empty                          # .isNotEmpty вместо .length > 0
+    - use_is_even_rather_than_modulo               # isEven более явно и может быть эффективнее
+    - use_setters_to_change_properties             # Изменение полей через сеттеры (инкапсуляция)
+    - use_string_buffers                           # StringBuffer эффективнее при конкатенации в циклах
+    - use_to_and_as_if_applicable                  # Использовать to*/as* если семантика преобразования доступна
+    
+    # === Удаление избыточности ===
+    - avoid_return_types_on_setters                # Сеттеры не должны объявлять тип возврата
+    - unnecessary_const                            # Убирает лишние const
+    - unnecessary_new                              # Убирает лишние new
+    - unnecessary_this                             # Убирает лишние this
+    - unnecessary_parenthesis                      # Лишние скобки
+    
+    # === Продакшн / отладка ===
+    - avoid_print                                  # Запрет print в продакшене (использовать logger)
 
+bloc:
+  rules:
+    - avoid_flutter_imports        # Логика блока должна быть платформенно независимой
+    - avoid_public_bloc_methods    # Публичные методы могут нарушать чистоту паттерна (использовать события)
+    - avoid_public_fields          # Публичные поля обходят инкапсуляцию; использовать состояние/события
+    - prefer_file_naming_conventions # Единообразие именования файлов блоков повышает навигацию
+    

app_services/aurora/app_services/lib/app_services.dart

@@ -1,4 +1,5 @@
 library;
 
+export 'src/app_location_service.dart';
 export 'src/app_path_provider.dart';
 export 'src/app_secure_storage.dart';

app_services/aurora/app_services/lib/src/app_location_service.dart

@@ -0,0 +1,18 @@
+import 'package:i_app_services/i_app_services.dart';
+
+/// {@template app_location_service}
+/// Реализация сервиса для работы с гео на платформе Aurora.
+/// {@endtemplate}
+class AppLocationService implements ILocationService {
+  /// {@macro app_location_service}
+  const AppLocationService();
+
+  /// Наименование сервиса
+  static const name = 'AuroraAppLocationService';
+
+  @override
+  Future<Object?> getCurrentPosition() {
+    // TODO: Реализовать получение текущей позиции в AuroraOS
+    throw UnimplementedError();
+  }
+}

app_services/aurora/app_services/lib/src/app_path_provider.dart

@@ -1,5 +1,4 @@
 import 'package:i_app_services/i_app_services.dart';
-import 'package:path_provider/path_provider.dart';
 
 /// {@template app_path_provider}
 /// Класс для Аврора реализации сервиса работы с путями
@@ -13,6 +12,7 @@ class AppPathProvider implements IPathProvider {
 
   @override
   Future<String> getAppDocumentsDirectoryPath() async {
-    return (await getApplicationDocumentsDirectory()).path;
+    // TODO: Реализовать для AuroraOS
+    throw UnimplementedError();
   }
 }

app_services/aurora/app_services/lib/src/app_secure_storage.dart

@@ -1,5 +1,3 @@
-import 'package:flutter_secure_storage/flutter_secure_storage.dart';
-import 'package:flutter_secure_storage_aurora/flutter_secure_storage_aurora.dart';
 import 'package:i_app_services/i_app_services.dart';
 
 /// {@template app_secure_storage}
@@ -12,7 +10,8 @@ final class AppSecureStorage implements ISecureStorage {
   /// Принимает:
   /// - [secretKey] - ключ шифрования данных
   AppSecureStorage({required this.secretKey}) {
-    FlutterSecureStorageAurora.setSecret(secretKey);
+    // Инициализация Aurora Secure Storage с ключом шифрования
+    // FlutterSecureStorageAurora.setSecret(secretKey);
   }
 
   @override
@@ -20,34 +19,36 @@ final class AppSecureStorage implements ISecureStorage {
 
   static const name = 'AuroraAppSecureStorage';
 
-  /// Экземпляр хранилища данных
-  final _box = const FlutterSecureStorage();
-
-  @override
-  Future<void> clear() async {
-    await _box.deleteAll();
-  }
-
   @override
   Future<void> delete(String key) async {
-    await _box.delete(key: key);
-  }
-
-  @override
-  Future<bool> exists(String key) {
-    return _box.containsKey(key: key);
+    // TODO: Реализовать удаление ключа из Aurora Secure Storage
+    throw UnimplementedError();
   }
 
   @override
   Future<String?> read(String key) async {
-    return _box.read(key: key);
+    // TODO: Реализовать чтение значения по ключу из Aurora Secure Storage
+    throw UnimplementedError();
   }
 
   @override
   Future<void> write(String key, String value) async {
-    await _box.write(key: key, value: value);
+    // TODO: Реализовать запись значения по ключу в Aurora Secure Storage
+    throw UnimplementedError();
   }
 
   @override
   String get nameImpl => AppSecureStorage.name;
+
+  @override
+  Future<bool> containsKey(String key) {
+    // TODO: Реализовать проверку наличия ключа в Aurora Secure Storage
+    throw UnimplementedError();
+  }
+
+  @override
+  Future<void> deleteAll() {
+    // TODO: Реализовать удаление всех ключей из Aurora Secure Storage
+    throw UnimplementedError();
+  }
 }

app_services/aurora/app_services/pubspec.yaml

@@ -1,31 +1,15 @@
 name: app_services
-description: "Google сервисы для приложения"
+description: "Аврора ОС сервисы для приложения"
 version: 0.0.1
 publish_to: none
 
 environment:
-  sdk: ^3.8.0
-
+  sdk: ">=3.0.0 <4.0.0"
 
 dependencies:
   flutter:
     sdk: flutter
 
-  # Зависимости для сервиса защищенного хранилища
-  flutter_secure_storage: 8.0.0
-  flutter_secure_storage_aurora:
-    git:
-      url: https://gitlab.com/omprussia/flutter/flutter-community-plugins/flutter_secure_storage_aurora.git
-      ref: aurora-0.5.3
-
-  # для работы с путями в хранилища
-  path_provider: 2.1.4
-  path_provider_aurora:
-    git:
-      url: https://gitlab.com/omprussia/flutter/packages.git
-      ref: aurora-path_provider_aurora-0.6.0
-      path: packages/path_provider_aurora
-
   # Обязательные интерфейсы
   i_app_services:
     path: ../../i_app_services

app_services/base/app_services/analysis_options.yaml

@@ -1,89 +1,135 @@
 include: package:flutter_lints/flutter.yaml
 
-# Включает правила из:
-# - package:lints/core.yaml: основные правила критических проблем
-# - package:lints/recommended.yaml: рекомендуемые правила для чистого кода
-# - package:flutter_lints/flutter.yaml: специфичные правила для Flutter
+# Персонализированные настройки анализатора и линтера.
+# Базовый набор flutter_lints + дополнительные ужесточения.
 
 analyzer:
   exclude:
-    - "android/**"
-    - "assets/**"
-    - "build/**"
-    - "config/**"
-    - "core/**"
-    - "res/**"
-    - "ios/**"
-    - "**/*.g.dart"
-    - "**/*.config.dart"
-    - "**/*.gen.dart"
-    - "**/*.freezed.dart"
-    - "**/generated/*"
-    - "**/*.gr.dart"
-    - "**/*.yaml"
-    - "app_services/aurora/**"
-    - "/app_services/aurora/**"
-    - "**/app_services/aurora/**"
-    - "**/*.lock.dart"
-errors:
-  # Переопределения уровней ошибок (error/warning/info)
-  avoid_dynamic_calls: error # Запрещает использование dynamic для вызовов методов
-  avoid_returning_null_for_future: error # Запрещает возврат null вместо Future
-  avoid_slow_async_io: warning # Предупреждает о медленных асинхронных операциях ввода/вывода
-  avoid_type_to_string: warning # Предупреждает о неправильном использовании toString() для типов
-  cancel_subscriptions: error # Требует отмены подписок, предотвращает утечки памяти
-  close_sinks: error # Требует закрытия sink-ов, предотвращает утечки ресурсов
-  comment_references: warning # Проверяет корректность ссылок в комментариях
-  always_declare_return_types: error # Требует явного указания возвращаемых типов методов
-  always_require_non_null_named_parameters: warning # Требует использования @required для ненулевых параметров
-  avoid_bool_literals_in_conditional_expressions: warning # Запрещает избыточные булевы литералы в условных выражениях
-  avoid_return_types_on_setters: warning # Запрещает возвращаемые типы для сеттеров
-  avoid_returning_null: error # Запрещает возврат null
-  avoid_setters_without_getters: error # Требует создания геттера при наличии сеттера
-  avoid_void_async: error # Запрещает использование void для асинхронных функций
-  constant_identifier_names: error # Проверяет правильность именования констант
-  unnecessary_new: warning # Запрещает избыточное использование ключевого слова new
-  use_decorated_box: warning # Рекомендует использовать DecoratedBox вместо Container
-  use_colored_box: warning # Рекомендует использовать ColoredBox вместо Container с цветом
+    - "build/**"                   # Исключаем артефакты сборки (генерируемый код, кэш, ресурсы)
+    - "android/**"                 # Платформенный код Android (Java/Kotlin, Gradle) не анализируем Dart линтером
+    - "ios/**"                     # Платформенный код iOS (Swift/ObjC) вне области Dart анализа
+    - "assets/**"                  # Статические ассеты (шрифты, изображения, json и др.)
+    - "**/*.g.dart"                # Сгенерированные файлы build_runner / json_serializable
+    - "**/*.freezed.dart"          # Сгенерированные модели пакетом freezed
+    - "**/*.gen.dart"              # Общий паттерн для доп. генераторов
+    - "**/*.gr.dart"               # Генерируемые маршруты (auto_route / другие)
+    - "**/*.config.dart"           # Сгенерированные конфигурационные файлы
+    - "**/generated/**"            # Папки с автогенерируемыми исходниками
+    - "**/*.lock"             # Временные/lock файлы генераторов (если создаются)
+    - "**/app_services/aurora/**"  # Внутренний сервисный код (предположительно внешняя интеграция) исключён
+  errors:
+    avoid_dynamic_calls: error              # Запрет неявных dynamic вызовов (типобезопасность)
+    avoid_returning_null_for_future: error  # Future не должен завершаться null без явной модели
+    avoid_slow_async_io: warning            # Подсказка о потенциально медленных IO операциях
+    avoid_type_to_string: warning           # Предупреждение против использования Type.toString для логики
+    cancel_subscriptions: error             # Требование отменять StreamSubscription для предотвращения утечек
+    close_sinks: error                      # Обязательное закрытие Sink (ресурсное управление)
+    comment_references: warning             # Проверка корректности ссылок в документационных комментариях
+    always_declare_return_types: error      # Явный тип возвращаемого значения повышает читаемость
+    avoid_bool_literals_in_conditional_expressions: warning # Избегать выражений вида condition ? true : false
+    avoid_return_types_on_setters: warning  # Сеттеры не должны объявлять тип возврата
+    avoid_returning_null: warning           # Предпочтительнее nullable типы / Option объекты вместо raw null
+    avoid_setters_without_getters: error    # Сеттер без геттера может скрывать состояние
+    avoid_void_async: error                 # async void нежелателен (трудно ловить ошибки)
+    constant_identifier_names: error        # Единый стиль именования констант (UPPER_CASE)
+    unnecessary_new: warning                # Снижение шума: new не нужен в современном Dart
+    use_decorated_box: warning              # Оптимизация: DecoratedBox вместо контейнера без лишних виджетов
+    use_colored_box: warning                # Оптимизация: ColoredBox для простого цвета фона
 
 linter:
   rules:
-    # Нестандартные правила или правила с измененными значениями
-    always_put_required_named_parameters_first: true # Требовать размещать обязательные именованные параметры первыми
-    avoid_catches_without_on_clauses: true # Избегать catch без указания типа исключения
-    avoid_catching_errors: true # Избегать перехвата ошибок типа Error
-    avoid_equals_and_hash_code_on_mutable_classes: true # Избегать equals и hashCode в изменяемых классах
-    avoid_escaping_inner_quotes: true # Избегать экранирования внутренних кавычек
-    avoid_field_initializers_in_const_classes: true # Избегать инициализаторов полей в константных классах
-    avoid_implementing_value_types: true # Избегать реализации интерфейсов значимых типов
-    avoid_multiple_declarations_per_line: false # Разрешать несколько объявлений в одной строке
-    avoid_positional_boolean_parameters: true # Избегать позиционных булевых параметров
-    avoid_private_typedef_functions: true # Избегать приватных typedef-функций
-    avoid_redundant_argument_values: true # Избегать избыточных значений аргументов
-    avoid_returning_this: true # Избегать возврата this
-    cascade_invocations: true # Использовать каскадные вызовы
-    deprecated_consistency: true # Поддерживать согласованность устаревших элементов
-    do_not_use_environment: false # Разрешить использование Environment
-    leading_newlines_in_multiline_strings: true # Начинать многострочные строки с новой строки
-    no_runtimeType_toString: true # Не использовать runtimeType.toString()
-    one_member_abstracts: false # Разрешать абстрактные классы с одним методом
-    only_throw_errors: true # Выбрасывать только объекты Error
-    parameter_assignments: true # Запрещать присваивание значений параметрам
-    prefer_asserts_with_message: true # Использовать сообщения с assert
-    prefer_constructors_over_static_methods: true # Предпочитать конструкторы статическим методам
-    prefer_final_in_for_each: true # Использовать final в for-each циклах
-    prefer_final_locals: true # Использовать final для локальных переменных
-    public_member_api_docs: false # Не требовать документацию для всех публичных членов
-    require_trailing_commas: true # Требовать запятые в конце для улучшения форматирования
-    sort_constructors_first: true # Требовать размещать конструкторы первыми
-    sort_pub_dependencies: false # Не требовать сортировки зависимостей в pubspec
-    sort_unnamed_constructors_first: false # Не требовать размещать безымянные конструкторы первыми
-    use_is_even_rather_than_modulo: true # Использовать isEven вместо % 2 == 0
-    use_late_for_private_fields_and_variables: false # Не требовать late для приватных полей
-    use_setters_to_change_properties: true # Использовать сеттеры для изменения свойств
-    use_string_buffers: true # Использовать StringBuffer для сложной конкатенации
-    use_to_and_as_if_applicable: true # Использовать методы to и as при применимости
-    no_literal_bool_comparisons: true # Запрещать сравнения с литералами true/false
-    use_key_in_widget_constructors: true # Обязательное указание ключа для stateful/stateless widgets
-    always_use_package_imports: true # Всегда использовать package: импорты
+    # === Именование и стиль ===
+    - always_put_required_named_parameters_first   # Обязательные именованные параметры первыми повышают читаемость
+    - always_use_package_imports                   # Единый стиль импортов через package: упрощает refactoring
+    - curly_braces_in_flow_control_structures      # Обязательные фигурные скобки в if/for/while для безопасности
+    - directives_ordering                          # Упорядочивание импортов (dart → package → relative)
+    - eol_at_end_of_file                           # Пустая строка в конце файла (POSIX standard)
+    - prefer_single_quotes                         # Единый стиль кавычек (одинарные быстрее печатать)
+    - slash_for_doc_comments                       # Использовать /// вместо /** */ для документации
+    - sort_constructors_first                      # Конструкторы в начале класса — быстрый обзор API
+    
+    # === Обработка ошибок и типобезопасность ===
+    - avoid_catching_errors                        # Не перехватывать Error (только Exception) — ошибки системные
+    - await_only_futures                           # await только для Future (ловит ошибки типизации)
+    - control_flow_in_finally                      # Запрет return/break/continue в finally блоках
+    - empty_catches                                # Предупреждение о пустых catch (скрытые баги)
+    - hash_and_equals                              # Требует переопределять hashCode и == вместе
+    - only_throw_errors                            # Бросать Error/Exception типы, а не произвольные объекты
+    - test_types_in_equals                         # Проверка типа в equals для безопасности
+    - unrelated_type_equality_checks               # Запрет сравнения несовместимых типов
+    - use_build_context_synchronously              # КРИТИЧНО: запрет BuildContext после async gap
+    - use_rethrow_when_possible                    # Использовать rethrow вместо throw e (сохраняет stacktrace)
+    - discarded_futures                            # Выявляет неожиданные Future без await
+    - unawaited_futures                            # Явно помечать намеренно не ожидаемые Future
+    
+    # === Иммутабельность и const ===
+    - avoid_equals_and_hash_code_on_mutable_classes # hashCode/== на изменяемых классах приводит к багам в коллекциях
+    - prefer_const_constructors                    # Константные конструкторы для производительности
+    - prefer_const_constructors_in_immutables      # Обязательные const в неизменяемых классах
+    - prefer_const_literals_to_create_immutables   # Константные литералы коллекций
+    - prefer_final_fields                          # final для полей где возможно
+    - prefer_final_in_for_each                     # final в forEach предотвращает случайные изменения
+    - prefer_final_locals                          # final локальные переменные — стремимся к иммутабельности
+    - parameter_assignments                        # Не переназначать параметры — вводит путаницу
+    
+    # === Flutter оптимизации ===
+    - avoid_unnecessary_containers                 # Убирает лишние Container виджеты
+    - sized_box_for_whitespace                     # SizedBox вместо Container для отступов
+    - sized_box_shrink_expand                      # Специализированные конструкторы SizedBox.shrink/expand
+    - sort_child_properties_last                   # child/children последними в виджетах
+    - use_colored_box                              # ColoredBox для простого цвета фона
+    - use_decorated_box                            # DecoratedBox вместо контейнера без лишних виджетов
+    - use_key_in_widget_constructors               # Ключ позволяет корректно применить дифф к дереву виджетов
+    
+    # === Современный Dart (2.17+, 3.x) ===
+    - use_super_parameters                         # super параметры для краткости
+    - combinators_ordering                         # Сортировка show/hide в импортах
+    - implicit_call_tearoffs                       # Разрешить неявные tearoffs
+    - matching_super_parameters                    # Автоматическое соответствие параметрам супер-конструктора
+    - use_enums                                    # Предпочитать enums вместо статических констант
+    
+    # === Читаемость кода ===
+    - avoid_escaping_inner_quotes                  # Предпочтительно менять тип кавычек вместо экранирования
+    - avoid_field_initializers_in_const_classes    # Инициализация в константных классах тяжеловесна/избыточна
+    - avoid_implementing_value_types               # Не реализовывать value-type интерфейсы вручную (риск несовпадений)
+    - avoid_positional_boolean_parameters          # Булевые позиционные параметры плохо читаются (использовать именованные)
+    - avoid_private_typedef_functions              # Приватные typedef затрудняют повторное использование / читаемость
+    - avoid_redundant_argument_values              # Удалять аргументы совпадающие с значениями по умолчанию
+    - avoid_returning_this                         # Возврат this усложняет fluent API и может скрывать ошибки
+    - cascade_invocations                          # Использовать каскады для последовательности операций над объектом
+    - deprecated_consistency                       # Единый стиль пометок @deprecated
+    - leading_newlines_in_multiline_strings        # Многострочные строки начинают с новой строки — чище diff
+    - no_literal_bool_comparisons                  # Исключить сравнения вида flag == true
+    - no_runtimeType_toString                      # runtimeType.toString нестабилен для логики (только отладка)
+    - prefer_asserts_with_message                  # Сообщение в assert облегчает диагностику
+    - prefer_constructors_over_static_methods      # Конструкторы лучше выражают создание экземпляра
+    - comment_references                           # Корректные ссылки в комментариях (небитые, видимые)
+    
+    # === Сахар и идиомы ===
+    - avoid_init_to_null                           # Не писать = null явно (по умолчанию)
+    - prefer_if_null_operators                     # ?? оператор вместо тернарника с null
+    - prefer_interpolation_to_compose_strings      # Интерполяция вместо конкатенации
+    - prefer_is_empty                              # .isEmpty вместо .length == 0
+    - prefer_is_not_empty                          # .isNotEmpty вместо .length > 0
+    - use_is_even_rather_than_modulo               # isEven более явно и может быть эффективнее
+    - use_setters_to_change_properties             # Изменение полей через сеттеры (инкапсуляция)
+    - use_string_buffers                           # StringBuffer эффективнее при конкатенации в циклах
+    - use_to_and_as_if_applicable                  # Использовать to*/as* если семантика преобразования доступна
+    
+    # === Удаление избыточности ===
+    - avoid_return_types_on_setters                # Сеттеры не должны объявлять тип возврата
+    - unnecessary_const                            # Убирает лишние const
+    - unnecessary_new                              # Убирает лишние new
+    - unnecessary_this                             # Убирает лишние this
+    - unnecessary_parenthesis                      # Лишние скобки
+    
+    # === Продакшн / отладка ===
+    - avoid_print                                  # Запрет print в продакшене (использовать logger)
 
+bloc:
+  rules:
+    - avoid_flutter_imports        # Логика блока должна быть платформенно независимой
+    - avoid_public_bloc_methods    # Публичные методы могут нарушать чистоту паттерна (использовать события)
+    - avoid_public_fields          # Публичные поля обходят инкапсуляцию; использовать состояние/события
+    - prefer_file_naming_conventions # Единообразие именования файлов блоков повышает навигацию
+    

app_services/base/app_services/lib/app_services.dart

@@ -1,4 +1,5 @@
 library;
 
+export 'src/app_location_service.dart';
 export 'src/app_path_provider.dart';
 export 'src/app_secure_storage.dart';

app_services/base/app_services/lib/src/app_location_service.dart

@@ -0,0 +1,50 @@
+import 'package:geolocator/geolocator.dart';
+import 'package:i_app_services/i_app_services.dart';
+
+/// {@template app_location_service}
+/// Реализация сервиса для работы с гео в базовой реализацией Android/OS.
+/// {@endtemplate}
+class AppLocationService implements ILocationService {
+  /// {@macro app_location_service}
+  const AppLocationService();
+
+  /// Наименование сервиса
+  static const name = 'BaseAppLocationService';
+
+  @override
+  Future<Position> getCurrentPosition() async {
+    bool serviceEnabled;
+    LocationPermission permission;
+
+    serviceEnabled = await Geolocator.isLocationServiceEnabled();
+    if (!serviceEnabled) {
+      // Службы геолокации не включены, не продолжаем
+      // обращаться к позиции и запрашиваем у пользователей
+      // приложения включить службы геолокации.
+      return Future.error('Location services are disabled.');
+    }
+
+    permission = await Geolocator.checkPermission();
+    if (permission == LocationPermission.denied) {
+      permission = await Geolocator.requestPermission();
+      if (permission == LocationPermission.denied) {
+        // Разрешения отклонены, в следующий раз можно попробовать
+        // запросить разрешения снова (здесь также возвращается
+        // shouldShowRequestPermissionRationale Android.
+        // Согласно рекомендациям Android ваше приложение
+        // должно показать пояснительный интерфейс сейчас.
+        return Future.error('Location permissions are denied');
+      }
+    }
+    if (permission == LocationPermission.deniedForever) {
+      // Разрешения отклонены навсегда, обрабатываем соответствующим образом.
+      return Future.error(
+        'Location permissions are permanently denied, we cannot request permissions.',
+      );
+    }
+
+    // Когда мы доходим сюда, разрешения предоставлены и мы можем
+    // продолжить обращение к позиции устройства.
+    return await Geolocator.getCurrentPosition();
+  }
+}

app_services/base/app_services/lib/src/app_secure_storage.dart

@@ -2,15 +2,19 @@ import 'package:flutter_secure_storage/flutter_secure_storage.dart';
 import 'package:i_app_services/i_app_services.dart';
 
 /// {@template app_secure_storage}
-/// Класс для Aurora реализации сервис по работе с защищенным хранилищем
-/// [secretKey] - ключ для шифрования данных, если нужен
+/// Класс для базовой реализации сервиса работы с защищенным хранилищем.
+///
+/// Использует flutter_secure_storage для безопасного хранения данных.
+/// Поддерживает все основные операции с защищенным хранилищем.
 /// {@endtemplate}
 final class AppSecureStorage implements ISecureStorage {
+  /// {@macro app_secure_storage}
   AppSecureStorage({this.secretKey});
 
   @override
   final String? secretKey;
 
+  /// Наименование сервиса
   static const name = 'BaseAppSecureStorage';
 
   /// Экземпляр хранилища данных

app_services/base/app_services/pubspec.yaml

@@ -4,7 +4,7 @@ version: 0.0.1
 publish_to: none
 
 environment:
-  sdk: ^3.8.0
+  sdk: ">=3.0.0 <4.0.0"
 
 dependencies:
   flutter:
@@ -14,11 +14,14 @@ dependencies:
   flutter_secure_storage: 9.2.4
 
   # Зависимости для сервиса незащищенного хранилища
-  shared_preferences: 2.3.5
+  shared_preferences: 2.5.3
 
   # для работы с путями в хранилища
   path_provider: 2.1.5
 
+  # Работа с геолокацией
+  geolocator: 14.0.2
+
   # Обязательные интерфейсы
   i_app_services:
     path: ../../i_app_services

app_services/hms/app_services/.gitignore

@@ -0,0 +1,29 @@
+# Miscellaneous
+*.class
+*.log
+*.pyc
+*.swp
+.DS_Store
+.atom/
+.buildlog/
+.history
+.svn/
+migrate_working_dir/
+
+# IntelliJ related
+*.iml
+*.ipr
+*.iws
+.idea/
+
+# The .vscode folder contains launch configuration and tasks you configure in
+# VS Code which you may wish to be included in version control, so this line
+# is commented out by default.
+#.vscode/
+
+# Flutter/Dart/Pub related
+# Libraries should not include pubspec.lock, per https://dart.dev/guides/libraries/private-files#pubspeclock.
+/pubspec.lock
+**/doc/api/
+.dart_tool/
+build/

app_services/hms/app_services/.metadata

@@ -0,0 +1,10 @@
+# This file tracks properties of this Flutter project.
+# Used by Flutter tool to assess capabilities and perform upgrades etc.
+#
+# This file should be version controlled and should not be manually edited.
+
+version:
+  revision: "7482962148e8d758338d8a28f589f317e1e42ba4"
+  channel: "stable"
+
+project_type: package

app_services/hms/app_services/README.md

@@ -0,0 +1 @@
+# Реализация сервисов для HarmonyOS

app_services/hms/app_services/analysis_options.yaml

@@ -0,0 +1,135 @@
+include: package:flutter_lints/flutter.yaml
+
+# Персонализированные настройки анализатора и линтера.
+# Базовый набор flutter_lints + дополнительные ужесточения.
+
+analyzer:
+  exclude:
+    - "build/**"                   # Исключаем артефакты сборки (генерируемый код, кэш, ресурсы)
+    - "android/**"                 # Платформенный код Android (Java/Kotlin, Gradle) не анализируем Dart линтером
+    - "ios/**"                     # Платформенный код iOS (Swift/ObjC) вне области Dart анализа
+    - "assets/**"                  # Статические ассеты (шрифты, изображения, json и др.)
+    - "**/*.g.dart"                # Сгенерированные файлы build_runner / json_serializable
+    - "**/*.freezed.dart"          # Сгенерированные модели пакетом freezed
+    - "**/*.gen.dart"              # Общий паттерн для доп. генераторов
+    - "**/*.gr.dart"               # Генерируемые маршруты (auto_route / другие)
+    - "**/*.config.dart"           # Сгенерированные конфигурационные файлы
+    - "**/generated/**"            # Папки с автогенерируемыми исходниками
+    - "**/*.lock"             # Временные/lock файлы генераторов (если создаются)
+    - "**/app_services/aurora/**"  # Внутренний сервисный код (предположительно внешняя интеграция) исключён
+  errors:
+    avoid_dynamic_calls: error              # Запрет неявных dynamic вызовов (типобезопасность)
+    avoid_returning_null_for_future: error  # Future не должен завершаться null без явной модели
+    avoid_slow_async_io: warning            # Подсказка о потенциально медленных IO операциях
+    avoid_type_to_string: warning           # Предупреждение против использования Type.toString для логики
+    cancel_subscriptions: error             # Требование отменять StreamSubscription для предотвращения утечек
+    close_sinks: error                      # Обязательное закрытие Sink (ресурсное управление)
+    comment_references: warning             # Проверка корректности ссылок в документационных комментариях
+    always_declare_return_types: error      # Явный тип возвращаемого значения повышает читаемость
+    avoid_bool_literals_in_conditional_expressions: warning # Избегать выражений вида condition ? true : false
+    avoid_return_types_on_setters: warning  # Сеттеры не должны объявлять тип возврата
+    avoid_returning_null: warning           # Предпочтительнее nullable типы / Option объекты вместо raw null
+    avoid_setters_without_getters: error    # Сеттер без геттера может скрывать состояние
+    avoid_void_async: error                 # async void нежелателен (трудно ловить ошибки)
+    constant_identifier_names: error        # Единый стиль именования констант (UPPER_CASE)
+    unnecessary_new: warning                # Снижение шума: new не нужен в современном Dart
+    use_decorated_box: warning              # Оптимизация: DecoratedBox вместо контейнера без лишних виджетов
+    use_colored_box: warning                # Оптимизация: ColoredBox для простого цвета фона
+
+linter:
+  rules:
+    # === Именование и стиль ===
+    - always_put_required_named_parameters_first   # Обязательные именованные параметры первыми повышают читаемость
+    - always_use_package_imports                   # Единый стиль импортов через package: упрощает refactoring
+    - curly_braces_in_flow_control_structures      # Обязательные фигурные скобки в if/for/while для безопасности
+    - directives_ordering                          # Упорядочивание импортов (dart → package → relative)
+    - eol_at_end_of_file                           # Пустая строка в конце файла (POSIX standard)
+    - prefer_single_quotes                         # Единый стиль кавычек (одинарные быстрее печатать)
+    - slash_for_doc_comments                       # Использовать /// вместо /** */ для документации
+    - sort_constructors_first                      # Конструкторы в начале класса — быстрый обзор API
+    
+    # === Обработка ошибок и типобезопасность ===
+    - avoid_catching_errors                        # Не перехватывать Error (только Exception) — ошибки системные
+    - await_only_futures                           # await только для Future (ловит ошибки типизации)
+    - control_flow_in_finally                      # Запрет return/break/continue в finally блоках
+    - empty_catches                                # Предупреждение о пустых catch (скрытые баги)
+    - hash_and_equals                              # Требует переопределять hashCode и == вместе
+    - only_throw_errors                            # Бросать Error/Exception типы, а не произвольные объекты
+    - test_types_in_equals                         # Проверка типа в equals для безопасности
+    - unrelated_type_equality_checks               # Запрет сравнения несовместимых типов
+    - use_build_context_synchronously              # КРИТИЧНО: запрет BuildContext после async gap
+    - use_rethrow_when_possible                    # Использовать rethrow вместо throw e (сохраняет stacktrace)
+    - discarded_futures                            # Выявляет неожиданные Future без await
+    - unawaited_futures                            # Явно помечать намеренно не ожидаемые Future
+    
+    # === Иммутабельность и const ===
+    - avoid_equals_and_hash_code_on_mutable_classes # hashCode/== на изменяемых классах приводит к багам в коллекциях
+    - prefer_const_constructors                    # Константные конструкторы для производительности
+    - prefer_const_constructors_in_immutables      # Обязательные const в неизменяемых классах
+    - prefer_const_literals_to_create_immutables   # Константные литералы коллекций
+    - prefer_final_fields                          # final для полей где возможно
+    - prefer_final_in_for_each                     # final в forEach предотвращает случайные изменения
+    - prefer_final_locals                          # final локальные переменные — стремимся к иммутабельности
+    - parameter_assignments                        # Не переназначать параметры — вводит путаницу
+    
+    # === Flutter оптимизации ===
+    - avoid_unnecessary_containers                 # Убирает лишние Container виджеты
+    - sized_box_for_whitespace                     # SizedBox вместо Container для отступов
+    - sized_box_shrink_expand                      # Специализированные конструкторы SizedBox.shrink/expand
+    - sort_child_properties_last                   # child/children последними в виджетах
+    - use_colored_box                              # ColoredBox для простого цвета фона
+    - use_decorated_box                            # DecoratedBox вместо контейнера без лишних виджетов
+    - use_key_in_widget_constructors               # Ключ позволяет корректно применить дифф к дереву виджетов
+    
+    # === Современный Dart (2.17+, 3.x) ===
+    - use_super_parameters                         # super параметры для краткости
+    - combinators_ordering                         # Сортировка show/hide в импортах
+    - implicit_call_tearoffs                       # Разрешить неявные tearoffs
+    - matching_super_parameters                    # Автоматическое соответствие параметрам супер-конструктора
+    - use_enums                                    # Предпочитать enums вместо статических констант
+    
+    # === Читаемость кода ===
+    - avoid_escaping_inner_quotes                  # Предпочтительно менять тип кавычек вместо экранирования
+    - avoid_field_initializers_in_const_classes    # Инициализация в константных классах тяжеловесна/избыточна
+    - avoid_implementing_value_types               # Не реализовывать value-type интерфейсы вручную (риск несовпадений)
+    - avoid_positional_boolean_parameters          # Булевые позиционные параметры плохо читаются (использовать именованные)
+    - avoid_private_typedef_functions              # Приватные typedef затрудняют повторное использование / читаемость
+    - avoid_redundant_argument_values              # Удалять аргументы совпадающие с значениями по умолчанию
+    - avoid_returning_this                         # Возврат this усложняет fluent API и может скрывать ошибки
+    - cascade_invocations                          # Использовать каскады для последовательности операций над объектом
+    - deprecated_consistency                       # Единый стиль пометок @deprecated
+    - leading_newlines_in_multiline_strings        # Многострочные строки начинают с новой строки — чище diff
+    - no_literal_bool_comparisons                  # Исключить сравнения вида flag == true
+    - no_runtimeType_toString                      # runtimeType.toString нестабилен для логики (только отладка)
+    - prefer_asserts_with_message                  # Сообщение в assert облегчает диагностику
+    - prefer_constructors_over_static_methods      # Конструкторы лучше выражают создание экземпляра
+    - comment_references                           # Корректные ссылки в комментариях (небитые, видимые)
+    
+    # === Сахар и идиомы ===
+    - avoid_init_to_null                           # Не писать = null явно (по умолчанию)
+    - prefer_if_null_operators                     # ?? оператор вместо тернарника с null
+    - prefer_interpolation_to_compose_strings      # Интерполяция вместо конкатенации
+    - prefer_is_empty                              # .isEmpty вместо .length == 0
+    - prefer_is_not_empty                          # .isNotEmpty вместо .length > 0
+    - use_is_even_rather_than_modulo               # isEven более явно и может быть эффективнее
+    - use_setters_to_change_properties             # Изменение полей через сеттеры (инкапсуляция)
+    - use_string_buffers                           # StringBuffer эффективнее при конкатенации в циклах
+    - use_to_and_as_if_applicable                  # Использовать to*/as* если семантика преобразования доступна
+    
+    # === Удаление избыточности ===
+    - avoid_return_types_on_setters                # Сеттеры не должны объявлять тип возврата
+    - unnecessary_const                            # Убирает лишние const
+    - unnecessary_new                              # Убирает лишние new
+    - unnecessary_this                             # Убирает лишние this
+    - unnecessary_parenthesis                      # Лишние скобки
+    
+    # === Продакшн / отладка ===
+    - avoid_print                                  # Запрет print в продакшене (использовать logger)
+
+bloc:
+  rules:
+    - avoid_flutter_imports        # Логика блока должна быть платформенно независимой
+    - avoid_public_bloc_methods    # Публичные методы могут нарушать чистоту паттерна (использовать события)
+    - avoid_public_fields          # Публичные поля обходят инкапсуляцию; использовать состояние/события
+    - prefer_file_naming_conventions # Единообразие именования файлов блоков повышает навигацию
+    

app_services/hms/app_services/lib/app_services.dart

@@ -0,0 +1,5 @@
+library;
+
+export 'src/app_location_service.dart';
+export 'src/app_path_provider.dart';
+export 'src/app_secure_storage.dart';

app_services/hms/app_services/lib/src/app_location_service.dart

@@ -0,0 +1,18 @@
+import 'package:i_app_services/i_app_services.dart';
+
+/// {@template app_location_service}
+/// Реализация сервиса для работы с гео на HarmonyOS.
+/// {@endtemplate}
+class AppLocationService implements ILocationService {
+  /// {@macro app_location_service}
+  const AppLocationService();
+
+  /// Наименование сервиса
+  static const name = 'HarmonyAppLocationService';
+
+  @override
+  Future<Object?> getCurrentPosition() {
+    // TODO: Реализовать получение текущей позиции в HarmonyOS
+    throw UnimplementedError();
+  }
+}

app_services/hms/app_services/lib/src/app_path_provider.dart

@@ -0,0 +1,18 @@
+import 'package:i_app_services/i_app_services.dart';
+
+/// {@template app_path_provider}
+/// Класс для HarmonyOS реализации сервиса работы с путями
+/// {@endtemplate}
+class AppPathProvider implements IPathProvider {
+  /// {@macro app_path_provider}
+  const AppPathProvider();
+
+  /// Наименование сервиса
+  static const name = 'HarmonyAppPathProvider';
+
+  @override
+  Future<String> getAppDocumentsDirectoryPath() async {
+    // TODO: Реализовать для HarmonyOS
+    throw UnimplementedError();
+  }
+}

app_services/hms/app_services/lib/src/app_secure_storage.dart

@@ -0,0 +1,50 @@
+import 'package:i_app_services/i_app_services.dart';
+
+/// {@template app_secure_storage}
+/// Класс для HarmonyOS реализации сервиса по работе с защищенным хранилищем
+/// {@endtemplate}
+final class AppSecureStorage implements ISecureStorage {
+  /// Создает сервис для работы с защищенным хранилищем
+  ///
+  /// Принимает:
+  /// - [secretKey] - ключ шифрования данных, если требуется
+  AppSecureStorage({required this.secretKey});
+
+  @override
+  final String secretKey;
+
+  static const name = 'HarmonyAppSecureStorage';
+
+  @override
+  Future<void> delete(String key) async {
+    // TODO: Реализовать удаление ключа из HarmonyOS Secure Storage
+    throw UnimplementedError();
+  }
+
+  @override
+  Future<String?> read(String key) async {
+    // TODO: Реализовать чтение значения по ключу из HarmonyOS Secure Storage
+    throw UnimplementedError();
+  }
+
+  @override
+  Future<void> write(String key, String value) async {
+    // TODO: Реализовать запись значения по ключу в HarmonyOS Secure Storage
+    throw UnimplementedError();
+  }
+
+  @override
+  String get nameImpl => AppSecureStorage.name;
+
+  @override
+  Future<bool> containsKey(String key) {
+    // TODO: Реализовать проверку наличия ключа в HarmonyOS Secure Storage
+    throw UnimplementedError();
+  }
+
+  @override
+  Future<void> deleteAll() {
+    // TODO: Реализовать удаление всех ключей из HarmonyOS Secure Storage
+    throw UnimplementedError();
+  }
+}

app_services/hms/app_services/pubspec.yaml

@@ -0,0 +1,18 @@
+name: app_services
+description: "Huawei сервисы для приложения"
+version: 0.0.1
+publish_to: none
+
+environment:
+  sdk: ">=3.0.0 <4.0.0"
+
+dependencies:
+  flutter:
+    sdk: flutter
+
+  # Обязательные интерфейсы
+  i_app_services:
+    path: ../../i_app_services
+
+dev_dependencies:
+  flutter_lints: 6.0.0

app_services/i_app_services/analysis_options.yaml

@@ -1,89 +1,135 @@
 include: package:flutter_lints/flutter.yaml
 
-# Включает правила из:
-# - package:lints/core.yaml: основные правила критических проблем
-# - package:lints/recommended.yaml: рекомендуемые правила для чистого кода
-# - package:flutter_lints/flutter.yaml: специфичные правила для Flutter
+# Персонализированные настройки анализатора и линтера.
+# Базовый набор flutter_lints + дополнительные ужесточения.
 
 analyzer:
   exclude:
-    - "android/**"
-    - "assets/**"
-    - "build/**"
-    - "config/**"
-    - "core/**"
-    - "res/**"
-    - "ios/**"
-    - "**/*.g.dart"
-    - "**/*.config.dart"
-    - "**/*.gen.dart"
-    - "**/*.freezed.dart"
-    - "**/generated/*"
-    - "**/*.gr.dart"
-    - "**/*.yaml"
-    - "app_services/aurora/**"
-    - "/app_services/aurora/**"
-    - "**/app_services/aurora/**"
-    - "**/*.lock.dart"
-errors:
-  # Переопределения уровней ошибок (error/warning/info)
-  avoid_dynamic_calls: error # Запрещает использование dynamic для вызовов методов
-  avoid_returning_null_for_future: error # Запрещает возврат null вместо Future
-  avoid_slow_async_io: warning # Предупреждает о медленных асинхронных операциях ввода/вывода
-  avoid_type_to_string: warning # Предупреждает о неправильном использовании toString() для типов
-  cancel_subscriptions: error # Требует отмены подписок, предотвращает утечки памяти
-  close_sinks: error # Требует закрытия sink-ов, предотвращает утечки ресурсов
-  comment_references: warning # Проверяет корректность ссылок в комментариях
-  always_declare_return_types: error # Требует явного указания возвращаемых типов методов
-  always_require_non_null_named_parameters: warning # Требует использования @required для ненулевых параметров
-  avoid_bool_literals_in_conditional_expressions: warning # Запрещает избыточные булевы литералы в условных выражениях
-  avoid_return_types_on_setters: warning # Запрещает возвращаемые типы для сеттеров
-  avoid_returning_null: error # Запрещает возврат null
-  avoid_setters_without_getters: error # Требует создания геттера при наличии сеттера
-  avoid_void_async: error # Запрещает использование void для асинхронных функций
-  constant_identifier_names: error # Проверяет правильность именования констант
-  unnecessary_new: warning # Запрещает избыточное использование ключевого слова new
-  use_decorated_box: warning # Рекомендует использовать DecoratedBox вместо Container
-  use_colored_box: warning # Рекомендует использовать ColoredBox вместо Container с цветом
+    - "build/**"                   # Исключаем артефакты сборки (генерируемый код, кэш, ресурсы)
+    - "android/**"                 # Платформенный код Android (Java/Kotlin, Gradle) не анализируем Dart линтером
+    - "ios/**"                     # Платформенный код iOS (Swift/ObjC) вне области Dart анализа
+    - "assets/**"                  # Статические ассеты (шрифты, изображения, json и др.)
+    - "**/*.g.dart"                # Сгенерированные файлы build_runner / json_serializable
+    - "**/*.freezed.dart"          # Сгенерированные модели пакетом freezed
+    - "**/*.gen.dart"              # Общий паттерн для доп. генераторов
+    - "**/*.gr.dart"               # Генерируемые маршруты (auto_route / другие)
+    - "**/*.config.dart"           # Сгенерированные конфигурационные файлы
+    - "**/generated/**"            # Папки с автогенерируемыми исходниками
+    - "**/*.lock"             # Временные/lock файлы генераторов (если создаются)
+    - "**/app_services/aurora/**"  # Внутренний сервисный код (предположительно внешняя интеграция) исключён
+  errors:
+    avoid_dynamic_calls: error              # Запрет неявных dynamic вызовов (типобезопасность)
+    avoid_returning_null_for_future: error  # Future не должен завершаться null без явной модели
+    avoid_slow_async_io: warning            # Подсказка о потенциально медленных IO операциях
+    avoid_type_to_string: warning           # Предупреждение против использования Type.toString для логики
+    cancel_subscriptions: error             # Требование отменять StreamSubscription для предотвращения утечек
+    close_sinks: error                      # Обязательное закрытие Sink (ресурсное управление)
+    comment_references: warning             # Проверка корректности ссылок в документационных комментариях
+    always_declare_return_types: error      # Явный тип возвращаемого значения повышает читаемость
+    avoid_bool_literals_in_conditional_expressions: warning # Избегать выражений вида condition ? true : false
+    avoid_return_types_on_setters: warning  # Сеттеры не должны объявлять тип возврата
+    avoid_returning_null: warning           # Предпочтительнее nullable типы / Option объекты вместо raw null
+    avoid_setters_without_getters: error    # Сеттер без геттера может скрывать состояние
+    avoid_void_async: error                 # async void нежелателен (трудно ловить ошибки)
+    constant_identifier_names: error        # Единый стиль именования констант (UPPER_CASE)
+    unnecessary_new: warning                # Снижение шума: new не нужен в современном Dart
+    use_decorated_box: warning              # Оптимизация: DecoratedBox вместо контейнера без лишних виджетов
+    use_colored_box: warning                # Оптимизация: ColoredBox для простого цвета фона
 
 linter:
   rules:
-    # Нестандартные правила или правила с измененными значениями
-    always_put_required_named_parameters_first: true # Требовать размещать обязательные именованные параметры первыми
-    avoid_catches_without_on_clauses: true # Избегать catch без указания типа исключения
-    avoid_catching_errors: true # Избегать перехвата ошибок типа Error
-    avoid_equals_and_hash_code_on_mutable_classes: true # Избегать equals и hashCode в изменяемых классах
-    avoid_escaping_inner_quotes: true # Избегать экранирования внутренних кавычек
-    avoid_field_initializers_in_const_classes: true # Избегать инициализаторов полей в константных классах
-    avoid_implementing_value_types: true # Избегать реализации интерфейсов значимых типов
-    avoid_multiple_declarations_per_line: false # Разрешать несколько объявлений в одной строке
-    avoid_positional_boolean_parameters: true # Избегать позиционных булевых параметров
-    avoid_private_typedef_functions: true # Избегать приватных typedef-функций
-    avoid_redundant_argument_values: true # Избегать избыточных значений аргументов
-    avoid_returning_this: true # Избегать возврата this
-    cascade_invocations: true # Использовать каскадные вызовы
-    deprecated_consistency: true # Поддерживать согласованность устаревших элементов
-    do_not_use_environment: false # Разрешить использование Environment
-    leading_newlines_in_multiline_strings: true # Начинать многострочные строки с новой строки
-    no_runtimeType_toString: true # Не использовать runtimeType.toString()
-    one_member_abstracts: false # Разрешать абстрактные классы с одним методом
-    only_throw_errors: true # Выбрасывать только объекты Error
-    parameter_assignments: true # Запрещать присваивание значений параметрам
-    prefer_asserts_with_message: true # Использовать сообщения с assert
-    prefer_constructors_over_static_methods: true # Предпочитать конструкторы статическим методам
-    prefer_final_in_for_each: true # Использовать final в for-each циклах
-    prefer_final_locals: true # Использовать final для локальных переменных
-    public_member_api_docs: false # Не требовать документацию для всех публичных членов
-    require_trailing_commas: true # Требовать запятые в конце для улучшения форматирования
-    sort_constructors_first: true # Требовать размещать конструкторы первыми
-    sort_pub_dependencies: false # Не требовать сортировки зависимостей в pubspec
-    sort_unnamed_constructors_first: false # Не требовать размещать безымянные конструкторы первыми
-    use_is_even_rather_than_modulo: true # Использовать isEven вместо % 2 == 0
-    use_late_for_private_fields_and_variables: false # Не требовать late для приватных полей
-    use_setters_to_change_properties: true # Использовать сеттеры для изменения свойств
-    use_string_buffers: true # Использовать StringBuffer для сложной конкатенации
-    use_to_and_as_if_applicable: true # Использовать методы to и as при применимости
-    no_literal_bool_comparisons: true # Запрещать сравнения с литералами true/false
-    use_key_in_widget_constructors: true # Обязательное указание ключа для stateful/stateless widgets
-    always_use_package_imports: true # Всегда использовать package: импорты
+    # === Именование и стиль ===
+    - always_put_required_named_parameters_first   # Обязательные именованные параметры первыми повышают читаемость
+    - always_use_package_imports                   # Единый стиль импортов через package: упрощает refactoring
+    - curly_braces_in_flow_control_structures      # Обязательные фигурные скобки в if/for/while для безопасности
+    - directives_ordering                          # Упорядочивание импортов (dart → package → relative)
+    - eol_at_end_of_file                           # Пустая строка в конце файла (POSIX standard)
+    - prefer_single_quotes                         # Единый стиль кавычек (одинарные быстрее печатать)
+    - slash_for_doc_comments                       # Использовать /// вместо /** */ для документации
+    - sort_constructors_first                      # Конструкторы в начале класса — быстрый обзор API
+    
+    # === Обработка ошибок и типобезопасность ===
+    - avoid_catching_errors                        # Не перехватывать Error (только Exception) — ошибки системные
+    - await_only_futures                           # await только для Future (ловит ошибки типизации)
+    - control_flow_in_finally                      # Запрет return/break/continue в finally блоках
+    - empty_catches                                # Предупреждение о пустых catch (скрытые баги)
+    - hash_and_equals                              # Требует переопределять hashCode и == вместе
+    - only_throw_errors                            # Бросать Error/Exception типы, а не произвольные объекты
+    - test_types_in_equals                         # Проверка типа в equals для безопасности
+    - unrelated_type_equality_checks               # Запрет сравнения несовместимых типов
+    - use_build_context_synchronously              # КРИТИЧНО: запрет BuildContext после async gap
+    - use_rethrow_when_possible                    # Использовать rethrow вместо throw e (сохраняет stacktrace)
+    - discarded_futures                            # Выявляет неожиданные Future без await
+    - unawaited_futures                            # Явно помечать намеренно не ожидаемые Future
+    
+    # === Иммутабельность и const ===
+    - avoid_equals_and_hash_code_on_mutable_classes # hashCode/== на изменяемых классах приводит к багам в коллекциях
+    - prefer_const_constructors                    # Константные конструкторы для производительности
+    - prefer_const_constructors_in_immutables      # Обязательные const в неизменяемых классах
+    - prefer_const_literals_to_create_immutables   # Константные литералы коллекций
+    - prefer_final_fields                          # final для полей где возможно
+    - prefer_final_in_for_each                     # final в forEach предотвращает случайные изменения
+    - prefer_final_locals                          # final локальные переменные — стремимся к иммутабельности
+    - parameter_assignments                        # Не переназначать параметры — вводит путаницу
+    
+    # === Flutter оптимизации ===
+    - avoid_unnecessary_containers                 # Убирает лишние Container виджеты
+    - sized_box_for_whitespace                     # SizedBox вместо Container для отступов
+    - sized_box_shrink_expand                      # Специализированные конструкторы SizedBox.shrink/expand
+    - sort_child_properties_last                   # child/children последними в виджетах
+    - use_colored_box                              # ColoredBox для простого цвета фона
+    - use_decorated_box                            # DecoratedBox вместо контейнера без лишних виджетов
+    - use_key_in_widget_constructors               # Ключ позволяет корректно применить дифф к дереву виджетов
+    
+    # === Современный Dart (2.17+, 3.x) ===
+    - use_super_parameters                         # super параметры для краткости
+    - combinators_ordering                         # Сортировка show/hide в импортах
+    - implicit_call_tearoffs                       # Разрешить неявные tearoffs
+    - matching_super_parameters                    # Автоматическое соответствие параметрам супер-конструктора
+    - use_enums                                    # Предпочитать enums вместо статических констант
+    
+    # === Читаемость кода ===
+    - avoid_escaping_inner_quotes                  # Предпочтительно менять тип кавычек вместо экранирования
+    - avoid_field_initializers_in_const_classes    # Инициализация в константных классах тяжеловесна/избыточна
+    - avoid_implementing_value_types               # Не реализовывать value-type интерфейсы вручную (риск несовпадений)
+    - avoid_positional_boolean_parameters          # Булевые позиционные параметры плохо читаются (использовать именованные)
+    - avoid_private_typedef_functions              # Приватные typedef затрудняют повторное использование / читаемость
+    - avoid_redundant_argument_values              # Удалять аргументы совпадающие с значениями по умолчанию
+    - avoid_returning_this                         # Возврат this усложняет fluent API и может скрывать ошибки
+    - cascade_invocations                          # Использовать каскады для последовательности операций над объектом
+    - deprecated_consistency                       # Единый стиль пометок @deprecated
+    - leading_newlines_in_multiline_strings        # Многострочные строки начинают с новой строки — чище diff
+    - no_literal_bool_comparisons                  # Исключить сравнения вида flag == true
+    - no_runtimeType_toString                      # runtimeType.toString нестабилен для логики (только отладка)
+    - prefer_asserts_with_message                  # Сообщение в assert облегчает диагностику
+    - prefer_constructors_over_static_methods      # Конструкторы лучше выражают создание экземпляра
+    - comment_references                           # Корректные ссылки в комментариях (небитые, видимые)
+    
+    # === Сахар и идиомы ===
+    - avoid_init_to_null                           # Не писать = null явно (по умолчанию)
+    - prefer_if_null_operators                     # ?? оператор вместо тернарника с null
+    - prefer_interpolation_to_compose_strings      # Интерполяция вместо конкатенации
+    - prefer_is_empty                              # .isEmpty вместо .length == 0
+    - prefer_is_not_empty                          # .isNotEmpty вместо .length > 0
+    - use_is_even_rather_than_modulo               # isEven более явно и может быть эффективнее
+    - use_setters_to_change_properties             # Изменение полей через сеттеры (инкапсуляция)
+    - use_string_buffers                           # StringBuffer эффективнее при конкатенации в циклах
+    - use_to_and_as_if_applicable                  # Использовать to*/as* если семантика преобразования доступна
+    
+    # === Удаление избыточности ===
+    - avoid_return_types_on_setters                # Сеттеры не должны объявлять тип возврата
+    - unnecessary_const                            # Убирает лишние const
+    - unnecessary_new                              # Убирает лишние new
+    - unnecessary_this                             # Убирает лишние this
+    - unnecessary_parenthesis                      # Лишние скобки
+    
+    # === Продакшн / отладка ===
+    - avoid_print                                  # Запрет print в продакшене (использовать logger)
 
+bloc:
+  rules:
+    - avoid_flutter_imports        # Логика блока должна быть платформенно независимой
+    - avoid_public_bloc_methods    # Публичные методы могут нарушать чистоту паттерна (использовать события)
+    - avoid_public_fields          # Публичные поля обходят инкапсуляцию; использовать состояние/события
+    - prefer_file_naming_conventions # Единообразие именования файлов блоков повышает навигацию
+    

app_services/i_app_services/lib/i_app_services.dart

@@ -1,4 +1,5 @@
 library;
 
+export 'src/i_location_service.dart';
 export 'src/i_path_provider.dart';
 export 'src/i_secure_storage.dart';

app_services/i_app_services/lib/src/i_location_service.dart

@@ -0,0 +1,9 @@
+/// {@template i_location_service}
+/// Интерфейс для работы с геопозицией пользователя
+/// {@endtemplate}
+abstract interface class ILocationService {
+  static const name = 'ILocationService';
+
+  /// Метод для получения координат пользователя
+  Future<dynamic> getCurrentPosition();
+}

app_services/i_app_services/lib/src/i_path_provider.dart

@@ -4,6 +4,6 @@ abstract interface class IPathProvider {
   /// Наименования интерфейса
   static const name = 'IPathProvider';
 
-  /// Получение path на внутренне хранилище приложения
+  /// Получение path на внутреннее хранилище приложения
   Future<String?> getAppDocumentsDirectoryPath();
 }

app_services/i_app_services/pubspec.yaml

@@ -1,10 +1,10 @@
 name: i_app_services
-description: "Хранит в себе все интерфейсы для реализации общих сервисов"
+description: "Хранит в себе все интерфейсы для реализации сервисов"
 version: 0.0.1
 publish_to: "none"
 
 environment:
-  sdk: ^3.8.0
+  sdk: ">=3.0.0 <4.0.0"
 
 dependencies:
   flutter:

l10n.yaml

@@ -1,5 +1,4 @@
 arb-dir: lib/l10n
 template-arb-file: app_en.arb
 output-dir: lib/l10n/gen
-output-localization-file: app_localizations.dart
-synthetic-package: false
+output-localization-file: app_localizations.dart

lib/app/app.dart

@@ -1,110 +0,0 @@
-import 'package:flutter/material.dart';
-import 'package:friflex_starter/app/app_context_ext.dart';
-import 'package:friflex_starter/app/app_providers.dart';
-import 'package:friflex_starter/app/depends_providers.dart';
-import 'package:friflex_starter/app/theme/app_theme.dart';
-import 'package:friflex_starter/app/theme/theme_notifier.dart';
-import 'package:friflex_starter/di/di_container.dart';
-
-import 'package:friflex_starter/features/error/error_screen.dart';
-import 'package:friflex_starter/features/splash/splash_screen.dart';
-import 'package:friflex_starter/l10n/gen/app_localizations.dart';
-import 'package:friflex_starter/l10n/localization_notifier.dart';
-import 'package:go_router/go_router.dart';
-
-/// Класс приложения
-class App extends StatefulWidget {
-  const App({required this.router, required this.initDependencies, super.key});
-
-  /// Роутер приложения
-  final GoRouter router;
-
-  /// Функция для инициализации зависимостей
-  final Future<DiContainer> Function() initDependencies;
-
-  @override
-  State<App> createState() => _AppState();
-}
-
-class _AppState extends State<App> {
-  /// Мутабельная Future для инициализации зависимостей
-  late Future<DiContainer> _initFuture;
-
-  @override
-  void initState() {
-    super.initState();
-    _initFuture = widget.initDependencies();
-  }
-
-  @override
-  Widget build(BuildContext context) {
-    return AppProviders(
-      // Consumer для локализации добавляем выше чем DependsProviders
-      // чтобы при изменении локализации перестраивался весь виджет
-      // Но, это не обязательно, можно добавить в DependsProviders
-      child: LocalizationConsumer(
-        builder: () => FutureBuilder<DiContainer>(
-          future: _initFuture,
-          builder: (_, snapshot) {
-            switch (snapshot.connectionState) {
-              case ConnectionState.none:
-              case ConnectionState.waiting:
-              case ConnectionState.active:
-                // Пока инициализация показываем Splash
-                return const SplashScreen();
-              case ConnectionState.done:
-                if (snapshot.hasError) {
-                  return ErrorScreen(
-                    error: snapshot.error,
-                    stackTrace: snapshot.stackTrace,
-                    onRetry: _retryInit,
-                  );
-                }
-
-                final diContainer = snapshot.data;
-                if (diContainer == null) {
-                  return ErrorScreen(
-                    error:
-                        'Ошибка инициализации зависимостей, diContainer = null',
-                    stackTrace: null,
-                    onRetry: _retryInit,
-                  );
-                }
-                return DependsProviders(
-                  diContainer: diContainer,
-                  child: ThemeConsumer(
-                    builder: () => _App(router: widget.router),
-                  ),
-                );
-            }
-          },
-        ),
-      ),
-    );
-  }
-
-  void _retryInit() {
-    setState(() {
-      _initFuture = widget.initDependencies();
-    });
-  }
-}
-
-class _App extends StatelessWidget {
-  const _App({required this.router});
-
-  final GoRouter router;
-
-  @override
-  Widget build(BuildContext context) {
-    return MaterialApp.router(
-      routerConfig: router,
-      darkTheme: AppTheme.dark,
-      theme: AppTheme.light,
-      themeMode: context.theme.themeMode,
-      locale: context.localization.locale,
-      localizationsDelegates: AppLocalizations.localizationsDelegates,
-      supportedLocales: AppLocalizations.supportedLocales,
-    );
-  }
-}

lib/app/app_config/app_config.dart

@@ -1,14 +1,47 @@
 import 'package:envied/envied.dart';
-import 'package:friflex_starter/app/app_config/i_app_config.dart';
 import 'package:friflex_starter/app/app_env.dart';
 
 part 'app_config.g.dart';
 
-/// Класс для реализации конфигурации с моковыми данными
+/// {@template i_app_config}
+/// Интерфейс для конфигурации приложения.
+///
+/// Определяет обязательные параметры для всех реализаций конфигурации:
+/// - Наименование конфигурации
+/// - Базовый URL для API
+/// - Тип окружения (dev, prod, stage)
+/// - Секретный ключ для шифрования данных
+/// {@endtemplate}
+abstract interface class IAppConfig {
+  /// {@macro i_app_config}
+  IAppConfig();
+
+  /// Наименование сервиса конфигурации
+  String get name => 'IAppConfig';
+
+  /// Основной адрес для запросов к API
+  String get baseUrl;
+
+  /// Тип окружения (dev, prod, stage)
+  AppEnv get env;
+
+  /// Секретный ключ для шифрования данных
+  String get secretKey;
+}
+
+/// {@template app_config_dev}
+/// Класс для реализации конфигурации приложения в режиме разработки.
+///
+/// Использует переменные окружения из файла env/dev.env.
+/// Предназначен для локальной разработки и тестирования.
+/// {@endtemplate}
 @Envied(name: 'Dev', path: 'env/dev.env')
 class AppConfigDev implements IAppConfig {
+  /// {@macro app_config_dev}
+  AppConfigDev();
+
   @override
-  AppEnv get env => AppEnv.dev;
+  AppEnv get env => .dev;
 
   @override
   String get name => 'AppConfigDev';
@@ -22,11 +55,19 @@ class AppConfigDev implements IAppConfig {
   final String secretKey = _Dev.secretKey;
 }
 
-/// Класс для реализации конфигурации с продакшн данными
+/// {@template app_config_prod}
+/// Класс для реализации конфигурации приложения в продакшн режиме.
+///
+/// Использует переменные окружения из файла env/prod.env.
+/// Предназначен для финальной сборки приложения.
+/// {@endtemplate}
 @Envied(name: 'Prod', path: 'env/prod.env')
 class AppConfigProd implements IAppConfig {
+  /// {@macro app_config_prod}
+  AppConfigProd();
+
   @override
-  AppEnv get env => AppEnv.prod;
+  AppEnv get env => .prod;
 
   @override
   String get name => 'AppConfigProd';
@@ -40,11 +81,19 @@ class AppConfigProd implements IAppConfig {
   final String secretKey = _Prod.secretKey;
 }
 
-/// Класс для реализации конфигурации с стейдж данными
+/// {@template app_config_stage}
+/// Класс для реализации конфигурации приложения в стейдж режиме.
+///
+/// Использует переменные окружения из файла env/stage.env.
+/// Предназначен для тестирования в среде, близкой к продакшн.
+/// {@endtemplate}
 @Envied(name: 'Stage', path: 'env/stage.env')
 class AppConfigStage implements IAppConfig {
+  /// {@macro app_config_stage}
+  AppConfigStage();
+
   @override
-  AppEnv get env => AppEnv.stage;
+  AppEnv get env => .stage;
 
   @override
   String get name => 'AppConfigStage';

lib/app/app_config/app_config.g.dart

@@ -13,22 +13,24 @@ final class _Dev {
   static const String baseUrl = 'https://dev';
 
   static const List<int> _enviedkeysecretKey = <int>[
-    1144186709,
-    921404830,
-    4081271781,
+    1250675737,
+    1700106436,
+    3701613773,
   ];
 
   static const List<int> _envieddatasecretKey = <int>[
-    1144186673,
-    921404923,
-    4081271699,
+    1250675837,
+    1700106401,
+    3701613755,
   ];
 
-  static final String secretKey = String.fromCharCodes(List<int>.generate(
-    _envieddatasecretKey.length,
-    (int i) => i,
-    growable: false,
-  ).map((int i) => _envieddatasecretKey[i] ^ _enviedkeysecretKey[i]));
+  static final String secretKey = String.fromCharCodes(
+    List<int>.generate(
+      _envieddatasecretKey.length,
+      (int i) => i,
+      growable: false,
+    ).map((int i) => _envieddatasecretKey[i] ^ _enviedkeysecretKey[i]),
+  );
 }
 
 // coverage:ignore-file
@@ -36,60 +38,64 @@ final class _Dev {
 // generated_from: env/prod.env
 final class _Prod {
   static const List<int> _enviedkeybaseUrl = <int>[
-    3830062036,
-    1024953349,
-    2723997296,
-    2959773775,
-    4255295633,
-    114701674,
-    1920572043,
-    3423730200,
-    3647804248,
-    2815792265,
-    3038381766,
-    655048609,
+    2313418965,
+    1278864221,
+    2117667009,
+    1514310825,
+    996679495,
+    1388625655,
+    2368060187,
+    1047428716,
+    502950869,
+    2499923893,
+    963407594,
+    1679400929,
   ];
 
   static const List<int> _envieddatabaseUrl = <int>[
-    3830062012,
-    1024953457,
-    2723997188,
-    2959773759,
-    4255295714,
-    114701648,
-    1920572068,
-    3423730231,
-    3647804200,
-    2815792379,
-    3038381737,
-    655048645,
+    2313418941,
+    1278864169,
+    2117666997,
+    1514310873,
+    996679476,
+    1388625613,
+    2368060212,
+    1047428675,
+    502950821,
+    2499923911,
+    963407493,
+    1679400837,
   ];
 
-  static final String baseUrl = String.fromCharCodes(List<int>.generate(
-    _envieddatabaseUrl.length,
-    (int i) => i,
-    growable: false,
-  ).map((int i) => _envieddatabaseUrl[i] ^ _enviedkeybaseUrl[i]));
+  static final String baseUrl = String.fromCharCodes(
+    List<int>.generate(
+      _envieddatabaseUrl.length,
+      (int i) => i,
+      growable: false,
+    ).map((int i) => _envieddatabaseUrl[i] ^ _enviedkeybaseUrl[i]),
+  );
 
   static const List<int> _enviedkeysecretKey = <int>[
-    359753139,
-    3208048313,
-    1722903860,
-    3044498179,
+    1650398676,
+    1481444979,
+    21401329,
+    1103991377,
   ];
 
   static const List<int> _envieddatasecretKey = <int>[
-    359753155,
-    3208048331,
-    1722903899,
-    3044498279,
+    1650398628,
+    1481444865,
+    21401246,
+    1103991349,
   ];
 
-  static final String secretKey = String.fromCharCodes(List<int>.generate(
-    _envieddatasecretKey.length,
-    (int i) => i,
-    growable: false,
-  ).map((int i) => _envieddatasecretKey[i] ^ _enviedkeysecretKey[i]));
+  static final String secretKey = String.fromCharCodes(
+    List<int>.generate(
+      _envieddatasecretKey.length,
+      (int i) => i,
+      growable: false,
+    ).map((int i) => _envieddatasecretKey[i] ^ _enviedkeysecretKey[i]),
+  );
 }
 
 // coverage:ignore-file
@@ -97,62 +103,66 @@ final class _Prod {
 // generated_from: env/stage.env
 final class _Stage {
   static const List<int> _enviedkeybaseUrl = <int>[
-    2791397647,
-    1739207173,
-    306419752,
-    1371918084,
-    4062400488,
-    3004897854,
-    2820011348,
-    1751321626,
-    3103957517,
-    2168627914,
-    1003673382,
-    1168070657,
-    568662299,
+    1623636460,
+    1720327728,
+    1318998227,
+    1880230818,
+    1752001284,
+    726589281,
+    1688681936,
+    2751223200,
+    1403987498,
+    1289212622,
+    1492662645,
+    2947900480,
+    809806156,
   ];
 
   static const List<int> _envieddatabaseUrl = <int>[
-    2791397735,
-    1739207281,
-    306419804,
-    1371918196,
-    4062400411,
-    3004897796,
-    2820011387,
-    1751321653,
-    3103957630,
-    2168627902,
-    1003673415,
-    1168070758,
-    568662398,
+    1623636356,
+    1720327748,
+    1318998183,
+    1880230866,
+    1752001399,
+    726589275,
+    1688681983,
+    2751223183,
+    1403987545,
+    1289212602,
+    1492662548,
+    2947900455,
+    809806121,
   ];
 
-  static final String baseUrl = String.fromCharCodes(List<int>.generate(
-    _envieddatabaseUrl.length,
-    (int i) => i,
-    growable: false,
-  ).map((int i) => _envieddatabaseUrl[i] ^ _enviedkeybaseUrl[i]));
+  static final String baseUrl = String.fromCharCodes(
+    List<int>.generate(
+      _envieddatabaseUrl.length,
+      (int i) => i,
+      growable: false,
+    ).map((int i) => _envieddatabaseUrl[i] ^ _enviedkeybaseUrl[i]),
+  );
 
   static const List<int> _enviedkeysecretKey = <int>[
-    2132342089,
-    2579069434,
-    3904165526,
-    3391356107,
-    1192880530,
+    5890476,
+    3047051242,
+    2874959210,
+    758075519,
+    3738110555,
   ];
 
   static const List<int> _envieddatasecretKey = <int>[
-    2132342074,
-    2579069326,
-    3904165623,
-    3391356076,
-    1192880631,
+    5890527,
+    3047051166,
+    2874959115,
+    758075416,
+    3738110526,
   ];
 
-  static final String secretKey = String.fromCharCodes(List<int>.generate(
-    _envieddatasecretKey.length,
-    (int i) => i,
-    growable: false,
-  ).map((int i) => _envieddatasecretKey[i] ^ _enviedkeysecretKey[i]));
+  static final String secretKey = String.fromCharCodes(
+    List<int>.generate(
+      _envieddatasecretKey.length,
+      (int i) => i,
+      growable: false,
+    ).map((int i) => _envieddatasecretKey[i] ^ _enviedkeysecretKey[i]),
+  );
 }

lib/app/app_config/i_app_config.dart

@@ -1,16 +0,0 @@
-import 'package:friflex_starter/app/app_env.dart';
-
-/// Класс для описания интерфейса конфигурации
-abstract interface class IAppConfig {
-  /// Наименование сервиса
-  String get name => 'IAppConfig';
-
-  /// Основной адрес для запросов к API
-  String get baseUrl;
-
-  /// Тип окружения
-  AppEnv get env;
-
-  /// Секретный ключ для шифрования данных
-  String get secretKey;
-}

lib/app/app_context_ext.dart

@@ -1,5 +1,4 @@
 import 'package:flutter/material.dart';
-import 'package:friflex_starter/app/theme/app_colors_scheme.dart';
 import 'package:friflex_starter/app/theme/theme_notifier.dart';
 import 'package:friflex_starter/di/di_container.dart';
 import 'package:friflex_starter/l10n/gen/app_localizations.dart';
@@ -11,9 +10,6 @@ extension AppContextExt on BuildContext {
   /// Метод для получения экземпляра DIContainer
   DiContainer get di => read<DiContainer>();
 
-  /// Геттер для получения цветовой схемы
-  AppColors get colors => Theme.of(this).extension<AppColors>()!;
-
   /// Геттер для получения темы
   ThemeNotifier get theme => read<ThemeNotifier>();
 

lib/app/app_providers.dart

@@ -1,14 +1,28 @@
 import 'package:flutter/material.dart';
+import 'package:flutter_bloc/flutter_bloc.dart';
 import 'package:friflex_starter/app/theme/theme_notifier.dart';
+import 'package:friflex_starter/di/di_container.dart';
+import 'package:friflex_starter/features/update/domain/state/cubit/update_cubit.dart';
 import 'package:friflex_starter/l10n/localization_notifier.dart';
 import 'package:provider/provider.dart';
 
-/// Класс для добавления провайдеров темы и локализации
+/// {@template app_providers}
+/// Класс для добавления зависимостей приложения
+/// {@endtemplate}
 final class AppProviders extends StatelessWidget {
-  const AppProviders({required this.child, super.key});
+  /// {@macro app_providers}
+  const AppProviders({
+    required this.child,
+    required this.diContainer,
+    super.key,
+  });
 
+  /// Виджет, который будет отображаться внутри провайдеров
   final Widget child;
 
+  /// Контейнер зависимостей
+  final DiContainer diContainer;
+
   @override
   Widget build(BuildContext context) {
     return MultiProvider(
@@ -19,6 +33,10 @@ final class AppProviders extends StatelessWidget {
         ChangeNotifierProvider(
           create: (_) => LocalizationNotifier(),
         ), // Провайдер для локализации
+        Provider.value(value: diContainer), // Передаем контейнер зависимостей
+        BlocProvider(
+          create: (_) => UpdateCubit(diContainer.repositories.updateRepository),
+        ),
       ],
       child: child,
     );

lib/app/app_root.dart

@@ -0,0 +1,54 @@
+import 'package:flutter/material.dart';
+import 'package:friflex_starter/app/app_context_ext.dart';
+import 'package:friflex_starter/app/app_providers.dart';
+import 'package:friflex_starter/app/theme/app_theme.dart';
+import 'package:friflex_starter/app/theme/theme_notifier.dart';
+import 'package:friflex_starter/di/di_container.dart';
+import 'package:friflex_starter/l10n/gen/app_localizations.dart';
+import 'package:friflex_starter/l10n/localization_notifier.dart';
+import 'package:go_router/go_router.dart';
+
+/// {@template app}
+/// Главный виджет приложения, отображающий основной интерфейс приложения
+///
+/// Отвечает за:
+/// - Настройку провайдеров для темы и локализации
+/// {@endtemplate}
+class AppRoot extends StatelessWidget {
+  /// {@macro app_root}
+  const AppRoot({required this.diContainer, required this.router, super.key});
+
+  /// Контейнер зависимостей
+  final DiContainer diContainer;
+
+  /// Роутер приложения
+  final GoRouter router;
+
+  @override
+  Widget build(BuildContext context) {
+    return AppProviders(
+      diContainer: diContainer,
+      child: LocalizationConsumer(
+        builder: (localizationContext) {
+          return ThemeConsumer(
+            builder: (themeContext) => MediaQuery(
+              key: const ValueKey('prevent_rebuild'),
+              data: MediaQuery.of(
+                themeContext,
+              ).copyWith(textScaler: TextScaler.noScaling, boldText: false),
+              child: MaterialApp.router(
+                darkTheme: AppTheme.dark,
+                theme: AppTheme.light,
+                themeMode: themeContext.theme.themeMode,
+                locale: localizationContext.localization.locale,
+                localizationsDelegates: AppLocalizations.localizationsDelegates,
+                supportedLocales: AppLocalizations.supportedLocales,
+                routerConfig: router,
+              ),
+            ),
+          );
+        },
+      ),
+    );
+  }
+}

lib/app/depends_providers.dart

@@ -1,26 +0,0 @@
-import 'package:flutter/material.dart';
-import 'package:friflex_starter/di/di_container.dart';
-import 'package:provider/provider.dart';
-
-/// Класс для внедрения глобальных зависимостей
-final class DependsProviders extends StatelessWidget {
-  const DependsProviders({
-    required this.child,
-    required this.diContainer,
-    super.key,
-  });
-
-  final Widget child;
-  final DiContainer diContainer;
-
-  @override
-  Widget build(BuildContext context) {
-    return MultiProvider(
-      providers: [
-        // Сюда добавляем глобальные блоки, inherited и т.д.
-        Provider.value(value: diContainer), // Передаем контейнер зависимостей
-      ],
-      child: child,
-    );
-  }
-}

lib/app/http/app_http_client.dart

@@ -1,13 +1,12 @@
 import 'package:dio/dio.dart';
-import 'package:friflex_starter/app/app_config/i_app_config.dart';
-import 'package:friflex_starter/app/http/i_http_client.dart';
+import 'package:friflex_starter/app/app_config/app_config.dart';
 
 import 'package:friflex_starter/features/debug/i_debug_service.dart';
 
 /// {@template app_http_client}
 ///  Класс для реализации HTTP-клиента для управления запросами
 /// {@endtemplate}
-final class AppHttpClient implements IHttpClient {
+final class AppHttpClient {
   /// Создает HTTP клиент
   ///
   /// Принимает:
@@ -18,7 +17,6 @@ final class AppHttpClient implements IHttpClient {
     required IAppConfig appConfig,
   }) {
     _httpClient = Dio();
-    _appConfig = appConfig;
 
     _httpClient.options
       ..baseUrl = appConfig.baseUrl
@@ -30,111 +28,8 @@ final class AppHttpClient implements IHttpClient {
     _httpClient.interceptors.add(debugService.dioLogger);
   }
 
-  /// Конфигурация приложения
-  late final IAppConfig _appConfig;
-
   /// Экземпляр HTTP клиента
   late final Dio _httpClient;
 
-  @override
-  Future<Response> get(
-    String path, {
-    Object? data,
-    Map<String, dynamic>? queryParameters,
-    Options? options,
-  }) async {
-    _httpClient.options.baseUrl = _appConfig.baseUrl;
-
-    return _httpClient.get(
-      path,
-      data: data,
-      queryParameters: queryParameters,
-      options: options,
-    );
-  }
-
-  @override
-  Future<Response> post(
-    String path, {
-    Object? data,
-    Map<String, dynamic>? queryParameters,
-    Options? options,
-  }) async {
-    _httpClient.options.baseUrl = _appConfig.baseUrl;
-
-    return _httpClient.post(
-      path,
-      data: data,
-      queryParameters: queryParameters,
-      options: options,
-    );
-  }
-
-  @override
-  Future<Response> patch(
-    String path, {
-    Object? data,
-    Map<String, dynamic>? queryParameters,
-    Options? options,
-  }) async {
-    _httpClient.options.baseUrl = _appConfig.baseUrl;
-
-    return _httpClient.patch(
-      path,
-      data: data,
-      queryParameters: queryParameters,
-      options: options,
-    );
-  }
-
-  @override
-  Future<Response> put(
-    String path, {
-    Object? data,
-    Map<String, dynamic>? queryParameters,
-    Options? options,
-  }) async {
-    _httpClient.options.baseUrl = _appConfig.baseUrl;
-
-    return _httpClient.put(
-      path,
-      data: data,
-      queryParameters: queryParameters,
-      options: options,
-    );
-  }
-
-  @override
-  Future<Response> delete(
-    String path, {
-    Object? data,
-    Map<String, dynamic>? queryParameters,
-    Options? options,
-  }) async {
-    _httpClient.options.baseUrl = _appConfig.baseUrl;
-
-    return _httpClient.delete(
-      path,
-      data: data,
-      queryParameters: queryParameters,
-      options: options,
-    );
-  }
-
-  @override
-  Future<Response> head(
-    String path, {
-    Object? data,
-    Map<String, dynamic>? queryParameters,
-    Options? options,
-  }) async {
-    _httpClient.options.baseUrl = _appConfig.baseUrl;
-
-    return _httpClient.head(
-      path,
-      data: data,
-      queryParameters: queryParameters,
-      options: options,
-    );
-  }
+  Dio get client => _httpClient;
 }

lib/app/http/i_http_client.dart

@@ -1,94 +0,0 @@
-import 'package:dio/dio.dart';
-
-/// Класс для описания интерфейса сервиса по управлению HTTP запросами
-abstract interface class IHttpClient {
-  /// Описывает поля HTTP клиента
-  const IHttpClient();
-
-  /// Наименование сервиса
-  static const name = 'IHttpClient';
-
-  /// Метод для реализации запроса GET
-  ///
-  /// Принимает:
-  /// - [path] - путь к ресурсу
-  /// - [data] - тело запроса
-  /// - [queryParameters] - параметры запроса
-  /// - [options] - конфигурация запроса
-  Future<Response> get(
-    String path, {
-    Object? data,
-    Map<String, dynamic>? queryParameters,
-    Options? options,
-  });
-
-  /// Метод для реализации запроса POST
-  ///
-  /// Принимает:
-  /// - [path] - путь к ресурсу
-  /// - [data] - тело запроса
-  /// - [queryParameters] - параметры запроса
-  /// - [options] - конфигурация запроса
-  Future<Response> post(
-    String path, {
-    Object? data,
-    Map<String, dynamic>? queryParameters,
-    Options? options,
-  });
-
-  /// Метод для реализации запроса PATCH
-  ///
-  /// Принимает:
-  /// - [path] - путь к ресурсу
-  /// - [data] - тело запроса
-  /// - [queryParameters] - параметры запроса
-  /// - [options] - конфигурация запроса
-  Future<Response> patch(
-    String path, {
-    Object? data,
-    Map<String, dynamic>? queryParameters,
-    Options? options,
-  });
-
-  /// Метод для реализации запроса PUT
-  ///
-  /// Принимает:
-  /// - [path] - путь к ресурсу
-  /// - [data] - тело запроса
-  /// - [queryParameters] - параметры запроса
-  /// - [options] - конфигурация запроса
-  Future<Response> put(
-    String path, {
-    Object? data,
-    Map<String, dynamic>? queryParameters,
-    Options? options,
-  });
-
-  /// Метод для реализации запроса DELETE
-  ///
-  /// Принимает:
-  /// - [path] - путь к ресурсу
-  /// - [data] - тело запроса
-  /// - [queryParameters] - параметры запроса
-  /// - [options] - конфигурация запроса
-  Future<Response> delete(
-    String path, {
-    Object? data,
-    Map<String, dynamic>? queryParameters,
-    Options? options,
-  });
-
-  /// Метод для реализации запроса POST
-  ///
-  /// Принимает:
-  /// - [path] - путь к ресурсу
-  /// - [data] - тело запроса
-  /// - [queryParameters] - параметры запроса
-  /// - [options] - конфигурация запроса
-  Future<Response> head(
-    String path, {
-    Object? data,
-    Map<String, dynamic>? queryParameters,
-    Options? options,
-  });
-}

lib/app/theme/app_colors_scheme.dart

@@ -1,10 +1,13 @@
-import 'package:flutter/foundation.dart';
 import 'package:flutter/material.dart';
+import 'package:theme_tailor_annotation/theme_tailor_annotation.dart';
+
+part 'app_colors_scheme.tailor.dart';
 
 /// {@template app_colors}
 /// Класс, реализующий расширение для добавления токенов в цветовую схему
 /// {@endtemplate}
-class AppColors extends ThemeExtension<AppColors> with DiagnosticableTreeMixin {
+@TailorMixin(themeGetter: ThemeGetter.onBuildContext)
+class AppColors extends ThemeExtension<AppColors> with _$AppColorsTailorMixin {
   /// {@macro app_colors}
   ///
   /// Принимает:
@@ -23,81 +26,40 @@ class AppColors extends ThemeExtension<AppColors> with DiagnosticableTreeMixin {
   });
 
   /// Цвет тестовый
+  @override
   final Color testColor;
 
   /// Цвет элемента текста
+  @override
   final Color itemTextColor;
 
   /// Цвет фона снекбара ошибки
+  @override
   final Color errorSnackbarBackground;
 
   /// Цвет фона снекбара успеха
+  @override
   final Color successSnackbarBackground;
 
   /// Цвет фона снекбара информации
+  @override
   final Color infoSnackbarBackground;
 
   /// Цвета светлой темы
-  static final AppColors light = AppColors(
+  static const AppColors light = AppColors(
     testColor: Colors.red,
-    errorSnackbarBackground: const Color(0xFFD24720),
-    successSnackbarBackground: const Color(0xFF6FB62C),
-    infoSnackbarBackground: const Color.fromARGB(255, 220, 108, 77),
-    itemTextColor: const Color(0xFFFAF3EB),
+    errorSnackbarBackground: Color(0xFFD24720),
+    successSnackbarBackground: Color(0xFF6FB62C),
+    infoSnackbarBackground: .fromARGB(255, 220, 108, 77),
+    itemTextColor: Color(0xFFFAF3EB),
   );
 
   /// Цвета тёмной темы
-  static final AppColors dark = AppColors(
+  static const AppColors dark = AppColors(
     testColor: Colors.green,
-    errorSnackbarBackground: const Color(0xFF638B8B),
-    successSnackbarBackground: const Color(0xFF93C499),
-    infoSnackbarBackground: const Color.fromARGB(255, 35, 147, 178),
+    errorSnackbarBackground: Color(0xFF638B8B),
+    successSnackbarBackground: Color(0xFF93C499),
+    infoSnackbarBackground: .fromARGB(255, 35, 147, 178),
     itemTextColor: Colors.white,
   );
-
-  @override
-  ThemeExtension<AppColors> copyWith({
-    Color? testColor,
-    Color? errorSnackbarBackground,
-    Color? successSnackbarBackground,
-    Color? infoSnackbarBackground,
-    Color? itemTextColor,
-  }) => AppColors(
-    testColor: testColor ?? this.testColor,
-    errorSnackbarBackground:
-        errorSnackbarBackground ?? this.errorSnackbarBackground,
-    successSnackbarBackground:
-        successSnackbarBackground ?? this.successSnackbarBackground,
-    infoSnackbarBackground:
-        infoSnackbarBackground ?? this.infoSnackbarBackground,
-    itemTextColor: itemTextColor ?? this.itemTextColor,
-  );
-
-  @override
-  ThemeExtension<AppColors> lerp(
-    covariant ThemeExtension<AppColors>? other,
-    double t,
-  ) {
-    if (other is! AppColors) return this;
-
-    return AppColors(
-      testColor: Color.lerp(testColor, other.testColor, t)!,
-      errorSnackbarBackground: Color.lerp(
-        errorSnackbarBackground,
-        other.errorSnackbarBackground,
-        t,
-      )!,
-      successSnackbarBackground: Color.lerp(
-        successSnackbarBackground,
-        other.successSnackbarBackground,
-        t,
-      )!,
-      infoSnackbarBackground: Color.lerp(
-        infoSnackbarBackground,
-        other.infoSnackbarBackground,
-        t,
-      )!,
-      itemTextColor: Color.lerp(itemTextColor, other.itemTextColor, t)!,
-    );
-  }
 }

lib/app/theme/app_colors_scheme.tailor.dart

@@ -0,0 +1,102 @@
+// coverage:ignore-file
+// GENERATED CODE - DO NOT MODIFY BY HAND
+// ignore_for_file: type=lint
+// ignore_for_file: unused_element, deprecated_member_use, deprecated_member_use_from_same_package, use_function_type_syntax_for_parameters, unnecessary_const, avoid_init_to_null, invalid_override_different_default_values_named, prefer_expression_function_bodies, annotate_overrides, invalid_annotation_target, unnecessary_question_mark
+
+part of 'app_colors_scheme.dart';
+
+// **************************************************************************
+// TailorAnnotationsGenerator
+// **************************************************************************
+
+mixin _$AppColorsTailorMixin on ThemeExtension<AppColors> {
+  Color get testColor;
+  Color get itemTextColor;
+  Color get errorSnackbarBackground;
+  Color get successSnackbarBackground;
+  Color get infoSnackbarBackground;
+
+  @override
+  AppColors copyWith({
+    Color? testColor,
+    Color? itemTextColor,
+    Color? errorSnackbarBackground,
+    Color? successSnackbarBackground,
+    Color? infoSnackbarBackground,
+  }) {
+    return AppColors(
+      testColor: testColor ?? this.testColor,
+      itemTextColor: itemTextColor ?? this.itemTextColor,
+      errorSnackbarBackground:
+          errorSnackbarBackground ?? this.errorSnackbarBackground,
+      successSnackbarBackground:
+          successSnackbarBackground ?? this.successSnackbarBackground,
+      infoSnackbarBackground:
+          infoSnackbarBackground ?? this.infoSnackbarBackground,
+    );
+  }
+
+  @override
+  AppColors lerp(covariant ThemeExtension<AppColors>? other, double t) {
+    if (other is! AppColors) return this as AppColors;
+    return AppColors(
+      testColor: Color.lerp(testColor, other.testColor, t)!,
+      itemTextColor: Color.lerp(itemTextColor, other.itemTextColor, t)!,
+      errorSnackbarBackground: Color.lerp(
+        errorSnackbarBackground,
+        other.errorSnackbarBackground,
+        t,
+      )!,
+      successSnackbarBackground: Color.lerp(
+        successSnackbarBackground,
+        other.successSnackbarBackground,
+        t,
+      )!,
+      infoSnackbarBackground: Color.lerp(
+        infoSnackbarBackground,
+        other.infoSnackbarBackground,
+        t,
+      )!,
+    );
+  }
+
+  @override
+  bool operator ==(Object other) {
+    return identical(this, other) ||
+        (other.runtimeType == runtimeType &&
+            other is AppColors &&
+            const DeepCollectionEquality().equals(testColor, other.testColor) &&
+            const DeepCollectionEquality().equals(
+              itemTextColor,
+              other.itemTextColor,
+            ) &&
+            const DeepCollectionEquality().equals(
+              errorSnackbarBackground,
+              other.errorSnackbarBackground,
+            ) &&
+            const DeepCollectionEquality().equals(
+              successSnackbarBackground,
+              other.successSnackbarBackground,
+            ) &&
+            const DeepCollectionEquality().equals(
+              infoSnackbarBackground,
+              other.infoSnackbarBackground,
+            ));
+  }
+
+  @override
+  int get hashCode {
+    return Object.hash(
+      runtimeType.hashCode,
+      const DeepCollectionEquality().hash(testColor),
+      const DeepCollectionEquality().hash(itemTextColor),
+      const DeepCollectionEquality().hash(errorSnackbarBackground),
+      const DeepCollectionEquality().hash(successSnackbarBackground),
+      const DeepCollectionEquality().hash(infoSnackbarBackground),
+    );
+  }
+}
+
+extension AppColorsBuildContext on BuildContext {
+  AppColors get appColors => Theme.of(this).extension<AppColors>()!;
+}

lib/app/theme/theme_notifier.dart

@@ -1,30 +1,55 @@
 import 'package:flutter/material.dart';
 import 'package:provider/provider.dart';
 
-typedef ThemeBuilder = Widget Function();
+/// Тип функции для построения виджета с учетом темы
+typedef ThemeBuilder = Widget Function(BuildContext context);
 
-/// Виджет для подписки на изменение темы приложения
+/// {@template theme_consumer}
+/// Виджет для подписки на изменения темы приложения.
+///
+/// Автоматически перестраивает дочерние виджеты при изменении темы,
+/// обеспечивая реактивность интерфейса к изменениям настроек темы.
+/// {@endtemplate}
 class ThemeConsumer extends StatelessWidget {
+  /// {@macro theme_consumer}
   const ThemeConsumer({required this.builder, super.key});
 
+  /// Функция для построения виджета с учетом текущей темы
   final ThemeBuilder builder;
 
   @override
   Widget build(BuildContext context) {
     return Consumer<ThemeNotifier>(
-      builder: (_, _, _) {
-        return builder();
+      builder: (context, _, _) {
+        return builder(context);
       },
     );
   }
 }
 
-/// Класс для управления темой приложения
+/// {@template theme_notifier}
+/// Класс для управления темой приложения.
+///
+/// Отвечает за:
+/// - Хранение текущего режима темы (светлая/темная/системная)
+/// - Уведомление подписчиков об изменениях темы
+/// - Переключение между режимами темы
+/// {@endtemplate}
 final class ThemeNotifier extends ChangeNotifier {
+  /// {@macro theme_notifier}
+  ThemeNotifier();
+
+  /// Текущий режим темы приложения
+  /// По умолчанию используется системная тема
   ThemeMode _themeMode = ThemeMode.system;
 
+  /// Получение текущего режима темы
   ThemeMode get themeMode => _themeMode;
 
+  /// Метод для переключения темы приложения.
+  ///
+  /// Переключает между светлой и темной темой.
+  /// Если текущая тема светлая, переключает на темную и наоборот.
   void changeTheme() {
     _themeMode = _themeMode == ThemeMode.light
         ? ThemeMode.dark

lib/app/ui_kit/app_box.dart

@@ -1,7 +1,10 @@
 import 'package:flutter/widgets.dart';
 
 /// {@template h_box}
-///  HBox виджет для вертикального отступа (Надстройка над SizedBox)
+/// Виджет для создания вертикального отступа.
+///
+/// Надстройка над SizedBox, предназначенная для создания
+/// отступов по вертикали с более понятным названием.
 /// {@endtemplate}
 class HBox extends SizedBox {
   /// {@macro h_box}
@@ -9,7 +12,10 @@ class HBox extends SizedBox {
 }
 
 /// {@template w_box}
-/// WBox виджет для вертикального отступа (Надстройка над SizedBox)
+/// Виджет для создания горизонтального отступа.
+///
+/// Надстройка над SizedBox, предназначенная для создания
+/// отступов по горизонтали с более понятным названием.
 /// {@endtemplate}
 class WBox extends SizedBox {
   /// {@macro w_box}

lib/app/ui_kit/app_snackbar.dart

@@ -1,7 +1,7 @@
 import 'dart:async';
 
 import 'package:flutter/material.dart';
-import 'package:friflex_starter/app/app_context_ext.dart';
+import 'package:friflex_starter/app/theme/app_colors_scheme.dart';
 import 'package:friflex_starter/app/ui_kit/app_box.dart';
 
 /// {@template app_snackbar}
@@ -63,7 +63,7 @@ class AppSnackBar extends StatefulWidget {
     _show(
       context: context,
       message: message,
-      type: TypeSnackBar.error,
+      type: .error,
       displayDuration: displayDuration,
     );
   }
@@ -81,7 +81,7 @@ class AppSnackBar extends StatefulWidget {
     _show(
       context: context,
       message: message,
-      type: TypeSnackBar.info,
+      type: .info,
       displayDuration: displayDuration,
     );
   }
@@ -99,7 +99,7 @@ class AppSnackBar extends StatefulWidget {
     _show(
       context: context,
       message: message,
-      type: TypeSnackBar.success,
+      type: .success,
       displayDuration: displayDuration,
     );
   }
@@ -180,11 +180,11 @@ class _AppSnackBarState extends State<AppSnackBar>
           CurvedAnimation(parent: _animationController, curve: Curves.easeOut),
         );
 
-    _animationController.forward();
+    unawaited(_animationController.forward());
   }
 
   /// Запуск таймера для автоматического закрытия снекбара
-  /// Таймер срабатывает по истечении [widget.displayDuration]
+  /// Таймер срабатывает по истечении widget.displayDuration
   /// и вызывает метод [_dismiss] для закрытия снекбара
   void _startDismissTimer() {
     _dismissTimer = Timer(widget.displayDuration, _dismiss);
@@ -192,17 +192,19 @@ class _AppSnackBarState extends State<AppSnackBar>
 
   /// Закрытие снекбара
   /// Отменяет таймер, если он существует, и запускает обратную анимацию
-  /// После завершения анимации вызывает функцию [widget.onDismiss], если она задана
+  /// После завершения анимации вызывает функцию widget.onDismiss, если она задана
   /// Если виджет не смонтирован, ничего не делает
   void _dismiss() {
     if (!mounted) return;
 
     _dismissTimer?.cancel();
-    _animationController.reverse().then((_) {
-      if (mounted) {
-        widget.onDismiss?.call();
-      }
-    });
+    unawaited(
+      _animationController.reverse().then((_) {
+        if (mounted) {
+          widget.onDismiss?.call();
+        }
+      }),
+    );
   }
 
   @override
@@ -243,7 +245,7 @@ class _AppSnackBarState extends State<AppSnackBar>
                     Flexible(
                       child: Text(
                         widget.message,
-                        style: TextStyle(color: Colors.white),
+                        style: const TextStyle(color: Colors.white),
                         maxLines: 3,
                         overflow: TextOverflow.ellipsis,
                       ),
@@ -264,9 +266,9 @@ class _AppSnackBarState extends State<AppSnackBar>
   /// [TypeSnackBar.error] - цвет ошибки
   Color _getBackgroundColor(TypeSnackBar type) {
     return switch (type) {
-      TypeSnackBar.success => context.colors.successSnackbarBackground,
-      TypeSnackBar.error => context.colors.errorSnackbarBackground,
-      TypeSnackBar.info => context.colors.infoSnackbarBackground,
+      .success => context.appColors.successSnackbarBackground,
+      .error => context.appColors.errorSnackbarBackground,
+      .info => context.appColors.infoSnackbarBackground,
     };
   }
 }
@@ -288,13 +290,9 @@ class _Icon extends StatelessWidget {
   @override
   Widget build(BuildContext context) {
     return switch (type) {
-      TypeSnackBar.success => Icon(
-        Icons.check_circle,
-        color: Colors.white,
-        size: 32,
-      ),
-      TypeSnackBar.error => Icon(Icons.error, color: Colors.white, size: 32),
-      TypeSnackBar.info => Icon(Icons.info, color: Colors.white, size: 32),
+      .success => const Icon(Icons.check_circle, color: Colors.white, size: 32),
+      .error => const Icon(Icons.error, color: Colors.white, size: 32),
+      .info => const Icon(Icons.info, color: Colors.white, size: 32),
     };
   }
 }

lib/di/di_base_repo.dart

@@ -1,6 +1,17 @@
-/// Миксин репозитория в приложении.
-/// Каждый интерфейс репозитория в приложении должен подмешивать текущий класс
+/// {@template di_base_repo}
+/// Базовый миксин для всех репозиториев в приложении.
+///
+/// Предоставляет общую функциональность для всех репозиториев:
+/// - Уникальное наименование репозитория
+/// - Базовую структуру для DI контейнера
+///
+/// Каждый репозиторий в приложении должен использовать этот миксин
+/// для обеспечения совместимости с системой зависимостей.
+/// {@endtemplate}
 mixin class DiBaseRepo {
-  /// Наименование репозитория
+  /// {@macro di_base_repo}
+  DiBaseRepo();
+
+  /// Наименование репозитория для идентификации в DI контейнере
   String get name => 'DiBaseRepo';
 }

lib/di/di_container.dart

@@ -1,8 +1,6 @@
 import 'package:friflex_starter/app/app_config/app_config.dart';
-import 'package:friflex_starter/app/app_config/i_app_config.dart';
 import 'package:friflex_starter/app/app_env.dart';
 import 'package:friflex_starter/app/http/app_http_client.dart';
-import 'package:friflex_starter/app/http/i_http_client.dart';
 import 'package:friflex_starter/di/di_repositories.dart';
 import 'package:friflex_starter/di/di_services.dart';
 import 'package:friflex_starter/di/di_typedefs.dart';
@@ -26,7 +24,7 @@ final class DiContainer {
   late final IAppConfig appConfig;
 
   /// Сервис для работы с HTTP запросами
-  late final IHttpClient Function(IDebugService, IAppConfig) httpClientFactory;
+  late final AppHttpClient httpClient;
 
   /// Репозитории приложения
   late final DiRepositories repositories;
@@ -42,14 +40,16 @@ final class DiContainer {
   }) async {
     // Инициализация конфигурации приложения
     appConfig = switch (env) {
-      AppEnv.dev => AppConfigDev(),
-      AppEnv.prod => AppConfigProd(),
-      AppEnv.stage => AppConfigStage(),
+      .dev => AppConfigDev(),
+      .prod => AppConfigProd(),
+      .stage => AppConfigStage(),
     };
 
     // Инициализация HTTP клиента
-    httpClientFactory = (debugService, appConfig) =>
-        AppHttpClient(debugService: debugService, appConfig: appConfig);
+    httpClient = AppHttpClient(
+      debugService: debugService,
+      appConfig: appConfig,
+    );
 
     // Инициализация сервисов
     services = DiServices()

lib/di/di_repositories.dart

@@ -2,37 +2,45 @@ import 'package:friflex_starter/app/app_env.dart';
 import 'package:friflex_starter/di/di_base_repo.dart';
 import 'package:friflex_starter/di/di_container.dart';
 import 'package:friflex_starter/di/di_typedefs.dart';
-import 'package:friflex_starter/features/auth/data/repository/auth_mock_repository.dart';
-import 'package:friflex_starter/features/auth/data/repository/auth_repository.dart';
-import 'package:friflex_starter/features/auth/domain/repository/i_auth_repository.dart';
 import 'package:friflex_starter/features/main/data/repository/main_mock_repository.dart';
 import 'package:friflex_starter/features/main/data/repository/main_repository.dart';
 import 'package:friflex_starter/features/main/domain/repository/i_main_repository.dart';
 import 'package:friflex_starter/features/profile/data/repository/profile_mock_repository.dart';
 import 'package:friflex_starter/features/profile/data/repository/profile_repository.dart';
 import 'package:friflex_starter/features/profile/domain/repository/i_profile_repository.dart';
+import 'package:friflex_starter/features/update/data/repository/update_mock_repository.dart';
+import 'package:friflex_starter/features/update/data/repository/update_repository.dart';
+import 'package:friflex_starter/features/update/domain/repository/i_update_repository.dart';
 
 /// Список названий моковых репозиториев, которые должны быть подменены
-/// для использования в сборке stage окружения
+/// для использования в сборке stage окружения.
 ///
 /// Для того, чтобы репозиторий был автоматически подменен на моковый в stage
-/// сборке, необходимо в этом списке указать название мокового репозитория,
-/// обращаясь к соответствующему полю name.
+/// сборке, необходимо в этом списке указать тип интерфейса репозитория
 ///
 /// Пример:
 /// ```
-///   [ AuthCheckRepositoryMock().name, ]
+///   <Type>{ IUpdateRepository }
 /// ```
-final List<String> _mockReposToSwitch = [];
+const _mockReposToSwitch = <Type>{IUpdateRepository};
 
-/// Класс для инициализации репозиториев в приложении
+/// {@template di_repositories}
+/// Класс для инициализации и управления репозиториями приложения.
 ///
-/// По умолчанию репозиторию присваивается моковая реализация.
-/// В зависимости от окружения либо выполняется подмена репозиторий,
-/// либо используется моковый.
+/// Отвечает за:
+/// - Инициализацию репозиториев для работы с данными
+/// - Автоматическое переключение между моковыми и реальными репозиториями
+/// - Уведомление о прогрессе инициализации
+/// - Обработку ошибок инициализации репозиториев
+///
+/// Стратегия инициализации по окружениям:
+/// - dev: всегда используются моковые репозитории
+/// - prod: всегда используются реальные репозитории
+/// - stage: используются моковые репозитории из списка _mockReposToSwitch
+/// {@endtemplate}
 final class DiRepositories {
-  /// Интерфейс для работы с репозиторием авторизации
-  late final IAuthRepository authRepository;
+  /// {@macro di_repositories}
+  DiRepositories();
 
   /// Интерфейс для работы с репозиторием главного сервиса
   late final IMainRepository mainRepository;
@@ -40,81 +48,53 @@ final class DiRepositories {
   /// Интерфейс для работы с репозиторием профиля
   late final IProfileRepository profileRepository;
 
-  /// Метод для инициализации репозиториев в приложении
+  /// Интерфейс для работы с репозиторием обновлений
+  late final IUpdateRepository updateRepository;
+
+  /// Метод для инициализации репозиториев в приложении.
   ///
   /// Принимает:
-  /// - [onProgress] - обратный вызов при прогрессе
-  /// - [diContainer] - контейнер зависимостей
+  /// - [onProgress] - обратный вызов для уведомления о прогрессе инициализации
+  /// - [diContainer] - контейнер зависимостей с конфигурацией приложения
+  /// - [onError] - обратный вызов для обработки ошибок инициализации
+  ///
+  /// Последовательность инициализации:
+  /// 1. Инициализация репозитория авторизации
+  /// 2. Инициализация репозитория главного сервиса
+  /// 3. Инициализация репозитория профиля
   void init({
     required OnProgress onProgress,
     required OnError onError,
     required DiContainer diContainer,
   }) {
-    try {
-      //Инициализация репозитория авторизации
-      authRepository = _lazyInitRepo<IAuthRepository>(
-        mockFactory: AuthMockRepository.new,
-        mainFactory: () => AuthRepository(
-          httpClient: diContainer.httpClientFactory(
-            diContainer.debugService,
-            diContainer.appConfig,
-          ),
-        ),
-        onProgress: onProgress,
-        environment: diContainer.env,
-      );
-      onProgress(authRepository.name);
-    } on Object catch (error, stackTrace) {
-      onError(
-        'Ошибка инициализации репозитория IAuthRepository',
-        error,
-        stackTrace,
-      );
-    }
+    onProgress('Начинаем инициализацию репозиториев...');
 
-    try {
-      // Инициализация репозитория сервиса управления токеном доступа
-      mainRepository = _lazyInitRepo<IMainRepository>(
-        mockFactory: MainMockRepository.new,
-        mainFactory: () => MainRepository(
-          httpClient: diContainer.httpClientFactory(
-            diContainer.debugService,
-            diContainer.appConfig,
-          ),
-        ),
-        onProgress: onProgress,
-        environment: diContainer.env,
-      );
-      onProgress(mainRepository.name);
-    } on Object catch (error, stackTrace) {
-      onError(
-        'Ошибка инициализации репозитория IMainRepository',
-        error,
-        stackTrace,
-      );
-    }
+    // Инициализация репозитория обновлений
+    updateRepository = _lazyInitRepo<IUpdateRepository>(
+      mockFactory: () => const UpdateMockRepository(),
+      mainFactory: () => UpdateRepository(httpClient: diContainer.httpClient),
+      onProgress: onProgress,
+      onError: onError,
+      environment: diContainer.env,
+    );
 
-    try {
-      // Инициализация репозитория профиля
-      profileRepository = _lazyInitRepo<IProfileRepository>(
-        mockFactory: ProfileMockRepository.new,
-        mainFactory: () => ProfileRepository(
-          httpClient: diContainer.httpClientFactory(
-            diContainer.debugService,
-            diContainer.appConfig,
-          ),
-        ),
-        onProgress: onProgress,
-        environment: diContainer.env,
-      );
-      onProgress(profileRepository.name);
-    } on Object catch (error, stackTrace) {
-      onError(
-        'Ошибка инициализации репозитория IProfileRepository',
-        error,
-        stackTrace,
-      );
-    }
+    // Инициализация репозитория сервиса управления токеном доступа
+    mainRepository = _lazyInitRepo<IMainRepository>(
+      mockFactory: () => const MainMockRepository(),
+      mainFactory: () => MainRepository(httpClient: diContainer.httpClient),
+      onProgress: onProgress,
+      onError: onError,
+      environment: diContainer.env,
+    );
+
+    // Инициализация репозитория профиля
+    profileRepository = _lazyInitRepo<IProfileRepository>(
+      mockFactory: () => const ProfileMockRepository(),
+      mainFactory: () => ProfileRepository(httpClient: diContainer.httpClient),
+      onProgress: onProgress,
+      onError: onError,
+      environment: diContainer.env,
+    );
 
     onProgress(
       'Инициализация репозиториев завершена! Было подменено репозиториев - ${_mockReposToSwitch.length} (${_mockReposToSwitch.join(', ')})',
@@ -125,26 +105,39 @@ final class DiRepositories {
   /// В зависимости от окружения инициализируется моковый или сетевой репозиторий.
   ///
   /// Принимает:
-  /// - [mockFactory] - функция - фабрика для инициализации репозитория для управления моковыми запросами
-  /// - [mainFactory] - функция - фабрика для инициализации основного репозиторий
-  /// - [onProgress] - обратный вызов при прогрессе
+  /// - [mockFactory] - функция-фабрика для инициализации мокового репозитория
+  /// - [mainFactory] - функция-фабрика для инициализации основного репозитория
+  /// - [onProgress] - обратный вызов для уведомления о прогрессе
+  /// - [onError] - обратный вызов для обработки ошибок инициализации
+  /// - [environment] - окружение приложения для определения стратегии инициализации
+  ///
+  /// Возвращает:
+  /// - Экземпляр репозитория в зависимости от окружения
+  ///
+  /// Throws:
+  /// - Перебрасывает исключение, если инициализация репозитория завершилась с ошибкой
   T _lazyInitRepo<T extends DiBaseRepo>({
     required AppEnv environment,
     required T Function() mainFactory,
     required T Function() mockFactory,
     required OnProgress onProgress,
+    required OnError onError,
   }) {
-    final mockRepo = mockFactory();
-    final mainRepo = mainFactory();
+    try {
+      final repo = switch (environment) {
+        .dev => mockFactory(),
+        .prod => mainFactory(),
+        .stage =>
+          _mockReposToSwitch.contains(T) ? mockFactory() : mainFactory(),
+      };
 
-    final repo = switch (environment) {
-      AppEnv.dev => mockRepo,
-      AppEnv.prod => mainRepo,
-      AppEnv.stage =>
-        _mockReposToSwitch.contains(mockRepo.name) ? mockRepo : mainRepo,
-    };
-
-    onProgress(repo.name);
-    return repo;
+      // throw Exception('Тестовая - ошибка инициализации репозитория $T');
+      onProgress(repo.name);
+      return repo;
+    } on Object catch (error, stackTrace) {
+      onError('Ошибка инициализации репозитория $T', error, stackTrace);
+      // Перебрасываем исключение дальше, чтобы не скрыть ошибку инициализации
+      rethrow;
+    }
   }
 }

lib/di/di_services.dart

@@ -3,26 +3,45 @@ import 'package:friflex_starter/di/di_container.dart';
 import 'package:friflex_starter/di/di_typedefs.dart';
 import 'package:i_app_services/i_app_services.dart';
 
-/// Класс для инициализации сервисов
+/// {@template di_services}
+/// Класс для инициализации и управления сервисами приложения.
+///
+/// Отвечает за:
+/// - Инициализацию сервисов для работы с путями
+/// - Инициализацию сервисов для работы с защищенным хранилищем
+/// - Уведомление о прогрессе инициализации
+/// - Обработку ошибок инициализации сервисов
+/// {@endtemplate}
 final class DiServices {
-  /// Сервис для работы с путями
+  /// {@macro di_services}
+  DiServices();
+
+  /// Сервис для работы с путями файловой системы
   late final IPathProvider pathProvider;
 
-  /// Сервис для работы с локальным хранилищем
+  /// Сервис для работы с защищенным локальным хранилищем
   late final ISecureStorage secureStorage;
 
-  /// Метод для инициализации репозиториев в приложении
+  /// Сервис для работы с геолокацией
+  late final ILocationService locationService;
+
+  /// Метод для инициализации сервисов в приложении.
   ///
   /// Принимает:
-  /// - [onProgress] - обратный вызов при прогрессе
-  /// - [diContainer] - контейнер зависимостей
-  /// - [onError] - обратный вызов при ошибке
+  /// - [onProgress] - обратный вызов для уведомления о прогрессе инициализации
+  /// - [diContainer] - контейнер зависимостей с конфигурацией приложения
+  /// - [onError] - обратный вызов для обработки ошибок инициализации
+  ///
+  /// Последовательность инициализации:
+  /// 1. Инициализация сервиса путей (AppPathProvider)
+  /// 2. Инициализация защищенного хранилища (AppSecureStorage)
   void init({
     required OnProgress onProgress,
     required OnError onError,
     required DiContainer diContainer,
   }) {
     try {
+      // throw Exception('Тестовая - ошибка инициализации сервиса путей');
       pathProvider = const AppPathProvider();
       onProgress(AppPathProvider.name);
     } on Object catch (error, stackTrace) {
@@ -37,6 +56,17 @@ final class DiServices {
       onError('Ошибка инициализации ${ISecureStorage.name}', error, stackTrace);
     }
 
+    try {
+      locationService = const AppLocationService();
+      onProgress(AppLocationService.name);
+    } on Object catch (error, stackTrace) {
+      onError(
+        'Ошибка инициализации ${ILocationService.name}',
+        error,
+        stackTrace,
+      );
+    }
+
     onProgress('Инициализация сервисов завершена!');
   }
 }

lib/features/auth/data/repository/auth_mock_repository.dart

@@ -1,9 +0,0 @@
-import 'package:friflex_starter/features/auth/domain/repository/i_auth_repository.dart';
-
-/// {@template AuthMockRepository}
-/// Mock реализация репозитория авторизации
-/// {@endtemplate}
-final class AuthMockRepository implements IAuthRepository {
-  @override
-  String get name => 'AuthMockRepository';
-}

lib/features/auth/data/repository/auth_repository.dart

@@ -1,14 +0,0 @@
-import 'package:friflex_starter/app/http/i_http_client.dart';
-
-import 'package:friflex_starter/features/auth/domain/repository/i_auth_repository.dart';
-
-/// {@template AuthRepository}
-///  Реализация репозитория авторизации
-/// {@endtemplate}
-final class AuthRepository implements IAuthRepository {
-  AuthRepository({required this.httpClient});
-  final IHttpClient httpClient;
-
-  @override
-  String get name => 'AuthRepository';
-}

lib/features/auth/domain/repository/i_auth_repository.dart

@@ -1,6 +0,0 @@
-import 'package:friflex_starter/di/di_base_repo.dart';
-
-/// {@template IAuthRepository}
-/// Интерфейс для работы с репозиторием авторизации
-/// {@endtemplate}
-abstract interface class IAuthRepository with DiBaseRepo {}

lib/features/auth/presentation/screens/auth_screen.dart

@@ -1,17 +0,0 @@
-import 'package:flutter/material.dart';
-
-/// {@template AuthScreen}
-///
-/// {@endtemplate}
-class AuthScreen extends StatelessWidget {
-  /// {@macro AuthScreen}
-  const AuthScreen({super.key});
-
-  @override
-  Widget build(BuildContext context) {
-    return Scaffold(
-      appBar: AppBar(title: const Text('AuthScreen')),
-      body: const Center(child: Text('AuthScreen')),
-    );
-  }
-}

lib/features/debug/i_debug_service.dart

@@ -1,17 +1,19 @@
+import 'package:dio/dio.dart';
 import 'package:flutter/material.dart';
+import 'package:flutter_bloc/flutter_bloc.dart';
 
 /// Интерфейс для сервиса отладки
 abstract interface class IDebugService {
   static const name = 'IDebugService';
 
   /// Наблюдение за dio
-  dynamic get dioLogger;
+  Interceptor get dioLogger;
 
   /// Наблюдение за роутами
-  dynamic get routeObserver;
+  NavigatorObserver get routeObserver;
 
   /// Наблюдение за BLoC
-  dynamic get blocObserver;
+  BlocObserver get blocObserver;
 
   /// Метод для логирования сообщений
   void log(Object message, {Object logLevel, Map<String, dynamic>? args});

lib/features/debug/screens/components_screen.dart

@@ -1,19 +1,41 @@
+import 'dart:async';
+
 import 'package:flutter/material.dart';
 import 'package:friflex_starter/app/ui_kit/app_box.dart';
 import 'package:friflex_starter/app/ui_kit/app_snackbar.dart';
+import 'package:friflex_starter/features/update/domain/state/cubit/update_cubit.dart';
+import 'package:friflex_starter/features/update/presentation/components/soft_modal_sheet.dart';
+import 'package:friflex_starter/features/update/update_routes.dart';
+import 'package:go_router/go_router.dart';
+import 'package:provider/provider.dart';
 
-/// {@template ComponentsScreen}
-/// Экран для демонстрации компонентов приложения.
+/// {@template components_screen}
+/// Экран для демонстрации и тестирования компонентов приложения.
+///
+/// Отвечает за:
+/// - Демонстрацию различных типов снекбаров (ошибка, успех, информация)
+/// - Тестирование кастомных UI компонентов
+/// - Предоставление примеров использования компонентов
+/// - Валидацию корректности работы компонентов
 /// {@endtemplate}
 class ComponentsScreen extends StatefulWidget {
-  /// {@macro ComponentsScreen}
+  /// {@macro components_screen}
   const ComponentsScreen({super.key});
 
   @override
   State<ComponentsScreen> createState() => _ComponentsScreenState();
 }
 
+/// {@template components_screen_state}
+/// Состояние экрана компонентов.
+///
+/// Управляет отображением различных типов снекбаров
+/// и демонстрирует их функциональность.
+/// {@endtemplate}
 class _ComponentsScreenState extends State<ComponentsScreen> {
+  /// {@macro components_screen_state}
+  _ComponentsScreenState();
+
   @override
   Widget build(BuildContext context) {
     return Scaffold(
@@ -51,6 +73,35 @@ class _ComponentsScreenState extends State<ComponentsScreen> {
               },
               child: const Text('Показать снекбар с информацией'),
             ),
+            const HBox(16),
+            ElevatedButton(
+              onPressed: () {
+                final updateCubitState = context.read<UpdateCubit>().state;
+                if (updateCubitState is UpdateSuccessState &&
+                    updateCubitState.updateInfo.updateType == .soft) {
+                  unawaited(
+                    SoftUpdateModal.show(
+                      context,
+                      updateEntity: updateCubitState.updateInfo,
+                      onUpdate: () {
+                        AppSnackBar.showSuccess(
+                          context: context,
+                          message: 'Начато обновление приложения',
+                        );
+                      },
+                    ),
+                  );
+                }
+              },
+              child: const Text('Показать модальное окно обновления'),
+            ),
+            const HBox(16),
+            ElevatedButton(
+              onPressed: () {
+                unawaited(context.pushNamed(UpdateRoutes.hardUpdateScreenName));
+              },
+              child: const Text('Переход на экран Hard Update обновления'),
+            ),
           ],
         ),
       ),

lib/features/debug/screens/debug_screen.dart

@@ -1,6 +1,8 @@
+import 'dart:async';
+
 import 'package:flutter/material.dart';
-import 'package:friflex_starter/app/ui_kit/app_box.dart';
 import 'package:friflex_starter/app/app_context_ext.dart';
+import 'package:friflex_starter/app/ui_kit/app_box.dart';
 import 'package:friflex_starter/features/debug/debug_routes.dart';
 import 'package:go_router/go_router.dart';
 
@@ -35,42 +37,42 @@ class DebugScreen extends StatelessWidget {
             const HBox(16),
             ElevatedButton(
               onPressed: () {
-                context.pushNamed(DebugRoutes.iconsScreenName);
+                unawaited(context.pushNamed(DebugRoutes.iconsScreenName));
               },
               child: const Text('Экран с иконками'),
             ),
             const HBox(16),
             ElevatedButton(
               onPressed: () {
-                context.pushNamed(DebugRoutes.themeScreenName);
+                unawaited(context.pushNamed(DebugRoutes.themeScreenName));
               },
               child: const Text('Экран настроек темы'),
             ),
             const HBox(16),
             ElevatedButton(
               onPressed: () {
-                context.pushNamed(DebugRoutes.tokensScreenName);
+                unawaited(context.pushNamed(DebugRoutes.tokensScreenName));
               },
               child: const Text('Экран с токенами'),
             ),
             const HBox(16),
             ElevatedButton(
               onPressed: () {
-                context.pushNamed(DebugRoutes.uiKitScreenName);
+                unawaited(context.pushNamed(DebugRoutes.uiKitScreenName));
               },
               child: const Text('Экран UI Kit'),
             ),
             const HBox(16),
             ElevatedButton(
               onPressed: () {
-                context.pushNamed(DebugRoutes.langScreenName);
+                unawaited(context.pushNamed(DebugRoutes.langScreenName));
               },
               child: const Text('Экран локализации'),
             ),
             const HBox(16),
             ElevatedButton(
-              onPressed: () {
-                context.pushNamed(DebugRoutes.componentsScreenName);
+              onPressed: () async {
+                await context.pushNamed(DebugRoutes.componentsScreenName);
               },
               child: const Text('Экран компонентов'),
             ),

lib/features/debug/screens/icons_screen.dart

@@ -2,11 +2,16 @@ import 'package:flutter/material.dart';
 import 'package:friflex_starter/app/ui_kit/app_box.dart';
 import 'package:friflex_starter/gen/assets.gen.dart';
 
-/// {@template IconsScreen}
-///  Экран для отрисовки иконок
+/// {@template icons_screen}
+/// Экран для отображения всех доступных иконок приложения.
+///
+/// Отвечает за:
+/// - Отображение списка всех SVG иконок из assets/icons/
+/// - Предоставление возможности просмотра иконок для разработчиков
+/// - Демонстрацию использования системы генерации ресурсов
 /// {@endtemplate}
 class IconsScreen extends StatelessWidget {
-  /// {@macro IconsScreen}
+  /// {@macro icons_screen}
   const IconsScreen({super.key});
 
   @override
@@ -30,19 +35,20 @@ class IconsScreen extends StatelessWidget {
   }
 }
 
-// Приватный класс для реализации элемента списка иконок
+/// {@template item_icon}
+/// Виджет для отображения отдельной иконки в списке.
+///
+/// Отображает SVG иконку вместе с её названием файла
+/// для удобства идентификации в процессе разработки.
+/// {@endtemplate}
 class _ItemIcon extends StatelessWidget {
-  /// Создает экземпляр элемента списка иконок
-  ///
-  /// Принимает:
-  /// - [icon] - иконка
-  /// - [name] - название иконки
+  /// {@macro item_icon}
   const _ItemIcon({required this.icon, required this.name});
 
-  /// Иконка
+  /// SVG иконка для отображения
   final Widget icon;
 
-  /// Название иконки
+  /// Название файла иконки для идентификации
   final String name;
 
   @override

lib/features/debug/screens/lang_screen.dart

@@ -1,13 +1,18 @@
 import 'package:flutter/material.dart';
 import 'package:friflex_starter/app/app_context_ext.dart';
-import 'package:friflex_starter/gen/assets.gen.dart';
-import 'package:friflex_starter/gen/fonts.gen.dart';
+import 'package:friflex_starter/app/theme/app_colors_scheme.dart';
 
-/// {@template LangScreen}
-/// Экран для отладки языков приложения
+/// {@template lang_screen}
+/// Экран для отладки и тестирования локализации приложения.
+///
+/// Отвечает за:
+/// - Демонстрацию переключения между поддерживаемыми языками
+/// - Отображение локализованных строк с разными шрифтами
+/// - Тестирование системы локализации и шрифтов
+/// - Показ текущего языка приложения
 /// {@endtemplate}
 class LangScreen extends StatelessWidget {
-  /// {@macro LangScreen}
+  /// {@macro lang_screen}
   const LangScreen({super.key});
 
   @override
@@ -35,18 +40,12 @@ class LangScreen extends StatelessWidget {
             const SizedBox(height: 16),
             Text(
               'Тестовое слово  bold: ${context.l10n.helloWorld}',
-              style: TextStyle(
-                color: context.colors.testColor,
-                fontFamily: Assets.fonts.montserratBold,
-              ),
+              style: TextStyle(color: context.appColors.testColor),
             ),
             const SizedBox(height: 16),
             Text(
               'Тестовое слово  medium: ${context.l10n.helloWorld}',
-              style: TextStyle(
-                color: context.colors.testColor,
-                fontFamily: FontFamily.montserrat,
-              ),
+              style: TextStyle(color: context.appColors.testColor),
             ),
             const SizedBox(height: 16),
             Text('Текущий язык: ${context.l10n.localeName}'),

lib/features/debug/screens/theme_screen.dart

@@ -1,16 +1,23 @@
 import 'package:flutter/material.dart';
 import 'package:friflex_starter/app/app_context_ext.dart';
+import 'package:friflex_starter/app/theme/app_colors_scheme.dart';
 
-/// {@template ThemeScreen}
-///  Экран для отладки темы приложения
+/// {@template theme_screen}
+/// Экран для отладки и тестирования темы приложения.
+///
+/// Отвечает за:
+/// - Демонстрацию переключения между светлой и темной темами
+/// - Отображение тестовых цветов из цветовой схемы
+/// - Показ текущего режима темы
+/// - Тестирование системы управления темами
 /// {@endtemplate}
 class ThemeScreen extends StatelessWidget {
-  /// {@macro ThemeScreen}
+  /// {@macro theme_screen}
   const ThemeScreen({super.key});
 
   @override
   Widget build(BuildContext context) {
-    final colors = context.colors;
+    final colors = context.appColors;
     return Scaffold(
       appBar: AppBar(title: const Text('Theme')),
       body: Center(
@@ -25,7 +32,7 @@ class ThemeScreen extends StatelessWidget {
             ),
             const SizedBox(height: 16),
             ColoredBox(
-              color: context.colors.testColor,
+              color: context.appColors.testColor,
               child: const SizedBox(height: 100, width: 100),
             ),
             const SizedBox(height: 16),

lib/features/debug/screens/tokens_screen.dart

@@ -1,10 +1,17 @@
 import 'package:flutter/material.dart';
 
-/// {@template TokensScreen}
-///  Экран для отображения токенов
+/// {@template tokens_screen}
+/// Экран для отображения и управления токенами аутентификации.
+///
+/// Отвечает за:
+/// - Отображение текущих токенов доступа и обновления
+/// - Демонстрацию работы с токенами в приложении
+/// - Тестирование функциональности аутентификации
+///
+/// В текущей реализации является заглушкой для будущей функциональности.
 /// {@endtemplate}
 class TokensScreen extends StatelessWidget {
-  /// {@macro TokensScreen}
+  /// {@macro tokens_screen}
   const TokensScreen({super.key});
 
   @override

lib/features/debug/screens/ui_kit_screen.dart

@@ -1,11 +1,18 @@
 import 'package:flutter/material.dart';
 
-/// {@template UiKitScreen}
-///  Экран для отрисовки UI Kit
-///  и тестирования его компонентов.
+/// {@template ui_kit_screen}
+/// Экран для демонстрации и тестирования компонентов UI Kit.
+///
+/// Отвечает за:
+/// - Отображение всех доступных компонентов UI Kit
+/// - Демонстрацию использования кастомных виджетов
+/// - Тестирование стилей и тем оформления
+/// - Предоставление примера использования UI компонентов
+///
+/// В текущей реализации является заглушкой для будущих компонентов.
 /// {@endtemplate}
 class UiKitScreen extends StatelessWidget {
-  /// {@macro UiKitScreen}
+  /// {@macro ui_kit_screen}
   const UiKitScreen({super.key});
 
   @override

lib/features/main/data/repository/main_mock_repository.dart

@@ -1,9 +1,12 @@
 import 'package:friflex_starter/features/main/domain/repository/i_main_repository.dart';
 
 /// {@template MainMockRepository}
-///
+/// Мок реализация репозитория главного сервиса
 /// {@endtemplate}
 final class MainMockRepository implements IMainRepository {
+  /// {@macro MainMockRepository}
+  const MainMockRepository();
+
   @override
   String get name => 'MainMockRepository';
 }

lib/features/main/data/repository/main_repository.dart

@@ -1,13 +1,14 @@
-import 'package:friflex_starter/app/http/i_http_client.dart';
-
+import 'package:friflex_starter/app/http/app_http_client.dart';
 import 'package:friflex_starter/features/main/domain/repository/i_main_repository.dart';
 
 /// {@template MainRepository}
-///
+///  Реализация репозитория главного сервиса
 /// {@endtemplate}
 final class MainRepository implements IMainRepository {
   MainRepository({required this.httpClient});
-  final IHttpClient httpClient;
+
+  /// Экземпляр HTTP клиента для взаимодействия с сервером
+  final AppHttpClient httpClient;
 
   @override
   String get name => 'MainRepository';

lib/features/main/presentation/screens/main_screen.dart

@@ -1,3 +1,5 @@
+import 'dart:async';
+
 import 'package:flutter/material.dart';
 import 'package:friflex_starter/app/ui_kit/app_box.dart';
 import 'package:friflex_starter/features/main/presentation/main_routes.dart';
@@ -23,7 +25,7 @@ class MainScreen extends StatelessWidget {
             ElevatedButton(
               onPressed: () {
                 // Переход на экран с деталями
-                context.pushNamed(MainRoutes.mainDetailScreenName);
+                unawaited(context.pushNamed(MainRoutes.mainDetailScreenName));
               },
               child: const Text('Переход на экран с деталями'),
             ),

lib/features/profile/data/repository/profile_mock_repository.dart

@@ -1,9 +1,12 @@
 import 'package:friflex_starter/features/profile/domain/repository/i_profile_repository.dart';
 
 /// {@template ProfileMockRepository}
-///
+/// Мок реализация репозитория профиля пользователя
 /// {@endtemplate}
 final class ProfileMockRepository implements IProfileRepository {
+  /// {@macro ProfileMockRepository}
+  const ProfileMockRepository();
+
   @override
   String get name => 'ProfileMockRepository';
 

lib/features/profile/data/repository/profile_repository.dart

@@ -1,13 +1,15 @@
-import 'package:friflex_starter/app/http/i_http_client.dart';
+import 'package:friflex_starter/app/http/app_http_client.dart';
 
 import 'package:friflex_starter/features/profile/domain/repository/i_profile_repository.dart';
 
 /// {@template ProfileRepository}
-///
+///  Реализация репозитория профиля пользователя
 /// {@endtemplate}
 final class ProfileRepository implements IProfileRepository {
   ProfileRepository({required this.httpClient});
-  final IHttpClient httpClient;
+
+  /// Экземпляр HTTP клиента для взаимодействия с сервером
+  final AppHttpClient httpClient;
 
   @override
   String get name => 'ProfileRepository';

lib/features/profile/domain/bloc/profile_bloc.dart

@@ -5,19 +5,41 @@ import 'package:friflex_starter/features/profile/domain/repository/i_profile_rep
 part 'profile_event.dart';
 part 'profile_state.dart';
 
+/// {@template profile_bloc}
+/// Bloc для управления состоянием профиля пользователя.
+///
+/// Обрабатывает события загрузки данных профиля и управляет
+/// соответствующими состояниями (загрузка, успех, ошибка).
+/// {@endtemplate}
 class ProfileBloc extends Bloc<ProfileEvent, ProfileState> {
+  /// {@macro profile_bloc}
   ProfileBloc(this._profileRepository) : super(ProfileInitialState()) {
-    // Вам необходимо добавлять только
-    // один обработчик событий в конструкторе
+    // Регистрируем обработчики событий в конструкторе
     on<ProfileEvent>((event, emit) async {
+      // Обрабатываем событие загрузки профиля
       if (event is ProfileFetchProfileEvent) {
         await _fetchProfile(event, emit);
       }
+      // Обрабатываем событие выхода из профиля
+      else if (event is ProfileLogoutProfileEvent) {
+        await _logout(event, emit);
+      }
     });
   }
 
+  /// Репозиторий для работы с данными профиля
   final IProfileRepository _profileRepository;
 
+  /// Метод для загрузки данных профиля пользователя.
+  ///
+  /// Принимает:
+  /// - [event] - событие с ID пользователя для загрузки
+  /// - [emit] - функция для эмиссии состояний
+  ///
+  /// Последовательность состояний:
+  /// 1. ProfileWaitingState - начало загрузки
+  /// 2. ProfileSuccessState - успешная загрузка с данными
+  /// 3. ProfileErrorState - ошибка загрузки с сообщением
   Future<void> _fetchProfile(
     ProfileFetchProfileEvent event,
     Emitter<ProfileState> emit,
@@ -27,6 +49,7 @@ class ProfileBloc extends Bloc<ProfileEvent, ProfileState> {
       final data = await _profileRepository.fetchUserProfile(event.id);
       emit(ProfileSuccessState(data: data));
     } on Object catch (error, stackTrace) {
+      // Обработка ошибки при загрузке профиля
       emit(
         ProfileErrorState(
           message: 'Ошибка при загрузке профиля',
@@ -34,6 +57,19 @@ class ProfileBloc extends Bloc<ProfileEvent, ProfileState> {
           stackTrace: stackTrace,
         ),
       );
+      // Пробрасываем исключение в BlocObserver, для логирования или обработки
+      addError(error, stackTrace);
     }
   }
+
+  /// Метод для выхода из профиля пользователя.
+  Future<void> _logout(
+    ProfileLogoutProfileEvent event,
+    Emitter<ProfileState> emit,
+  ) async {
+    // Здесь можно добавить логику выхода из профиля
+    // Например, очистка токенов, данных пользователя и т.д.
+    // В данном примере просто эмитим начальное состояние
+    emit(ProfileInitialState());
+  }
 }

lib/features/profile/domain/bloc/profile_event.dart

@@ -1,16 +1,37 @@
 part of 'profile_bloc.dart';
 
+/// {@template profile_event}
+/// События для управления состоянием профиля пользователя.
+/// {@endtemplate}
 sealed class ProfileEvent extends Equatable {
+  /// {@macro profile_event}
   const ProfileEvent();
 
   @override
   List<Object> get props => [];
 }
 
+/// {@template profile_event}
+/// Событие для загрузки профиля пользователя.
+/// {@endtemplate}
 final class ProfileFetchProfileEvent extends ProfileEvent {
+  /// {@macro profile_event}
   const ProfileFetchProfileEvent({required this.id});
+
+  /// ID пользователя для загрузки профиля
   final String id;
 
   @override
   List<Object> get props => [id];
 }
+
+/// {@template profile_logout_event}
+/// Событие для выхода из профиля пользователя.
+/// {@endtemplate}
+final class ProfileLogoutProfileEvent extends ProfileEvent {
+  /// {@macro profile_logout_event}
+  const ProfileLogoutProfileEvent();
+
+  @override
+  List<Object> get props => [];
+}

lib/features/profile/presentation/screens/profile_screen.dart

@@ -3,17 +3,22 @@ import 'package:flutter_bloc/flutter_bloc.dart';
 import 'package:friflex_starter/app/app_context_ext.dart';
 import 'package:friflex_starter/features/profile/domain/bloc/profile_bloc.dart';
 
-// Класс экрана, где мы инициализируем ProfileBloc
-// и вызываем событие ProfileFetchProfileEvent
+/// {@template profile_screen}
+/// Экран профиля пользователя.
+///
+/// Отвечает за:
+/// - Инициализацию ProfileBloc с репозиторием профиля
+/// - Отображение данных профиля пользователя
+/// - Обработку состояний загрузки, успеха и ошибок
+/// {@endtemplate}
 class ProfileScreen extends StatelessWidget {
+  /// {@macro profile_screen}
   const ProfileScreen({super.key});
 
   @override
   Widget build(BuildContext context) {
     final profileRepository = context.di.repositories.profileRepository;
-    // Здесь мы инициализируем ProfileBloc
-    // и вызываем событие ProfileFetchProfileEvent
-    // Или любые другие события, которые вам нужны
+    // Инициализируем ProfileBloc с репозиторием и загружаем данные профиля
     return BlocProvider(
       create: (context) =>
           ProfileBloc(profileRepository)
@@ -23,8 +28,16 @@ class ProfileScreen extends StatelessWidget {
   }
 }
 
-/// Виджет, который отображает UI экрана
+/// {@template profile_screen_view}
+/// Виджет для отображения UI экрана профиля.
+///
+/// Отображает данные профиля в зависимости от состояния ProfileBloc:
+/// - Индикатор загрузки во время получения данных
+/// - Данные профиля при успешной загрузке
+/// - Сообщение об ошибке при неудачной загрузке
+/// {@endtemplate}
 class _ProfileScreenView extends StatelessWidget {
+  /// {@macro profile_screen_view}
   const _ProfileScreenView();
 
   @override

lib/features/root/root_screen.dart

@@ -1,39 +1,83 @@
+import 'dart:async';
+
 import 'package:flutter/material.dart';
+import 'package:flutter_bloc/flutter_bloc.dart';
 import 'package:friflex_starter/app/app_context_ext.dart';
-import 'package:friflex_starter/app/app_env.dart';
 import 'package:friflex_starter/features/debug/debug_routes.dart';
+import 'package:friflex_starter/features/update/domain/state/cubit/update_cubit.dart';
+import 'package:friflex_starter/features/update/presentation/components/soft_modal_sheet.dart';
 import 'package:go_router/go_router.dart';
 
-/// Класс для реализации корневой страницы приложения
-class RootScreen extends StatelessWidget {
-  /// Создает корневую страницу приложения
-  ///
-  /// Принимает:
-  /// - [navigationShell] - текущая ветка навигации
+/// {@template root_screen}
+/// Корневой экран приложения с навигационной структурой.
+///
+/// Отвечает за:
+/// - Отображение основного навигационного интерфейса
+/// - Управление переключением между основными разделами приложения
+/// - Отображение кнопки отладки в не-продакшн окружениях
+/// - Интеграцию с GoRouter для навигации
+/// {@endtemplate}
+class RootScreen extends StatefulWidget {
+  /// {@macro root_screen}
   const RootScreen({required this.navigationShell, super.key});
 
-  /// Текущая ветка навигации
+  /// Текущая ветка навигации от GoRouter
+  /// Содержит информацию о текущем состоянии навигации
   final StatefulNavigationShell navigationShell;
 
+  @override
+  State<RootScreen> createState() => _RootScreenState();
+}
+
+class _RootScreenState extends State<RootScreen> {
+  @override
+  void initState() {
+    super.initState();
+    // После построения виджета, проверяем состояние кубита обновлений
+    // и если есть обновление, то показываем модальное окно
+    _checkSoftUpdate();
+  }
+
+  /// Проверяет состояние кубита обновлений и показывает модальное окно при наличии мягкого обновления
+  void _checkSoftUpdate() {
+    WidgetsBinding.instance.addPostFrameCallback((_) {
+      final updateState = context.read<UpdateCubit>().state;
+
+      // Проверяем только состояние успеха с доступной информацией об обновлении
+      if (updateState is UpdateSuccessState &&
+          updateState.updateInfo.updateType == .soft) {
+        unawaited(
+          SoftUpdateModal.show(
+            context,
+            updateEntity: updateState.updateInfo,
+            onUpdate: () {
+              // TODO(yura): реализовать логику обновления приложения
+            },
+          ),
+        );
+      }
+    });
+  }
+
   @override
   Widget build(BuildContext context) {
     return Scaffold(
-      floatingActionButton: context.di.env != AppEnv.prod
+      floatingActionButton: context.di.env != .prod
           ? FloatingActionButton(
               child: const Icon(Icons.bug_report),
               onPressed: () {
-                context.pushNamed(DebugRoutes.debugScreenName);
+                unawaited(context.pushNamed(DebugRoutes.debugScreenName));
               },
             )
           : null,
-      body: navigationShell,
+      body: widget.navigationShell,
       bottomNavigationBar: BottomNavigationBar(
         items: const <BottomNavigationBarItem>[
-          BottomNavigationBarItem(icon: Icon(Icons.home), label: 'Home'),
+          BottomNavigationBarItem(icon: Icon(Icons.home), label: 'Главная'),
           BottomNavigationBarItem(icon: Icon(Icons.person), label: 'Профиль'),
         ],
-        currentIndex: navigationShell.currentIndex,
-        onTap: navigationShell.goBranch,
+        currentIndex: widget.navigationShell.currentIndex,
+        onTap: widget.navigationShell.goBranch,
       ),
     );
   }

lib/features/splash/splash_screen.dart

@@ -1,16 +0,0 @@
-import 'package:flutter/material.dart';
-import 'package:flutter/widgets.dart';
-import 'package:friflex_starter/gen/assets.gen.dart';
-
-/// {@template SplashScreen}
-/// Экран загрузки приложения.
-/// {@endtemplate}
-class SplashScreen extends StatelessWidget {
-  /// {@macro SplashScreen}
-  const SplashScreen({super.key});
-
-  @override
-  Widget build(BuildContext context) {
-    return Center(child: Assets.lottie.splash.lottie());
-  }
-}

lib/features/update/README.md

@@ -0,0 +1,88 @@
+# Модуль Hard/Soft Updates
+
+Модуль для управления обновлениями приложения. Поддерживает мягкие (soft) и обязательные (hard) обновления.
+
+## Ключевые сущности и состояния
+
+- **`UpdateEntity`**: доменная сущность с данными об обновлении
+  - `availableVersion`: доступная версия
+  - `updateUrl`: ссылка на обновление
+  - `updateType`: тип (`soft` | `hard`), см. `UpdateType`
+  - `whatIsNew`: описание изменений
+
+- **`UpdateType`**: перечисление типов обновления
+  - `UpdateType.soft`
+  - `UpdateType.hard`
+  - `UpdateType.none`
+
+- **`UpdateCubit`**: управление состоянием проверки обновлений
+  - Состояния: `UpdateInitialState`, `UpdateLoadingState`, `UpdateSuccessState(UpdateEntity?)`, `UpdateErrorState(message)`
+  - Метод: `checkForUpdates({required String versionCode, required String platform})`
+
+## Репозитории
+
+- **`IUpdateRepository`**: Интерфейс, описывающий методы для проверки обновлений.
+  - Возвращает `Future<UpdateEntity>` (не может быть `null`)
+
+- **`UpdateRepository`**: заготовка для реальной интеграции (бэкенд/стор)
+  - Реализуйте логику в `checkForUpdates`
+
+- **`UpdateMockRepository`**: мок-реализация для разработки/демо
+  - Возвращает фиктивное обновление (по умолчанию soft)
+
+## UI
+
+- **Soft update** — `SoftUpdateModal`
+  - BottomSheet с заголовком, списком изменений и кнопками: «Отложить» и «Обновить»
+  - Статический метод `show` безопасно не откроет модалку, если `updateEntity == null`
+
+Пример показа модального окна:
+```dart
+await SoftUpdateModal.show(
+  context,
+  updateEntity: updateEntity, // экземпляр UpdateEntity
+  onUpdate: () {
+    // TODO: переход в стор/браузер по updateEntity.updateUrl
+  },
+);
+```
+
+- **Hard update** — `HardUpdateScreen`
+  - Блокирующий экран, информирует и не даёт продолжить без обновления
+
+## Роуты
+
+- `UpdateRoutes.buildRoutes()` — регистрирует экран hard-обновления по пути `/update`
+
+
+## Структура модуля
+
+```
+features/update/
+├── data/
+│   └── repository/
+│       ├── update_repository.dart        # реализация для интеграции
+│       └── update_mock_repository.dart   # мок-репозиторий
+├── domain/
+│   ├── entity/
+│   │   └── update_entity.dart            # доменная сущность
+│   ├── repository/
+│   │   └── i_update_repository.dart      # контракт репозитория
+│   └── state/
+│       └── cubit/
+│           ├── update_cubit.dart         # кубит и логика
+│           └── update_state.dart         # состояния
+├── presentation/
+│   ├── components/
+│   │   └── soft_modal_sheet.dart         # модалка для soft-обновления
+│   └── screens/
+│       └── hard_update_screen.dart       # экран для hard-обновления
+├── update_type.dart                       # константы типов обновления
+└── update_routes.dart                     # роут на hard-экран
+```
+
+## Заметки по реализации
+
+- Для продакшена реализуйте переход в магазин или браузер по `updateUrl`
+- Для soft-обновления не блокируйте UX; для hard — перенаправляйте на блокирующий экран
+- Возвращайте `null` из репозитория, если обновлений нет

lib/features/update/data/repository/update_mock_repository.dart

@@ -0,0 +1,42 @@
+import 'package:friflex_starter/features/update/domain/entity/update_entity.dart';
+import 'package:friflex_starter/features/update/domain/repository/i_update_repository.dart';
+
+/// Мок обновления обязательное, можно использовать для тестирования
+const mockHardUpdateEntity = UpdateEntity(
+  availableVersion: '2.0.0',
+  updateUrl: 'https://example.com/update',
+  updateType: .hard,
+  whatIsNew: 'Добавлены новые функции и исправлены ошибки.',
+);
+
+/// Мок обновления мягкое, можно использовать для тестирования
+const mockSoftUpdateEntity = UpdateEntity(
+  availableVersion: '2.0.0',
+  updateUrl: 'https://example.com/update',
+  updateType: .soft,
+  whatIsNew: 'Добавлены новые функции и исправлены ошибки.',
+);
+
+/// {@template UpdateMockRepository}
+/// Репозиторий для моковой реализации проверки обновлений
+/// {@endtemplate}
+final class UpdateMockRepository implements IUpdateRepository {
+  /// {@macro UpdateMockRepository}
+  const UpdateMockRepository();
+
+  @override
+  Future<UpdateEntity> checkForUpdates({
+    required String versionCode,
+    required String platform,
+  }) async {
+    // Имитация задержки для асинхронной операции
+    await Future<void>.delayed(const Duration(seconds: 1));
+
+    // Возвращаем фиктивные данные об обновлении
+    // Можно возвращать [_mockHardUpdateEntity] или [_mockSoftUpdateEntity]
+    return mockSoftUpdateEntity;
+  }
+
+  @override
+  String get name => 'UpdateMockRepository';
+}

lib/features/update/data/repository/update_repository.dart

@@ -0,0 +1,27 @@
+import 'package:friflex_starter/app/http/app_http_client.dart';
+import 'package:friflex_starter/features/update/domain/entity/update_entity.dart';
+import 'package:friflex_starter/features/update/domain/repository/i_update_repository.dart';
+
+/// {@template UpdateRepository}
+///  Репозиторий для реализации проверки обновлений
+/// {@endtemplate}
+final class UpdateRepository implements IUpdateRepository {
+  /// {@macro UpdateRepository}
+  UpdateRepository({required this.httpClient});
+
+  /// Экземпляр HTTP клиента для взаимодействия с сервером
+  final AppHttpClient httpClient;
+
+  @override
+  Future<UpdateEntity> checkForUpdates({
+    required String versionCode,
+    required String platform,
+  }) {
+    // TODO: Реализовать реальную логику проверки обновлений
+    // Если обновления нет, возвращаем null
+    throw UnimplementedError();
+  }
+
+  @override
+  String get name => 'UpdateRepository';
+}

lib/features/update/domain/entity/update_entity.dart

@@ -0,0 +1,35 @@
+import 'package:equatable/equatable.dart';
+import 'package:friflex_starter/features/update/update_type.dart';
+
+/// {@template UpdateEntity}
+///  Сущность для представления информации об обновлении
+/// {@endtemplate}
+class UpdateEntity extends Equatable {
+  /// {@macro UpdateEntity}
+  const UpdateEntity({
+    required this.availableVersion,
+    required this.updateUrl,
+    required this.updateType,
+    required this.whatIsNew,
+  });
+
+  /// Доступная версия обновления
+  final String availableVersion;
+
+  /// URL для загрузки обновления
+  final String updateUrl;
+
+  /// Тип обновления (например, 'hard' или 'soft', или не требуется)
+  final UpdateType updateType;
+
+  /// Описание изменений в обновлении
+  final String whatIsNew;
+
+  @override
+  List<Object?> get props => [
+    availableVersion,
+    updateUrl,
+    updateType,
+    whatIsNew,
+  ];
+}

lib/features/update/domain/repository/i_update_repository.dart

@@ -0,0 +1,16 @@
+import 'package:friflex_starter/di/di_base_repo.dart';
+import 'package:friflex_starter/features/update/domain/entity/update_entity.dart';
+
+/// {@template IUpdateRepository}
+///  Интерфейс репозитория для Hard&Soft обновлений
+/// {@endtemplate}
+abstract interface class IUpdateRepository with DiBaseRepo {
+  /// Проверяет наличие обновлений
+  /// [versionCode] - текущий код версии приложения
+  /// [platform] - платформа (например, 'android' или 'ios')
+  /// Возвращает [UpdateEntity] с информацией об обновлении
+  Future<UpdateEntity> checkForUpdates({
+    required String versionCode,
+    required String platform,
+  });
+}

lib/features/update/domain/state/cubit/update_cubit.dart

@@ -0,0 +1,38 @@
+import 'package:equatable/equatable.dart';
+import 'package:flutter_bloc/flutter_bloc.dart';
+import 'package:friflex_starter/features/update/domain/entity/update_entity.dart';
+import 'package:friflex_starter/features/update/domain/repository/i_update_repository.dart';
+
+part 'update_state.dart';
+
+/// {@template UpdateCubit}
+/// Кубит для управления состояниями обновления приложения
+/// {@endtemplate}
+class UpdateCubit extends Cubit<UpdateState> {
+  /// {@macro UpdateCubit}
+  UpdateCubit(this._updatesRepository) : super(const UpdateInitialState());
+
+  /// Репозиторий для проверки обновлений
+  final IUpdateRepository _updatesRepository;
+
+  /// Метод для проверки доступности обновлений
+  /// [versionCode] - текущий код версии приложения
+  /// [platform] - платформа (например, 'android' или 'ios')
+  Future<void> checkForUpdates({
+    required String versionCode,
+    required String platform,
+  }) async {
+    if (state is UpdateLoadingState) return;
+    emit(const UpdateLoadingState());
+    try {
+      final updateInfo = await _updatesRepository.checkForUpdates(
+        versionCode: versionCode,
+        platform: platform,
+      );
+      emit(UpdateSuccessState(updateInfo));
+    } on Object catch (e, st) {
+      emit(UpdateErrorState(e.toString()));
+      addError(e, st);
+    }
+  }
+}

lib/features/update/domain/state/cubit/update_state.dart

@@ -0,0 +1,56 @@
+part of 'update_cubit.dart';
+
+/// {@template UpdateState}
+///  Состояния для управления процессом обновления приложения
+/// {@endtemplate}
+sealed class UpdateState extends Equatable {
+  /// {@macro UpdateState}
+  const UpdateState();
+
+  @override
+  List<Object?> get props => [];
+}
+
+/// {@template UpdateInitialState}
+///  Состояние начальной инициализации
+/// {@endtemplate}
+final class UpdateInitialState extends UpdateState {
+  /// {@macro UpdateInitialState}
+  const UpdateInitialState();
+}
+
+/// {@template UpdateLoadingState}
+///  Состояние загрузки информации об обновлении
+/// {@endtemplate}
+final class UpdateLoadingState extends UpdateState {
+  /// {@macro UpdateLoadingState}
+  const UpdateLoadingState();
+}
+
+/// {@template UpdateSuccessState}
+///  Состояние успешного получения информации об обновлении
+/// {@endtemplate}
+final class UpdateSuccessState extends UpdateState {
+  /// {@macro UpdateSuccessState}
+  const UpdateSuccessState(this.updateInfo);
+
+  /// Информация об обновлении
+  final UpdateEntity updateInfo;
+
+  @override
+  List<Object?> get props => [updateInfo];
+}
+
+/// {@template UpdateErrorState}
+///  Состояние ошибки при получении информации об обновлении
+/// {@endtemplate}
+final class UpdateErrorState extends UpdateState {
+  /// {@macro UpdateErrorState}
+  const UpdateErrorState(this.message);
+
+  /// Сообщение об ошибке в UI
+  final String message;
+
+  @override
+  List<Object> get props => [message];
+}

lib/features/update/presentation/components/soft_modal_sheet.dart

@@ -0,0 +1,103 @@
+import 'package:flutter/material.dart';
+import 'package:friflex_starter/app/ui_kit/app_box.dart';
+import 'package:friflex_starter/features/update/domain/entity/update_entity.dart';
+import 'package:go_router/go_router.dart';
+
+/// {@template soft_update_modal}
+/// Модальное окно для уведомления о доступности новой версии приложения.
+///
+/// Отвечает за:
+/// - Отображение информации о новой версии приложения
+/// - Предоставление возможности обновления или отложения
+/// - Показ описания изменений в новой версии
+/// - Мягкое уведомление пользователя без принуждения к обновлению
+/// {@endtemplate}
+class SoftUpdateModal extends StatelessWidget {
+  /// {@macro soft_update_modal}
+  const SoftUpdateModal({required this.updateEntity, this.onUpdate, super.key});
+
+  /// Информация об обновлении
+  final UpdateEntity updateEntity;
+
+  /// Обратный вызов при нажатии "Обновить"
+  final VoidCallback? onUpdate;
+
+  @override
+  Widget build(BuildContext context) {
+    return Padding(
+      padding: const EdgeInsets.all(24),
+      child: Column(
+        mainAxisSize: MainAxisSize.min,
+        crossAxisAlignment: CrossAxisAlignment.start,
+        children: [
+          // Заголовок
+          Text(
+            'Доступна новая версия: ${updateEntity.availableVersion} ',
+            style: Theme.of(
+              context,
+            ).textTheme.headlineSmall?.copyWith(fontWeight: FontWeight.bold),
+          ),
+
+          const HBox(16),
+
+          // Описание изменений
+          Text(
+            'Что нового:',
+            style: Theme.of(
+              context,
+            ).textTheme.titleMedium?.copyWith(fontWeight: FontWeight.w600),
+          ),
+          const HBox(8),
+          Text(
+            updateEntity.whatIsNew,
+            style: Theme.of(context).textTheme.bodyMedium,
+          ),
+
+          const HBox(24),
+
+          // Кнопки действий
+          Row(
+            children: [
+              Expanded(
+                child: OutlinedButton(
+                  onPressed: () {
+                    context.pop();
+                  },
+                  child: const Text('Отложить'),
+                ),
+              ),
+              const WBox(12),
+              Expanded(
+                child: ElevatedButton(
+                  onPressed: () {
+                    context.pop();
+                    onUpdate?.call();
+                  },
+                  child: const Text('Обновить'),
+                ),
+              ),
+            ],
+          ),
+        ],
+      ),
+    );
+  }
+
+  /// Показать модальное окно обновления
+  ///
+  /// [context] - контекст для отображения модального окна
+  /// [updateEntity] - информация об обновлении
+  /// [onUpdate] - функция при нажатии "Обновить"
+  static Future<void> show(
+    BuildContext context, {
+    required UpdateEntity updateEntity,
+    VoidCallback? onUpdate,
+  }) {
+    return showModalBottomSheet<void>(
+      context: context,
+      isScrollControlled: true,
+      builder: (context) =>
+          SoftUpdateModal(updateEntity: updateEntity, onUpdate: onUpdate),
+    );
+  }
+}

lib/features/update/presentation/screens/hard_update_screen.dart

@@ -0,0 +1,42 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_bloc/flutter_bloc.dart';
+import 'package:friflex_starter/app/ui_kit/app_box.dart';
+import 'package:friflex_starter/features/update/domain/state/cubit/update_cubit.dart';
+
+/// Блокирующий экран для обязательного обновления приложения
+class HardUpdateScreen extends StatelessWidget {
+  const HardUpdateScreen({super.key});
+
+  @override
+  Widget build(BuildContext context) {
+    return Scaffold(
+      appBar: AppBar(title: const Text('Hard Обновление')),
+      body: Center(
+        child: BlocBuilder<UpdateCubit, UpdateState>(
+          builder: (context, updateCubitState) {
+            final updateEntity = updateCubitState is UpdateSuccessState
+                ? updateCubitState.updateInfo
+                : null;
+            return Column(
+              children: [
+                const Text(
+                  'Доступна новая версия приложения. Пожалуйста, обновите его.',
+                ),
+                const HBox(16),
+                Text(
+                  'Доступная версия: ${updateEntity?.availableVersion ?? ''}',
+                ),
+                const HBox(8),
+                Text('Что нового: ${updateEntity?.whatIsNew ?? ''}'),
+                const HBox(8),
+                Text('Тип обновления: ${updateEntity?.updateType ?? ''}'),
+                const HBox(8),
+                Text('URL для обновления: ${updateEntity?.updateUrl ?? ''}'),
+              ],
+            );
+          },
+        ),
+      ),
+    );
+  }
+}

lib/features/update/update_routes.dart

@@ -0,0 +1,20 @@
+import 'package:friflex_starter/features/update/presentation/screens/hard_update_screen.dart';
+import 'package:go_router/go_router.dart';
+
+abstract final class UpdateRoutes {
+  /// Название роута главной страницы
+  static const String hardUpdateScreenName = 'update_screen';
+
+  /// Путь роута экрана обновления
+  static const String _hardUpdateScreenPath = '/update';
+
+  /// Метод для построения роутов по Update
+  ///
+  /// Принимает:
+  /// - [routes] - вложенные роуты
+  static GoRoute buildRoutes({List<RouteBase> routes = const []}) => GoRoute(
+    path: _hardUpdateScreenPath,
+    name: hardUpdateScreenName,
+    builder: (context, state) => const HardUpdateScreen(),
+  );
+}

lib/features/update/update_type.dart

@@ -0,0 +1,13 @@
+/// {@template UpdateType}
+///  Тип обновления
+/// {@endtemplate}
+enum UpdateType {
+  /// Обязательное обновление
+  hard,
+
+  /// Мягкое обновление
+  soft,
+
+  /// Не требуется обновление
+  none,
+}

lib/gen/assets.gen.dart

@@ -1,3 +1,5 @@
+// dart format width=80
+
 /// GENERATED CODE - DO NOT MODIFY BY HAND
 /// *****************************************************
 ///  FlutterGen
@@ -5,7 +7,7 @@
 
 // coverage:ignore-file
 // ignore_for_file: type=lint
-// ignore_for_file: directives_ordering,unnecessary_import,implicit_dynamic_list_literal,deprecated_member_use
+// ignore_for_file: deprecated_member_use,directives_ordering,implicit_dynamic_list_literal,unnecessary_import
 
 import 'package:flutter/services.dart';
 import 'package:flutter/widgets.dart';
@@ -13,34 +15,6 @@ import 'package:flutter_svg/flutter_svg.dart' as _svg;
 import 'package:lottie/lottie.dart' as _lottie;
 import 'package:vector_graphics/vector_graphics.dart' as _vg;
 
-class $AssetsFontsGen {
-  const $AssetsFontsGen();
-
-  /// File path: assets/fonts/Montserrat-Bold.ttf
-  String get montserratBold => 'assets/fonts/Montserrat-Bold.ttf';
-
-  /// File path: assets/fonts/Montserrat-ExtraBold.ttf
-  String get montserratExtraBold => 'assets/fonts/Montserrat-ExtraBold.ttf';
-
-  /// File path: assets/fonts/Montserrat-Medium.ttf
-  String get montserratMedium => 'assets/fonts/Montserrat-Medium.ttf';
-
-  /// File path: assets/fonts/Montserrat-Regular.ttf
-  String get montserratRegular => 'assets/fonts/Montserrat-Regular.ttf';
-
-  /// File path: assets/fonts/Montserrat-SemiBold.ttf
-  String get montserratSemiBold => 'assets/fonts/Montserrat-SemiBold.ttf';
-
-  /// List of all assets
-  List<String> get values => [
-        montserratBold,
-        montserratExtraBold,
-        montserratMedium,
-        montserratRegular,
-        montserratSemiBold
-      ];
-}
-
 class $AssetsIconsGen {
   const $AssetsIconsGen();
 
@@ -63,25 +37,18 @@ class $AssetsLottieGen {
 }
 
 class Assets {
-  Assets._();
+  const Assets._();
 
-  static const $AssetsFontsGen fonts = $AssetsFontsGen();
   static const $AssetsIconsGen icons = $AssetsIconsGen();
   static const $AssetsLottieGen lottie = $AssetsLottieGen();
 }
 
 class SvgGenImage {
-  const SvgGenImage(
-    this._assetName, {
-    this.size,
-    this.flavors = const {},
-  }) : _isVecFormat = false;
+  const SvgGenImage(this._assetName, {this.size, this.flavors = const {}})
+    : _isVecFormat = false;
 
-  const SvgGenImage.vec(
-    this._assetName, {
-    this.size,
-    this.flavors = const {},
-  }) : _isVecFormat = true;
+  const SvgGenImage.vec(this._assetName, {this.size, this.flavors = const {}})
+    : _isVecFormat = true;
 
   final String _assetName;
   final Size? size;
@@ -102,6 +69,7 @@ class SvgGenImage {
     String? semanticsLabel,
     bool excludeFromSemantics = false,
     _svg.SvgTheme? theme,
+    _svg.ColorMapper? colorMapper,
     ColorFilter? colorFilter,
     Clip clipBehavior = Clip.hardEdge,
     @deprecated Color? color,
@@ -121,6 +89,7 @@ class SvgGenImage {
         assetBundle: bundle,
         packageName: package,
         theme: theme,
+        colorMapper: colorMapper,
       );
     }
     return _svg.SvgPicture(
@@ -135,7 +104,8 @@ class SvgGenImage {
       placeholderBuilder: placeholderBuilder,
       semanticsLabel: semanticsLabel,
       excludeFromSemantics: excludeFromSemantics,
-      colorFilter: colorFilter ??
+      colorFilter:
+          colorFilter ??
           (color == null ? null : ColorFilter.mode(color, colorBlendMode)),
       clipBehavior: clipBehavior,
       cacheColorFilter: cacheColorFilter,
@@ -148,10 +118,7 @@ class SvgGenImage {
 }
 
 class LottieGenImage {
-  const LottieGenImage(
-    this._assetName, {
-    this.flavors = const {},
-  });
+  const LottieGenImage(this._assetName, {this.flavors = const {}});
 
   final String _assetName;
   final Set<String> flavors;
@@ -168,11 +135,8 @@ class LottieGenImage {
     _lottie.LottieImageProviderFactory? imageProviderFactory,
     Key? key,
     AssetBundle? bundle,
-    Widget Function(
-      BuildContext,
-      Widget,
-      _lottie.LottieComposition?,
-    )? frameBuilder,
+    Widget Function(BuildContext, Widget, _lottie.LottieComposition?)?
+    frameBuilder,
     ImageErrorWidgetBuilder? errorBuilder,
     double? width,
     double? height,
@@ -182,6 +146,9 @@ class LottieGenImage {
     bool? addRepaintBoundary,
     FilterQuality? filterQuality,
     void Function(String)? onWarning,
+    _lottie.LottieDecoder? decoder,
+    _lottie.RenderCache? renderCache,
+    bool? backgroundLoading,
   }) {
     return _lottie.Lottie.asset(
       _assetName,
@@ -206,6 +173,9 @@ class LottieGenImage {
       addRepaintBoundary: addRepaintBoundary,
       filterQuality: filterQuality,
       onWarning: onWarning,
+      decoder: decoder,
+      renderCache: renderCache,
+      backgroundLoading: backgroundLoading,
     );
   }