From 7ee042bdec46a7e1b531aa0112dd9de7a9cc974c Mon Sep 17 00:00:00 2001
From: Natalia Portillo <claunia@claunia.com>
Date: Sat, 15 Nov 2025 04:13:24 +0000
Subject: [PATCH] Add consoles pages.

---
 Marechai.App/App.xaml.cs                      |  19 +-
 .../ViewModels/ComputersViewModel.cs          |   6 +-
 .../ViewModels/ConsolesListViewModel.cs       | 249 +++++++++++++++
 .../ViewModels/ConsolesViewModel.cs           | 207 ++++++++++++
 .../ViewModels/MachineViewViewModel.cs        |  16 +
 .../Presentation/Views/ConsolesListPage.xaml  | 261 +++++++++++++++
 .../Presentation/Views/ConsolesPage.xaml      | 297 ++++++++++++++++++
 .../Services/ConsolesListFilterContext.cs     |  29 ++
 Marechai.App/Services/ConsolesService.cs      | 205 ++++++++++++
 9 files changed, 1285 insertions(+), 4 deletions(-)
 create mode 100644 Marechai.App/Presentation/ViewModels/ConsolesListViewModel.cs
 create mode 100644 Marechai.App/Presentation/ViewModels/ConsolesViewModel.cs
 create mode 100644 Marechai.App/Presentation/Views/ConsolesListPage.xaml
 create mode 100644 Marechai.App/Presentation/Views/ConsolesPage.xaml
 create mode 100644 Marechai.App/Services/ConsolesListFilterContext.cs
 create mode 100644 Marechai.App/Services/ConsolesService.cs

diff --git a/Marechai.App/App.xaml.cs b/Marechai.App/App.xaml.cs
index 83eb47ab..ec5b0a15 100644
--- a/Marechai.App/App.xaml.cs
+++ b/Marechai.App/App.xaml.cs
@@ -109,13 +109,20 @@ public partial class App : Application
                                                                  services.AddSingleton<NewsViewModel>();
                                                                  services.AddSingleton<ComputersService>();
                                                                  services.AddSingleton<ComputersViewModel>();
+                                                                 services.AddSingleton<ConsolesService>();
+                                                                 services.AddSingleton<ConsolesViewModel>();
                                                                  services.AddSingleton<MachineViewViewModel>();
 
                                                                  services
                                                                     .AddSingleton<IComputersListFilterContext,
                                                                          ComputersListFilterContext>();
 
+                                                                 services
+                                                                    .AddSingleton<IConsolesListFilterContext,
+                                                                         ConsolesListFilterContext>();
+
                                                                  services.AddTransient<ComputersListViewModel>();
+                                                                 services.AddTransient<ConsolesListViewModel>();
                                                              })
                                                             .UseNavigation(RegisterRoutes));
 
@@ -136,6 +143,8 @@ public partial class App : Application
                        new ViewMap<NewsPage, NewsViewModel>(),
                        new ViewMap<ComputersPage, ComputersViewModel>(),
                        new ViewMap<ComputersListPage, ComputersListViewModel>(),
+                       new ViewMap<ConsolesPage, ConsolesViewModel>(),
+                       new ViewMap<ConsolesListPage, ConsolesListViewModel>(),
                        new ViewMap<MachineViewPage, MachineViewViewModel>(),
                        new DataViewMap<SecondPage, SecondViewModel, Entity>());
 
@@ -155,13 +164,21 @@ public partial class App : Application
                                                                        views.FindByViewModel<ComputersViewModel>(),
                                                                        Nested:
                                                                        [
-                                                                           new RouteMap("list",
+                                                                           new RouteMap("list-computers",
                                                                                views.FindByViewModel<
                                                                                    ComputersListViewModel>()),
                                                                            new RouteMap("view",
                                                                                views.FindByViewModel<
                                                                                    MachineViewViewModel>())
                                                                        ]),
+                                                          new RouteMap("consoles",
+                                                                       views.FindByViewModel<ConsolesViewModel>(),
+                                                                       Nested:
+                                                                       [
+                                                                           new RouteMap("list-consoles",
+                                                                               views.FindByViewModel<
+                                                                                   ConsolesListViewModel>())
+                                                                       ]),
                                                           new RouteMap("Second",
                                                                        views.FindByViewModel<SecondViewModel>())
                                                       ])
diff --git a/Marechai.App/Presentation/ViewModels/ComputersViewModel.cs b/Marechai.App/Presentation/ViewModels/ComputersViewModel.cs
index 22b86d1b..1783afd4 100644
--- a/Marechai.App/Presentation/ViewModels/ComputersViewModel.cs
+++ b/Marechai.App/Presentation/ViewModels/ComputersViewModel.cs
@@ -155,7 +155,7 @@ public partial class ComputersViewModel : ObservableObject
             _logger.LogInformation("Navigating to computers by letter: {Letter}", letter);
             _filterContext.FilterType  = ComputerListFilterType.Letter;
             _filterContext.FilterValue = letter.ToString();
