# frhgm/portafolio_frontend_net architecture

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

- Interactive diagram: https://gitdiagram.com/frhgm/portafolio_frontend_net
- Repository: https://github.com/frhgm/portafolio_frontend_net

## Overview

A continuación se detalla una guía paso a paso para crear un diagrama arquitectónico detallado y preciso adaptado a nuestro proyecto WPF para consumir la API AutoREST de Oracle Autonomous Database:

##### Identificación del tipo y propósito del proyecto
- Se trata de un proyecto de escritorio basado en WPF (Windows Presentation Foundation) que sirve de interfaz de usuario para consumir servicios ofrecidos por una API de Oracle Autonomous Database.
- El README indica claramente que el proyecto se compone de tres proyectos principales: "app" para la interfaz, "classLibrary" para los Data Services y DTOs, y "components" para componentes UI reutilizables, junto con un proyecto de pruebas unitarias ("pruebas").

##### Análisis del árbol de archivos y la estructura
- Directorio app: Contiene todas las ventanas (por ejemplo, Login, Pedidos, Productos, Solicitudes, Subastas, Usuarios) y utilidades del WPF. Esto representa la capa de presentación.
- Directorio classLibrary: Aloja los servicios de datos (que incluyen Data Services para pedidos, productos, subastas, roles, etc.) y los DTOs que sirven para transferir datos entre la aplicación y la API (o incluso entre capas). Aquí se encapsula la lógica de negocio y las comunicaciones externas.
- Directorio components: Es una librería de componentes reutilizables (como el menú dinámico) que soportan la aplicación, permitiendo modularidad y reutilización en la capa UI.
- Proyecto pruebas: Incluye pruebas unitarias utilizando NUnit para validar la funcionalidad de los Data Services, lo que resalta la importancia de la testabilidad en el diseño.
- Además, el archivo "Procedimientos almacenados.sql" probablemente contenga scripts relacionados con la base de datos, lo que indica una interacción directa con el almacén de datos (por ejemplo, para validar o configurar la integración con la API y la base de datos Oracle).

##### Componentes fundamentales y relaciones
a. Capa de Presentación (app):
- Incluye ventanas (Login, Pedidos, Productos, etc.) y utilidades relacionadas con el WPF.
- Se encarga de la interacción del usuario y la renderización de la UI, orquestando la llamada a la capa de servicios.

b. Capa de Servicios y Lógica de Negocios (classLibrary):
- Contiene todos los Data Services que se comunican con la API REST de Oracle.
- Incluye DTOs que definen los esquemas de datos y la comunicación entre la capa de presentación y la lógica de negocio.
- Gestiona la transformación de datos, validaciones y llamadas a servicios externos, actuando como intermediario entre el front-end y la fuente de datos (Oracle Autonomous Database).

c. Componentes Reutilizables (components):
- Contiene elementos (por ejemplo, el menú dinámico) que pueden ser integrados en la UI de "app" para mantener consistencia y facilitar la reutilización de código.

d. Pruebas Unitarias (pruebas):
- Proyecto de NUnit que valida la funcionalidad de los Data Services.
- Asegura que la lógica de negocio se comporta según lo esperado al interactuar con datos reales o simulados.

e. Integración con Oracle Autonomous Database:
- Aunque se comunica vía la API AutoREST, el script "Procedimientos almacenados.sql" sugiere que existen procedimientos SQL o configuraciones directas relacionados con la base de datos. Este componente también podría representarse como un servicio externo que interactúa con "classLibrary".

##### Guía para elaborar el diagrama de arquitectura
- Diseñe un diagrama que separe claramente las capas de la aplicación:
- Capa de Servicios y Lógica de Negocios (classLibrary): Dibuje bloques para cada uno de los Data Services y, de forma agrupada, los DTOs. Use una paleta diferente (por ejemplo, verde) para esta sección.
- Pruebas Unitarias (pruebas): Mencione este proyecto aparte, representándolo como un bloque de verificación/de test que se conecta a "classLibrary" para validar sus componentes.
- Integración Externa (Oracle Autonomous Database/API AutoREST & Procedimientos almacenados): Dibuje un bloque o ícono representativo para la base de datos y la API externa. Conecte el bloque de "classLibrary" hacia este componente mediante flechas que indiquen la dirección de la solicitud/respuesta.

- Incluir flechas direccionales:
- De la capa de Presentación a la capa de Servicios: Indique la llamada y flujo de datos del usuario a las lógicas de negocio.
- De la capa de Servicios a la API/Oracle Database: Indique la comunicación REST y el manejo de respuestas.

