How gust4av033/godentalapp works
Para representar con detalle el flujo de trabajo del módulo de Insumos (dentro de GoDentalAPP) y su interacción con los procedimientos almacenados (SP) en la base de datos, sigue estas indicaciones para crear tu diagrama:
Identifica los componentes principales
• Capa de Presentación (WPF)
• InsumosView.xaml (interfaz gráfica)
• InsumosViewModel (GoDentalAPP.APP/ViewModels – maneja comandos y propiedades de UI)
• Capa de Servicios (GoDentalAPP.SERVICES)
• InsumoService (implementa la lógica de negocio relacionada con insumos)
• IInsumoService (interfaz para inyección de dependencias)
• Capa de Infraestructura / Datos (GoDentalAPP.INFRAESTRUCTURE)
• IInsumoRepository (contrato para acceso a datos de insumos)
• InsumoRepository (implementación que invoca SP vía AppDbContext)
• AppDbContext (Entity Framework Core – configuración para ejecutar SP)
• Base de Datos (SQL Server)
• Tabla InsumosDentales (InsumoID, Nombre, Descripción, CantidadEnStock, PrecioUnitario, etc.)
• Tabla Categorias (CategoriaID, NombreCategoria, Descripción)
• Tabla Proveedores (ProveedorID, NombreProveedor, Contacto)
• Procedimientos Almacenados:
– AgregarInsumo
– ActualizarInsumo
– EliminarInsumo
– ObtenerInsumos (lectura)
– …otros SP relacionados (p. ej. ObtenerCategorias, ObtenerProveedores)
Determina las relaciones y flujos de datos
1. El usuario interactúa con InsumosView (botones “Agregar”, “Editar”, “Eliminar”, “Refrescar”).
2. InsumosViewModel recibe el comando y prepara un DTO (InsumoDto) con los datos.
3. Llama a IInsumoService.XxxAsync(Dto), que internamente:
a. Valida reglas de negocio.
b. Mapea el DTO a la entidad de dominio (GoDentalAPP.CORE/Entities/InsumoDental).
c. Invoca el método correspondiente en IInsumoRepository.
4. InsumoRepository usa AppDbContext para ejecutar el SP:
– context.Database.ExecuteSqlRaw("EXEC AgregarInsumo @p0, @p1, …", parámetros)
– o bien context.InsumosDentales.FromSqlRaw("EXEC ObtenerInsumos")
5. El SP opera sobre las tablas InsumosDentales, Categorias, Proveedores y retorna resultados o confirma la operación.
6. El resultado (lista de insumos, éxito/fallo) sube de nuevo por la capa de servicio al ViewModel.
7. El ViewModel expone cambios a la View (IEnumerable<InsumoDto>, mensajes de validación, etc.).
Patrón arquitectónico
• Arquitectura en capas (Clean Architecture / Onion / Layered)
• Principio de separación de responsabilidades:
• Presentation (MVVM)
• Domain (Entidades, DTOs, Especificaciones)
• Application Services (lógica orquestadora)
• Infrastructure (acceso a datos via EF y SP)
Elementos a incluir en el diagrama
• Componentes y capas con etiquetas claras:
[View] → [ViewModel] → [Service] → [Repository] → [DbContext] → [Database]
• Flechas direccionales que indiquen el sentido del flujo de datos y las llamadas (por ejemplo: ViewModel ► Service ► Repository ► DB).
• Azul: Presentación
• Verde: Servicios / Lógica de negocio
• Naranja: Infraestructura / Repositorio
• Gris: Base de datos
• En la capa de Base de datos, representar tablas (rectángulos) y SP (subprocesos o cilindros pequeños) con nombres:
– InsumosDentales, Categorias, Proveedores
– AgregarInsumo(), ActualizarInsumo(), EliminarInsumo(), ObtenerInsumos()
Flujo CRUD detallado
• Crear (AgregarInsumo):
Usuario ► ViewModel ► Service ► Repository ► SP:AgregarInsumo ► Inserta fila en InsumosDentales
• Leer (ObtenerInsumos):
Usuario ► ViewModel ► Service ► Repository ► SP:ObtenerInsumos ► Retorna lista ► ViewModel ► View
• Actualizar (ActualizarInsumo):
Usuario ► ViewModel ► Service ► Repository ► SP:ActualizarInsumo ► UPDATE sobre InsumosDentales
• Eliminar (EliminarInsumo):
Usuario ► ViewModel ► Service ► Repository ► SP:EliminarInsumo ► Marca flag “Eliminado” en InsumosDentales
Recomendaciones de detalle
• Incluye DTOs y Entidades en la capa de dominio como nodos intermedios.
• Muestra los mappers (AutoMapper o manual) entre DTO y Entidad.
• Añade notas de “inyección de dependencias” (flechas punteadas entre interfaces e implementaciones).
• Si existen validaciones o filtros (p. ej. atributos en ViewModel), represéntalos como subprocesos o anotaciones junto a la capa de servicios.
Con esta guía tendrás un diagrama claro y completo del módulo de Insumos, mostrando todos los actores (UI, ViewModel, Servicio, Repositorio y DB), los procedimientos almacenados y las tablas involucradas en las operaciones CRUD.