refactor(router): улучшить обработку ошибок при создании роутера

refactor(app): изменить AppRoot на StatefulWidget и переместить инициализацию роутера

.agent/skills/flutter_dev/SKILL.md

@@ -1,32 +0,0 @@
----
-name: flutter_dev
-description: Скилл для разработки Flutter-приложений по стандартам компании Friflex. Используйте этот скилл при написании кода, создании новых фич, проведении ревью или настройке архитектуры проекта. Включает правила именования, структуру слоев (data/domain/presentation) и стандарты Git.
----
-
-# Flutter Dev Skill (Friflex Standards)
-
-Этот скилл содержит набор правил и инструкций для разработки Flutter-приложений. Основная цель — соблюдение единого стиля кода, архитектурных подходов и процессов разработки.
-
-## Основные принципы
-
-1.  **Архитектура**: Проект делится на слои: `data`, `domain` и `presentation`.
-2.  **Именование**: Интерфейсы всегда начинаются с префикса `I`. Экраны имеют постфикс `Screen`.
-3.  **Документация**: Весь публичный API должен быть покрыт документацией `///`.
-4.  **Git**: Коммиты и PR на русском языке по стандарту Conventional Commits.
-
-## Справочники (References)
-
-Для получения детальной информации по конкретным областям обращайтесь к следующим файлам:
-
-- [Правила именования и стиль кода](references/codestyle.md) — именование классов, методов, переменных и структура файлов.
-- [Структура проекта и слои](references/project_structure.md) — детальное описание папок и взаимодействия между уровнями архитектуры.
-- [Работа с Git и ветками](references/gitflow.md) — типы коммитов, именование веток и процессы релизов.
-- [Документирование кода](references/documentation.md) — стандарты `///`, использование шаблонов и правила для TODO.
-- [Стандарты проекта](references/project_standards.md) — управление сгенерированными файлами, `pubspec.lock` и сборка.
-
-## Когда использовать этот скилл
-
-- При создании новых классов или файлов (проверка именования).
-- При реализации новой feature (выбор структуры папок).
-- Перед созданием Pull Request (проверка соответствия стандартам).
-- При возникновении вопросов по архитектурному взаимодействию слоев.

.agent/skills/flutter_dev/references/codestyle.md

@@ -1,34 +0,0 @@
-# Правила именования и стиль кода
-
-Мы придерживаемся рекомендаций **Effective Dart** и внутренних правил компании.
-
-## Именование
-
-### Интерфейсы
-- Начинаются с заглавной буквы **I**.
-- Пример: `IAuthRepository`, `IUserRepository`.
-
-### Классы и файлы
-- **Классы**: `UpperCamelCase`. Приватные — с префиксом `_`. Должны содержать тип в конце (например, `UserEntity`).
-- **Файлы**: `snake_case`. Структура: `[раздел]_[тип].dart`. Пример: `user_details_screen.dart`.
-
-### Репозитории
-- Основная реализация — без постфикса (`AuthRepository`).
-- Альтернативные реализации — с постфиксами: `Network`, `Local`, `Mock`.
-
-### Виджеты
-- **Экраны**: Постфикс `Screen` (`ShopListScreen`).
-- **Контент экрана**: Постфикс `View` (`ShopListView`).
-- **Глобальные виджеты**: Префикс `App` (`AppButton`).
-- В названии **не должно** быть слова `widget`.
-
-## Методы и переменные
-- **Методы**: Начинаются с глагола (`fetch`, `put`, `update`, `delete`). Не должны содержать `And/Or`.
-- **Переменные/Константы**: `lowerCamelCase`.
-
-## Структура класса (порядок элементов)
-1. Конструкторы (default, named, factory).
-2. Static элементы (methods, const fields).
-3. Инстанс-поля (final, потом обычные; public, потом private).
-4. Геттеры/Сеттеры.
-5. Методы (overridden, public, protected, private).

.agent/skills/flutter_dev/references/documentation.md

