Facade y menú completo en C# con persistencia JSON

Contenido del curso

El ecosistema .NET

Entradas, Salidas y Tipos

Funciones y Modelado de Dominio

Colecciones y LINQ (Language Integrated Query)

Archivos y Procesamiento

Tomar examen

Cursos Empresas Blog Live Conf Eventos Precios

0:0017:35

Facade y menú completo en C# con persistencia JSON

Curso de Fundamentos de .NET

Clase 21 de 21

Clase 21 / 21

Comentarios (2)2 comentarios

Cristhian Alexis Vera Sandoval

Hace 4 meses

¿Por qué es mejor usar el patrón Facade?

El patrón Facade (Fachada) actúa como un recepcionista en un hotel. En lugar de que tú (el cliente o la interfaz de usuario) tengas que hablar por separado con el encargado de limpieza, el de mantenimiento y el de cocina, simplemente le pides lo que necesitas al recepcionista, y él coordina todo internamente. En el desarrollo de software, es mejor usarlo porque reduce drásticamente la complejidad y el acoplamiento. Si tu aplicación necesita guardar datos en un JSON, buscar en memoria y generar reportes, hacer todo esto directamente desde la interfaz de usuario crearía un código desordenado y difícil de mantener. Al centralizar estas operaciones en un servicio intermediario, tu menú principal solo necesita llamar a un método simple como AgregarProducto(). Si en el futuro decides cambiar la forma en que se guardan los datos, solo modificarás el interior del Facade, sin tocar ni una sola línea del código de tu menú interactivo.

Cesar Augusto Suaza

Hace 7 meses

Excelente curso. Fue muy claro, práctico y de gran utilidad. Quedo atento a un próximo curso para seguir profundizando en temas de .NET

Meifer Alexander Rodriguez Sierra

Hace 5 meses

Creo que hubiera sido mejor si escribia el código directamente y no copia y pega. asi da chance de uno tambien programar en tiempo real.

Recursos

Construir un sistema de inventario completo en C# requiere algo más que métodos sueltos: necesita una capa que coordine repositorio, almacenamiento y reportes sin exponer la complejidad interna. Eso es exactamente lo que se logra al aplicar el patrón facade a través de una clase llamada InventarioService, que se convierte en el punto de entrada único para toda la lógica de negocio.

¿Qué hace el patrón facade en InventarioService?

El patrón facade simplifica la interfaz de un sistema al ofrecer un único punto de acceso que coordina múltiples colaboradores internos [0:06]. En este caso, InventarioService trabaja con tres dependencias:

InMemoryProductRepository: almacena los productos en memoria.
JsonInventarioStorage: gestiona la persistencia en formato JSON.
Una ruta de archivo (inventario.json) donde se guardan los datos.

Dentro del constructor se instancian estos colaboradores y se define la ruta por defecto como inventario.json [0:49]. Inmediatamente después se implementa el método CargarInventario, que verifica con un condicional if si el archivo ya existe en la ruta indicada. Si existe, carga la lista de productos y los agrega al repositorio mediante un ciclo foreach [1:10].

¿Cómo se implementan los métodos CRUD?

Las operaciones CRUD (crear, leer, actualizar y eliminar) se traducen en cinco métodos concretos [1:30]:

AgregarProducto: recibe nombre, precio, cantidad y categoría, crea el producto con ProductFactory.Crear y lo añade al repositorio. Al final llama a _Persistir() para guardar los cambios.
ObtenerTodosLosProductos: retorna un IEnumerable<Producto> usando repository.ObtenerTodos().
ObtenerProductoPorId: recibe un int como parámetro y aplica el operador de nulabilidad (?) porque el resultado puede ser nulo [2:15].
ActualizarProducto: obtiene el producto por ID, verifica que no sea nulo y luego actualiza nombre, precio, cantidad y categoría.
EliminarProducto: recibe el ID y llama a repository.EliminarPorId().

¿Qué métodos de búsqueda y consultas se incluyen?

