# miqueias26/sigueai architecture

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

- Interactive diagram: https://gitdiagram.com/miqueias26/sigueai
- Repository: https://github.com/miqueias26/sigueai

## Overview

Para representar con precisión la arquitectura de SigueAI, sigue los pasos detallados a continuación y ajústalos al contexto específico de este proyecto full-stack (frontend React/Vite + backend Node.js/Express). El diagrama resultante te ayudará a visualizar componentes, flujos de datos y dependencias externas de forma clara y profesional.

##### Identificación del tipo de proyecto y propósito
- Es una aplicación web full-stack de “ayuda emocional” que expone un frontend SPA en React (SigueAI-WEB) y un backend en Node.js/Express (SigueAI-API).
- Usa la API de OpenAI para chat conversacional y un servicio de formularios (Web3Forms) para la sección de contactos.

##### Análisis de la estructura de ficheros
- Top-level:
- SigueAI-WEB: proyecto frontend con Vite, React, Tailwind CSS, React Router, Framer Motion, Web3Forms API.
- SigueAI-API: project backend con Node.js, Express, dotenv, cors y OpenAI SDK.
- Archivos de despliegue: vercel.json en ambos para hosting en Vercel.
- No hay base de datos propia: toda la “lógica persistente” externa recae en OpenAI (modelo de chat) y Web3Forms (almacena formularios).

##### Insights del README
- Stack frontend: React + Vite + Tailwind + animaciones (Framer Motion).
- Stack backend: Node.js + Express + OpenAI SDK.
- Despliegue: Vercel.
- Flujos principales:
a. Usuario interactúa con la SPA.
b. SPA invoca endpoints de la API Express.
c. API habla con OpenAI y devuelve respuesta.
d. SPA envía formularios de contacto a Web3Forms.

##### Componentes principales y sus interacciones
a. Frontend (SigueAI-WEB)
- Browser/Cliente React SPA
- Módulos: rutas (React Router), componentes UI, servicio Web3FormsAPI, llamadas al backend.
b. Backend (SigueAI-API)
- Servidor Express
- Endpoints: /chat (OpenAI), /contact (reenruta a Web3Forms o a un endpoint propio)
- Variables de entorno (.env) para claves OpenAI y configuraciones CORS.
c. Servicios externos
- OpenAI API (modelo GPT para conversación)
- Web3Forms (procesamiento de formularios de contacto)
d. Hosting/Deploy
- Vercel (front y API como serverless functions o servidor Node).

##### Guía para el diagrama
- Distingue tres capas con colores o formas:
- Frontend (rectángulo azul)
- Backend (rectángulo verde)
- Servicios externos (rectángulos amarillos)
- Incluye un contenedor “Vercel” que englobe front y API, indicando el hosting.
- Flechas direccionales:
1. Usuario → React SPA
2. SPA → Endpoint Express (/chat, /contact)
3. Express → OpenAI API
4. Express → Web3Forms API (solo contacto)
5. OpenAI/Web3Forms → Express → SPA → Usuario
- Señala protocolos (HTTPS) y puertos si lo deseas.
- Usa iconos pequeños o logos para React, Node.js, OpenAI, Web3Forms, Vercel (opcional).

##### Patrones y principios arquitectónicos
- SPA desacoplada del backend (aplicación cliente-servidor REST).
- Uso de serverless (Vercel) o servidor Express estándar.
- Single Responsibility:
- Frontend = UI / UX
- Backend = Orquestación OpenAI + seguridad CORS/env
- Servicios externos = AI / formularios
- Variables de entorno (dotenv) para configuración sensible.

##### Elementos que no deben faltar
- Líneas y flechas claras con dirección definida.
- Etiquetas: nombres de componentes (AppRoutes, index.js, index.html, endpoints).
- Leyenda de colores/formas.
- Notas breves sobre tecnologías principales en cada bloque (e.g., “Express + OpenAI SDK”).

Resumen de pasos:
##### Conecta con flechas numeradas el flujo de datos.

