# eeminionn/labtecnologiasemergentes architecture

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

- Interactive diagram: https://gitdiagram.com/eeminionn/labtecnologiasemergentes
- Repository: https://github.com/eeminionn/labtecnologiasemergentes

## Overview

El repositorio reúne dos herramientas de investigación: Mapa Gestual MLR, una aplicación de escritorio que permite explorar el mapa con gestos y consultar análisis territoriales, y Registro Vehicular MLR, una herramienta web para medir ciclos semafóricos y contar vehículos. También documenta un gemelo digital de la sala, integrado con el prototipo para proyección y vista previa. El grafo distingue interacción, análisis, simulación, integración de escritorio y registro de terreno. Las relaciones se limitan a llamadas visibles en los extractos, referencias del índice y capacidades expresas del README; algunos detalles de subsistemas no muestreados quedan sin conectar.

Main entry points: [`mapaGestualMLR/src/main.js`](https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/src/main.js) (Control de aplicación), [`mapaGestualMLR/src/analysis-view.js`](https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/src/analysis-view.js) (Vista de análisis), [`mapaGestualMLR/src/traffic-experience.js`](https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/src/traffic-experience.js) (Experiencia vial), [`registroVehicularMLR/src/main.js`](https://github.com/eeminionn/labtecnologiasemergentes/blob/main/registroVehicularMLR/src/main.js) (Registro Vehicular)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_exploration["Mapa gestual"]
  node_app["Control de aplicación<br/>[main.js]"]
  node_hand["Interpretación gestual<br/>[gestures.js]"]
  node_gesture_geometry["Geometría gestual<br/>[ok-geometry.js]"]
  node_point_geometry["Geometría de puntos<br/>[point-geometry.js]"]
  node_camera_quality["Calidad de cámara<br/>[frame-quality.js]"]
  node_vision["Inferencia de manos<br/>[vision.worker.js]"]
  node_map["Mapa territorial<br/>[map.js]"]
  node_selection["Selección de puntos<br/>[selection.js]"]
  node_content["Visor de contenido<br/>[content-viewer.js]"]
end

subgraph group_analysis["Análisis territorial"]
  node_analysis_view["Vista de análisis<br/>[analysis-view.js]"]
  node_analysis_panel["Paneles de análisis<br/>[analysis-panel.js]"]
  node_analysis_data["Datos de seguridad<br/>[analysis-data.js]"]
  node_camera_data["Datos de cámaras"]
end

subgraph group_traffic["Escena vial"]
  node_traffic_experience["Experiencia vial"]
  node_traffic_scene["Escena 3D<br/>[traffic-scene.js]"]
  node_traffic_sim["Simulación de tráfico"]
  node_vehicle_count["Conteo vehicular"]
  node_vehicles["Vehículos 3D"]
end

subgraph group_desktop["Escritorio y gemelo"]
  node_electron["Proceso de escritorio<br/>[main.cjs]"]
  node_twin_bridge["Puente del gemelo<br/>[twin-bridge.cjs]"]
  node_preview["Vista previa del gemelo<br/>[twin-preview.js]"]
end

subgraph group_field["Registro de terreno"]
  node_field_app["Registro Vehicular<br/>[main.js]"]
  node_field_domain["Reglas de registro<br/>[domain.js]"]
  node_firebase["Firebase Auth y Firestore<br/>[firebase.js]"]
end

node_user(("Persona usuaria"))
node_unity["Unity / puesto Mac"]
node_firestore[("Firestore")]

node_user -->|"interactúa"| node_app
node_app -->|"instancia"| node_hand
node_hand -->|"usa geometría"| node_gesture_geometry
node_hand -->|"usa geometría"| node_point_geometry
node_app -->|"crea mapa"| node_map
node_app -->|"crea visor"| node_content
node_app -->|"aplica controles"| node_camera_quality
node_vision -->|"analiza calidad"| node_camera_quality
node_app -.->|"gestiona selección"| node_selection
node_app -->|"abre análisis"| node_analysis_view
node_analysis_view -->|"parsea seguridad"| node_analysis_data
node_analysis_view -->|"parsea cámaras"| node_camera_data
node_analysis_view -->|"actualiza paneles"| node_analysis_panel
node_analysis_view -->|"configura capas"| node_map
node_user -.->|"consulta tráfico"| node_traffic_experience
node_app -->|"inicia experiencia"| node_traffic_experience
node_traffic_experience -->|"crea escena"| node_traffic_scene
node_traffic_experience -->|"usa simulación"| node_traffic_sim
node_traffic_experience -->|"usa conteo"| node_vehicle_count
node_traffic_scene -->|"crea vehículos"| node_vehicles
node_vehicles -->|"lee conteo"| node_vehicle_count
node_unity -.->|"envía proyección"| node_electron
node_electron -->|"crea puente"| node_twin_bridge
node_electron -->|"transmite vista"| node_preview
node_user -->|"registra medición"| node_field_app
node_field_app -->|"valida y agrupa"| node_field_domain
node_field_app -->|"usa servicios"| node_firebase
node_firebase -->|"inicializa acceso"| node_firestore
node_field_app -->|"lee y guarda registros"| node_firestore

click node_app "https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/src/main.js"
click node_hand "https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/src/gestures.js"
click node_gesture_geometry "https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/src/ok-geometry.js"
click node_point_geometry "https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/src/point-geometry.js"
click node_camera_quality "https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/src/frame-quality.js"
click node_vision "https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/src/vision.worker.js"
click node_map "https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/src/map.js"
click node_selection "https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/src/selection.js"
click node_content "https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/src/content-viewer.js"
click node_analysis_view "https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/src/analysis-view.js"
click node_analysis_panel "https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/src/analysis-panel.js"
click node_analysis_data "https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/src/analysis-data.js"
click node_camera_data "https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/src/camera-analysis-data.js"
click node_traffic_experience "https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/src/traffic-experience.js"
click node_traffic_scene "https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/src/traffic-scene.js"
click node_traffic_sim "https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/src/traffic-simulation.js"
click node_vehicle_count "https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/src/traffic-vehicle-count.js"
click node_vehicles "https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/src/traffic-vehicles.js"
click node_electron "https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/electron/main.cjs"
click node_twin_bridge "https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/electron/twin-bridge.cjs"
click node_preview "https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/electron/twin-preview.js"
click node_field_app "https://github.com/eeminionn/labtecnologiasemergentes/blob/main/registroVehicularMLR/src/main.js"
click node_field_domain "https://github.com/eeminionn/labtecnologiasemergentes/blob/main/registroVehicularMLR/src/domain.js"
click node_firebase "https://github.com/eeminionn/labtecnologiasemergentes/blob/main/registroVehicularMLR/src/firebase.js"

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_app,node_hand,node_gesture_geometry,node_point_geometry,node_camera_quality,node_vision,node_map,node_selection,node_content toneBlue
class node_analysis_view,node_analysis_panel,node_analysis_data,node_camera_data,node_firestore toneAmber
class node_traffic_experience,node_traffic_scene,node_traffic_sim,node_vehicle_count,node_vehicles toneMint
class node_electron,node_twin_bridge,node_preview toneRose
class node_field_app,node_field_domain,node_firebase,node_user,node_unity toneIndigo
```

## Components

### Mapa gestual

- [Control de aplicación](https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/src/main.js): `mapaGestualMLR/src/main.js`
- [Interpretación gestual](https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/src/gestures.js): `mapaGestualMLR/src/gestures.js`
- [Geometría gestual](https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/src/ok-geometry.js): `mapaGestualMLR/src/ok-geometry.js`
- [Geometría de puntos](https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/src/point-geometry.js): `mapaGestualMLR/src/point-geometry.js`
- [Calidad de cámara](https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/src/frame-quality.js): `mapaGestualMLR/src/frame-quality.js`
- [Inferencia de manos](https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/src/vision.worker.js): `mapaGestualMLR/src/vision.worker.js`
- [Mapa territorial](https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/src/map.js): `mapaGestualMLR/src/map.js`
- [Selección de puntos](https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/src/selection.js): `mapaGestualMLR/src/selection.js`
- [Visor de contenido](https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/src/content-viewer.js): `mapaGestualMLR/src/content-viewer.js`

### Análisis territorial

- [Vista de análisis](https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/src/analysis-view.js): `mapaGestualMLR/src/analysis-view.js`
- [Paneles de análisis](https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/src/analysis-panel.js): `mapaGestualMLR/src/analysis-panel.js`
- [Datos de seguridad](https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/src/analysis-data.js): `mapaGestualMLR/src/analysis-data.js`
- [Datos de cámaras](https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/src/camera-analysis-data.js): `mapaGestualMLR/src/camera-analysis-data.js`

### Escena vial

- [Experiencia vial](https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/src/traffic-experience.js): `mapaGestualMLR/src/traffic-experience.js`
- [Escena 3D](https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/src/traffic-scene.js): `mapaGestualMLR/src/traffic-scene.js`
- [Simulación de tráfico](https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/src/traffic-simulation.js): `mapaGestualMLR/src/traffic-simulation.js`
- [Conteo vehicular](https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/src/traffic-vehicle-count.js): `mapaGestualMLR/src/traffic-vehicle-count.js`
- [Vehículos 3D](https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/src/traffic-vehicles.js): `mapaGestualMLR/src/traffic-vehicles.js`

### Escritorio y gemelo

- [Proceso de escritorio](https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/electron/main.cjs): `mapaGestualMLR/electron/main.cjs`
- [Puente del gemelo](https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/electron/twin-bridge.cjs): `mapaGestualMLR/electron/twin-bridge.cjs`
- [Vista previa del gemelo](https://github.com/eeminionn/labtecnologiasemergentes/blob/main/mapaGestualMLR/electron/twin-preview.js): `mapaGestualMLR/electron/twin-preview.js`

### Registro de terreno

- [Registro Vehicular](https://github.com/eeminionn/labtecnologiasemergentes/blob/main/registroVehicularMLR/src/main.js): `registroVehicularMLR/src/main.js`
- [Reglas de registro](https://github.com/eeminionn/labtecnologiasemergentes/blob/main/registroVehicularMLR/src/domain.js): `registroVehicularMLR/src/domain.js`
- [Firebase Auth y Firestore](https://github.com/eeminionn/labtecnologiasemergentes/blob/main/registroVehicularMLR/src/firebase.js): `registroVehicularMLR/src/firebase.js`

### Other components

- **Persona usuaria**
- **Unity / puesto Mac**
- **Firestore**

## Connections

- Persona usuaria → Control de aplicación: interactúa (evidence: `README.md`)
- Control de aplicación → Interpretación gestual: instancia (evidence: `mapaGestualMLR/src/main.js`)
- Interpretación gestual → Geometría gestual: usa geometría (evidence: `mapaGestualMLR/src/gestures.js`)
- Interpretación gestual → Geometría de puntos: usa geometría (evidence: `mapaGestualMLR/src/gestures.js`)
- Control de aplicación → Mapa territorial: crea mapa (evidence: `mapaGestualMLR/src/main.js`)
- Control de aplicación → Visor de contenido: crea visor (evidence: `mapaGestualMLR/src/main.js`)
- Control de aplicación → Calidad de cámara: aplica controles (evidence: `mapaGestualMLR/src/main.js`)
- Inferencia de manos → Calidad de cámara: analiza calidad (evidence: `mapaGestualMLR/src/vision.worker.js`)
- Control de aplicación → Selección de puntos: gestiona selección (evidence: `mapaGestualMLR/src/main.js`)
- Control de aplicación → Vista de análisis: abre análisis (evidence: `mapaGestualMLR/src/main.js`)
- Vista de análisis → Datos de seguridad: parsea seguridad (evidence: `mapaGestualMLR/src/analysis-view.js`)
- Vista de análisis → Datos de cámaras: parsea cámaras (evidence: `mapaGestualMLR/src/analysis-view.js`)
- Vista de análisis → Paneles de análisis: actualiza paneles (evidence: `mapaGestualMLR/src/analysis-view.js`)
- Vista de análisis → Mapa territorial: configura capas (evidence: `mapaGestualMLR/src/analysis-view.js`)
- Persona usuaria → Experiencia vial: consulta tráfico
- Control de aplicación → Experiencia vial: inicia experiencia (evidence: `mapaGestualMLR/src/main.js`)
- Experiencia vial → Escena 3D: crea escena (evidence: `mapaGestualMLR/src/traffic-experience.js`)
- Experiencia vial → Simulación de tráfico: usa simulación (evidence: `mapaGestualMLR/src/traffic-experience.js`)
- Experiencia vial → Conteo vehicular: usa conteo (evidence: `mapaGestualMLR/src/traffic-experience.js`)
- Escena 3D → Vehículos 3D: crea vehículos (evidence: `mapaGestualMLR/src/traffic-scene.js`)
- Vehículos 3D → Conteo vehicular: lee conteo (evidence: `mapaGestualMLR/src/traffic-vehicles.js`)
- Unity / puesto Mac → Proceso de escritorio: envía proyección
- Proceso de escritorio → Puente del gemelo: crea puente (evidence: `mapaGestualMLR/electron/main.cjs`)
- Proceso de escritorio → Vista previa del gemelo: transmite vista (evidence: `mapaGestualMLR/electron/main.cjs`)
- Persona usuaria → Registro Vehicular: registra medición (evidence: `README.md`)
- Registro Vehicular → Reglas de registro: valida y agrupa (evidence: `registroVehicularMLR/src/main.js`)
- Registro Vehicular → Firebase Auth y Firestore: usa servicios (evidence: `registroVehicularMLR/src/main.js`)
- Firebase Auth y Firestore → Firestore: inicializa acceso (evidence: `registroVehicularMLR/src/firebase.js`)
- Registro Vehicular → Firestore: lee y guarda registros (evidence: `registroVehicularMLR/src/main.js`)
