# davidsantes/dav-blazorinventory architecture

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

- Interactive diagram: https://gitdiagram.com/davidsantes/dav-blazorinventory
- Repository: https://github.com/davidsantes/dav-blazorinventory

## Overview

Para diseñar un diagrama de arquitectura claro y detallado para este proyecto de inventariado con Blazor Server, sigue estos pasos:

##### Identificación del tipo y propósito del proyecto
- Es una aplicación full-stack de ejemplo (CRUD) basada en Blazor Server (.NET 5).
- Simula la gestión de categorías, productos, bodegas (storages/warehouses) y movimientos de inventario (entradas/salidas).
- Emplea una arquitectura por capas: Entidades → DataAccess (EF Core) → Lógica de negocio → UI (Blazor).

##### Análisis de la estructura de ficheros
- Proyectos principales en la solución Inventory.sln:
- Entities (modelos POCO)
- DataAccess (InventoryContext con EF Core y migraciones)
- Business (servicios CRUD: CategoryService, ProductService, etc., sobre interfaces ICrudDataService)
- Inventory (UI Blazor Server: páginas, componentes, Startup, Program)
- Observa los archivos de configuración (appsettings.json), launchSettings y migraciones EF Core en DataAccess/Migrations.
- La carpeta wwwroot contiene recursos estáticos CSS y fuentes.

##### Información adicional del README
- Destaca el uso de capas, EF Core, Razor Components/páginas, inyección de dependencias, validaciones y combos en cascada.
- No implementa eliminación (solo CRU).

##### Cómo estructurar el diagrama de sistema
a. Componentes principales
1. UI (Blazor Server)
- App.razor, páginas razor (Pages/...), componentes (Components/...)
- Startup.cs / Program.cs configura el servidor y DI
2. Business Logic Layer
- Servicios: CategoryService, ProductService, WarehouseService, StorageService, InputOutputService
- Interfaces: ICrudDataService<T>, ICrudDataServiceStorage
3. Data Access Layer
- InventoryContext (DbContext EF Core)
- Migraciones EF Core (proyecto DataAccess/Migrations)
4. Domain Models
- Entities: CategoryEntity, ProductEntity, StorageEntity, WarehouseEntity, InputOutputEntity
5. Base de datos
- SQL Server (Express recomendado)
b. Relaciones e interacciones
- El UI invoca componentes Razor que llaman a servicios del Business Layer via DI
- Cada servicio de negocio utiliza InventoryContext para CRUD sobre entidades
- EF Core ejecuta comandos SQL contra la base de datos
- Migraciones mantienen el esquema en DataAccess
c. Patrones y principios arquitectónicos
- Arquitectura en capas (separación de responsabilidades)
- Inyección de dependencias (Startup.cs registra DbContext y servicios)
- Repositorio/genérico + Unidad de Trabajo vía DbContext
- Componentes reutilizables en Blazor
d. Tecnologías y frameworks clave
- .NET 5, C#
- Blazor Server (Razor Components + páginas Razor)
- Entity Framework Core (Code First + Migraciones)
- SQL Server
- DI integrada de ASP.NET Core

##### Guía para adaptar el diagrama al proyecto
- Coloca en la capa superior la UI Blazor (servidor), en la siguiente capa la lógica de negocio, luego el acceso a datos y, finalmente, la BD como sistema externo.
- Añade un módulo lateral de Migraciones EF Core ligado al DataAccess si quieres destacar el versionado de esquema.

##### Elementos gráficos recomendados
- Componentes: dibuja cajas rectangulares grandes para cada capa/proyecto, con subcomponentes (por ejemplo, dentro de Business un rectángulo para “CategoryService” y otro para “ProductService”).
- Flechas direccionales:
- UI → Business (peticiones HTTP / llamadas a servicios)
- Business → DataAccess (DbContext)
- DataAccess → SQL Server (consultas)
- Azul para UI (Blazor)
- Verde para Business Layer
- Naranja para DataAccess Layer
- Gris para Entities (modelos)
- Etiquetas claras: cada flecha indica “GetCategories()”, “AddProduct()”, “SaveChanges()”, etc., para que se vea el flujo de datos.

##### Detalles a capturar
- Nombre de cada proyecto/capa (Entities, DataAccess, Business, Inventory)
- Principales servicios e interfaces en la capa de negocio
- El DbContext y la ruta de migraciones en DataAccess
- Los componentes y páginas clave en la UI (por ejemplo, ListProductsComponent, ProductCreatePage)
- Configuración de DI en Startup.cs (AddDbContext, AddScoped<ICrudDataService<Product>, ProductService>)
- Dependencia externa: SQL Server con cadenas de conexión en appsettings.json

