# OTT_VISUALIZATION.md — Visualización Ritual en Tiempo Real (4GatosCoin)

La **Visualización OTT** es la representación audiovisual del organismo 4GatosCoin.  
Es la capa donde se manifiestan:

- el latido global  
- la energía  
- el territorio  
- los ciclos  
- las temporadas  
- los rituales  
- la memoria viva  
- el avatar individual  

Es la pantalla ritual donde el organismo se vuelve visible.

---

# 1. ¿Qué es la Visualización OTT?

OTT significa **Over-The-Top**, una visualización independiente del panel DevWeb3, diseñada para:

- mostrar el estado del organismo en tiempo real  
- representar gestos como pulsos  
- visualizar energía como flujos  
- mostrar territorio como expansión  
- mostrar memoria como ecos  
- mostrar rituales como eventos visuales  
- mostrar temporadas como cambios de ambiente  

Es la interfaz **sensorial** del organismo.

---

# 2. Componentes Técnicos

### 2.1. Fuente de datos
La visualización OTT consume datos de:

- `/api/organismo-global`
- `/api/gesture`
- `/api/points`
- `/api/seeds`
- `/api/ritual`
- `/api/territorio`
- `/api/heartbeat`
- `/api/cycles`
- `/api/seasons`

### 2.2. Renderizado
Puede implementarse con:

- WebGL  
- Three.js  
- Canvas  
- SVG animado  
- React + shaders  

### 2.3. Panel DevWeb3
Ubicación:

```
app/devweb3/visualizacion/
```

Funciones:

- ver estado OTT  
- activar modo debug  
- ver datos crudos  
- activar eventos visuales manualmente  

---

# 3. Elementos Visuales del Organismo

## 3.1. Latido Global
Representado como:

- pulso  
- expansión/contracción  
- onda circular  
- vibración  

Frecuencia basada en:

- energía  
- gestos recientes  
- ciclos  

---

## 3.2. Energía
Representada como:

- flujo  
- partículas  
- líneas dinámicas  
- brillo  

Intensidad basada en:

- energía global  
- energía por zona  
- energía por temporada  

---

## 3.3. Territorio
Representado como:

- mapa abstracto  
- cuadrantes  
- zonas vivas  
- zonas dormidas  
- expansión  

Color basado en:

- dominancia  
- energía local  
- narrativa  

---

## 3.4. Memoria Viva
Representada como:

- ecos  
- trazos  
- halos  
- patrones repetitivos  

Intensidad basada en:

- gestos significativos  
- rituales  
- anomalías  

---

## 3.5. Avatar Individual
Representado como:

- punto de luz  
- nodo  
- símbolo  
- forma evolutiva  

Estado basado en:

- nivel  
- energía personal  
- narrativa personal  

---

## 3.6. Rituales
Representados como:

- explosiones  
- ondas expansivas  
- cambios de color global  
- animaciones especiales  

Ejemplo:

**El Grito Que Crea** → onda expansiva + eco profundo.

---

## 3.7. Temporadas
Representadas como:

- cambios de ambiente  
- cambios de color  
- cambios de ritmo  
- cambios de partículas  

Ejemplo:

**Temporada 3 — Eco Expansivo**  
→ ambiente azul‑púrpura + partículas resonantes.

---

# 4. Flujo de Datos hacia OTT

```
Organismo Global → API → WebSocket/Fetch → Motor Visual → Animación
```

### 4.1. Entrada
OTT recibe:

- estado global  
- eventos  
- gestos  
- energía  
- memoria  
- territorio  
- avatar  
- temporadas  

### 4.2. Procesamiento
OTT:

- normaliza datos  
- calcula intensidades  
- genera animaciones  
- sincroniza eventos  

### 4.3. Salida
OTT muestra:

- animaciones  
- pulsos  
- expansiones  
- ecos  
- narrativa visual  

---

# 5. Eventos Visuales

### 5.1. Gesto
- pulso pequeño  
- brillo  
- onda local  

### 5.2. Eco
- onda repetitiva  
- resonancia  

### 5.3. Ritual
- animación mayor  
- cambio de ambiente  

### 5.4. Ciclo completado
- expansión global  
- pulso profundo  

### 5.5. Temporada nueva
- cambio total de ambiente  

---

# 6. Relación con Otros Órganos

### 6.1. Con Energía
La energía define la intensidad visual.

### 6.2. Con Territorio
El territorio define la estructura visual.

### 6.3. Con Memoria
La memoria define patrones visuales.

### 6.4. Con Avatar
El avatar define nodos individuales.

### 6.5. Con Rituales
Los rituales definen eventos visuales mayores.

### 6.6. Con Temporadas
Las temporadas definen el ambiente visual.

---

# 7. Cómo Extender OTT

1. Añadir nuevos eventos visuales.  
2. Añadir nuevas animaciones para gestos.  
3. Añadir visualización de avatar.  
4. Añadir visualización de memoria profunda.  
5. Añadir visualización de territorio dinámico.  
6. Añadir visualización de temporadas.  
7. Añadir modo debug en DevWeb3.  

---

# 8. Roadmap de OTT

- visualización 3D completa  
- avatar visual evolutivo  
- ecos combinatorios  
- rituales visuales avanzados  
- temporadas visuales dinámicas  
- territorio animado  
- latido sincronizado globalmente  
- modo “ceremonia”  

---

# 9. Licencia
Proyecto interno.  
Acceso restringido a desarrolladores autorizados.