# 504-sistemas/uth-florida architecture

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

- Interactive diagram: https://gitdiagram.com/504-sistemas/uth-florida
- Repository: https://github.com/504-sistemas/uth-florida

## Overview

Aquí tienes una explicación detallada para diseñar un diagrama de arquitectura que represente de manera precisa la estructura y el funcionamiento del proyecto UTH Florida:

##### Identificar el tipo y propósito del proyecto
- Se trata de una aplicación web full-stack que integra un backend desarrollado en PHP (utilizando Apache, PDO y MySQL/MariaDB) y un frontend construido con React (apoyado en React Bootstrap y React Router DOM).
- El propósito es gestionar usuarios, autenticación y manejo de datos (crear, actualizar, eliminar y listar registros), lo que se evidencia en la estructura de archivos y en los procedimientos almacenados descritos en el README.

##### Análisis de la estructura de archivos
- En nivel superior se encuentran dos carpetas principales:
- backend: contiene la lógica del servidor, organizada en subdirectorios para controladores (controllers), modelos (models), middleware, configuraciones (config), rutas (routes.php), y archivos públicos (public/) que se exponen a través de Apache.
- frontend: contiene la aplicación cliente React, con su propia estructura de carpetas (src, public) y archivos de configuración (package.json, etc.).
- Además, se identifican archivos de configuración importantes (Database.php, .htaccess para reglas de redireccionamiento/CORS) y scripts SQL en backend/db.

##### Componentes principales a incluir en el diagrama
a. Frontend:
- Representa la interfaz de usuario: utiliza React y Bootstrap.
- Componentes clave: páginas (Login, Register, Dashboard) y el manejo de rutas (React Router DOM).
b. Backend:
- Incluye la capa de controladores (como AuthController, DataController, UserController) para gestionar la lógica de negocio.
- La capa de middleware (por ejemplo, AuthMiddleware) que se encarga de la autorización y validaciones.
- Modelos (User, Data) para la representación de entidades y conexión a la base de datos.
- Un archivo central de rutas (routes.php) que enruta las peticiones HTTP.
c. Base de datos:
- MySQL/MariaDB que contiene las tablas “users” y “datos”, así como procedimientos almacenados para operaciones CRUD y autenticación.
d. Servidor / Infraestructura:
- Apache (con XAMPP en desarrollo) que sirve el backend (y maneja configuraciones de CORS).

##### Relaciones e interacciones
- Conexión entre Frontend y Backend:
- Las aplicaciones React consumen una API REST alojada en el backend (acciones como autenticación, inserción, actualización, eliminación y consulta de datos).
- Es importante mostrar flechas direccionales desde el componente cliente hacia el backend, indicando las peticiones HTTP y respuestas.
- Comunicación interna en el backend:
- Los controladores reciben solicitudes, pasan por middleware (que valida la autenticidad y permisos) y utilizan los modelos para interactuar con la base de datos.
- Se puede representar la secuencia: Cliente → API Gateway (routes.php) → Middleware → Controlador → Modelo → Base de datos.

##### Patrones de diseño y principios arquitectónicos
- Se observa una separación clara de responsabilidades (MVC: Modelos, Vistas/Páginas, Controladores).
- El uso de procedimientos almacenados en MySQL para operaciones de datos, lo que indica encapsulamiento de lógica de base de datos.
- En el frontend se maneja un patrón basado en componentes en React.

##### Tecnologías, frameworks y bibliotecas relevantes
- Backend: PHP 8+, MySQL/MariaDB, Apache, PDO.
- Frontend: React 18+, React Router DOM, React Bootstrap.
- Integración y comunicación: API REST (manejada desde routes.php) y configuración de CORS en Apache.

##### Directrices para elaborar el diagrama
- Dividir el diagrama en secciones claras:
- Una sección para el Frontend (cliente React) y otra para el Backend (servidor PHP) junto con la Base de datos.
- Incluir flechas direccionadas que muestren:
- Solicitudes y respuestas (por ejemplo, desde el navegador -> API backend -> base de datos).
- Flujo de datos entre controladores, modelos y la base de datos.
- Usar etiquetas claras para cada componente: “Frontend (React)”, “Backend (PHP)”, “Base de Datos (MySQL)”, “Middleware (AuthMiddleware)” etc.
- Aplicar codificación por colores o diferentes formas (rectángulos para módulos, cilindros para bases de datos, etc.) para diferenciar categóricamente:
- Componentes de presentación versus componentes de negocio y almacenamiento.
- Asegurarse de marcar elementos configurables o variables (como la configuración de puertos en Apache para backend) que afecten la conexión de los componentes.
- Resaltar en el diagrama la integración de tecnologías específicas (por ejemplo, la interacción entre el backend que utiliza PDO y la base de datos MySQL; o el consumo de la API en el frontend).

