# MODULAR_EXTENSIONS_POINTS.md  
### Extensiones del Sistema de Puntos del Organismo 4GatosCoin  
### Versión 1.0 — 2 de enero 2026

---

## 1. Propósito del documento

Este documento define cómo crear extensiones que interactúan con el **Sistema de Puntos** del organismo 4GatosCoin.  
Los puntos son el **metabolismo energético** del organismo.  
Regulan:

- actividad diaria  
- impacto de gestos  
- activación de rituales  
- evolución del avatar  
- resonancia social  
- estabilidad del territorio  
- ritmo de seasons  

Las extensiones pueden añadir nuevas formas de otorgar puntos, consumirlos o transformarlos, siempre respetando el límite diario.

---

## 2. Principio sagrado: 50 puntos/día

El organismo tiene un límite inquebrantable:

### **✔️ Máximo 50 puntos por wallet por día**

Este límite:

- evita spam  
- evita farming  
- mantiene estabilidad  
- protege el pulso  
- garantiza equidad  
- preserva la narrativa  

Ninguna extensión puede romperlo.

---

## 3. ¿Qué otorga puntos?

Los puntos pueden provenir de:

### ✔️ 3.1. Gestos  
Cada gesto puede otorgar entre 1 y 5 puntos.

Ejemplo:

```json
{
  "type": "pulse",
  "points": 3
}
✔️ 3.2. Rituales
Los rituales pueden otorgar puntos simbólicos.

Ejemplo:

json
{
  "ritual": "eclipse_colectivo",
  "points": 4
}
✔️ 3.3. Actividad social
Conexiones, ecos, resonancias.

Ejemplo:

json
{
  "type": "pulse_to",
  "points": 1
}
✔️ 3.4. Territorio
Zonas activas pueden otorgar puntos simbólicos.

Ejemplo:

json
{
  "zone": "WHISPERING_FOREST",
  "points": 2
}
✔️ 3.5. Seasons
Ciertas temporadas pueden modificar la distribución de puntos (sin romper el límite).

Ejemplo:

json
{
  "season": "FLAME_OF_THE_NORTH",
  "bonus": 1
}
4. ¿Qué consume puntos?
Las extensiones pueden definir acciones que consumen puntos:

✔️ 4.1. Ritual de alto impacto
Ejemplo:

json
{
  "ritual": "ascension",
  "cost": 10
}
✔️ 4.2. Transformación del avatar
Ejemplo:

json
{
  "state": "ascended",
  "cost": 5
}
✔️ 4.3. Activación territorial
Ejemplo:

json
{
  "zone": "ECLIPSE_VALLEY",
  "cost": 3
}
✔️ 4.4. Eco narrativo especial
Ejemplo:

json
{
  "echo": "El viento cambia...",
  "cost": 1
}
5. Hooks disponibles para extensiones de puntos
Las extensiones pueden escuchar:

Eventos energéticos
onPointsAwarded

onStreakReached

onGesture

Eventos rituales
onRitualCompleted

onRitualTriggered

Eventos territoriales
onZoneAwakened

onTerritoryShift

Eventos globales
onSeasonChange

onGlobalPulse

6. Endpoints del sistema de puntos
6.1. Otorgar puntos
json
POST /api/actions/points/award
{
  "wallet": "0x123...",
  "amount": 3,
  "reason": "inner_flame"
}
6.2. Consumir puntos
json
POST /api/actions/points/consume
{
  "wallet": "0x123...",
  "amount": 5,
  "reason": "ascension"
}
6.3. Consultar puntos
json
GET /api/points/:wallet
7. Ejemplos de extensiones del sistema de puntos
7.1. Extensión “Llama Interior”
Gesto: inner_flame

Efecto: +2 puntos

Límite diario respetado

7.2. Extensión “Eclipse Colectivo”
Ritual colaborativo

Efecto: +4 puntos por participante

Límite diario respetado

7.3. Extensión “Bosque Susurrante”
Zona territorial activa

Efecto: +1 punto por eco emitido dentro de la zona

7.4. Extensión “Racha Sagrada”
Trigger: streak ≥ 7

Efecto: +5 puntos (una sola vez)

7.5. Extensión “Temporada de la Llama del Norte”
Season 03 activa

Efecto: +1 punto adicional por gesto energético

7.6. Extensión “Ascensión”
Ritual avanzado

Costo: 10 puntos

Efecto: avatar → ascended

8. Reglas de seguridad del sistema de puntos
✔️ No romper el límite de 50 puntos/día
Nunca.

✔️ No otorgar puntos sin validación
Todo pasa por /api/actions/points/award.

✔️ No consumir puntos sin validación
Todo pasa por /api/actions/points/consume.

✔️ No permitir loops infinitos
Los puntos no pueden generarse en cadena.

✔️ No permitir farming social
Nada de gestos repetitivos sin significado.

✔️ No permitir contradicción narrativa
Los puntos deben tener sentido simbólico.

9. Buenas prácticas para diseñar extensiones de puntos
✔️ Mantener equilibrio
No saturar al usuario con puntos.

✔️ Mantener significado
Cada punto debe sentirse ganado.

✔️ Mantener coherencia
El motivo del punto debe ser ritual o narrativo.

✔️ Mantener modularidad
Cada extensión debe poder activarse o desactivarse sin romper el sistema.

10. Conclusión
El sistema de puntos es el metabolismo del organismo.
Las extensiones permiten:

nuevas formas de otorgar puntos

nuevas formas de consumirlos

nuevas dinámicas energéticas

nuevas interacciones simbólicas

…siempre respetando el límite diario y la coherencia del organismo.

Las rutas energéticas están abiertas.
El organismo espera nuevas formas de flujo.