-            await _navigator.NavigateViewModelAsync<ComputersListViewModel>(this);
+            await _navigator.NavigateRouteAsync(this, "list-computers");
         }
         catch(Exception ex)
         {
@@ -175,7 +175,7 @@ public partial class ComputersViewModel : ObservableObject
             _logger.LogInformation("Navigating to computers by year: {Year}", year);
             _filterContext.FilterType  = ComputerListFilterType.Year;
             _filterContext.FilterValue = year.ToString();
-            await _navigator.NavigateViewModelAsync<ComputersListViewModel>(this);
+            await _navigator.NavigateRouteAsync(this, "list-computers");
         }
         catch(Exception ex)
         {
@@ -195,7 +195,7 @@ public partial class ComputersViewModel : ObservableObject
             _logger.LogInformation("Navigating to all computers");
             _filterContext.FilterType  = ComputerListFilterType.All;
             _filterContext.FilterValue = string.Empty;
-            await _navigator.NavigateViewModelAsync<ComputersListViewModel>(this);
+            await _navigator.NavigateRouteAsync(this, "list-computers");
         }
         catch(Exception ex)
         {
diff --git a/Marechai.App/Presentation/ViewModels/ConsolesListViewModel.cs b/Marechai.App/Presentation/ViewModels/ConsolesListViewModel.cs
new file mode 100644
index 00000000..7825decf
--- /dev/null
+++ b/Marechai.App/Presentation/ViewModels/ConsolesListViewModel.cs
@@ -0,0 +1,249 @@
+#nullable enable
+
+using System;
+using System.Collections.Generic;
+using System.Collections.ObjectModel;
+using System.Linq;
+using System.Threading.Tasks;
+using System.Windows.Input;
+using Marechai.App.Helpers;
+using Marechai.App.Presentation.Models;
+using Marechai.App.Services;
+using Uno.Extensions.Navigation;
+
+namespace Marechai.App.Presentation.ViewModels;
+
+/// <summary>
+///     ViewModel for displaying a filtered list of consoles
+/// </summary>
+public partial class ConsolesListViewModel : ObservableObject
+{
+    private readonly ConsolesService                _consolesService;
+    private readonly IConsolesListFilterContext     _filterContext;
+    private readonly IStringLocalizer               _localizer;
+    private readonly ILogger<ConsolesListViewModel> _logger;
+    private readonly INavigator                     _navigator;
+
+    [ObservableProperty]
+    private ObservableCollection<ConsoleListItem> _consolesList = [];
+
+    [ObservableProperty]
+    private string _errorMessage = string.Empty;
+
+    [ObservableProperty]
+    private string _filterDescription = string.Empty;
+
+    [ObservableProperty]
+    private bool _hasError;
+
+    [ObservableProperty]
+    private bool _isDataLoaded;
+
+    [ObservableProperty]
+    private bool _isLoading;
+
+    [ObservableProperty]
+    private string _pageTitle = string.Empty;
+
+    public ConsolesListViewModel(ConsolesService                consolesService, IStringLocalizer localizer,
+                                 ILogger<ConsolesListViewModel> logger,          INavigator       navigator,
+                                 IConsolesListFilterContext     filterContext)
+    {
+        _consolesService         = consolesService;
+        _localizer               = localizer;
+        _logger                  = logger;
+        _navigator               = navigator;
+        _filterContext           = filterContext;
+        LoadData                 = new AsyncRelayCommand(LoadDataAsync);
+        GoBackCommand            = new AsyncRelayCommand(GoBackAsync);
+        NavigateToConsoleCommand = new AsyncRelayCommand<ConsoleListItem>(NavigateToConsoleAsync);
+    }
+
+    public IAsyncRelayCommand                  LoadData                 { get; }
+    public ICommand                            GoBackCommand            { get; }
+    public IAsyncRelayCommand<ConsoleListItem> NavigateToConsoleCommand { get; }
+
+    /// <summary>
+    ///     Gets or sets the filter type
+    /// </summary>
+    public ConsoleListFilterType FilterType
+    {
+        get => _filterContext.FilterType;
+        set => _filterContext.FilterType = value;
+    }
+
+    /// <summary>
+    ///     Gets or sets the filter value
+    /// </summary>
+    public string FilterValue
+    {
+        get => _filterContext.FilterValue;
+        set => _filterContext.FilterValue = value;
+    }
+
+    /// <summary>
+    ///     Loads consoles based on the current filter
+    /// </summary>
+    private async Task LoadDataAsync()
+    {
+        try
+        {
+            IsLoading    = true;
+            ErrorMessage = string.Empty;
+            HasError     = false;
+            IsDataLoaded = false;
+            ConsolesList.Clear();
+
+            _logger.LogInformation("LoadDataAsync called. FilterType={FilterType}, FilterValue={FilterValue}",
+                                   FilterType,
+                                   FilterValue);
+
+            // Update title and filter description based on filter type
+            UpdateFilterDescription();
+
+            // Load consoles from the API based on the current filter
+            await LoadConsolesFromApiAsync();
+
+            _logger.LogInformation("LoadConsolesFromApiAsync completed. ConsolesList.Count={Count}",
+                                   ConsolesList.Count);
+
+            if(ConsolesList.Count == 0)
+            {
+                ErrorMessage = _localizer["No consoles found for this filter"].Value;
+                HasError     = true;
+
+                _logger.LogWarning("No consoles found for filter: {FilterType} {FilterValue}", FilterType, FilterValue);
+            }
+            else
+                IsDataLoaded = true;
+        }
+        catch(Exception ex)
+        {
+            _logger.LogError(ex, "Error loading consoles: {Exception}", ex.Message);
+            ErrorMessage = _localizer["Failed to load consoles. Please try again later."].Value;
+            HasError     = true;
+        }
+        finally
+        {
+            IsLoading = false;
+        }
+    }
+
+    /// <summary>
+    ///     Updates the title and filter description based on the current filter
+    /// </summary>
+    private void UpdateFilterDescription()
+    {
+        switch(FilterType)
+        {
+            case ConsoleListFilterType.All:
+                PageTitle         = _localizer["All Consoles"];
+                FilterDescription = _localizer["Browsing all consoles in the database"];
+
+                break;
+
+            case ConsoleListFilterType.Letter:
+                if(!string.IsNullOrEmpty(FilterValue) && FilterValue.Length == 1)
+                {
+                    PageTitle         = $"{_localizer["Consoles Starting with"]} {FilterValue}";
+                    FilterDescription = $"{_localizer["Showing consoles that start with"]} {FilterValue}";
+                }
+
+                break;
+
+            case ConsoleListFilterType.Year:
+                if(!string.IsNullOrEmpty(FilterValue) && int.TryParse(FilterValue, out int year))
+                {
+                    PageTitle         = $"{_localizer["Consoles from"]} {year}";
+                    FilterDescription = $"{_localizer["Showing consoles released in"]} {year}";
+                }
+
+                break;
+        }
+    }
+
+    /// <summary>
+    ///     Loads consoles from the API based on the current filter
+    /// </summary>
+    private async Task LoadConsolesFromApiAsync()
+    {
+        try
+        {
+            List<MachineDto> consoles = FilterType switch
+                                        {
+                                            ConsoleListFilterType.Letter when FilterValue.Length == 1 =>
+                                                await _consolesService.GetConsolesByLetterAsync(FilterValue[0]),
+
+                                            ConsoleListFilterType.Year when int.TryParse(FilterValue, out int year) =>
+                                                await _consolesService.GetConsolesByYearAsync(year),
+
+                                            _ => await _consolesService.GetAllConsolesAsync()
+                                        };
+
+            // Add consoles to the list sorted by name
+            foreach(MachineDto console in consoles.OrderBy(c => c.Name))
+            {
+                int year = console.Introduced?.Year ?? 0;
+                int id   = UntypedNodeExtractor.ExtractInt(console.Id);
+
+                _logger.LogInformation("Console: {Name}, Introduced: {Introduced}, Year: {Year}, Company: {Company}, ID: {Id}",
+                                       console.Name,
+                                       console.Introduced,
+                                       year,
+                                       console.Company,
+                                       id);
+
+                ConsolesList.Add(new ConsoleListItem
+                {
+                    Id           = id,
+                    Name         = console.Name ?? string.Empty,
+                    Year         = year,
+                    Manufacturer = console.Company ?? string.Empty
+                });
+            }
+        }
+        catch(Exception ex)
+        {
+            _logger.LogError(ex, "Error loading consoles from API");
+        }
+    }
+
+    /// <summary>
+    ///     Navigates back to the consoles main view
+    /// </summary>
+    private async Task GoBackAsync()
+    {
+        await _navigator.NavigateViewModelAsync<ConsolesViewModel>(this);
+    }
+
+    /// <summary>
+    ///     Navigates to the console detail view
+    /// </summary>
+    private async Task NavigateToConsoleAsync(ConsoleListItem? console)
+    {
+        if(console is null) return;
+
+        _logger.LogInformation("Navigating to console detail: {ConsoleName} (ID: {ConsoleId})",
+                               console.Name,
+                               console.Id);
+
+        var navParam = new MachineViewNavigationParameter
+        {
+            MachineId        = console.Id,
+            NavigationSource = this
+        };
+
+        await _navigator.NavigateViewModelAsync<MachineViewViewModel>(this, data: navParam);
+    }
+}
+
+/// <summary>
+///     Data model for a console in the list
+/// </summary>
+public class ConsoleListItem
+{
+    public int    Id           { get; set; }
+    public string Name         { get; set; } = string.Empty;
+    public int    Year         { get; set; }
+    public string Manufacturer { get; set; } = string.Empty;
+}
\ No newline at end of file
diff --git a/Marechai.App/Presentation/ViewModels/ConsolesViewModel.cs b/Marechai.App/Presentation/ViewModels/ConsolesViewModel.cs
new file mode 100644
index 00000000..924ab1c0
--- /dev/null
+++ b/Marechai.App/Presentation/ViewModels/ConsolesViewModel.cs
@@ -0,0 +1,207 @@
+using System;
+using System.Collections.ObjectModel;
+using System.Threading.Tasks;
+using System.Windows.Input;
+using Marechai.App.Services;
+using Uno.Extensions.Navigation;
+
+namespace Marechai.App.Presentation.ViewModels;
+
+public partial class ConsolesViewModel : ObservableObject
+{
+    private readonly ConsolesService            _consolesService;
+    private readonly IConsolesListFilterContext _filterContext;
+    private readonly IStringLocalizer           _localizer;
+    private readonly ILogger<ConsolesViewModel> _logger;
+    private readonly INavigator                 _navigator;
+
+    [ObservableProperty]
+    private int _consoleCount;
+
+    [ObservableProperty]
+    private string _consoleCountText = string.Empty;
+
+    [ObservableProperty]
+    private string _errorMessage = string.Empty;
+
+    [ObservableProperty]
+    private bool _hasError;
+
+    [ObservableProperty]
+    private bool _isDataLoaded;
+
+    [ObservableProperty]
+    private bool _isLoading;
+
+    [ObservableProperty]
+    private ObservableCollection<char> _lettersList = [];
+
+    [ObservableProperty]
+    private int _maximumYear;
+
+    [ObservableProperty]
+    private int _minimumYear;
+
+    [ObservableProperty]
+    private string _yearsGridTitle = string.Empty;
+
+    [ObservableProperty]
+    private ObservableCollection<int> _yearsList = [];
+
+    public ConsolesViewModel(ConsolesService            consolesService, IStringLocalizer localizer,
+                             ILogger<ConsolesViewModel> logger,          INavigator       navigator,
+                             IConsolesListFilterContext filterContext)
+    {
+        _consolesService           = consolesService;
+        _localizer                 = localizer;
+        _logger                    = logger;
+        _navigator                 = navigator;
+        _filterContext             = filterContext;
+        LoadData                   = new AsyncRelayCommand(LoadDataAsync);
+        GoBackCommand              = new AsyncRelayCommand(GoBackAsync);
+        NavigateByLetterCommand    = new AsyncRelayCommand<char>(NavigateByLetterAsync);
+        NavigateByYearCommand      = new AsyncRelayCommand<int>(NavigateByYearAsync);
+        NavigateAllConsolesCommand = new AsyncRelayCommand(NavigateAllConsolesAsync);
+
+        InitializeLetters();
+    }
+
+    public IAsyncRelayCommand       LoadData                   { get; }
+    public ICommand                 GoBackCommand              { get; }
+    public IAsyncRelayCommand<char> NavigateByLetterCommand    { get; }
+    public IAsyncRelayCommand<int>  NavigateByYearCommand      { get; }
+    public IAsyncRelayCommand       NavigateAllConsolesCommand { get; }
+    public string                   Title                      { get; } = "Consoles";
+
+    /// <summary>
+    ///     Initializes the alphabet list (A-Z)
+    /// </summary>
+    private void InitializeLetters()
+    {
+        LettersList.Clear();
+
+        for(var c = 'A'; c <= 'Z'; c++) LettersList.Add(c);
+    }
+
+    /// <summary>
+    ///     Loads consoles count, minimum and maximum years from the API
+    /// </summary>
+    private async Task LoadDataAsync()
+    {
+        try
+        {
+            IsLoading    = true;
+            ErrorMessage = string.Empty;
+            HasError     = false;
+            IsDataLoaded = false;
+            YearsList.Clear();
+
+            // Load all data in parallel for better performance
+            Task<int> countTask   = _consolesService.GetConsolesCountAsync();
+            Task<int> minYearTask = _consolesService.GetMinimumYearAsync();
+            Task<int> maxYearTask = _consolesService.GetMaximumYearAsync();
+            await Task.WhenAll(countTask, minYearTask, maxYearTask);
+
+            ConsoleCount = countTask.Result;
+            MinimumYear  = minYearTask.Result;
+            MaximumYear  = maxYearTask.Result;
+
+            // Update display text
+            ConsoleCountText = _localizer["Consoles in the database"];
+
+            // Generate years list
+            if(MinimumYear > 0 && MaximumYear > 0)
+            {
+                for(int year = MinimumYear; year <= MaximumYear; year++) YearsList.Add(year);
+
+                YearsGridTitle = $"Browse by Year ({MinimumYear} - {MaximumYear})";
+            }
+
+            if(ConsoleCount == 0)
+            {
+                ErrorMessage = _localizer["No consoles found"].Value;
+                HasError     = true;
+            }
+            else
+                IsDataLoaded = true;
+        }
+        catch(Exception ex)
+        {
+            _logger.LogError("Error loading consoles data: {Exception}", ex.Message);
+            ErrorMessage = _localizer["Failed to load consoles data. Please try again later."].Value;
+            HasError     = true;
+        }
+        finally
+        {
+            IsLoading = false;
+        }
+    }
+
+    /// <summary>
+    ///     Handles back navigation
+    /// </summary>
+    private async Task GoBackAsync()
+    {
+        await _navigator.NavigateViewModelAsync<MainViewModel>(this);
+    }
+
+    /// <summary>
+    ///     Navigates to consoles filtered by letter
+    /// </summary>
+    private async Task NavigateByLetterAsync(char letter)
+    {
+        try
+        {
+            _logger.LogInformation("Navigating to consoles by letter: {Letter}", letter);
+            _filterContext.FilterType  = ConsoleListFilterType.Letter;
+            _filterContext.FilterValue = letter.ToString();
+            await _navigator.NavigateRouteAsync(this, "list-consoles");
+        }
+        catch(Exception ex)
+        {
+            _logger.LogError("Error navigating to letter consoles: {Exception}", ex.Message);
+            ErrorMessage = _localizer["Failed to navigate. Please try again."].Value;
+            HasError     = true;
+        }
+    }
+
+    /// <summary>
+    ///     Navigates to consoles filtered by year
+    /// </summary>
+    private async Task NavigateByYearAsync(int year)
+    {
+        try
+        {
+            _logger.LogInformation("Navigating to consoles by year: {Year}", year);
+            _filterContext.FilterType  = ConsoleListFilterType.Year;
+            _filterContext.FilterValue = year.ToString();
+            await _navigator.NavigateRouteAsync(this, "list-consoles");
+        }
+        catch(Exception ex)
+        {
+            _logger.LogError("Error navigating to year consoles: {Exception}", ex.Message);
+            ErrorMessage = _localizer["Failed to navigate. Please try again."].Value;
+            HasError     = true;
+        }
+    }
+
+    /// <summary>
+    ///     Navigates to all consoles view
+    /// </summary>
+    private async Task NavigateAllConsolesAsync()
+    {
+        try
+        {
+            _logger.LogInformation("Navigating to all consoles");
+            _filterContext.FilterType  = ConsoleListFilterType.All;
+            _filterContext.FilterValue = string.Empty;
+            await _navigator.NavigateRouteAsync(this, "list-consoles");
+        }
+        catch(Exception ex)
+        {
+            _logger.LogError("Error navigating to all consoles: {Exception}", ex.Message);
+            ErrorMessage = _localizer["Failed to navigate. Please try again."].Value;
+            HasError     = true;
+        }
+    }
+}
\ No newline at end of file
diff --git a/Marechai.App/Presentation/ViewModels/MachineViewViewModel.cs b/Marechai.App/Presentation/ViewModels/MachineViewViewModel.cs
index 43ad13e8..706c9493 100644
--- a/Marechai.App/Presentation/ViewModels/MachineViewViewModel.cs
+++ b/Marechai.App/Presentation/ViewModels/MachineViewViewModel.cs
@@ -127,6 +127,22 @@ public partial class MachineViewViewModel : ObservableObject
             return;
         }
 