Esto capturará la esencia arquitectónica de SigueAI, mostrando claramente separación de capas, flujos y dependencias externas. Mantén el diagrama lo más detallado posible sin sobrecargarlo: cada repositorio, servicio y framework clave debe estar etiquetado y enlazado según el flujo real de la aplicación.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Vercel"
        direction TB

        subgraph "Frontend (React SPA)"
            direction TB
            User["User Browser"]:::frontend
            Client["React SPA"]:::frontend
            User --> Client

            Entry["Entry Point<br>main.jsx & index.html"]:::code
            Client --> Entry

            Routing["Routing<br>AppRoutes.jsx"]:::frontend
            Entry --> Routing

            subgraph "UI Components"
                direction TB
                Header["Header"]:::frontend
                Hero["Hero"]:::frontend
                Footer["Footer"]:::frontend
            end
            Entry --> Header
            Entry --> Hero
            Entry --> Footer

            subgraph "Pages/Views"
                direction TB
                Chat["Chat.jsx"]:::frontend
                Contactos["Contactos.jsx"]:::frontend
                Home["Home.jsx"]:::frontend
                Politica["Politica de Privacidad<br>PoliticadePrivacidad.jsx"]:::frontend
                Sobre["Sobre Nosotros<br>SobreNosotros.jsx"]:::frontend
            end
            Entry --> Chat
            Entry --> Contactos
            Entry --> Home
            Entry --> Politica
            Entry --> Sobre

            Anim["Animations<br>Motion.jsx"]:::frontend
            Entry --> Anim

            Services["Web3Forms Service<br>Web3FormsAPI.jsx"]:::frontend
            Entry --> Services

            subgraph "Styles & Config"
                direction TB
                Tailwind["tailwind.config.js"]:::code
                PostCSS["postcss.config.js"]:::code
                IndexCSS["index.css"]:::code
                AppCSS["App.css"]:::code
            end
            Entry --> Tailwind
            Entry --> PostCSS
            Entry --> IndexCSS
            Entry --> AppCSS

            subgraph "Build & Deployment Config"
                direction TB
                ViteCFG["vite.config.js"]:::code
                VercelCFG_F["vercel.json"]:::code
            end
            Entry --> ViteCFG
            Entry --> VercelCFG_F
        end

        subgraph "Backend (Node.js/Express)"
            direction TB
            Server["Express Server<br>index.js"]:::backend

            Env["dotenv + cors + OpenAI SDK<br>index.js"]:::backend
            Server --> Env

            VercelCFG_B["vercel.json"]:::code
            Server --> VercelCFG_B

            Package["package.json<br>package-lock.json"]:::code
            Server --> Package

            Dist["dist/index.html"]:::code
            Server --> Dist
        end
    end

    subgraph "External Services"
        direction TB
        OA["OpenAI API"]:::external
        WF["Web3Forms API"]:::external
    end

    Client -->|"/chat"| Server
    Client -->|"/contact"| Server
    Server -->|"OpenAI chat"| OA
    Server -->|"Web3Forms submit"| WF
    OA -->|"response"| Server
    WF -->|"ack"| Server
    Server -->|"response"| Client

    click Entry "https://github.com/miqueias26/sigueai/blob/main/SigueAI-WEB/src/main.jsx"
    click Client "https://github.com/miqueias26/sigueai/blob/main/SigueAI-WEB/index.html"
    click Routing "https://github.com/miqueias26/sigueai/blob/main/SigueAI-WEB/src/routes/AppRoutes.jsx"
    click Header "https://github.com/miqueias26/sigueai/blob/main/SigueAI-WEB/src/components/header/header.jsx"
    click Hero "https://github.com/miqueias26/sigueai/blob/main/SigueAI-WEB/src/components/hero/Hero.jsx"
    click Footer "https://github.com/miqueias26/sigueai/blob/main/SigueAI-WEB/src/components/footer/Footer.jsx"
    click Chat "https://github.com/miqueias26/sigueai/blob/main/SigueAI-WEB/src/pages/Chat.jsx"
    click Contactos "https://github.com/miqueias26/sigueai/blob/main/SigueAI-WEB/src/pages/Contactos.jsx"
    click Home "https://github.com/miqueias26/sigueai/blob/main/SigueAI-WEB/src/pages/Home.jsx"
    click Politica "https://github.com/miqueias26/sigueai/blob/main/SigueAI-WEB/src/pages/PoliticadePrivacidad.jsx"
    click Sobre "https://github.com/miqueias26/sigueai/blob/main/SigueAI-WEB/src/pages/SobreNosotros.jsx"
    click Anim "https://github.com/miqueias26/sigueai/blob/main/SigueAI-WEB/src/animations/Motion.jsx"
    click Tailwind "https://github.com/miqueias26/sigueai/blob/main/SigueAI-WEB/tailwind.config.js"
    click PostCSS "https://github.com/miqueias26/sigueai/blob/main/SigueAI-WEB/postcss.config.js"
    click IndexCSS "https://github.com/miqueias26/sigueai/blob/main/SigueAI-WEB/src/index.css"
    click AppCSS "https://github.com/miqueias26/sigueai/blob/main/SigueAI-WEB/src/App.css"
    click Services "https://github.com/miqueias26/sigueai/blob/main/SigueAI-WEB/src/services/Web3FormsAPI.jsx"
    click ViteCFG "https://github.com/miqueias26/sigueai/blob/main/SigueAI-WEB/vite.config.js"
    click VercelCFG_F "https://github.com/miqueias26/sigueai/blob/main/SigueAI-WEB/vercel.json"
    click Server "https://github.com/miqueias26/sigueai/blob/main/SigueAI-API/index.js"
    click VercelCFG_B "https://github.com/miqueias26/sigueai/blob/main/SigueAI-API/vercel.json"
    click Package "https://github.com/miqueias26/sigueai/blob/main/SigueAI-API/package.json"
    click Dist "https://github.com/miqueias26/sigueai/blob/main/SigueAI-API/dist/index.html"

    classDef frontend fill:#BBDEFB,stroke:#1E88E5;
    classDef backend fill:#C8E6C9,stroke:#43A047;
    classDef external fill:#FFF9C4,stroke:#F9A825;
    classDef code fill:#E0E0E0,stroke:#9E9E9E;
```
