feat(update): добавить модуль управления Hard & Soft обновлений (#30)

1. Реализован интерфейс и репозитории для проверки обновлений. 2. Добавлены состояния и кубит для управления процессом обновления. 3. Созданы UI-компоненты для отображения информации об обновлениях. 4. Обновлен README.md с описанием нового модуля и его интеграции
2025-12-22 17:40:45 +00:00 · 2025-09-26 08:21:42 +03:00
parent e1fb99c86f
commit 8710792c4b
20 changed files with 664 additions and 56 deletions
--- a/lib/features/update/presentation/components/soft_modal_sheet.dart
+++ b/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),
+    );
+  }
+}