# ch3557er/encriptadordetextos-one-g7 architecture

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

- Interactive diagram: https://gitdiagram.com/ch3557er/encriptadordetextos-one-g7
- Repository: https://github.com/ch3557er/encriptadordetextos-one-g7

## Overview

A continuación se explica cómo puedes elaborar un diagrama de diseño del sistema que represente acertadamente la arquitectura de este proyecto de encriptación web:

##### Identificar el tipo y propósito del proyecto
- Se trata de una aplicación web simple cuyo objetivo es encriptar y desencriptar textos basándose en reglas definidas. Está diseñada exclusivamente en tecnologías front-end (HTML, CSS y JavaScript) y alojada para GitHub Pages.
- Debido a su objetivo, no hay división entre frontend y backend; toda la lógica y la interfaz residen en el navegador.

##### Componentes principales a incluir
a. Interfaz de Usuario (UI):
- index.html: Estructura HTML que contiene el área de entrada de texto, los botones (Encriptar, Desencriptar y Copiar) y el área de resultados.
- assets (si contiene imágenes u otros recursos estáticos que enriquezcan la UI).
b. Lógica de Aplicación:
- app.js: Contiene el código JavaScript que manipula el DOM, realiza la validación de las entradas y ejecuta las funciones de encriptación y desencriptación.
c. Presentación / Estilo:
- styles (reset.css y style.css): Archivos responsables de la apariencia visual, el layout y la experiencia de usuario según la referencia Figma.

##### Relaciones e Interacciones entre los Componentes
- La página HTML carga y presenta el contenido, incluyendo el formulario para capturar el texto del usuario.
- Al interactuar (por ejemplo, al pulsar el botón "Encriptar" o "Desencriptar"), el HTML comunica el evento al archivo app.js mediante selectores y manejadores de eventos.
- app.js procesa la entrada realizando validaciones (límites a solo letras minúsculas) y llama a las funciones de encriptar o desencriptar.
- El resultado obtenido lo inyecta en la interfaz (área de resultados) y ofrece la funcionalidad adicional de copiar el resultado mediante la API del portapapeles.
- Los estilos (CSS) se aplican a los elementos HTML para garantizar una experiencia visual consistente y acorde al diseño.

##### Principales patrones y principios usados
- Separación de responsabilidades: HTML para estructurar, CSS para el estilo y JavaScript para la lógica.
- Validación del input del usuario y transformación de datos mediante funciones específicas de encriptación/desencriptación.

##### Tecnologías y librerías relevantes
- HTML y CSS básicos (sin frameworks específicos).
- JavaScript puro para manipulación del DOM y lógica de negocio.
- API del portapapeles para la función de copiar texto.

##### Guía para el diagrama del sistema
- Representa cada uno de los componentes como nodos claramente etiquetados:
- "HTML (index.html)" – mostrar estructuras de entrada y salida.
- "JavaScript (app.js)" – para procesamiento, validación y funciones de encriptación/desencriptación.
- "CSS (styles/reset.css y style.css)" – para el estilo y layout.
- "Assets" – para recursos estáticos (si aplican).
- Indica con flechas la comunicación entre ellos:
- Una flecha desde "Usuario" hacia "HTML" para indicar la entrada (texto, botones).
- Una flecha desde "HTML" hacia "JavaScript" señalando how los eventos (clics) desencadenan funciones en app.js.
- Una flecha desde "JavaScript" de regreso a "HTML" para actualizar la interfaz con el resultado.
- Una conexión que muestra la inclusión de los archivos CSS en el HTML (puedes usar líneas punteadas o flechas etiquetadas como “estilos”).
- Incluye notas sobre validaciones y flujos importantes (por ejemplo, validación de entrada, copia al portapapeles).

##### Personalización del diagrama para este proyecto
- Dada la simplicidad y la naturaleza front-end exclusiva, enfoca el diagrama en ilustrar el flujo de datos desde la interfaz de usuario hacia la función de procesamiento en JavaScript y viceversa.
- Usa colores o formas diferentes para distinguir entre capa de presentación (HTML/CSS) y capa lógica (JavaScript).
- Asegúrate de marcar claramente los botones “Encriptar”, “Desencriptar” y “Copiar”, para resaltar los puntos de interacción del usuario.

##### Elementos clave en el diagrama
- Cada componente (HTML, JavaScript, CSS, Assets) debidamente etiquetado.
- Flechas direccionales que indiquen el flujo de datos/eventos:
- Entrada de texto del usuario.
- Procesamiento en app.js.
- Actualización en el DOM (salida de resultados).
- Notas sobre las validaciones y funciones específicas (por ejemplo, “Validar solo minúsculas”, “Transformación de ‘e’ a ‘enter’, etc.”).
- Uso de colores y formas para diferenciar entre la vista (UI) y la lógica (funciones) y recursos de estilo.

Este diagrama no sólo ayudará a visualizar la arquitectura del proyecto sino también a identificar los puntos donde podrían surgir futuros cambios o mejoras, facilitando la comprensión y mantenimiento de la aplicación. ¡Buena suerte en la elaboración del diagrama!

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Global Nodes
    U("Usuario"):::external

    %% Capa de Presentación
    subgraph "Capa de Presentación"
        HTML["HTML (index.html)"]:::ui
        ENCR["Botón Encriptar"]:::ui
        DECR["Botón Desencriptar"]:::ui
        COPY["Botón Copiar"]:::ui
        CSS1["CSS (reset.css)"]:::ui
        CSS2["CSS (style.css)"]:::ui
        ASSETS["Assets"]:::ui
    end

    %% Capa Lógica
    subgraph "Lógica de Aplicación"
        JS["JavaScript (app.js)"]:::logic
    end

    %% Relaciones
    U -->|"ingresaTexto"| HTML
    HTML -->|"clickEnBotón"| ENCR
    HTML -->|"clickEnBotón"| DECR
    HTML -->|"clickEnBotón"| COPY

    ENCR -->|"procesaEvento"| JS
    DECR -->|"procesaEvento"| JS
    COPY -->|"procesaEvento"| JS

    JS -->|"actualizaDOM"| HTML

    HTML -- "estilos" --- CSS1
    HTML -- "estilos" --- CSS2
    HTML -- "incluyeRecursos" --- ASSETS

    %% Click Events
    click HTML "https://github.com/ch3557er/encriptadordetextos-one-g7/blob/main/index.html"
    click ASSETS "https://github.com/ch3557er/encriptadordetextos-one-g7/tree/main/assets"
    click JS "https://github.com/ch3557er/encriptadordetextos-one-g7/blob/main/app.js"
    click CSS1 "https://github.com/ch3557er/encriptadordetextos-one-g7/blob/main/styles/reset.css"
    click CSS2 "https://github.com/ch3557er/encriptadordetextos-one-g7/blob/main/styles/style.css"

    %% Styles
    classDef ui fill:#F7DBFF,stroke:#A64AC9,stroke-width:2px;
    classDef logic fill:#D0E6A5,stroke:#66B032,stroke-width:2px;
    classDef external fill:#FFECB3,stroke:#FFA000,stroke-width:2px;
```
