# manolora67-cloud/tourismeasy architecture

> Architecture diagram of the GitHub repository manolora67-cloud/tourismeasy, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/manolora67-cloud/tourismeasy
- Repository: https://github.com/manolora67-cloud/tourismeasy

## Overview

TourismEasy is a Santander tourism-discovery platform connecting travelers with destinations and tourism providers, with no traveler accounts. Travelers explore catalogs, maps and the 3D metaverse, ask the Sue assistant, and contact providers through WhatsApp; businesses and administrators manage listings and accounts. The graph preserves the documented discovery, commerce, accessibility and administration branches. Some feature paths are directory-level because their implementation was not sampled; edges are limited to README-documented relationships or visible source references.

Main entry points: [`con_db/db.php`](https://github.com/manolora67-cloud/tourismeasy/blob/main/con_db/db.php) (PDO connection), [`admin`](https://github.com/manolora67-cloud/tourismeasy/tree/main/admin) (Admin portal), [`login/login.php`](https://github.com/manolora67-cloud/tourismeasy/blob/main/login/login.php) (Login and recovery), [`api/ia_sue.php`](https://github.com/manolora67-cloud/tourismeasy/blob/main/api/ia_sue.php) (Sue assistant)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Traveler discovery"]
  node_destinations["Destinations<br/>[destinos.js]"]
  node_destination_map["Interactive map<br/>[mapa.js]"]
  node_metaverse["3D metaverse<br/>[metaverso.js]"]
  node_catalogs["Travel catalogs"]
  node_sue["Sue assistant<br/>[ia_sue.php]"]
  node_reviews["Reviews"]
  node_whatsapp["WhatsApp contact"]
end

subgraph group_business["Tourism services"]
  node_business_accounts["Business accounts"]
  node_artisan_shop["Artisan products<br/>[admin.php]"]
  node_image_upload["Image uploads<br/>[subir_imagen.php]"]
  node_cloudinary["Cloudinary"]
end

subgraph group_admin["Administration"]
  node_admin_portal["Admin portal"]
  node_security_settings["Security settings<br/>[seguridad.php]"]
  node_click_metrics["Click metrics"]
  node_audit_export["Audit export"]
end

subgraph group_identity["Accounts and security"]
  node_auth["Login and recovery<br/>[login.php]"]
  node_device_approval["Device approval"]
  node_sessions["Persistent sessions"]
end

subgraph group_shared["Shared platform"]
  node_database[("PostgreSQL")]
  node_db_connection["PDO connection<br/>[db.php]"]
  node_accessibility["Accessibility menu<br/>[menu.js]"]
  node_translation["Local translation<br/>[traductor.js]"]
  node_email["Recovery email"]
  node_groq["Groq service"]
end

node_traveler(("Traveler"))

node_traveler -->|"explores"| node_destinations
node_traveler -->|"browses"| node_destination_map
node_traveler -->|"explores"| node_metaverse
node_traveler -->|"searches"| node_catalogs
node_traveler -->|"asks"| node_sue
node_traveler -->|"reacts to"| node_reviews
node_traveler -->|"contacts via"| node_whatsapp
node_business_accounts -.->|"manages listings"| node_catalogs
node_artisan_shop -.->|"uploads images"| node_image_upload
node_image_upload -->|"uploads to"| node_cloudinary
node_admin_portal -->|"configures"| node_security_settings
node_admin_portal -->|"views"| node_click_metrics
node_admin_portal -->|"downloads"| node_audit_export
node_auth -->|"requests approval"| node_device_approval
node_device_approval -->|"sends code"| node_email
node_auth -->|"starts session"| node_sessions
node_auth -->|"queries"| node_db_connection
node_device_approval -->|"uses PDO"| node_db_connection
node_db_connection -->|"connects"| node_database
node_sue -->|"queries catalogs"| node_db_connection
node_sue -.->|"may consult"| node_groq
node_accessibility -->|"supports language"| node_translation

click node_destinations "https://github.com/manolora67-cloud/tourismeasy/blob/main/componentes/destinos.js"
click node_destination_map "https://github.com/manolora67-cloud/tourismeasy/blob/main/mapa_interactuable/mapa.js"
click node_metaverse "https://github.com/manolora67-cloud/tourismeasy/blob/main/metaverso/metaverso.js"
click node_catalogs "https://github.com/manolora67-cloud/tourismeasy/tree/main/planes"
click node_sue "https://github.com/manolora67-cloud/tourismeasy/blob/main/api/ia_sue.php"
click node_reviews "https://github.com/manolora67-cloud/tourismeasy/tree/main/resenas"
click node_whatsapp "https://github.com/manolora67-cloud/tourismeasy/blob/main/api/registrar_click_whatsapp.php"
click node_business_accounts "https://github.com/manolora67-cloud/tourismeasy/tree/main/soli_empresas"
click node_artisan_shop "https://github.com/manolora67-cloud/tourismeasy/blob/main/e-commerce/admin.php"
click node_image_upload "https://github.com/manolora67-cloud/tourismeasy/blob/main/subir_imagen.php"
click node_admin_portal "https://github.com/manolora67-cloud/tourismeasy/tree/main/admin"
click node_security_settings "https://github.com/manolora67-cloud/tourismeasy/blob/main/admin/seguridad.php"
click node_click_metrics "https://github.com/manolora67-cloud/tourismeasy/blob/main/login/get_estadisticas_clicks.php"
click node_audit_export "https://github.com/manolora67-cloud/tourismeasy/blob/main/login/exportar_auditoria_mensual_admin.php"
click node_auth "https://github.com/manolora67-cloud/tourismeasy/blob/main/login/login.php"
click node_device_approval "https://github.com/manolora67-cloud/tourismeasy/blob/main/con_db/aprobacion_dispositivo.php"
click node_sessions "https://github.com/manolora67-cloud/tourismeasy/blob/main/con_db/sesion_persistente.php"
click node_db_connection "https://github.com/manolora67-cloud/tourismeasy/blob/main/con_db/db.php"
click node_accessibility "https://github.com/manolora67-cloud/tourismeasy/blob/main/menu_accesibilidad/menu.js"
click node_translation "https://github.com/manolora67-cloud/tourismeasy/blob/main/translate/traductor.js"
click node_email "https://github.com/manolora67-cloud/tourismeasy/blob/main/recuperacion/servicio_correo.php"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_destinations,node_destination_map,node_metaverse,node_catalogs,node_sue,node_reviews,node_whatsapp toneBlue
class node_business_accounts,node_artisan_shop,node_image_upload,node_cloudinary toneAmber
class node_admin_portal,node_security_settings,node_click_metrics,node_audit_export toneMint
class node_auth,node_device_approval,node_sessions toneRose
class node_database,node_db_connection,node_accessibility,node_translation,node_email,node_groq,node_traveler toneIndigo
```

## Components

### Traveler discovery

- [Destinations](https://github.com/manolora67-cloud/tourismeasy/blob/main/componentes/destinos.js): `componentes/destinos.js`
- [Interactive map](https://github.com/manolora67-cloud/tourismeasy/blob/main/mapa_interactuable/mapa.js): `mapa_interactuable/mapa.js`
- [3D metaverse](https://github.com/manolora67-cloud/tourismeasy/blob/main/metaverso/metaverso.js): `metaverso/metaverso.js`
- [Travel catalogs](https://github.com/manolora67-cloud/tourismeasy/tree/main/planes): `planes`
- [Sue assistant](https://github.com/manolora67-cloud/tourismeasy/blob/main/api/ia_sue.php): `api/ia_sue.php`
- [Reviews](https://github.com/manolora67-cloud/tourismeasy/tree/main/resenas): `resenas`
- [WhatsApp contact](https://github.com/manolora67-cloud/tourismeasy/blob/main/api/registrar_click_whatsapp.php): `api/registrar_click_whatsapp.php`

### Tourism services

- [Business accounts](https://github.com/manolora67-cloud/tourismeasy/tree/main/soli_empresas): `soli_empresas`
- [Artisan products](https://github.com/manolora67-cloud/tourismeasy/blob/main/e-commerce/admin.php): `e-commerce/admin.php`
- [Image uploads](https://github.com/manolora67-cloud/tourismeasy/blob/main/subir_imagen.php): `subir_imagen.php`
- **Cloudinary**

### Administration

- [Admin portal](https://github.com/manolora67-cloud/tourismeasy/tree/main/admin): `admin`
- [Security settings](https://github.com/manolora67-cloud/tourismeasy/blob/main/admin/seguridad.php): `admin/seguridad.php`
- [Click metrics](https://github.com/manolora67-cloud/tourismeasy/blob/main/login/get_estadisticas_clicks.php): `login/get_estadisticas_clicks.php`
- [Audit export](https://github.com/manolora67-cloud/tourismeasy/blob/main/login/exportar_auditoria_mensual_admin.php): `login/exportar_auditoria_mensual_admin.php`

### Accounts and security

- [Login and recovery](https://github.com/manolora67-cloud/tourismeasy/blob/main/login/login.php): `login/login.php`
- [Device approval](https://github.com/manolora67-cloud/tourismeasy/blob/main/con_db/aprobacion_dispositivo.php): `con_db/aprobacion_dispositivo.php`
- [Persistent sessions](https://github.com/manolora67-cloud/tourismeasy/blob/main/con_db/sesion_persistente.php): `con_db/sesion_persistente.php`

### Shared platform

- **PostgreSQL**
- [PDO connection](https://github.com/manolora67-cloud/tourismeasy/blob/main/con_db/db.php): `con_db/db.php`
- [Accessibility menu](https://github.com/manolora67-cloud/tourismeasy/blob/main/menu_accesibilidad/menu.js): `menu_accesibilidad/menu.js`
- [Local translation](https://github.com/manolora67-cloud/tourismeasy/blob/main/translate/traductor.js): `translate/traductor.js`
- [Recovery email](https://github.com/manolora67-cloud/tourismeasy/blob/main/recuperacion/servicio_correo.php): `recuperacion/servicio_correo.php`
- **Groq service**

### Other components

- **Traveler**

## Connections

- Traveler → Destinations: explores
- Traveler → Interactive map: browses
- Traveler → 3D metaverse: explores
- Traveler → Travel catalogs: searches
- Traveler → Sue assistant: asks
- Traveler → Reviews: reacts to
- Traveler → WhatsApp contact: contacts via
- Business accounts → Travel catalogs: manages listings
- Artisan products → Image uploads: uploads images
- Image uploads → Cloudinary: uploads to (evidence: `subir_imagen.php`)
- Admin portal → Security settings: configures (evidence: `admin/seguridad.php`)
- Admin portal → Click metrics: views
- Admin portal → Audit export: downloads
- Login and recovery → Device approval: requests approval (evidence: `login/login.php`)
- Device approval → Recovery email: sends code (evidence: `con_db/aprobacion_dispositivo.php`)
- Login and recovery → Persistent sessions: starts session (evidence: `login/login.php`)
- Login and recovery → PDO connection: queries (evidence: `login/login.php`)
- Device approval → PDO connection: uses PDO (evidence: `con_db/aprobacion_dispositivo.php`)
- PDO connection → PostgreSQL: connects (evidence: `con_db/db.php`)
- Sue assistant → PDO connection: queries catalogs (evidence: `api/ia_sue.php`)
- Sue assistant → Groq service: may consult
- Accessibility menu → Local translation: supports language