+        // If we came from ConsolesListViewModel, navigate back to consoles list
+        if(_navigationSource is ConsolesListViewModel)
+        {
+            await _navigator.NavigateViewModelAsync<ConsolesListViewModel>(this);
+
+            return;
+        }
+
+        // If we came from ComputersListViewModel, navigate back to computers list
+        if(_navigationSource is ComputersListViewModel)
+        {
+            await _navigator.NavigateViewModelAsync<ComputersListViewModel>(this);
+
+            return;
+        }
+
         // Otherwise, try to go back in the navigation stack
         await _navigator.GoBack(this);
     }
diff --git a/Marechai.App/Presentation/Views/ConsolesListPage.xaml b/Marechai.App/Presentation/Views/ConsolesListPage.xaml
new file mode 100644
index 00000000..de1dc013
--- /dev/null
+++ b/Marechai.App/Presentation/Views/ConsolesListPage.xaml
@@ -0,0 +1,261 @@
+<?xml version="1.0"
+      encoding="utf-8"?>
+
+<Page x:Class="Marechai.App.Presentation.Views.ConsolesListPage"
+      x:Name="PageRoot"
+      xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
+      xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+      NavigationCacheMode="Required"
+      Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
+
+    <Grid RowSpacing="0">
+        <Grid.RowDefinitions>
+            <RowDefinition Height="Auto" /> <RowDefinition Height="*" />
+        </Grid.RowDefinitions>
+
+        <!-- Header with Back Button and Title -->
+        <Grid Grid.Row="0"
+              Background="{ThemeResource CardBackgroundFillColorDefaultBrush}"
+              BorderBrush="{ThemeResource DividerStrokeColorDefaultBrush}"
+              BorderThickness="0,0,0,1"
+              Padding="16,12,16,12">
+            <Grid.ColumnDefinitions>
+                <ColumnDefinition Width="Auto" /> <ColumnDefinition Width="*" />
+            </Grid.ColumnDefinitions>
+
+            <!-- Back Button -->
+            <Button Grid.Column="0"
+                    Command="{Binding GoBackCommand}"
+                    Style="{ThemeResource AlternateButtonStyle}"
+                    ToolTipService.ToolTip="Go back"
+                    Padding="8"
+                    MinWidth="44"
+                    MinHeight="44"
+                    VerticalAlignment="Center">
+                <FontIcon Glyph="&#xE72B;"
+                          FontSize="16" />
+            </Button>
+
+            <!-- Page Title -->
+            <StackPanel Grid.Column="1"
+                        Margin="16,0,0,0"
+                        VerticalAlignment="Center">
+                <TextBlock Text="{Binding PageTitle}"
+                           FontSize="20"
+                           FontWeight="SemiBold"
+                           Foreground="{ThemeResource TextControlForeground}" />
+                <TextBlock Text="{Binding FilterDescription}"
+                           FontSize="12"
+                           Foreground="{ThemeResource SystemBaseMediumColor}"
+                           Margin="0,4,0,0" />
+            </StackPanel>
+        </Grid>
+
+        <!-- Main Content -->
+        <Grid Grid.Row="1">
+
+            <!-- Loading State -->
+            <StackPanel Visibility="{Binding IsLoading}"
+                        VerticalAlignment="Center"
+                        HorizontalAlignment="Center"
+                        Padding="32"
+                        Spacing="16">
+                <ProgressRing IsActive="True"
+                              IsIndeterminate="True"
+                              Height="64"
+                              Width="64"
+                              Foreground="{ThemeResource SystemAccentColor}" />
+                <TextBlock Text="Loading consoles..."
+                           FontSize="14"
+                           TextAlignment="Center"
+                           Foreground="{ThemeResource SystemBaseMediumColor}" />
+            </StackPanel>
+
+            <!-- Error State -->
+            <StackPanel Visibility="{Binding HasError}"
+                        VerticalAlignment="Center"
+                        HorizontalAlignment="Center"
+                        Padding="24"
+                        Spacing="16"
+                        MaxWidth="400">
+                <InfoBar IsOpen="True"
+                         Severity="Error"
+                         Title="Unable to Load Consoles"
+                         Message="{Binding ErrorMessage}"
+                         IsClosable="False" />
+                <Button Content="Retry"
+                        Command="{Binding LoadData}"
+                        HorizontalAlignment="Center"
+                        Style="{ThemeResource AccentButtonStyle}" />
+            </StackPanel>
+
+            <!-- Consoles List -->
+            <Grid Visibility="{Binding IsDataLoaded}">
+                <ScrollViewer VerticalScrollBarVisibility="Auto"
+                              HorizontalScrollBarVisibility="Disabled">
+                    <Grid Padding="8">
+                        <Grid.RowDefinitions>
+                            <RowDefinition Height="Auto" /> <RowDefinition Height="*" />
+                        </Grid.RowDefinitions>
+
+                        <!-- Count Header -->
+                        <StackPanel Grid.Row="0"
+                                    Padding="16,12"
+                                    Orientation="Horizontal"
+                                    Spacing="4">
+                            <TextBlock FontSize="12"
+                                       FontWeight="SemiBold"
+                                       Foreground="{ThemeResource SystemBaseMediumColor}"
+                                       Text="RESULTS:" />
+                            <TextBlock FontSize="12"
+                                       FontWeight="SemiBold"
+                                       Foreground="{ThemeResource SystemBaseMediumColor}"
+                                       Text="{Binding ConsolesList.Count}" />
+                            <TextBlock FontSize="12"
+                                       FontWeight="SemiBold"
+                                       Foreground="{ThemeResource SystemBaseMediumColor}"
+                                       Text="consoles" />
+                        </StackPanel>
+
+                        <!-- Consoles List -->
+                        <ItemsControl Grid.Row="1"
+                                      ItemsSource="{Binding ConsolesList}"
+                                      Padding="0"
+                                      Margin="0,8,0,0"
+                                      HorizontalAlignment="Stretch">
+                            <ItemsControl.ItemsPanel>
+                                <ItemsPanelTemplate>
+                                    <StackPanel Orientation="Vertical"
+                                                Spacing="0"
+                                                HorizontalAlignment="Stretch" />
+                                </ItemsPanelTemplate>
+                            </ItemsControl.ItemsPanel>
+                            <ItemsControl.ItemTemplate>
+                                <DataTemplate>
+                                    <Button Padding="0"
+                                            Margin="0,0,0,8"
+                                            MinHeight="80"
+                                            HorizontalContentAlignment="Stretch"
+                                            VerticalContentAlignment="Stretch"
+                                            HorizontalAlignment="Stretch"
+                                            Command="{Binding DataContext.NavigateToConsoleCommand, ElementName=PageRoot}"
+                                            CommandParameter="{Binding}"
+                                            Background="Transparent"
+                                            BorderThickness="0">
+                                        <Button.Template>
+                                            <ControlTemplate TargetType="Button">
+                                                <Grid MinHeight="80"
+                                                      HorizontalAlignment="Stretch"
+                                                      VerticalAlignment="Stretch">
+                                                    <!-- Shadow effect -->
+                                                    <Border x:Name="ShadowBorder"
+                                                            Background="{ThemeResource CardBackgroundFillColorDefaultBrush}"
+                                                            BorderBrush="{ThemeResource CardStrokeColorDefaultBrush}"
+                                                            BorderThickness="1"
+                                                            CornerRadius="8"
+                                                            Padding="16,12"
+                                                            Translation="0, 0, 4"
+                                                            VerticalAlignment="Stretch">
+                                                        <Border.Shadow>
+                                                            <ThemeShadow />
+                                                        </Border.Shadow>
+
+                                                        <Grid ColumnSpacing="16">
+                                                            <Grid.ColumnDefinitions>
+                                                                <ColumnDefinition Width="*" />
+                                                                <ColumnDefinition Width="Auto" />
+                                                            </Grid.ColumnDefinitions>
+
+                                                            <!-- Console Info -->
+                                                            <StackPanel Grid.Column="0"
+                                                                        Spacing="8"
+                                                                        VerticalAlignment="Center"
+                                                                        HorizontalAlignment="Stretch">
+                                                                <TextBlock Text="{Binding Name}"
+                                                                           FontSize="16"
+                                                                           FontWeight="SemiBold"
+                                                                           Foreground="{ThemeResource TextControlForeground}"
+                                                                           TextTrimming="CharacterEllipsis" />
+                                                                <Grid ColumnSpacing="16"
+                                                                      Height="20"
+                                                                      VerticalAlignment="Center">
+                                                                    <Grid.ColumnDefinitions>
+                                                                        <ColumnDefinition Width="Auto" />
+                                                                        <ColumnDefinition Width="Auto" />
+                                                                    </Grid.ColumnDefinitions>
+
+                                                                    <StackPanel Grid.Column="0"
+                                                                            Orientation="Horizontal"
+                                                                            Spacing="6"
+                                                                            VerticalAlignment="Center">
+                                                                        <FontIcon Glyph="&#xE731;"
+                                                                                FontSize="14"
+                                                                                Foreground="{ThemeResource SystemAccentColor}" />
+                                                                        <TextBlock Text="{Binding Manufacturer}"
+                                                                                FontSize="13"
+                                                                                Foreground="{ThemeResource SystemBaseMediumColor}" />
+                                                                    </StackPanel>
+
+                                                                    <StackPanel Grid.Column="1"
+                                                                            Orientation="Horizontal"
+                                                                            Spacing="6"
+                                                                            VerticalAlignment="Center">
+                                                                        <FontIcon Glyph="&#xE787;"
+                                                                                FontSize="14"
+                                                                                Foreground="{ThemeResource SystemAccentColor}" />
+                                                                        <TextBlock FontSize="13"
+                                                                                Foreground="{ThemeResource SystemBaseMediumColor}">
+                                                                            <Run Text="{Binding Year}" />
+                                                                        </TextBlock>
+                                                                    </StackPanel>
+                                                                </Grid>
+                                                            </StackPanel>
+
+                                                            <!-- Navigation Arrow -->
+                                                            <StackPanel Grid.Column="1"
+                                                                        VerticalAlignment="Center">
+                                                                <FontIcon Glyph="&#xE72A;"
+                                                                          FontSize="18"
+                                                                          Foreground="{ThemeResource SystemAccentColor}" />
+                                                            </StackPanel>
+                                                        </Grid>
+                                                    </Border>
+
+                                                    <VisualStateManager.VisualStateGroups>
+                                                        <VisualStateGroup x:Name="CommonStates">
+                                                            <VisualState x:Name="Normal" />
+                                                            <VisualState x:Name="PointerOver">
+                                                                <VisualState.Setters>
+                                                                    <Setter Target="ShadowBorder.Background"
+                                                                            Value="{ThemeResource CardBackgroundFillColorSecondaryBrush}" />
+                                                                    <Setter Target="ShadowBorder.Translation"
+                                                                            Value="0, -2, 8" />
+                                                                </VisualState.Setters>
+                                                            </VisualState>
+                                                            <VisualState x:Name="Pressed">
+                                                                <VisualState.Setters>
+                                                                    <Setter Target="ShadowBorder.Background"
+                                                                            Value="{ThemeResource CardBackgroundFillColorTertiaryBrush}" />
+                                                                    <Setter Target="ShadowBorder.Translation"
+                                                                            Value="0, 0, 2" />
+                                                                </VisualState.Setters>
+                                                            </VisualState>
+                                                        </VisualStateGroup>
+                                                    </VisualStateManager.VisualStateGroups>
+                                                </Grid>
+                                            </ControlTemplate>
+                                        </Button.Template>
+                                    </Button>
+                                </DataTemplate>
+                            </ItemsControl.ItemTemplate>
+                        </ItemsControl>
+
+                    </Grid>
+                </ScrollViewer>
+            </Grid>
+
+        </Grid>
+
+    </Grid>
+
+</Page>
\ No newline at end of file
diff --git a/Marechai.App/Presentation/Views/ConsolesPage.xaml b/Marechai.App/Presentation/Views/ConsolesPage.xaml
new file mode 100644
index 00000000..861ec13e
--- /dev/null
+++ b/Marechai.App/Presentation/Views/ConsolesPage.xaml
@@ -0,0 +1,297 @@
+<?xml version="1.0"
+      encoding="utf-8"?>
+
+<Page x:Class="Marechai.App.Presentation.Views.ConsolesPage"
+      x:Name="PageRoot"
+      xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
+      xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+      xmlns:utu="using:Uno.Toolkit.UI"
+      NavigationCacheMode="Required"
+      Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
+
+    <Grid utu:SafeArea.Insets="VisibleBounds">
+        <Grid.RowDefinitions>
+            <RowDefinition Height="Auto" /> <RowDefinition Height="*" />
+        </Grid.RowDefinitions>
+
+        <!-- Header -->
+        <utu:NavigationBar Grid.Row="0"
+                           Content="{Binding Path=Title}">
+            <utu:NavigationBar.MainCommand>
+                <AppBarButton Icon="Back"
+                              Label="Back"
+                              Command="{Binding GoBackCommand}"
+                              AutomationProperties.Name="Go back" />
+            </utu:NavigationBar.MainCommand>
+        </utu:NavigationBar>
+
+        <!-- Content -->
+        <ScrollViewer Grid.Row="1">
+            <StackPanel Padding="16"
+                        Spacing="24">
+
+                <!-- Console Count Display -->
+                <StackPanel HorizontalAlignment="Center"
+                            Spacing="8">
+                    <TextBlock Text="{Binding ConsoleCountText}"
+                               TextAlignment="Center"
+                               FontSize="18"
+                               FontWeight="SemiBold"
+                               Foreground="{ThemeResource SystemBaseMediumColor}" />
+                    <TextBlock Text="{Binding ConsoleCount}"
+                               TextAlignment="Center"
+                               FontSize="48"
+                               FontWeight="Bold"
+                               Foreground="{ThemeResource SystemAccentColor}" />
+                </StackPanel>
+
+                <!-- Loading State -->
+                <StackPanel Visibility="{Binding IsLoading}"
+                            VerticalAlignment="Center"
+                            HorizontalAlignment="Center"
+                            Padding="32"
+                            Spacing="16">
+                    <ProgressRing IsActive="True"
+                                  IsIndeterminate="True"
+                                  Height="48"
+                                  Width="48" />
+                    <TextBlock Text="Loading..."
+                               TextAlignment="Center"
+                               FontSize="14" />
+                </StackPanel>
+
+                <!-- Error State -->
+                <StackPanel Visibility="{Binding HasError}"
+                            Padding="16"
+                            Background="{ThemeResource SystemErrorBackgroundColor}"
+                            CornerRadius="8"
+                            Spacing="8">
+                    <TextBlock Text="Error"
+                               FontWeight="Bold"
+                               Foreground="{ThemeResource SystemErrorTextForegroundColor}" />
+                    <TextBlock Text="{Binding ErrorMessage}"
+                               Foreground="{ThemeResource SystemErrorTextForegroundColor}"
+                               TextWrapping="Wrap" />
+                </StackPanel>
+
+                <!-- Main Content (visible when loaded and no error) -->
+                <StackPanel Visibility="{Binding IsDataLoaded}"
+                            Spacing="24">
+
+                    <!-- Letters Grid Section -->
+                    <StackPanel Spacing="12">
+                        <TextBlock Text="Browse by Letter"
+                                   FontSize="16"
+                                   FontWeight="SemiBold"
+                                   Foreground="{ThemeResource SystemBaseMediumColor}" />
+                        <ItemsRepeater ItemsSource="{Binding LettersList}"
+                                       Layout="{StaticResource LettersGridLayout}">
+                            <ItemsRepeater.ItemTemplate></ItemsRepeater.ItemTemplate>
+                        </ItemsRepeater>
+                    </StackPanel>
+
+                    <!-- Years Grid Section -->
+                    <StackPanel Spacing="12">
+                        <TextBlock Text="{Binding YearsGridTitle}"
+                                   FontSize="16"
+                                   FontWeight="SemiBold"
+                                   Foreground="{ThemeResource SystemBaseMediumColor}" />
+                        <ItemsRepeater ItemsSource="{Binding YearsList}"
+                                       Layout="{StaticResource YearsGridLayout}">
+                            <ItemsRepeater.ItemTemplate></ItemsRepeater.ItemTemplate>
+                        </ItemsRepeater>
+                    </StackPanel>
+
+                    <!-- All Consoles and Search Section -->
+                    <StackPanel Spacing="12">
+                        <Button Content="All Consoles"
+                                Padding="16,12"
+                                HorizontalAlignment="Stretch"
+                                FontSize="16"
+                                FontWeight="SemiBold"
+                                Command="{Binding NavigateAllConsolesCommand}"
+                                Style="{StaticResource AccentButtonStyle}" />
+
+                        <!-- Search Field (placeholder for future implementation) -->
+                        <TextBox PlaceholderText="Search consoles..."
+                                 Padding="12"
+                                 IsEnabled="False"
+                                 Opacity="0.5" />
+                    </StackPanel>
+
+                </StackPanel>
+
+            </StackPanel>
+        </ScrollViewer>
+
+    </Grid>
+
+    <Page.Resources>
+        <!-- Keyboard Key Button Style (revised: more padding, simplified borders to avoid clipping, darker scheme) -->
+        <Style x:Key="KeyboardKeyButtonStyle"
+               TargetType="Button">
+            <!-- Base appearance -->
+            <Setter Property="Foreground"
+                    Value="#1A1A1A" />
+            <Setter Property="Background">
+                <Setter.Value>
+                    <LinearGradientBrush StartPoint="0,0"
+                                         EndPoint="0,1">
+                        <GradientStop Color="#D6D6D6"
+                                      Offset="0" />
+                        <GradientStop Color="#C2C2C2"
+                                      Offset="0.55" />
+                        <GradientStop Color="#B0B0B0"
+                                      Offset="1" />
+                    </LinearGradientBrush>
+                </Setter.Value>
+            </Setter>
+            <Setter Property="BorderBrush"
+                    Value="#7A7A7A" />
+            <Setter Property="BorderThickness"
+                    Value="1" />
+            <Setter Property="CornerRadius"
+                    Value="6" />
+            <Setter Property="Padding"
+                    Value="14,12" /> <!-- Increased vertical padding to prevent cutoff -->
+            <Setter Property="Margin"
+                    Value="4" />
+            <Setter Property="FontFamily"
+                    Value="Segoe UI" />
+            <Setter Property="FontWeight"
+                    Value="SemiBold" />
+            <Setter Property="FontSize"
+                    Value="15" />
+            <Setter Property="HorizontalAlignment"
+                    Value="Stretch" />
+            <Setter Property="VerticalAlignment"
+                    Value="Stretch" />
+            <Setter Property="HorizontalContentAlignment"
+                    Value="Center" />
+            <Setter Property="VerticalContentAlignment"
+                    Value="Center" />
+            <Setter Property="MinWidth"
+                    Value="52" />
+            <Setter Property="MinHeight"
+                    Value="52" /> <!-- Larger min height avoids clipping ascenders/descenders -->
+            <Setter Property="Template">
+                <Setter.Value>
+                    <ControlTemplate TargetType="Button">
+                        <Grid>
+                            <!-- Shadow (simple) -->
+                            <Border x:Name="Shadow"
+                                    CornerRadius="6"
+                                    Background="#33000000"
+                                    Margin="2,4,4,2" />
+                            <!-- Key surface -->
+                            <Border x:Name="KeyBorder"
+                                    Background="{TemplateBinding Background}"
+                                    BorderBrush="{TemplateBinding BorderBrush}"
+                                    BorderThickness="{TemplateBinding BorderThickness}"
+                                    CornerRadius="{TemplateBinding CornerRadius}">
+                                <!-- Inner highlight & content -->
+                                <Grid>
+                                    <Border CornerRadius="{TemplateBinding CornerRadius}"
+                                            BorderBrush="#60FFFFFF"
+                                            BorderThickness="1,1,0,0" />
+                                    <Border CornerRadius="{TemplateBinding CornerRadius}"
+                                            BorderBrush="#30000000"
+                                            BorderThickness="0,0,1,1" />
+                                    <ContentPresenter x:Name="ContentPresenter"
+                                                      HorizontalAlignment="{TemplateBinding HorizontalContentAlignment}"
+                                                      VerticalAlignment="{TemplateBinding VerticalContentAlignment}"
+                                                      Margin="0"
+                                                      TextWrapping="NoWrap" />
+                                </Grid>
+                            </Border>
+                            <VisualStateManager.VisualStateGroups>
+                                <VisualStateGroup x:Name="CommonStates">
+                                    <VisualState x:Name="Normal" />
+                                    <VisualState x:Name="PointerOver">
+                                        <VisualState.Setters>
+                                            <Setter Target="KeyBorder.Background">
+                                                <Setter.Value>
+                                                    <LinearGradientBrush StartPoint="0,0"
+                                                                         EndPoint="0,1">
+                                                        <GradientStop Color="#E0E0E0"
+                                                                      Offset="0" />
+                                                        <GradientStop Color="#CFCFCF"
+                                                                      Offset="0.55" />
+                                                        <GradientStop Color="#BDBDBD"
+                                                                      Offset="1" />
+                                                    </LinearGradientBrush>
+                                                </Setter.Value>
+                                            </Setter>
+                                            <Setter Target="KeyBorder.BorderBrush"
+                                                    Value="#5F5F5F" />
+                                        </VisualState.Setters>
+                                    </VisualState>
+                                    <VisualState x:Name="Pressed">
+                                        <VisualState.Setters>
+                                            <Setter Target="KeyBorder.Background">
+                                                <Setter.Value>
+                                                    <LinearGradientBrush StartPoint="0,0"
+                                                                         EndPoint="0,1">
+                                                        <GradientStop Color="#9C9C9C"
+                                                                      Offset="0" />
+                                                        <GradientStop Color="#A8A8A8"
+                                                                      Offset="0.55" />
+                                                        <GradientStop Color="#B4B4B4"
+                                                                      Offset="1" />
+                                                    </LinearGradientBrush>
+                                                </Setter.Value>
+                                            </Setter>
+                                            <Setter Target="KeyBorder.BorderBrush"
+                                                    Value="#4A4A4A" />
+                                            <Setter Target="KeyBorder.RenderTransform">
+                                                <Setter.Value>
+                                                    <TranslateTransform Y="2" />
+                                                </Setter.Value>
+                                            </Setter>
+                                            <Setter Target="Shadow.Opacity"
+                                                    Value="0.15" />
+                                        </VisualState.Setters>
+                                    </VisualState>
+                                    <VisualState x:Name="Disabled">
+                                        <VisualState.Setters>
+                                            <Setter Target="KeyBorder.Opacity"
+                                                    Value="0.45" />
+                                            <Setter Target="ContentPresenter.Foreground"
+                                                    Value="#777777" />
+                                        </VisualState.Setters>
+                                    </VisualState>
+                                </VisualStateGroup>
+                                <VisualStateGroup x:Name="FocusStates">
+                                    <VisualState x:Name="Focused">
+                                        <VisualState.Setters>
+                                            <Setter Target="KeyBorder.BorderBrush"
+                                                    Value="#3A7AFE" />
+                                            <Setter Target="KeyBorder.BorderThickness"
+                                                    Value="2" />
+                                        </VisualState.Setters>
+                                    </VisualState>
+                                    <VisualState x:Name="Unfocused" />
+                                </VisualStateGroup>
+                            </VisualStateManager.VisualStateGroups>
+                        </Grid>
+                    </ControlTemplate>
+                </Setter.Value>
+            </Setter>
+        </Style>
+
+        <!-- Responsive Grid Layouts -->
+        <UniformGridLayout x:Key="LettersGridLayout"
+                           ItemsStretch="Fill"
+                           MinItemWidth="44"
+                           MinItemHeight="44"
+                           MaximumRowsOrColumns="13" />
+
+        <UniformGridLayout x:Key="YearsGridLayout"
+                           ItemsStretch="Fill"
+                           MinItemWidth="54"
+                           MinItemHeight="44"
+                           MaximumRowsOrColumns="10" />
+
+    </Page.Resources>
+
+</Page>
\ No newline at end of file
diff --git a/Marechai.App/Services/ConsolesListFilterContext.cs b/Marechai.App/Services/ConsolesListFilterContext.cs
new file mode 100644
index 00000000..8f114bcf
--- /dev/null
+++ b/Marechai.App/Services/ConsolesListFilterContext.cs
@@ -0,0 +1,29 @@
+namespace Marechai.App.Services;
+
+/// <summary>
+///     Context for filtering consoles by various criteria
+/// </summary>
+public interface IConsolesListFilterContext
+{
+    ConsoleListFilterType FilterType  { get; set; }
+    string                FilterValue { get; set; }
+}
+
+/// <summary>
+///     Implementation of the consoles list filter context
+/// </summary>
+public class ConsolesListFilterContext : IConsolesListFilterContext
+{
+    public ConsoleListFilterType FilterType  { get; set; } = ConsoleListFilterType.All;
+    public string                FilterValue { get; set; } = string.Empty;
+}
+
+/// <summary>
+///     Enumeration for console list filter types
+/// </summary>
+public enum ConsoleListFilterType
+{
+    All,
+    Letter,
+    Year
+}
\ No newline at end of file
diff --git a/Marechai.App/Services/ConsolesService.cs b/Marechai.App/Services/ConsolesService.cs
new file mode 100644
index 00000000..410d7824
--- /dev/null
+++ b/Marechai.App/Services/ConsolesService.cs
@@ -0,0 +1,205 @@
+using System;
+using System.Collections.Generic;
+using System.Threading.Tasks;
+using Marechai.App.Helpers;
+using Microsoft.Kiota.Abstractions.Serialization;
+
+namespace Marechai.App.Services;
+
+/// <summary>
+///     Service for fetching and managing consoles from the Marechai API
+/// </summary>
+public class ConsolesService
+{
+    private readonly ApiClient                _apiClient;
+    private readonly ILogger<ConsolesService> _logger;
+
+    public ConsolesService(ApiClient apiClient, ILogger<ConsolesService> logger)
+    {
+        _apiClient = apiClient;
+        _logger    = logger;
+    }
+
+    /// <summary>
+    ///     Fetches the total count of consoles from the API
+    /// </summary>
+    /// <returns>Total number of consoles, or 0 if API call fails</returns>
+    public async Task<int> GetConsolesCountAsync()
+    {
+        try
+        {
+            _logger.LogInformation("Fetching consoles count from API");
+            UntypedNode result = await _apiClient.Consoles.Count.GetAsync();
+
+            // Extract integer value from UntypedNode
+            // UntypedNode wraps a JsonElement, we need to parse it
+            int count = UntypedNodeExtractor.ExtractInt(result);
+            _logger.LogInformation("Successfully fetched consoles count: {Count}", count);
+
+            return count;
+        }
+        catch(Exception ex)
+        {
+            _logger.LogError(ex, "Error fetching consoles count from API");
+
+            return 0;
+        }
+    }
+
+    /// <summary>
+    ///     Fetches the minimum year of consoles from the API
+    /// </summary>
+    /// <returns>Minimum year, or 0 if API call fails</returns>
+    public async Task<int> GetMinimumYearAsync()
+    {
+        try
+        {
+            _logger.LogInformation("Fetching minimum year from API");
+            UntypedNode result = await _apiClient.Consoles.MinimumYear.GetAsync();
+
+            // Extract integer value from UntypedNode
+            int year = UntypedNodeExtractor.ExtractInt(result);
+            _logger.LogInformation("Successfully fetched minimum year: {Year}", year);
+
+            return year;
+        }
+        catch(Exception ex)
+        {
+            _logger.LogError(ex, "Error fetching minimum year from API");
+
+            return 0;
+        }
+    }
+
+    /// <summary>
+    ///     Fetches the maximum year of consoles from the API
+    /// </summary>
+    /// <returns>Maximum year, or 0 if API call fails</returns>
+    public async Task<int> GetMaximumYearAsync()
+    {
+        try
+        {
+            _logger.LogInformation("Fetching maximum year from API");
+            UntypedNode result = await _apiClient.Consoles.MaximumYear.GetAsync();
+
+            // Extract integer value from UntypedNode
+            int year = UntypedNodeExtractor.ExtractInt(result);
+            _logger.LogInformation("Successfully fetched maximum year: {Year}", year);
+
+            return year;
+        }
+        catch(Exception ex)
+        {
+            _logger.LogError(ex, "Error fetching maximum year from API");
+
+            return 0;
+        }
+    }
+
+    /// <summary>
+    ///     Fetches consoles filtered by starting letter from the API
+    /// </summary>
+    public async Task<List<MachineDto>> GetConsolesByLetterAsync(char letter)
+    {
+        try
+        {
+            _logger.LogInformation("Fetching consoles starting with '{Letter}' from API", letter);
+
+            List<MachineDto> consoles = await _apiClient.Consoles.ByLetter[letter.ToString()].GetAsync();
+
+            if(consoles == null) return [];
+
+            _logger.LogInformation("Successfully fetched {Count} consoles starting with '{Letter}'",
+                                   consoles.Count,
+                                   letter);
+
+            return consoles;
+        }
+        catch(Exception ex)
+        {
+            _logger.LogError(ex, "Error fetching consoles by letter '{Letter}' from API", letter);
+
+            return [];
+        }
+    }
+
+    /// <summary>
+    ///     Fetches consoles filtered by year from the API
+    /// </summary>
+    public async Task<List<MachineDto>> GetConsolesByYearAsync(int year)
+    {
+        try
+        {
+            _logger.LogInformation("Fetching consoles from year {Year} from API", year);
+
+            List<MachineDto> consoles = await _apiClient.Consoles.ByYear[year].GetAsync();
+
+            if(consoles == null) return [];
+
+            _logger.LogInformation("Successfully fetched {Count} consoles from year {Year}", consoles.Count, year);
+
+            return consoles;
+        }
+        catch(Exception ex)
+        {
+            _logger.LogError(ex, "Error fetching consoles by year {Year} from API", year);
+
+            return [];
+        }
+    }
+
+    /// <summary>
+    ///     Fetches all consoles from the API
+    /// </summary>
+    public async Task<List<MachineDto>> GetAllConsolesAsync()
+    {
+        try
+        {
+            _logger.LogInformation("Fetching all consoles from API");
+
+            List<MachineDto> consoles = await _apiClient.Consoles.GetAsync();
+
+            if(consoles == null) return [];
+
+            _logger.LogInformation("Successfully fetched {Count} total consoles", consoles.Count);
+
+            return consoles;
+        }
+        catch(Exception ex)
+        {
+            _logger.LogError(ex, "Error fetching all consoles from API");
+
+            return [];
+        }
+    }
+
+    /// <summary>
+    ///     Fetches a single machine with full details by ID from the API
+    /// </summary>
+    public async Task<MachineDto?> GetMachineByIdAsync(int machineId)
+    {
+        try
+        {
+            _logger.LogInformation("Fetching machine {MachineId} from API", machineId);
+
+            MachineDto? machine = await _apiClient.Machines[machineId].Full.GetAsync();
+
+            if(machine == null)
+            {
+                _logger.LogWarning("Machine {MachineId} not found", machineId);
+
+                return null;
+            }
+
+            _logger.LogInformation("Successfully fetched machine {MachineId}: {MachineName}", machineId, machine.Name);
+
+            return machine;
+        }
+        catch(Exception ex)
+        {
+            _logger.LogError(ex, "Error fetching machine {MachineId} from API", machineId);
+
+            return null;
+        }
+    }
+}
\ No newline at end of file