How sebin3/generar-perfil-aleatorio works
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.