# ENERGY_SYSTEM.md — Sistema de Energía del Organismo 4GatosCoin La **Energía** es el recurso vital del organismo 4GatosCoin. Es la fuerza que impulsa el latido, la expansión territorial, los ciclos, las temporadas y la narrativa. Este documento describe cómo funciona, cómo se genera, cómo se consume, cómo se distribuye y cómo se relaciona con otros órganos. --- # 1. ¿Qué es la Energía? La energía representa: - la vitalidad del organismo - la intensidad de la actividad colectiva - la fuerza de los gestos - el impacto de los rituales - el avance de ciclos - la expansión del territorio Es un recurso **global**, no individual. --- # 2. Componentes Técnicos ### 2.1. Modelo La energía se almacena en: ``` models/OrganismoGlobal.ts ``` Campos típicos: ```json { "energia": 1200, "energiaPorZona": { "norte": 300, "sur": 250, "este": 320, "oeste": 330 } } ``` ### 2.2. Endpoints relacionados Futuro: ``` /api/energia /api/energia/update /api/energia/zona/ ``` ### 2.3. Panel DevWeb3 Ubicación: ``` app/devweb3/energia/ ``` Funciones: - ver energía global - ver energía por zona - ver impacto de gestos - ver impacto de rituales - ver regeneración --- # 3. Flujo de Energía ``` Gestos → Puntos → Energía → Latido → Territorio → Ciclos → Temporadas ``` ### 3.1. Entrada La energía se genera cuando: - se ejecutan gestos - se completan rachas - se activan rituales - se generan semillas - se completan ciclos ### 3.2. Procesamiento El organismo calcula: - energía total - energía por zona - energía por ciclo - energía por temporada ### 3.3. Salida La energía afecta: - latido global - expansión territorial - avance de ciclos - activación de temporadas - narrativa - memoria --- # 4. Generación de Energía ### 4.1. Por gestos Cada gesto genera energía según: - tipo - intensidad - multiplicadores de temporada - racha del usuario Ejemplo: ``` pulso_vocal → +3 energía reflection → +1 energía mirror → +5 energía ``` ### 4.2. Por rituales Los rituales generan energía masiva. Ejemplo: ``` El Grito Que Crea → +200 energía ``` ### 4.3. Por ciclos Completar un ciclo genera energía acumulada. ### 4.4. Por semillas Las semillas pueden generar energía pasiva. --- # 5. Consumo de Energía La energía se consume cuando: - el organismo late - se expande el territorio - se activan rituales - se inicia una temporada - se generan ecos profundos Ejemplo: ``` Latido global → -1 energía por pulso Expansión territorial → -50 energía Temporada nueva → -200 energía ``` --- # 6. Energía por Zona El organismo distribuye energía entre zonas: ``` norte sur este oeste ``` ### 6.1. Cómo se distribuye Factores: - actividad local - gestos por zona - ecos locales - rituales regionales - narrativa ### 6.2. Impacto La energía por zona afecta: - dominancia - expansión - narrativa local - visualización OTT --- # 7. Relación con Otros Órganos ### 7.1. Con Gestos Los gestos son la fuente primaria de energía. ### 7.2. Con Puntos Los puntos influyen en la energía generada. ### 7.3. Con Memoria Eventos de memoria profunda pueden generar energía. ### 7.4. Con Territorio La energía alimenta la expansión territorial. ### 7.5. Con Ciclos Los ciclos consumen y generan energía. ### 7.6. Con Temporadas Las temporadas redefinen reglas energéticas. ### 7.7. Con Rituales Los rituales son picos energéticos. --- # 8. Ejemplos de Eventos Energéticos ### 8.1. Generación por gesto ```json { "type": "energy_gain", "gesture": "pulso_vocal", "amount": 3 } ``` ### 8.2. Consumo por latido ```json { "type": "energy_loss", "reason": "heartbeat", "amount": 1 } ``` ### 8.3. Ritual ```json { "type": "energy_gain", "ritual": "elgritoquecrea", "amount": 200 } ``` --- # 9. Cómo Extender el Sistema de Energía 1. Añadir campos en: ``` OrganismoGlobal.energia ``` 2. Crear endpoints en: ``` app/api/energia/ ``` 3. Añadir lógica en: ``` lib/energia/ ``` 4. Añadir UI en: ``` app/devweb3/energia/ ``` 5. Actualizar narrativa si aplica. 6. Actualizar documentación. --- # 10. Roadmap del Sistema de Energía - energía por avatar individual - energía combinatoria - energía por temporada - energía ritual profunda - energía visualizada en OTT - energía regenerativa dinámica --- # 11. Licencia Proyecto interno. Acceso restringido a desarrolladores autorizados.