- Etiquetado claro y uso de íconos:
- Asegúrese de etiquetar cada componente (por ejemplo, etiquetar cada ventana y cada servicio) para mayor claridad.
- Considere el uso de diferentes formas o iconos para distinguir entre módulos internos y servicios externos.
- Utilice líneas y flechas para marcar dependencias y flujos de datos, asegurándose de indicar claramente la dirección de la comunicación.

##### Personalización para este proyecto
- Destacar la separación de preocupaciones entre la UI de WPF (app), la lógica de comunicación y transformación de datos en classLibrary, y los controles reutilizables de components.
- Incluir un componente visual que represente la conexión con Oracle Autonomous Database a través de la API AutoREST, destacando esta integración crítica.
- Resaltar que se han implementado pruebas unitarias con NUnit, lo cual es esencial para verificar la robustez y el correcto funcionamiento de los Data Services.

##### Recomendaciones adicionales al diagrama
- Use un diseño modular que permita identificar fácilmente cada parte del sistema.
- Emplee colores y formas consistentes para señalar diferentes tipos de componentes (por ejemplo, rectángulos para módulos internos, íconos especiales para servicios externos).
- Mantenga en consideración la orientación del flujo de datos: desde la interacción del usuario en la interfaz, pasando por la capa de lógicas y servicios, hasta las llamadas a los servicios externos y retorno de la información.
- No olvide incluir los scripts y configuraciones de base de datos (Procedimientos almacenados.sql) que complementan la integración con Oracle.

Esta estructura y estos lineamientos permitirán que el diagrama refleje de forma precisa y completa la arquitectura del proyecto, resaltando sus componentes clave, relaciones y patrones de diseño. ¡Éste será un recurso muy valioso para la comprensión y el mantenimiento del sistema!

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Capa de Presentación (app)"
        A1["Login"]
        A2["Pedidos"]
    end

    subgraph "Capa de Servicios y Lógica de Negocios (classLibrary)"
        B1["Data Services"]
        B2["DTOs"]
        B3["UtilidadesLogica"]
        B4["Rut"]
    end

    subgraph "Componentes Reutilizables (components)"
        C1["Menú Dinámico"]
    end

    subgraph "Pruebas Unitarias (pruebas)"
        D1["NUnit Tests"]
    end

    E["Oracle Autonomous Database/API AutoREST"]
    F["Procedimientos almacenados.sql"]

    %% Connections between components
    A1 -->|"invoca"| B1
    A2 -->|"solicita"| B1
    A1 -->|"usa"| C1
    B1 -->|"RESTCall"| E
    D1 -->|"tests"| B1
    E -->|"configura"| F

    %% Styles
    classDef presentation fill:#cce5ff,stroke:#003399,stroke-width:2px;
    classDef business fill:#d4edda,stroke:#155724,stroke-width:2px;
    classDef reusable fill:#ffe5b4,stroke:#e69500,stroke-width:2px;
    classDef test fill:#f3d1f4,stroke:#b3007b,stroke-width:2px;
    classDef external fill:#f8d7da,stroke:#721c24,stroke-width:2px;

    %% Apply classes
    class A1,A2 presentation;
    class B1,B2,B3,B4 business;
    class C1 reusable;
    class D1 test;
    class E,F external;

    %% Click events
    click A1 "https://github.com/frhgm/portafolio_frontend_net/blob/develop/app/Ventanas/Login.xaml"
    click A2 "https://github.com/frhgm/portafolio_frontend_net/blob/develop/app/Ventanas/Pedidos.xaml"
    click B1 "https://github.com/frhgm/portafolio_frontend_net/tree/develop/classLibrary/Data Services"
    click B2 "https://github.com/frhgm/portafolio_frontend_net/tree/develop/classLibrary/DTOs"
    click B3 "https://github.com/frhgm/portafolio_frontend_net/blob/develop/classLibrary/UtilidadesLogica.cs"
    click B4 "https://github.com/frhgm/portafolio_frontend_net/blob/develop/classLibrary/Rut.cs"
    click C1 "https://github.com/frhgm/portafolio_frontend_net/blob/develop/components/MenuDinamico.xaml"
    click D1 "https://github.com/frhgm/portafolio_frontend_net/blob/develop/pruebas/UsuariosDataService_Tests.cs"
    click F "https://github.com/frhgm/portafolio_frontend_net/blob/develop/Procedimientos almacenados.sql"
```
