How davidsantes/dav-blazorinventory works
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.