Modelo de dominio - ds-2026-grupo-02/SmartPantry GitHub Wiki

Modelo de dominio

En esta sección se documenta el modelo de dominio del sistema, incluyendo las entidades principales, sus atributos y las relaciones entre ellas.

Operaciones principales

  • Agregar un producto a la despensa
  • Buscar un producto por código de barras o por su nombre y ver sus detalles
  • Generar advertencias al detectar coincidencias entre alérgenos/ingredientes del producto y las preferencias de usuario
  • Generar alertas cuando hay ítems de la despensa próximos a vencer
  • Configurar preferencias alimentarias (alérgenos/ingredientes a vigilar)
  • Guardar un producto externo en la base interna.

Diagrama de clases / Entidades

Descargar archivo editable

Invariantes

  • Cada usuario tiene una única despensa.
  • Ningún usuario puede modificar la despensa de otro.
  • La cantidad de ítems de la despensa no puede tener valores negativos.
  • Un producto se identifica de forma única por su código de barras.
  • Una advertencia se genera únicamente con información disponible en el producto; si falta un dato, se indica como no verificable.
  • Un ítem de una despensa hace referencia a exactamente un producto identificado por su código de barras.

Decisiones de diseño y evolución del dominio

  • Simplificación del atributo Unidad en PantryItem: Durante el desarrollo de las funcionalidades de la despensa (RF-11), el equipo decidió no utilizar las propiedades Unidad ni Cantidad en el modelo de dominio ni en los DTOs del sistema. En su lugar, la entidad Producto contiene Cantidad, el cual especifica la cantidad y unidad impresas en el envase (por ejemplo, 500 g).