How romerosebastian/tfi_genotec works
Para representar de forma clara y precisa la arquitectura de TFI_Genotec al nivel de sistema, sigue estos pasos:
Identificación del tipo de proyecto y propósito
• Proyecto full-stack compuesto por:
• UI web en Blazor (frontend SPA)
• Web API en .NET 6 (backend REST)
• Capa de negocio (BLL), acceso a datos (DAL) y dominio (Domain)
• Servicios transversales (logging, excepciones, scoping)
• Persistencia en SQL Server y Firebase
• Integración de autenticación/ autorización vía Auth0
• Integración con un dispositivo IoT+app de escritorio para captura de SPO2 y LPM
Análisis de la estructura de archivos
• Carpeta “UI”: Blazor, páginas (.razor), controladores UI, repositorios HTTP, configuración Auth0
• Carpeta “API”: Controllers (endpoints REST), Program/Startup (.NET), appsettings (SQL, Firebase, Auth0)
• Carpeta “BLL”: Lógica de negocio por entidad
• Carpeta “DAL”: Repositorios (SQL + Firebase), interfaces de contrato, adaptadores de entidades, fábrica, SqlHelper
• Carpeta “Domain”: Clases de entidad de negocio
• Carpeta “Services”: Facade, manejo de excepciones, logging (DAL/Domain/BLL), scope, utilidades
Puntos clave del README
• Web Blazor + Web API .NET
• Autenticación/Autorización con Auth0
• Base de datos SQL + Firebase
• Captura de datos IoT -> app escritorio -> API
Componentes principales a incluir
a. Frontend Blazor (UI)
b. Web API (.NET)
c. Capa BLL
d. Capa DAL (SQL Server, Firebase)
e. Base de datos SQL Server
f. Firebase (NoSQL)
g. Auth0 (Identity Provider)
h. IoT Device + App Escritorio
i. Servicios transversales (Logging, Excepciones, Facade, Scope)
Relaciones e interacciones
• UI ←→ Web API: llamadas HTTP REST (+ token JWT de Auth0)
• Web API → BLL → DAL → SQL / Firebase: flujo de persistencia
• IoT Device → App Escritorio (Bluetooth) → Web API: envío de datos médicos
• Web API ↔ Auth0: validación y emisión de tokens
• Todos los componentes de la API y BLL utilizan servicios de logging y manejo de excepciones
Patrones y principios arquitectónicos
• Arquitectura en capas (Presentation, Business Logic, Data Access, Domain)
• Dependency Injection (Startup.cs en UI y API)
• Repository + Factory + Adapter (en DAL)
• Facade para unificar llamadas desde UI/otros sistemas
• Servicios transversales desacoplados (logging, exceptions, scope)
Guía para dibujar el diagrama
a. Utiliza un enfoque C4 Container o diagrama en capas:
– Dibuja un rectángulo grande “Sistema TFI_Genotec”.
– Dentro, coloca dos grandes contenedores: “Blazor UI” y “Web API .NET”.
– Debajo de Web API, dibuja subcapas: BLL → DAL → Persistencia.
b. Añade fuera del contenedor principal:
– Base de datos SQL Server
– Firebase
– Auth0 (IDP)
– IoT Device + App de Escritorio
c. Conecta con flechas direccionales:
– UI → Web API: peticiones REST (+Auth0 token)
– Web API → BLL → DAL → SQL / Firebase
– IoT/App → Web API: POST de datos médicos
– Web API ↔ Auth0: validación / introspección de tokens
d. Incorpora los servicios transversales dentro del área de Web API/BLL:
– Módulo de Logging
– Módulo de Excepciones
– Facade
– Scope Handler
– Capa de presentación (UI): azul claro
– Backend/API y BLL/DAL: verde
– Persistencia (SQL, Firebase): naranja
– Servicios externos (Auth0, IoT): gris
– Servicios transversales: amarillo
Elementos de detalle que no pueden faltar
• Etiquetas claras en cada rectángulo (nombre del componente y tecnología)
• Flechas con leyenda de tipo de comunicación (HTTP REST, gRPC, Bluetooth, JWT)
• Límites de capas con anotaciones (“Presentation Layer”, “Business Layer”, “Data Layer”)
• Notas sobre patrones (Repository, Factory, Adapter, DI)
• Indicador de flujo de datos para el registro de SPO2/LPM
Con esta guía, el ingeniero principal podrá construir un diagrama de sistema detallado, capturando cada componente, sus interacciones y tecnologías clave, y destacando claramente la arquitectura en capas y la integración con servicios externos.