# sebin3/generar-perfil-aleatorio architecture

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

- Interactive diagram: https://gitdiagram.com/sebin3/generar-perfil-aleatorio
- Repository: https://github.com/sebin3/generar-perfil-aleatorio

## Overview

##### Identificación del proyecto y propósito
- Tipo: Aplicación web estática de una sola página (SPA) en front-end.
- Objetivo: Generar perfiles aleatorios usando la API de RandomUser, mostrarlos en tarjeta, y gestionar su almacenamiento local (guardar, listar, eliminar).

##### Análisis de la estructura de archivos
- index.html → estructura del DOM y punto de entrada.
- style.css   → estilos de la interfaz.
- script.js   → lógica de negocio:
- Módulo de Interfaz de Usuario (renderizado, gestión de eventos)
- Módulo de Integración con API externa (fetch a RandomUser)
- Módulo de Almacenamiento (lectura/escritura en localStorage)
- No hay backend propio: todo corre en el navegador.

##### Componentes principales para el diagrama
a. Navegador / Entorno Cliente
b. Módulo JavaScript
- UI Controller
- API Client
- Storage Manager
c. Servicio Externo: RandomUser API
d. Almacenamiento: localStorage (Web Storage)

##### Relaciones e interacciones
1) Usuario hace clic en “Generar perfil” → UI Controller
2) UI Controller llama a API Client → fetch HTTP → RandomUser API
3) RandomUser API responde JSON → API Client → UI Controller
4) UI Controller actualiza DOM con datos del perfil
5) Usuario hace clic en “Guardar” → UI Controller invoca Storage Manager → localStorage.setItem()
6) Para listar/eliminar perfiles → Storage Manager → localStorage.getItem()/removeItem() → UI Controller

##### Patrones y principios arquitectónicos
- Separación de responsabilidades (UI vs. integración de datos vs. almacenamiento).
- Flujo de datos unidireccional: eventos de usuario → acciones JS → actualizaciones UI.
- Uso de Web APIs estándar (fetch, localStorage).

##### Tecnologías y librerías clave
- HTML5 para el marcado semántico.
- CSS3 para el diseño responsivo y estilizado.
- JavaScript ES6+ (módulos IIFE o estructuración en objetos).
- Fetch API para llamadas HTTP.
- Web Storage API para persistencia en localStorage.

##### Guías para el diagrama (que se vea clara)
- Usa formas distintas:
- Rectángulos para componentes de front-end (Navegador, módulos JS).
- Cilindro para localStorage.
- Nube o ícono de servicio para RandomUser API.
- Flechas direccionales numeradas (1,2,3…) mostrando el orden de las interacciones.
- Colores consistentes:
- Azul claro → UI / navegador
- Verde → lógica JS
- Amarillo → almacenamiento
- Gris → servicio externo
- Etiquetas en flechas: “fetch() →”, “.json() →”, “localStorage.setItem() →”, “render() →”.
- Agrupa los tres submódulos JS en un contenedor “script.js” con fondo tenue para enfatizar que son parte del mismo archivo.

##### Resultado esperado
Un diagrama limpio y preciso donde se distingan claramente:
- El cliente web (browser)
- El flujo de llamadas a la API externa
- La gestión de persistencia local
- La actualización del DOM vía JavaScript

Con estos elementos tendrás una representación fiel y muy clara de la arquitectura de la aplicación de generación de perfiles aleatorios.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Layers and components
    B["Browser (Client)"]:::browser
    HTML["index.html"]:::browser
    CSS["style.css"]:::browser

    subgraph "script.js"
        direction TB
        UI["UI Controller"]:::logic
        API["API Client"]:::logic
        SM["Storage Manager"]:::logic
    end

    RU["RandomUser API"]:::external
    LS["localStorage"]:::storage

    %% Interactions
    B -->|"loads DOM"| HTML
    B -->|"loads CSS"| CSS

    B -->|"1.Click Generate"| UI
    UI -->|"2.fetch() →"| API
    API -->|"2.fetch() →"| RU
    RU -->|"3..json() →"| API
    API -->|"4.response →"| UI
    UI -->|"render() → Updates DOM"| B

    UI -->|"5.localStorage.setItem() →"| SM
    SM -->|"6.getItem()/removeItem() →"| UI
    SM -->|"uses Web Storage →"| LS

    %% Click events
    click HTML "https://github.com/sebin3/generar-perfil-aleatorio/blob/main/index.html"
    click CSS "https://github.com/sebin3/generar-perfil-aleatorio/blob/main/style.css"
    click UI "https://github.com/sebin3/generar-perfil-aleatorio/blob/main/script.js"
    click API "https://github.com/sebin3/generar-perfil-aleatorio/blob/main/script.js"
    click SM "https://github.com/sebin3/generar-perfil-aleatorio/blob/main/script.js"

    %% Styles
    classDef browser fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef logic fill:#90EE90,stroke:#333,stroke-width:1px
    classDef storage fill:#FFD700,stroke:#333,stroke-width:1px
    classDef external fill:#D3D3D3,stroke:#333,stroke-width:1px
```