@@ -1,29 +0,0 @@
-# Документирование кода
-
-## Документация (///)
-- Оформляется с использованием `///` над объектом.
-- Обязательна для всех классов, конструкторов, полей, методов и фабрик.
-- Должна быть краткой, емкой и указывать на назначение.
-
-### Шаблоны
-- **Классы**: Используйте `{@template name}` и `{@endtemplate}`.
-- **Конструкторы**: Если один — `{@macro name}`.
-- **Параметры**: Используйте ссылки в квадратных скобках `[paramName]`.
-
-### Пример метода
-```dart
-/// Метод для расчета температуры.
-/// Принимает:
-/// - [grad] - параметр для расчета.
-/// Возвращает температуру в градусах. Null при ошибке.
-int? calcTemperature({required int grad}) { ... }
-```
-
-## Комментарии (//)
-- Используются только там, где код не очевиден.
-- Не должны повторять то, что и так понятно из имен переменных или структуры.
-
-## TODO
-- Формат определяется линтером.
-- Указывать имя разработчика в контексте.
-- Указывать ссылку на задачу в скобках, если она известна.

.agent/skills/flutter_dev/references/gitflow.md

@@ -1,26 +0,0 @@
-# Работа с Git и ветками
-
-## Pull Requests
-- Язык описания — **Русский**.
-- Описание должно содержать суть изменений, ссылку на задачу и список deprecated-кода.
-
-## Коммиты (Conventional Commits)
-Типы:
-- `feat`: Новая функциональность.
-- `fix`: Исправление ошибок.
-- `refactor`: Рефакторинг без смены логики.
-- `docs`: Документация.
-- `chore`: Инструменты, зависимости (`pubspec.yaml`).
-- `test`, `build`, `ci`.
-
-## Именование веток
-Формат: `тип/PRIME-номер_описание`
-- `feat/PRIME-123_auth`
-- `fix/PRIME-456_typo`
-
-## Процесс Feature-разработки
-1. Создаем ветку от `main`.
-2. Вносим изменения, делаем коммиты.
-3. PR с названием по правилам (например, `feat(auth): PRIME-17 Добавить вход`).
-4. После Review — **squash commit** в `main`.
-5. Удаление ветки.

.agent/skills/flutter_dev/references/project_standards.md

@@ -1,26 +0,0 @@
-# Стандарты проекта
-
-## Управление файлами
-
-### Сгенерированные файлы (*.g.dart, *.freezed.dart)
-- **Хранить в репозитории**.
-- Это обеспечивает работоспособность `main` ветки сразу после чекаута без долгого ожидания генерации.
-- Нужно контролировать конфликты при слиянии и периодически актуализировать.
-
-### pubspec.lock
-- **Хранить** для приложений (applications).
-- **Не хранить** для пакетов (packages).
-- По умолчанию хранить GMS версию как базовую.
-
-## Сборка и запуск
-- Используйте анализатор `friflex_lint_rules`.
-- Перед созданием PR обязательно:
-  1. Форматирование кода (`dart format`).
-  2. Проверка анализатором на отсутствие ошибок.
-
-## Технологический стек
-- Роутинг: `go_router`.
-- State Manager: `flutter_bloc`.
-- DI: Ручная реализация через `InheritedWidget`.
-- API: `dio`.
-- Ресурсы: `flutter_gen`.

.agent/skills/flutter_dev/references/project_structure.md