Se crean varios métodos de tipo IEnumerable<Producto> para búsquedas específicas [2:55]:

BuscarPorCategoría: filtra productos según la categoría recibida.
BuscarPorNombre: filtra por coincidencia de nombre.
ObtenerProductosBajoStock: usa un parámetro mínimo de cinco unidades como umbral.
ObtenerValorTotalDeInventario: retorna un decimal con el valor acumulado.
ObtenerPrecioPromedio: calcula el promedio de precios.
ObtenerProductoMásCaro: retorna un producto con símbolo de nulabilidad para evitar excepciones.

¿Cómo funcionan los reportes y la persistencia?

Para generar reportes se instancia GeneradorReportes dentro de cada método correspondiente [3:54]. Los cuatro métodos de reporte son:

GenerarResumen: obtiene todos los productos y llama a generador.GenerarResumen().
GenerarReporteStockBajo: filtra con la condición de stock menor a cinco.
GenerarTopProductos: usa un parámetro inicial de cinco productos.
ExportarCSV: genera un archivo CSV con los datos del inventario.

El método privado _Persistir resuelve el error que el editor marca inicialmente [4:28]. Este método primero crea un backup con _storage.CrearBackup(), luego obtiene todos los productos del repositorio, los convierte a lista y finalmente los guarda en la ruta del inventario con storage.Guardar().

¿Cómo se construye el menú interactivo en Program.cs?

En Program.cs se inicializa el servicio y se usa un booleano para mantener activo el sistema [5:09]. Un ciclo while presenta al usuario diez opciones mediante un switch:

Agregar producto.
Listar productos.
Buscar por ID.
Eliminar producto.
Buscar por categoría.
Mostrar resumen.
Mostrar stock bajo.
Mostrar estadísticas.
Exportar CSV.
Salir del sistema.

El método MostrarMenú imprime las opciones con Console.WriteLine [5:52]. Cada caso lee la entrada del usuario con Console.ReadLine y la parsea al tipo correspondiente. Para las categorías se realiza un Enum.TryParse que valida la entrada o asigna la categoría "Otros" por defecto [6:30].

¿Qué sucede al probar la aplicación?

Al ejecutar dotnet run se despliega el menú completo [8:27]. La prueba demuestra:

Agregar un producto "Mac" con precio 1000, cantidad 4 y categoría electrónica.
Listarlo y verificar ID, nombre, precio, cantidad, total y categoría.
Buscarlo por ID y por categoría electrónica.
El resumen muestra el total de productos y valor del inventario.
El reporte de stock bajo incluye "Mac" porque tiene 4 unidades (menor al umbral de 5).
La exportación CSV respeta la estructura de columnas.
Eliminar el producto por ID y verificar que el inventario queda vacío.

Los datos persisten en inventario.json, lo que significa que al ejecutar la aplicación nuevamente los productos seguirán disponibles [9:43]. Los patrones aplicados durante todo el proyecto son Factory, Repository, Facade y persistencia JSON, formando una arquitectura profesional y extensible.

Si completaste el proyecto, comparte tu repositorio y compáralo con el release cinco disponible en los recursos.

Resumen

¿Qué hace el patrón facade en InventarioService?

InMemoryProductRepository: almacena los productos en memoria.
JsonInventarioStorage: gestiona la persistencia en formato JSON.
Una ruta de archivo (inventario.json) donde se guardan los datos.

¿Cómo se implementan los métodos CRUD?

Las operaciones CRUD (crear, leer, actualizar y eliminar) se traducen en cinco métodos concretos [1:30]:

AgregarProducto: recibe nombre, precio, cantidad y categoría, crea el producto con ProductFactory.Crear y lo añade al repositorio. Al final llama a _Persistir() para guardar los cambios.
ObtenerTodosLosProductos: retorna un IEnumerable<Producto> usando repository.ObtenerTodos().
ObtenerProductoPorId: recibe un int como parámetro y aplica el operador de nulabilidad (?) porque el resultado puede ser nulo [2:15].
ActualizarProducto: obtiene el producto por ID, verifica que no sea nulo y luego actualiza nombre, precio, cantidad y categoría.
EliminarProducto: recibe el ID y llama a repository.EliminarPorId().

