# ORGANISM_FLOW.md — Flujo Vital del Organismo 4GatosCoin Este documento describe el flujo completo del organismo 4GatosCoin: cómo nace un gesto, cómo se transforma en puntos, cómo afecta al organismo global, cómo genera memoria, cómo influye en el territorio y cómo alimenta el latido del sistema. Es una guía conceptual y técnica para entender **cómo vive y respira el organismo**. --- # 1. Visión General del Flujo El organismo funciona como un sistema vivo compuesto por órganos interconectados. Cada acción del usuario (gesto) desencadena una serie de procesos internos. ### Flujo general: ``` Gesto → Validación → Registro → Puntos → Energía → Memoria → Latido → Territorio → Ciclos → Temporadas ``` Cada etapa alimenta a la siguiente. --- # 2. Flujo Completo de un Gesto El gesto es la unidad mínima de acción dentro del organismo. ### 2.1. Entrada del gesto Un usuario ejecuta un gesto desde: - una interfaz externa - un ritual - una acción dentro de Auranet - un panel experimental ### 2.2. Llega al endpoint ``` POST /api/gesture ``` ### 2.3. Validación El endpoint valida: - wallet normalizada - tipo de gesto permitido - límites diarios - límites por wallet - frecuencia - integridad del payload ### 2.4. Registro en la colección Gestures Se inserta un documento: ``` models/Gesture.ts ``` ### 2.5. Actualización del sistema de puntos El gesto alimenta el órgano de puntos: ``` app/api/points ``` El sistema decide: - cuántos puntos asignar - si el gesto activa un bonus - si el gesto activa un hito ### 2.6. Actualización del Organismo Global El gesto puede afectar: - energía - ciclos - territorio - latido - flags del sistema ### 2.7. Registro en Logs Cada gesto genera un log: ``` models/Log.ts ``` ### 2.8. Respuesta al cliente El endpoint devuelve: - éxito - puntos asignados - estado actualizado --- # 3. Flujo de Puntos Los puntos representan la **energía individual** del usuario. ### 3.1. Entrada El sistema de puntos recibe: ``` wallet + tipo de gesto ``` ### 3.2. Cálculo Reglas internas determinan: - puntos base - multiplicadores - bonus por racha - bonus por temporada ### 3.3. Actualización Se actualiza: ``` models/Points.ts ``` ### 3.4. Impacto en el organismo Los puntos pueden: - aumentar energía global - activar hitos - influir en territorio - alimentar memoria --- # 4. Flujo de Energía La energía es la **fuerza vital** del organismo. ### 4.1. Entrada La energía se actualiza cuando: - se ejecutan gestos - se completan ciclos - se activan rituales - se generan semillas ### 4.2. Procesamiento El organismo calcula: - energía total - energía por zona - energía por ciclo ### 4.3. Impacto La energía afecta: - latido - territorio - memoria - temporadas --- # 5. Flujo de Semillas Las semillas representan **potencial narrativo y evolutivo**. ### 5.1. Generación Las semillas se generan cuando: - se alcanzan ciertos puntos - se ejecutan gestos especiales - se activan rituales - se completan ciclos ### 5.2. Registro ``` models/Seed.ts ``` ### 5.3. Distribución Las semillas pueden: - asignarse a wallets - alimentar memoria - activar eventos --- # 6. Flujo de Memoria La memoria es la **historia viva** del organismo. ### 6.1. Entrada La memoria se actualiza cuando: - se ejecutan gestos significativos - se activan rituales - se completan ciclos - se generan semillas ### 6.2. Registro ``` models/Log.ts models/Memory.ts (futuro) ``` ### 6.3. Impacto La memoria influye en: - narrativa - temporadas - visualización OTT - avatar individual --- # 7. Flujo del Latido (Heartbeat) El latido es el **pulso global** del organismo. ### 7.1. Entrada El latido se actualiza cuando: - se ejecutan gestos - se genera energía - se completan ciclos ### 7.2. Registro ``` models/OrganismoGlobal.ts ``` ### 7.3. Impacto El latido afecta: - visualización OTT - ciclos - territorio - rituales --- # 8. Flujo del Territorio El territorio representa la **expansión del organismo**. ### 8.1. Entrada El territorio cambia cuando: - se acumula energía - se completan ciclos - se activan rituales ### 8.2. Registro ``` models/OrganismoGlobal.ts ``` ### 8.3. Impacto El territorio influye en: - temporadas - visualización - narrativa global --- # 9. Flujo de Ciclos Los ciclos representan **etapas de evolución**. ### 9.1. Entrada Un ciclo avanza cuando: - se alcanza un umbral de energía - se completa un número de gestos - se activa un ritual ### 9.2. Impacto Los ciclos afectan: - reglas de puntos - generación de semillas - narrativa - temporadas --- # 10. Flujo de Temporadas Las temporadas son **macro-etapas** del organismo. ### 10.1. Entrada Una temporada cambia cuando: - se completan ciclos - se alcanza un estado global - se activa un evento ritual mayor ### 10.2. Impacto Las temporadas redefinen: - reglas - gestos válidos - puntuación - narrativa - visualización OTT --- # 11. Resumen del Flujo Completo ``` Gesto ↓ Validación ↓ Registro ↓ Puntos ↓ Energía ↓ Memoria ↓ Latido ↓ Territorio ↓ Ciclos ↓ Temporadas ``` Cada órgano alimenta al siguiente. El organismo vive, evoluciona y responde a la actividad de los usuarios. --- # 12. Licencia Proyecto interno. Acceso restringido a desarrolladores autorizados.