app updated

Author: Alpusa

.metadata

@@ -18,21 +18,6 @@ migration:
     - platform: android
       create_revision: 2663184aa79047d0a33a14a3b607954f8fdd8730
       base_revision: 2663184aa79047d0a33a14a3b607954f8fdd8730
-    - platform: ios
-      create_revision: 2663184aa79047d0a33a14a3b607954f8fdd8730
-      base_revision: 2663184aa79047d0a33a14a3b607954f8fdd8730
-    - platform: linux
-      create_revision: 2663184aa79047d0a33a14a3b607954f8fdd8730
-      base_revision: 2663184aa79047d0a33a14a3b607954f8fdd8730
-    - platform: macos
-      create_revision: 2663184aa79047d0a33a14a3b607954f8fdd8730
-      base_revision: 2663184aa79047d0a33a14a3b607954f8fdd8730
-    - platform: web
-      create_revision: 2663184aa79047d0a33a14a3b607954f8fdd8730
-      base_revision: 2663184aa79047d0a33a14a3b607954f8fdd8730
-    - platform: windows
-      create_revision: 2663184aa79047d0a33a14a3b607954f8fdd8730
-      base_revision: 2663184aa79047d0a33a14a3b607954f8fdd8730
 
   # User provided section
 

README.md

@@ -14,3 +14,51 @@ A few resources to get you started if this is your first Flutter project:
 For help getting started with Flutter development, view the
 [online documentation](https://docs.flutter.dev/), which offers tutorials,
 samples, guidance on mobile development, and a full API reference.
+
+
+## File Structure
+
+lib/
+├── core/
+│   ├── constants/
+│   │   └── app_routes.dart 
+│   └── utils/
+│       └── validators.dart
+│   └── themes/
+│       └── dark_schemes.dart
+│       └── light_schemes.dart
+│       └── material_theme.dart
+│       └── theme_utils.dart
+├── data/
+│   ├── datasources/
+│   │   └── local_data_source.dart
+│   ├── models/
+│   │   └── task_model.dart
+│   ├── repositories/
+│       └── task_repository_impl.dart
+├── domain/
+│   ├── entities/
+│   │   └── task.dart
+│   ├── repositories/
+│   │   └── task_repository.dart
+│   ├── usecases/
+│       └── add_task.dart
+│       └── delete_task.dart
+│       └── get_tasks.dart
+│       └── update_task.dart
+├── l10n/
+│    ├── intl_en.arb
+│    ├── intl_es.arb
+├── presentation/
+│    ├── bloc/
+│    │   ├── task_bloc.dart
+│    │   ├── task_event.dart
+│    │   ├── task_state.dart
+│    ├── pages/
+│    │   └── task_page.dart
+│    ├── widgets/
+│        └── task_list.dart
+│        └── task_item.dart
+│
+├── injection_container.dart
+├── main.dart

lib/core/constants/app_routes.dart

@@ -1,3 +1,4 @@
+// In this file you can find all the routes of the application
 class AppRoutes {
   static const String home = '/';
 }

lib/core/themes/dark_schemes.dart

@@ -1,8 +1,8 @@
 import 'package:flutter/material.dart';
 
-/// Esquemas de colores para Dark Theme
+/// Color schemes for Dark Theme
 class DarkSchemes {
-  /// Esquema de colores para Dark Theme (Contraste Bajo)
+  /// Color scheme for Dark Theme (Low Contrast)
   static ColorScheme darkScheme() {
     return const ColorScheme(
       brightness: Brightness.dark,
@@ -54,7 +54,7 @@ class DarkSchemes {
     );
   }
 
-  /// Esquema de colores para Dark Theme (Contraste Medio)
+  /// Color scheme for Dark Theme (Medium Contrast)
   static ColorScheme darkMediumContrastScheme() {
     return const ColorScheme(
       brightness: Brightness.dark,
@@ -106,7 +106,7 @@ class DarkSchemes {
     );
   }
 
-  /// Esquema de colores para Dark Theme (Contraste Alto)
+  /// Dark Theme color scheme (High Contrast)
   static ColorScheme darkHighContrastScheme() {
     return const ColorScheme(
       brightness: Brightness.dark,

lib/core/themes/light_schemes.dart

@@ -1,8 +1,8 @@
 import 'package:flutter/material.dart';
 
-/// Esquemas de colores para Light Theme
+/// Color schemes for Light Theme
 class LightSchemes {
-  /// Esquema de colores para Light Theme (Contraste Bajo)
+  /// Color scheme for Light Theme (Low Contrast)
   static ColorScheme lightScheme() {
     return const ColorScheme(
       brightness: Brightness.light,
@@ -54,7 +54,7 @@ class LightSchemes {
     );
   }
 
-  /// Esquema de colores para Light Theme (Contraste Medio)
+  /// Color scheme for Light Theme (Medium Contrast)
   static ColorScheme lightMediumContrastScheme() {
     return const ColorScheme(
       brightness: Brightness.light,
@@ -106,7 +106,7 @@ class LightSchemes {
     );
   }
 
-  /// Esquema de colores para Light Theme (Contraste Alto)
+  /// Color scheme for Light Theme (High Contrast)
   static ColorScheme lightHighContrastScheme() {
     return const ColorScheme(
       brightness: Brightness.light,

lib/core/themes/material_theme.dart

@@ -3,36 +3,36 @@ import 'light_schemes.dart';
 import 'dark_schemes.dart';
 import 'theme_utils.dart';
 
-/// Clase para manejar temas personalizados
+/// Class for manage custom themes
 class MaterialTheme {
   const MaterialTheme();
 
-  /// Tema para Light Scheme
+  /// Theme for Light Scheme
   ThemeData light() {
     return ThemeUtils.theme(LightSchemes.lightScheme());
   }
 
-  /// Tema para Light Medium Contrast Scheme
+  /// Theme for Light Medium Contrast Scheme
   ThemeData lightMediumContrast() {
     return ThemeUtils.theme(LightSchemes.lightMediumContrastScheme());
   }
 
-  /// Tema para Light High Contrast Scheme
+  /// Theme for Light High Contrast Scheme
   ThemeData lightHighContrast() {
     return ThemeUtils.theme(LightSchemes.lightHighContrastScheme());
   }
 
-  /// Tema para Dark Scheme
+  /// Theme for Dark Scheme
   ThemeData dark() {
     return ThemeUtils.theme(DarkSchemes.darkScheme());
   }
 
-  /// Tema para Dark Medium Contrast Scheme
+  /// Theme for Medium dark contrast scheme
   ThemeData darkMediumContrast() {
     return ThemeUtils.theme(DarkSchemes.darkMediumContrastScheme());
   }
 
-  /// Tema para Dark High Contrast Scheme
+  /// Theme for Dark High Contrast Scheme
   ThemeData darkHighContrast() {
     return ThemeUtils.theme(DarkSchemes.darkHighContrastScheme());
   }

lib/core/themes/theme_utils.dart

@@ -1,8 +1,8 @@
 import 'package:flutter/material.dart';
 
-/// Utilidades para temas
+/// Theme utilities
 class ThemeUtils {
-  /// Método común para crear ThemeData a partir de un ColorScheme
+  /// Common method to create ThemeData from a ColorScheme
   static ThemeData theme(
     ColorScheme scheme,
   ) {

lib/core/utils/validators.dart

@@ -1,7 +1,8 @@
-import 'package:intl/intl.dart'; // Para usar Intl
+import 'package:intl/intl.dart';
 
+/// this file is for the common validations in the application
 class Validators {
-  // Validado para campos requeridos
+  // Validated for required fields
   static String? requiredField(String? value) {
     if (value == null || value.trim().isEmpty) {
       return Intl.message("field_required");

lib/data/datasources/local_data_source.dart

@@ -0,0 +1,28 @@
+import '../models/task_model.dart';
+
+/// Abstract class defining the contract for a local data source.
+///
+/// This interface declares methods for managing task data in a local storage
+/// system. Any implementation must define these methods to handle tasks.
+abstract class LocalDataSource {
+  /// Retrieves a list of tasks from local storage.
+  ///
+  /// Returns a [Future] containing a list of [TaskModel] objects.
+  Future<List<TaskModel>> getTasks();
+
+  /// Saves a list of tasks to local storage.
+  ///
+  /// Takes a list of [TaskModel] objects and persists them in storage.
+  Future<void> saveTasks(List<TaskModel> tasks);
+
+  /// Deletes all tasks from local storage.
+  ///
+  /// Removes all task data stored in the system.
+  Future<void> deleteTasks();
+
+  /// Updates a specific task in local storage.
+  ///
+  /// Takes a [TaskModel] object representing the updated task. The implementation
+  /// should locate and replace the existing task with the provided one.
+  Future<void> updateTask(TaskModel task);
+}

lib/data/datasources/local_data_source_impl.dart

@@ -0,0 +1,94 @@
+import 'dart:convert';
+import 'package:shared_preferences/shared_preferences.dart';
+import '../models/task_model.dart';
+import 'local_data_source.dart';
+
+/// Implementation of the LocalDataSource interface.
+/// Handles local storage operations for task data using SharedPreferences.
+class LocalDataSourceImpl implements LocalDataSource {
+  /// SharedPreferences instance to manage persistent storage.
+  final SharedPreferences sharedPreferences;
+
+  /// Constructor to initialize the SharedPreferences dependency.
+  LocalDataSourceImpl(this.sharedPreferences);
+
+  /// Retrieves the list of tasks stored locally.
+  ///
+  /// Decodes the JSON string stored in SharedPreferences into a list of
+  /// [TaskModel] objects. Returns an empty list if no tasks are found.
+  @override
+  Future<List<TaskModel>> getTasks() async {
+    try {
+      // Fetch the stored JSON string associated with the 'tasks' key.
+      final jsonString = sharedPreferences.getString('tasks');
+      if (jsonString != null && jsonString.isNotEmpty) {
+        // Parse the JSON string into a list of TaskModel instances.
+        final List<dynamic> jsonList = json.decode(jsonString);
+        return jsonList.map((json) => TaskModel.fromJson(json)).toList();
+      }
+      // Return an empty list if the storage is empty.
+      return [];
+    } catch (e) {
+      // Handle and rethrow any errors encountered during the retrieval process.
+      throw Exception("Error reading tasks: $e");
+    }
+  }
+
+  /// Saves the given list of tasks to local storage.
+  ///
+  /// Encodes the list of [TaskModel] objects into a JSON string and stores
+  /// it in SharedPreferences under the 'tasks' key.
+  @override
+  Future<void> saveTasks(List<TaskModel> tasks) async {
+    try {
+      // Convert the list of tasks to a JSON-compatible structure.
+      final jsonList = tasks.map((task) => task.toJson()).toList();
+      // Save the encoded JSON string into SharedPreferences.
+      await sharedPreferences.setString('tasks', json.encode(jsonList));
+    } catch (e) {
+      // Handle and rethrow any errors encountered during the save process.
+      throw Exception("Error saving tasks: $e");
+    }
+  }
+
+  /// Deletes all tasks from local storage.
+  ///
+  /// Removes the value associated with the 'tasks' key in SharedPreferences.
+  @override
+  Future<void> deleteTasks() async {
+    try {
+      // Remove the 'tasks' key from SharedPreferences.
+      await sharedPreferences.remove('tasks');
+    } catch (e) {
+      // Handle and rethrow any errors encountered during the deletion process.
+      throw Exception("Error deleting tasks: $e");
+    }
+  }
+
+  /// Updates a specific task in the local storage.
+  ///
+  /// Searches for the [updatedTask] in the stored task list by index. If found,
+  /// updates the task and re-saves the modified list. Throws an exception if
+  /// the task is not found.
+  @override
+  Future<void> updateTask(TaskModel updatedTask) async {
+    try {
+      // Fetch the current list of tasks.
+      final tasks = await getTasks();
+      // Find the index of the task to update.
+      final taskIndex = tasks.indexWhere((task) => task == updatedTask);
+      if (taskIndex != -1) {
+        // Update the task at the found index.
+        tasks[taskIndex] = updatedTask;
+        // Save the updated task list.
+        await saveTasks(tasks);
+      } else {
+        // Throw an error if the task is not found.
+        throw Exception('Task not found');
+      }
+    } catch (e) {
+      // Handle and rethrow any errors encountered during the update process.
+      throw Exception("Error updating task: $e");
+    }
+  }
+}