Con estos puntos y la información extraída tanto del árbol de archivos como del README, el diagrama resultante podrá reflejar una imagen completa de la arquitectura del proyecto. Esto proporcionará a cualquier desarrollador o ingeniero principal una visión clara del flujo de datos, la separación de responsabilidades y el conjunto de tecnologías en uso. No dudes en ser muy detallado al etiquetar cada componente y sus interacciones para garantizar la precisión y claridad en la arquitectura.

¡Buena suerte con el diagrama!

## Diagram (Mermaid)

```mermaid
graph TD
    %% Frontend Layer
    subgraph "Frontend Layer"
        F1["Frontend (React App)"]:::frontend
        F2["Login Page"]:::frontend
        F3["Register Page"]:::frontend
        F4["Dashboard"]:::frontend
        F5["Routing & Entry"]:::frontend
    end

    %% Backend Layer
    subgraph "Backend Layer"
        S1["Apache (XAMPP)"]:::server
        B1["API Gateway (routes.php)"]:::backend
        B2["Auth Middleware"]:::backend
        B3["Auth Controller"]:::backend
        B4["Data Controller"]:::backend
        B5["User Controller"]:::backend
        M1["User Model"]:::backend
        M2["Data Model"]:::backend
        Cfg["DB Configuration"]:::backend
        AC["Apache Configuration (.htaccess)"]:::backend
    end

    %% Database Layer
    subgraph "Database Layer"
        D1["MySQL/MariaDB Database"]:::database
        D2["Database Procedures"]:::database
    end

    %% Frontend internal connections
    F1 -->|"includes"| F2
    F1 -->|"includes"| F3
    F1 -->|"includes"| F4
    F1 -->|"includes"| F5

    %% Overall system flow: Frontend -> Backend -> Database
    F1 -->|"HTTP_Request"| S1
    S1 -->|"forwards to"| B1
    B1 -->|"invokes"| B2
    B2 -->|"calls"| B3
    B2 -->|"calls"| B4
    B2 -->|"calls"| B5
    B3 -->|"uses"| M1
    B4 -->|"uses"| M2
    B5 -->|"uses"| M1
    M1 -->|"reads_config"| Cfg
    M2 -->|"reads_config"| Cfg
    Cfg -->|"connects_to"| D1
    D1 -->|"executes"| D2

    %% Click Events
    click F1 "https://github.com/504-sistemas/uth-florida/tree/main/frontend/"
    click F2 "https://github.com/504-sistemas/uth-florida/blob/main/frontend/src/pages/Login.js"
    click F3 "https://github.com/504-sistemas/uth-florida/blob/main/frontend/src/pages/Register.js"
    click F4 "https://github.com/504-sistemas/uth-florida/blob/main/frontend/src/pages/Dashboard.js"
    click F5 "https://github.com/504-sistemas/uth-florida/blob/main/frontend/src/App.js and frontend/src/index.js"
    click B1 "https://github.com/504-sistemas/uth-florida/blob/main/backend/routes.php"
    click B3 "https://github.com/504-sistemas/uth-florida/blob/main/backend/app/controllers/AuthController.php"
    click B4 "https://github.com/504-sistemas/uth-florida/blob/main/backend/app/controllers/DataController.php"
    click B5 "https://github.com/504-sistemas/uth-florida/blob/main/backend/app/controllers/UserController.php"
    click B2 "https://github.com/504-sistemas/uth-florida/blob/main/backend/app/middleware/AuthMiddleware.php"
    click M1 "https://github.com/504-sistemas/uth-florida/blob/main/backend/app/models/User.php"
    click M2 "https://github.com/504-sistemas/uth-florida/blob/main/backend/app/models/Data.php"
    click Cfg "https://github.com/504-sistemas/uth-florida/blob/main/backend/config/Database.php"
    click AC "https://github.com/504-sistemas/uth-florida/blob/main/backend/public/.htaccess"
    click D2 "https://github.com/504-sistemas/uth-florida/blob/main/backend/db/prueba_tecnica.sql"

    %% Styles
    classDef frontend fill:#e3f2fd,stroke:#1e88e5,stroke-width:2px;
    classDef backend fill:#fce4ec,stroke:#c2185b,stroke-width:2px;
    classDef database fill:#e8f5e9,stroke:#388e3c,stroke-width:2px;
    classDef server fill:#fff3e0,stroke:#f57c00,stroke-width:2px;
```