@@ -1,33 +0,0 @@
-# Структура проекта
-
-Проект строится на основе фич и слоев.
-
-## Общая иерархия
-- `/assets` — графические ресурсы.
-- `/lib` — основной код.
-  - `/app` — глобальные настройки, интерфейсы и реализации.
-  - `/di` — конфигурация зависимостей.
-  - `/routing` — описание путей.
-  - `/features` — функциональные модули приложения.
-  - `/gen` — сгенерированный код.
-
-## Структура Feature-папки
-Каждая фича делится на три слоя:
-
-1. **Data** (Поставщик данных):
-   - `/dto` — модели данных для API.
-   - `/repository` — реализация интерфейсов репозиториев.
-2. **Domain** (Бизнес-логика):
-   - `/entity` — чистые модели для использования в UI.
-   - `/repository` — **интерфейсы** репозиториев.
-   - `/state` — управление состоянием (BLoC).
-   - `/service` — реализации бизнес-сервисов.
-3. **Presentation** (Представление):
-   - `/screens` — виджеты экранов (`*Screen`).
-   - `/components` — переиспользуемые компоненты внутри фичи.
-
-## Правила взаимодействия
-- **Data** → доступ к **Entity** (для маппинга), не знает про UI.
-- **Domain** → не знает про **Data** (работает через интерфейсы) и **Presentation**.
-- **Presentation** → работает через **Domain**, не знает про **Data**.
-- Объекты внутри фичи инкапсулированы. Глобальные объекты выносятся в `/app`.

.metadata

@@ -4,7 +4,7 @@
 # This file should be version controlled and should not be manually edited.
 
 version:
-  revision: "66dd93f9a27ffe2a9bfc8297506ce066ff51265f"
+  revision: "be698c48a6750c8cb8e61c740ca9991bb947aba2"
   channel: "stable"
 
 project_type: app
@@ -13,11 +13,11 @@ project_type: app
 migration:
   platforms:
     - platform: root
-      create_revision: 66dd93f9a27ffe2a9bfc8297506ce066ff51265f
+      create_revision: be698c48a6750c8cb8e61c740ca9991bb947aba2
-      base_revision: 66dd93f9a27ffe2a9bfc8297506ce066ff51265f
+      base_revision: be698c48a6750c8cb8e61c740ca9991bb947aba2
-    - platform: web
+    - platform: android
-      create_revision: 66dd93f9a27ffe2a9bfc8297506ce066ff51265f
+      create_revision: be698c48a6750c8cb8e61c740ca9991bb947aba2
-      base_revision: 66dd93f9a27ffe2a9bfc8297506ce066ff51265f
+      base_revision: be698c48a6750c8cb8e61c740ca9991bb947aba2
 
   # User provided section
 

lib/app/app_root.dart

@@ -6,6 +6,7 @@ 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:friflex_starter/router/app_router.dart';
 import 'package:go_router/go_router.dart';
 
 /// {@template app}
@@ -13,21 +14,39 @@ import 'package:go_router/go_router.dart';
 ///
 /// Отвечает за:
 /// - Настройку провайдеров для темы и локализации
+/// - Инициализацию роутера приложения
 /// {@endtemplate}