¿Qué métodos de búsqueda y consultas se incluyen?

Se crean varios métodos de tipo IEnumerable<Producto> para búsquedas específicas [2:55]:

BuscarPorCategoría: filtra productos según la categoría recibida.
BuscarPorNombre: filtra por coincidencia de nombre.
ObtenerProductosBajoStock: usa un parámetro mínimo de cinco unidades como umbral.
ObtenerValorTotalDeInventario: retorna un decimal con el valor acumulado.
ObtenerPrecioPromedio: calcula el promedio de precios.
ObtenerProductoMásCaro: retorna un producto con símbolo de nulabilidad para evitar excepciones.

¿Cómo funcionan los reportes y la persistencia?

Para generar reportes se instancia GeneradorReportes dentro de cada método correspondiente [3:54]. Los cuatro métodos de reporte son:

GenerarResumen: obtiene todos los productos y llama a generador.GenerarResumen().
GenerarReporteStockBajo: filtra con la condición de stock menor a cinco.
GenerarTopProductos: usa un parámetro inicial de cinco productos.
ExportarCSV: genera un archivo CSV con los datos del inventario.

¿Cómo se construye el menú interactivo en Program.cs?

En Program.cs se inicializa el servicio y se usa un booleano para mantener activo el sistema [5:09]. Un ciclo while presenta al usuario diez opciones mediante un switch:

Agregar producto.
Listar productos.
Buscar por ID.
Eliminar producto.
Buscar por categoría.
Mostrar resumen.
Mostrar stock bajo.
Mostrar estadísticas.
Exportar CSV.
Salir del sistema.

¿Qué sucede al probar la aplicación?

Al ejecutar dotnet run se despliega el menú completo [8:27]. La prueba demuestra:

Agregar un producto "Mac" con precio 1000, cantidad 4 y categoría electrónica.
Listarlo y verificar ID, nombre, precio, cantidad, total y categoría.
Buscarlo por ID y por categoría electrónica.
El resumen muestra el total de productos y valor del inventario.
El reporte de stock bajo incluye "Mac" porque tiene 4 unidades (menor al umbral de 5).
La exportación CSV respeta la estructura de columnas.
Eliminar el producto por ID y verificar que el inventario queda vacío.

Si completaste el proyecto, comparte tu repositorio y compáralo con el release cinco disponible en los recursos.

El ecosistema .NET

Cómo el motor de .NET ejecuta tu código C#

Cómo .NET corre código en tres sistemas

Creación de un proyecto de consola en C#

CLI de .NET: comandos para organizar proyectos

Carpetas bin y obj en .NET: qué son y cuándo ignorarlas

Checkpoint del módulo: quiz y proyecto base

Entradas, Salidas y Tipos

Cómo funcionan los argumentos en C#

Conversión segura con TryParse en C#

Null en C#: validar entrada del usuario

Exit codes y manejo de null en C#

Funciones y Modelado de Dominio

Anatomía de un método en C#

Clases, enums y records en C#

Guard clauses: validación temprana en C#

Checkpoint: validación, Factory y enums en C#

Colecciones y LINQ (Language Integrated Query)

List, Dictionary y HashSet en C#

LINQ para filtrar, agrupar y calcular en C#

Checkpoint: Consultas Avanzadas

Archivos y Procesamiento

Cómo funciona FileManager en C#

Serialización JSON en .NET: guardar y recuperar objetos

LINQ y StringBuilder: reportes de inventario en C#

Facade y menú completo en C# con persistencia JSON

Facade y menú completo en C# con persistencia JSON

Progreso del curso

El ecosistema .NET

Entradas, Salidas y Tipos

Funciones y Modelado de Dominio

Colecciones y LINQ (Language Integrated Query)

Archivos y Procesamiento

Recursos

Recursos