Con esta guía podrás elaborar un diagrama preciso que muestre cómo fluye la información desde la UI Blazor hasta la base de datos, respetando las capas de arquitectura del proyecto y destacando las tecnologías y patrones utilizados.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% UI Layer
    subgraph "UI (Blazor Server)" 
        direction TB
        AppRazor["App.razor"]:::ui
        Program["Program.cs"]:::ui
        Startup["Startup.cs"]:::ui
        AppSettings["appsettings.json"]:::ui
        subgraph "Pages" 
            direction TB
            CatListPage["CategoryListPage.razor"]:::ui
            ProdListPage["ProductListPage.razor"]:::ui
        end
        subgraph "Components"
            direction TB
            ListCategoriesComp["ListCategoriesComponent.razor"]:::ui
            ListProductsComp["ListProductsComponent.razor"]:::ui
        end
    end

    %% Business Layer
    subgraph "Business Logic Layer"
        direction TB
        ICrud["ICrudDataService<T>"]:::business
        CategorySvc["CategoryService"]:::business
        ProductSvc["ProductService"]:::business
    end

    %% Data Access Layer
    subgraph "Data Access Layer"
        direction TB
        InventoryCtx["InventoryContext"]:::dataaccess
        subgraph "Migrations" 
            direction TB
            Mig1["20201107183500_FirstMigration.cs"]:::dataaccess
            Mig2["20201107185723_AddData.cs"]:::dataaccess
        end
    end

    %% Domain Models
    subgraph "Domain Models (Entities)"
        direction TB
        CatEntity["CategoryEntity"]:::entities
        ProdEntity["ProductEntity"]:::entities
    end

    %% Database
    SQLServer["SQL Server"]:::external

    %% Connections
    ListCategoriesComp -->|"calls GetCategories()"| CategorySvc
    ListProductsComp -->|"calls GetProducts()"| ProductSvc
    CatListPage -->|"renders component"| ListCategoriesComp
    ProdListPage -->|"renders component"| ListProductsComp
    AppRazor -->|"configures DI"| Startup
    Startup -->|"AddScoped<ICrudDataService<Category>, CategoryService>()"| CategorySvc
    Startup -->|"AddScoped<ICrudDataService<Product>, ProductService>()"| ProductSvc
    CategorySvc -->|"uses DbContext"| InventoryCtx
    ProductSvc -->|"uses DbContext"| InventoryCtx
    InventoryCtx -->|"executes SQL"| SQLServer
    Mig1 -.->|generates schema| InventoryCtx
    Mig2 -.->|seeds data| InventoryCtx
    CatEntity --> InventoryCtx
    ProdEntity --> InventoryCtx

    %% Click events
    click AppRazor "https://github.com/davidsantes/dav-blazorinventory/blob/master/Inventory/App.razor"
    click Program "https://github.com/davidsantes/dav-blazorinventory/blob/master/Inventory/Program.cs"
    click Startup "https://github.com/davidsantes/dav-blazorinventory/blob/master/Inventory/Startup.cs"
    click AppSettings "https://github.com/davidsantes/dav-blazorinventory/blob/master/Inventory/appsettings.json"
    click CatListPage "https://github.com/davidsantes/dav-blazorinventory/blob/master/Inventory/Pages/Categories/CategoryListPage.razor"
    click ProdListPage "https://github.com/davidsantes/dav-blazorinventory/blob/master/Inventory/Pages/Products/ProductListPage.razor"
    click ListCategoriesComp "https://github.com/davidsantes/dav-blazorinventory/blob/master/Inventory/Components/Categories/ListCategoriesComponent.razor"
    click ListProductsComp "https://github.com/davidsantes/dav-blazorinventory/blob/master/Inventory/Components/Products/ListProductsComponent.razor"
    click CategorySvc "https://github.com/davidsantes/dav-blazorinventory/blob/master/Business/CategoryService.cs"
    click ProductSvc "https://github.com/davidsantes/dav-blazorinventory/blob/master/Business/ProductService.cs"
    click ICrud "https://github.com/davidsantes/dav-blazorinventory/blob/master/Business/Interfaces/ICrudDataService.cs"
    click InventoryCtx "https://github.com/davidsantes/dav-blazorinventory/blob/master/DataAccess/InventoryContext.cs"
    click Mig1 "https://github.com/davidsantes/dav-blazorinventory/blob/master/DataAccess/Migrations/20201107183500_FirstMigration.cs"
    click Mig2 "https://github.com/davidsantes/dav-blazorinventory/blob/master/DataAccess/Migrations/20201107185723_AddData.cs"
    click CatEntity "https://github.com/davidsantes/dav-blazorinventory/blob/master/Entities/CategoryEntity.cs"
    click ProdEntity "https://github.com/davidsantes/dav-blazorinventory/blob/master/Entities/ProductEntity.cs"

    %% Styles
    classDef ui fill:#B3D1FF,stroke:#0366d6,color:#000;
    classDef business fill:#C6F6D5,stroke:#22863a,color:#000;
    classDef dataaccess fill:#FFE4B3,stroke:#D69B00,color:#000;
    classDef entities fill:#F0F0F0,stroke:#6a737d,color:#000;
    classDef external fill:#FDDCDC,stroke:#cb2431,color:#000
```