-class AppRoot extends StatelessWidget {
+class AppRoot extends StatefulWidget {
   /// {@macro app_root}
-  const AppRoot({required this.diContainer, required this.router, super.key});
+  const AppRoot({required this.diContainer, super.key});
 
   /// Контейнер зависимостей
   final DiContainer diContainer;
 
+  @override
+  State<AppRoot> createState() => _AppRootState();
+}
+
+class _AppRootState extends State<AppRoot> {
   /// Роутер приложения
-  final GoRouter router;
+  late final GoRouter router;
+
+  @override
+  void initState() {
+    super.initState();
+    router = AppRouter.createRouter(widget.diContainer.debugService);
+  }
+
+  @override
+  void dispose() {
+    router.dispose();
+    super.dispose();
+  }
 
   @override
   Widget build(BuildContext context) {
     return AppProviders(
-      diContainer: diContainer,
+      diContainer: widget.diContainer,
       child: LocalizationConsumer(
         builder: (localizationContext) {
           return ThemeConsumer(

lib/features/update/README.md

@@ -37,7 +37,6 @@
   - Статический метод `show` безопасно не откроет модалку, если `updateEntity == null`
 
 Пример показа модального окна:
-
 ```dart
 await SoftUpdateModal.show(
   context,
@@ -55,9 +54,10 @@ await SoftUpdateModal.show(
 
 - `UpdateRoutes.buildRoutes()` — регистрирует экран hard-обновления по пути `/update`
 
+
 ## Структура модуля
 
-```md
+```
 features/update/
 ├── data/
 │   └── repository/

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

@@ -26,7 +26,7 @@ final class UpdateMockRepository implements IUpdateRepository {
 
   @override
   Future<UpdateEntity> checkForUpdates({
-    required String versionApp,
+    required String versionCode,
     required String platform,
   }) async {
     // Имитация задержки для асинхронной операции

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

@@ -14,7 +14,7 @@ final class UpdateRepository implements IUpdateRepository {
 
   @override
   Future<UpdateEntity> checkForUpdates({
-    required String versionApp,
+    required String versionCode,
     required String platform,
   }) {
     // TODO: Реализовать реальную логику проверки обновлений

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

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

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

@@ -16,17 +16,17 @@ class UpdateCubit extends Cubit<UpdateState> {
   final IUpdateRepository _updatesRepository;
 
   /// Метод для проверки доступности обновлений
-  /// [versionApp] - текущая версия приложения
+  /// [versionCode] - текущий код версии приложения
   /// [platform] - платформа (например, 'android' или 'ios')
   Future<void> checkForUpdates({
-    required String versionApp,
+    required String versionCode,
     required String platform,
   }) async {
     if (state is UpdateLoadingState) return;
     emit(const UpdateLoadingState());
     try {
       final updateInfo = await _updatesRepository.checkForUpdates(
-        versionApp: versionApp,
+        versionCode: versionCode,
         platform: platform,
       );
       emit(UpdateSuccessState(updateInfo));

lib/router/app_router.dart

@@ -23,7 +23,20 @@ class AppRouter {
 
   /// Метод для создания экземпляра GoRouter
   static GoRouter createRouter(IDebugService debugService) {
-    return GoRouter(
+    try {
+      return _init(debugService);
+    } on Object catch (error, stackTrace) {
+      debugService.logError(
+        'Ошибка при создании роутера',
+        error: error,
+        stackTrace: stackTrace,
+      );
+      throw StateError('Не удалось создать роутер: $error');
+    }
+  }
+
+  /// Внутренний метод для инициализации роутера
+  static GoRouter _init(IDebugService debugService) => GoRouter(
     navigatorKey: rootNavigatorKey,
     initialLocation: initialLocation,
     observers: [debugService.routeObserver],
@@ -41,5 +54,4 @@ class AppRouter {
       UpdateRoutes.buildRoutes(),
     ],
   );
-  }
 }

lib/runner/app_runner.dart

@@ -10,7 +10,6 @@ import 'package:friflex_starter/di/di_container.dart';
 import 'package:friflex_starter/features/debug/debug_service.dart';
 import 'package:friflex_starter/features/debug/i_debug_service.dart';
 import 'package:friflex_starter/features/error/error_screen.dart';
-import 'package:friflex_starter/router/app_router.dart';
 import 'package:friflex_starter/runner/timer_runner.dart';
 import 'package:go_router/go_router.dart';
 
@@ -33,7 +32,7 @@ class AppRunner {
   /// Тип окружения сборки приложения¬
   final AppEnv env;
 
-  /// Сервис отладки
+  /// Контейнер зависимостей приложения
   late IDebugService _debugService;
 
   /// Роутер приложения
@@ -57,9 +56,6 @@ class AppRunner {
       // Инициализация приложения
       await _initApp();
 
-      // Инициализация роутера
-      router = AppRouter.createRouter(_debugService);
-
       final diContainer = await _initDependencies(
         debugService: _debugService,
         env: env,
@@ -67,7 +63,7 @@ class AppRunner {
       );
       // Инициализация метода обработки ошибок
       _initErrorHandlers(_debugService);
-      runApp(AppRoot(diContainer: diContainer, router: router));
+      runApp(AppRoot(diContainer: diContainer));
       await _onAppLoaded();
     } on Object catch (e, stackTrace) {
       await _onAppLoaded();