# HEARTBEAT.md — Latido Global del Organismo 4GatosCoin

El **Latido Global** es el pulso vital del organismo 4GatosCoin.  
Es la señal que indica que el organismo está vivo, activo, sincronizado y en evolución.

Este documento describe cómo funciona el latido, cómo se calcula, cómo se actualiza, cómo se visualiza y cómo afecta al resto de los órganos.

---

# 1. ¿Qué es el Latido Global?

El latido es:

- un pulso numérico  
- un ritmo energético  
- un indicador de actividad  
- un marcador de sincronización  
- un reflejo del estado del organismo  

Es el equivalente a un **corazón ritual**.

---

# 2. Componentes Técnicos

### 2.1. Modelo
El latido se almacena en:

```
models/OrganismoGlobal.ts
```

Campos típicos:

```json
{
  "heartbeat": 88,
  "lastUpdate": 1700000000
}
```

### 2.2. Endpoints relacionados

```
GET /api/heartbeat
```

### 2.3. Panel DevWeb3
Ubicación:

```
app/devweb3/heartbeat/
```

Funciones:

- ver latido actual  
- ver ritmo  
- ver historial  
- activar latido manual (solo dev)  

---

# 3. Flujo del Latido

```
Gestos → Energía → Latido → Territorio → Ciclos → Temporadas
```

### 3.1. Entrada
El latido se actualiza cuando:

- se ejecutan gestos  
- se genera energía  
- se completan ciclos  
- se activan rituales  
- se producen ecos  

### 3.2. Procesamiento
El organismo calcula:

- frecuencia  
- intensidad  
- ritmo  
- variaciones  

### 3.3. Salida
El latido afecta:

- visualización OTT  
- ciclos  
- territorio  
- narrativa  
- temporadas  

---

# 4. Cómo se Calcula el Latido

El latido se calcula según:

### 4.1. Actividad reciente
Más gestos → latido más rápido.

### 4.2. Energía global
Más energía → latido más intenso.

### 4.3. Rituales
Los rituales generan picos de latido.

### 4.4. Ciclos
Completar un ciclo puede aumentar el ritmo.

### 4.5. Temporadas
Cada temporada redefine el ritmo base.

---

# 5. Ritmo del Latido

El ritmo puede representarse como:

- **bpm rituales** (beats per minute simbólicos)  
- **pulsos por minuto**  
- **intensidad**  
- **variación**  

Ejemplo:

```
heartbeat: 88
intensity: 0.72
variation: +0.04
```

---

# 6. Visualización del Latido

En OTT, el latido se representa como:

- pulso luminoso  
- onda expansiva  
- vibración  
- expansión/contracción  
- halo energético  

La frecuencia visual se sincroniza con:

- energía  
- gestos  
- rituales  
- ciclos  

---

# 7. Relación con Otros Órganos

### 7.1. Con Energía
La energía alimenta el latido.

### 7.2. Con Gestos
Los gestos aceleran el latido.

### 7.3. Con Territorio
El latido puede activar zonas.

### 7.4. Con Memoria
Eventos de memoria profunda alteran el ritmo.

### 7.5. Con Avatar
El avatar puede tener un latido personal (futuro).

### 7.6. Con Temporadas
Las temporadas redefinen el ritmo base.

### 7.7. Con Rituales
Los rituales generan picos de latido.

---

# 8. Ejemplos de Eventos del Latido

### 8.1. Aceleración
```json
{
  "type": "heartbeat_increase",
  "amount": 5
}
```

### 8.2. Desaceleración
```json
{
  "type": "heartbeat_decrease",
  "amount": 3
}
```

### 8.3. Pico ritual
```json
{
  "type": "heartbeat_peak",
  "ritual": "elgritoquecrea",
  "amount": 20
}
```

---

# 9. Cómo Extender el Latido

1. Añadir campos en:
   ```
   OrganismoGlobal.heartbeat
   ```
2. Crear endpoints en:
   ```
   app/api/heartbeat/
   ```
3. Añadir lógica en:
   ```
   lib/heartbeat/
   ```
4. Añadir UI en:
   ```
   app/devweb3/heartbeat/
   ```
5. Actualizar narrativa si aplica.
6. Actualizar documentación.

---

# 10. Roadmap del Latido

- latido combinatorio  
- latido por zona  
- latido por avatar  
- latido ritual avanzado  
- latido visual en OTT  
- latido por temporada  
- latido narrativo  

---

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