# RITUALS.md — Sistema de Rituales del Organismo 4GatosCoin

Los **rituales** son eventos colectivos que alteran profundamente el estado del organismo 4GatosCoin.  
Son momentos de sincronización, transformación y narrativa que afectan energía, memoria, territorio, ciclos y temporadas.

Este documento describe cómo funcionan, cómo se activan, cómo se registran y cómo deben implementarse.

---

# 1. ¿Qué es un Ritual?

Un ritual es un evento especial que:

- involucra a múltiples usuarios  
- genera memoria profunda  
- altera reglas temporales  
- modifica energía y territorio  
- puede activar ciclos o temporadas  
- tiene impacto narrativo  
- sincroniza al organismo  

Los rituales son **puntos de inflexión** en la vida del organismo.

---

# 2. Rituales Actuales

## 2.1. *El Grito Que Crea*
El ritual fundacional del organismo.

### Propósito
- activar la primera memoria profunda  
- sincronizar a los participantes  
- generar un eco colectivo  
- abrir el territorio inicial  

### Activación
- cuando un número mínimo de gestos coincide  
- cuando se alcanza un umbral de energía  
- cuando se activa manualmente desde DevWeb3  

### Endpoints
```
/api/ritual
/api/clause-stats
```

### Memoria generada
```json
{
  "type": "ritual",
  "ritual": "elgritoquecrea",
  "participants": 88
}
```

### Impacto
- energía +X  
- memoria profunda  
- expansión territorial  
- avance de ciclo  
- posible inicio de temporada  

---

# 3. Flujo de un Ritual

```
Condición → Activación → Registro → Impacto → Memoria → Ecos → Visualización
```

### 3.1. Condición
Puede ser:

- número de gestos  
- energía acumulada  
- evento narrativo  
- acción manual del equipo  

### 3.2. Activación
El ritual se marca como activo en:

```
OrganismoGlobal.flags
```

### 3.3. Registro
Se registra en:

```
models/Log.ts
```

### 3.4. Impacto
El ritual puede modificar:

- energía  
- puntos  
- territorio  
- ciclos  
- temporadas  
- memoria  

### 3.5. Ecos
Los rituales generan ecos colectivos.

### 3.6. Visualización
El panel OTT puede mostrar:

- animaciones  
- pulsos  
- expansiones  
- narrativa visual  

---

# 4. Tipos de Rituales

## 4.1. Rituales de Gesto
Activados por:

- repetición masiva de un gesto  
- patrones de actividad  

Ejemplo: *El Grito Que Crea*

---

## 4.2. Rituales de Energía
Activados por:

- alcanzar umbrales energéticos  
- desbalances  
- regeneración masiva  

---

## 4.3. Rituales de Territorio
Activados por:

- expansión  
- dominancia  
- zonas activas  

---

## 4.4. Rituales Narrativos
Activados por:

- eventos de memoria profunda  
- hitos globales  
- temporadas  

---

## 4.5. Rituales Manuales (DevWeb3)
Activados desde:

```
app/devweb3/rituales/
```

Usados para:

- pruebas  
- sincronización  
- eventos especiales  

---

# 5. Registro Técnico de Rituales

### 5.1. Modelo
Actualmente se registran en:

```
models/Log.ts
```

Futuro:

```
models/Ritual.ts
```

### 5.2. Campos típicos
```json
{
  "type": "ritual",
  "ritual": "elgritoquecrea",
  "timestamp": 1700000000,
  "participants": 120,
  "metadata": {}
}
```

---

# 6. Panel DevWeb3

Ubicación:

```
app/devweb3/rituales/
```

Funciones:

- activar rituales  
- ver rituales activos  
- ver estadísticas  
- ver memoria ritual  
- ver participantes  
- ver impacto  

---

# 7. Cómo Crear un Nuevo Ritual

1. Definir nombre y propósito.  
2. Crear tipo en:
   ```
   types/Ritual.ts
   ```
3. Crear endpoint en:
   ```
   app/api/ritual/<nuevo>
   ```
4. Añadir lógica en:
   ```
   lib/rituals/
   ```
5. Añadir UI en:
   ```
   app/devweb3/rituales/
   ```
6. Registrar memoria profunda.  
7. Actualizar documentación.  

---

# 8. Ejemplo de Activación Manual

```bash
curl -X POST https://tudominio.com/api/ritual \
  -H "Content-Type: application/json" \
  -d '{"ritual":"elgritoquecrea"}'
```

---

# 9. Roadmap de Rituales

- rituales combinatorios  
- rituales por temporada  
- rituales territoriales  
- rituales de avatar  
- rituales de eco profundo  
- rituales visuales OTT  

---

# 10. Licencia
Proyecto interno.  
Acceso restringido a desarrolladores autorizados.
