# romerosebastian/tfi_genotec architecture

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

- Interactive diagram: https://gitdiagram.com/romerosebastian/tfi_genotec
- Repository: https://github.com/romerosebastian/tfi_genotec

## Overview

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.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Sistema TFI_Genotec"
        subgraph "Presentation Layer"
            UI["Frontend Blazor UI"]:::presentation
        end
        subgraph "Backend Layer"
            API["Web API .NET"]:::backend
            BLL["Business Logic Layer"]:::backend
            DAL["Data Access Layer"]:::backend
        end
        subgraph "Domain Layer"
            Domain["Domain Model"]:::backend
        end
        subgraph "Persistence Layer"
            SQL["SQL Server"]:::persistence
            Firebase["Firebase"]:::persistence
        end
        subgraph "Transversal Services"
            Services["Services Transversales"]:::transversal
        end
    end

    %% External Systems
    Auth0["Auth0 (IDP)"]:::external
    IoT["IoT Device + App Escritorio"]:::external

    %% Connections
    UI -->|"HTTP REST + JWT"| API
    API -->|"calls"| BLL
    BLL -->|"calls"| DAL
    DAL -->|"SQL queries"| SQL
    DAL -->|"NoSQL operations"| Firebase
    API -->|"Auth0 token validation"| Auth0
    IoT -->|"Bluetooth→HTTP POST"| API
    API -->|"uses"| Services
    BLL -->|"uses"| Services
    DAL -->|"uses"| Services

    %% Click Events
    click UI "https://github.com/romerosebastian/tfi_genotec/blob/master/UI/UI.csproj"
    click API "https://github.com/romerosebastian/tfi_genotec/blob/master/API/API.csproj"
    click BLL "https://github.com/romerosebastian/tfi_genotec/blob/master/BLL/BLL.csproj"
    click DAL "https://github.com/romerosebastian/tfi_genotec/blob/master/DAL/DAL.csproj"
    click Domain "https://github.com/romerosebastian/tfi_genotec/blob/master/Domain/Domain.csproj"
    click Services "https://github.com/romerosebastian/tfi_genotec/blob/master/Services/ApplicationSettings.cs"

    %% Styles
    classDef presentation fill:#add8e6,stroke:#333,stroke-width:1px
    classDef backend fill:#8fbc8f,stroke:#333,stroke-width:1px
    classDef persistence fill:#f4a460,stroke:#333,stroke-width:1px
    classDef external fill:#d3d3d3,stroke:#333,stroke-width:1px
    classDef transversal fill:#fffacd,stroke:#333,stroke-width:1px
```
