# gust4av033/godentalapp architecture

> Architecture diagram of the GitHub repository gust4av033/godentalapp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-25). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gust4av033/godentalapp
- Repository: https://github.com/gust4av033/godentalapp

## Overview

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.

## Diagram (Mermaid)

```mermaid
graph TB
    %% Presentation Layer
    subgraph "Presentation Layer"
        direction TB
        View["InsumosView"]:::frontend
        VM["InsumosViewModel"]:::frontend
    end

    %% Domain Layer
    subgraph "Domain Layer"
        direction TB
        DTO["InsumoDto"]:::domain
        Entity["InsumoDental"]:::domain
    end

    %% Service Layer
    subgraph "Service Layer"
        direction TB
        IServ["IInsumoService"]:::service
        Serv["InsumoService"]:::service
        Validator["Business Validation"]:::service
        Mapper["DTO ⇄ Entity Mapper"]:::service
    end

    %% Infrastructure Layer
    subgraph "Infrastructure Layer"
        direction TB
        IRepo["IInsumoRepository"]:::infra
        Repo["InsumoRepository"]:::infra
        Config["InsumoConfiguration"]:::infra
        DbContext["AppDbContext"]:::infra
    end

    %% Database Layer
    subgraph "Database"
        direction TB
        Table1["InsumosDentales"]:::db
        Table2["Categorias"]:::db
        Table3["Proveedores"]:::db
        subgraph "Stored Procedures"
            SP1["AgregarInsumo()"]:::db
            SP2["ObtenerInsumos()"]:::db
            SP3["ActualizarInsumo()"]:::db
            SP4["EliminarInsumo()"]:::db
        end
    end

    %% Flow of Data / Dependencies
    View -->|"Commands"| VM
    VM -->|"Creates DTO"| DTO
    VM -->|"Calls Async"| IServ
    IServ -->|"Validates"| Validator
    Validator -->|"Uses DTO"| DTO
    Validator -->|"Calls Mapper"| Mapper
    Mapper -->|"Maps to Entity"| Entity
    IServ -->|"Invokes"| Serv
    Serv -->|"Uses Interface"| IRepo
    Serv -->|"Passes Entity"| IRepo
    IRepo -.->|"Implements"| Repo
    Repo -->|"Uses DbContext"| DbContext
    DbContext -->|"Exec SP"| SP1
    DbContext -->|"Exec SP"| SP2
    DbContext -->|"Exec SP"| SP3
    DbContext -->|"Exec SP"| SP4
    SP1 -->|"Insert into"| Table1
    SP2 -->|"Select from"| Table1
    SP3 -->|"Update"| Table1
    SP4 -->|"Mark Deleted"| Table1
    Table2 -.-> SP2
    Table3 -.-> SP2
    Repo -->|"Configures Entities"| Config
    Config -->|"Maps Entity"| Table1

    %% Click Events
    click Entity "https://github.com/gust4av033/godentalapp/blob/master/src/GoDentalAPP.CORE/Entities/InsumoDental.cs"
    click IRepo "https://github.com/gust4av033/godentalapp/blob/master/src/GoDentalAPP.INFRAESTRUCTURE/Repositorios/IInsumoRepository.cs"
    click Repo "https://github.com/gust4av033/godentalapp/tree/master/src/GoDentalAPP.INFRAESTRUCTURE/Repositorios/"
    click DbContext "https://github.com/gust4av033/godentalapp/blob/master/src/GoDentalAPP.INFRAESTRUCTURE/Persistence/AppDbContext.cs"
    click Config "https://github.com/gust4av033/godentalapp/blob/master/src/GoDentalAPP.INFRAESTRUCTURE/Persistence/InsumoConfiguration.cs"
    click IServ "https://github.com/gust4av033/godentalapp/tree/master/src/GoDentalAPP.SERVICES/Services/"
    click DTO "https://github.com/gust4av033/godentalapp/tree/master/src/GoDentalAPP.API/DTOs/"
    click Table1 "https://github.com/gust4av033/godentalapp/blob/master/scripts/ScriptBD.sql"
    click Table2 "https://github.com/gust4av033/godentalapp/blob/master/scripts/ScriptBD.sql"
    click Table3 "https://github.com/gust4av033/godentalapp/blob/master/scripts/ScriptBD.sql"
    click SP1 "https://github.com/gust4av033/godentalapp/blob/master/scripts/ScriptBD.sql"
    click SP2 "https://github.com/gust4av033/godentalapp/blob/master/scripts/ScriptBD.sql"
    click SP3 "https://github.com/gust4av033/godentalapp/blob/master/scripts/ScriptBD.sql"
    click SP4 "https://github.com/gust4av033/godentalapp/blob/master/scripts/ScriptBD.sql"

    %% Styles
    classDef frontend fill:#1f77b4,stroke:#000,color:#fff;
    classDef service fill:#2ca02c,stroke:#000,color:#fff;
    classDef infra fill:#ff7f0e,stroke:#000,color:#fff;
    classDef db fill:#7f7f7f,stroke:#000,color:#fff;
    classDef domain fill:#d62728,stroke:#000,color:#fff;
```
