VOID-GAME — Wiki interna

Este documento presenta una auditoría exhaustiva del código de VOID Game, identificando 25 hallazgos de seguridad, arquitectura y calidad. Los problemas críticos incluyen ausencia total de autenticación en la API, permitiendo que cualquier jugador suplante a otros o modifique datos arbitrariamente, y almacenamiento de audio en base64 en la base de datos, lo que puede causar fallos. También se detectaron duplicación de motores de inteligencia artificial, endpoints rotos y desincronización entre frontend y backend. La auditoría prioriza correcciones que ya se han implementado, como la autenticación JWT, el almacenamiento de audio en R2 y la unificación de rutas, mejorando la seguridad y estabilidad del juego.

• 4 hallazgos críticos: sin autenticación, modificación arbitraria de stats, SQL inválido con arrays vacíos, audio en base64 en D1.
• 7 hallazgos altos: motores IA duplicados, polling roto, 15 rutas de API mal mapeadas, stub de misión, CORS wildcard, desincronización de peso, año galáctico incorrecto.
• 6 hallazgos medios: archivos 'god' de más de 2000 líneas, error de unidades en temporizador, nombre de tabla incorrecto, race condition, fecha de compatibilidad inconsistente.
• 8 hallazgos bajos: voces duplicadas, código comentado, dependencias faltantes, polling sin pausa, URL base duplicada, casts inseguros, parámetros no usados, naming frágil.
• Todas las correcciones prioritarias ya están implementadas en los commits indicados.

Este documento detalla las mecánicas centrales del juego Void Game, incluyendo el ciclo principal de ganar créditos, invertir en la nave y arriesgarse en misiones. Describe tres tipos de misiones: transporte (carreras con recompensas por posición), exploración (alto riesgo con recompensas variables y minijuegos arcade) y comercio (basado en oferta y demanda dinámica). También cubre el sistema de progresión por niveles y reputación, los minijuegos arcade con opción de auto-resolución, las facciones con control territorial y costos de mantenimiento, los sumideros de dinero para controlar la inflación, y los eventos galácticos que alteran temporalmente la economía y el juego. Todo está diseñado para crear una economía jugador-dirigida con riesgos y recompensas balanceados.

• Core loop: ganar créditos → invertir en nave → arriesgar en misiones (transporte, exploración, comercio).
• Misiones de transporte tipo carrera con entry fee y premios escalonados (60/30/10%).
• Exploración con requisitos de stats, minijuegos arcade y recompensas variables según desempeño.
• Sistema económico con precios dinámicos por oferta/demanda, producción local y eventos galácticos.
• Progresión por niveles (1-10+) que desbloquean naves y equipamiento, más reputación que afecta precios y acceso.
• Money sinks (comisiones, mantenimiento, combustible) para controlar inflación y evitar acumulación excesiva de créditos.

Este documento detalla la arquitectura técnica de VOID Game, un juego de navegación espacial con IA conversacional. Propone una evolución del sistema actual para resolver problemas clave: la IA no recuerda conversaciones pasadas, los jugadores no están vinculados a la cuenta de Cadences, y las imágenes generadas no son consistentes. La solución incluye un sistema dual de IA: una rápida para respuestas inmediatas y otra de análisis profundo que procesa el historial completo para mantener coherencia narrativa. También se añaden nuevas tablas en la base de datos para almacenar contexto de misiones, archivo de conversaciones y semillas visuales. Esto permitirá una experiencia de juego más inmersiva y persistente, mejorando la retención de usuarios.

• Propone un sistema dual de IA: Gemini Flash para respuestas rápidas y Gemini Pro para análisis de contexto profundo.
• Añade tablas como game_context_analysis, game_conversation_archive y game_mission_memory para persistencia narrativa.
• Vincula jugadores con clientes de Cadences mediante customer_id, unificando autenticación y facturación.
• Incluye generación de imágenes con semillas consistentes para mantener coherencia visual.
• Define triggers para análisis background: inactividad, eventos importantes, cambios de sistema o inicio de misión.

Este documento describe cómo el juego VOID aprovecha la infraestructura de Cadences (proyectos, tareas y tablas de datos) para construir un sistema de juego persistente y escalable. Cada jugador tiene proyectos automáticos para bitácora, misiones, viajes, combates y comercio, lo que permite guardar todo el progreso y generar contexto rico para la inteligencia artificial. La arquitectura garantiza que ninguna acción se pierda, facilita la sincronización entre dispositivos y sienta las bases para un juego multijugador.

• Cada jugador tiene proyectos automáticos: bitácora, misiones, viajes, combates y comercio.
• Se usan tareas (tasks) con estados detallados para modelar cada mecánica del juego.
• Tablas de datos (data_rows) almacenan el universo compartido, contexto de IA y activos generados.
• La arquitectura es persistente, escalable y preparada para multijugador.
• Se incluyen flujos de ejemplo y un plan de implementación por fases.

Este documento define el esquema de base de datos para el juego VOID, detallando todas las tablas, índices y relaciones necesarias para gestionar jugadores, naves, sistemas estelares, misiones y economía. La base de datos está diseñada para soportar consultas frecuentes como el estado del jugador cada 2.5 segundos, con índices optimizados y una estrategia de caché en KV para reducir la carga. El uso de un inventario unificado evita problemas de duplicación y simplifica las transferencias entre nave y estación. Además, incluye un sistema de transacciones con log para auditoría y un registro de eventos que alimenta la IA y las notificaciones.

• Tablas principales: game_players, game_systems, game_ships, game_inventory, game_missions_transport, game_missions_exploration, game_market_prices, game_transactions_log, game_events.
• Índices críticos para el endpoint /api/game/state, que se consulta cada 2.5 segundos por usuario activo.
• Inventario unificado (game_inventory) con location_type y location_id para evitar dualidad JSON/tabla y bugs de duplicación.
• Sistema de transacciones con log obligatorio para todas las modificaciones de créditos, garantizando auditoría y rollback.
• Estrategia de caché en KV con TTL de 2 segundos para reducir consultas a D1 en el endpoint de estado.

VOID es un juego espacial persistente que usa la infraestructura de Cadences para crear una experiencia narrativa impulsada por inteligencia artificial. El sistema combina dos IAs: una frontal que responde al jugador en menos de dos segundos, y otra de contexto que analiza el historial cada pocos minutos para ajustar la trama. Además, genera imágenes dinámicas con estilo retro anime y eventos ambientales que cambian según el sistema estelar. Todo esto permite que cada partida sea única y que la historia evolucione según las decisiones del jugador.

• Usa dos IAs: Phantom (respuestas rápidas) y Analyzer (contexto profundo cada 3 minutos).
• Genera imágenes dinámicas con estilo retro anime (Leiji Matsumoto) usando FLUX.1 o Gemini.
• Sistema de eventos ambientales que cambian según el tipo de sistema estelar y el estado de la nave.
• Persistencia en D1 (SQLite), R2 (imágenes) y KV (caché) de Cloudflare.
• Cada jugador tiene 7 proyectos automáticos para bitácora, misiones, viajes, combates, comercio, contexto y assets.

Este documento explica cómo el juego VOID utiliza la infraestructura de Cadences como su sistema de registro y administración invisible. Cada jugador tiene proyectos automáticos que guardan su bitácora, misiones, viajes y contexto de IA, todo visible desde el panel de administración de Cadences. Esto permite al equipo de operaciones monitorear la actividad de los jugadores, depurar problemas y obtener analíticas sin necesidad de construir una interfaz propia. La integración convierte a Cadences en el backend de observabilidad y gestión del juego, facilitando el soporte y la mejora continua.

• Cada jugador recibe 7 proyectos automáticos en Cadences (bitácora, misiones, viajes, etc.) que se pueden consultar con SQL desde el backoffice.
• El sistema de viajes registra cada etapa como tareas en Cadences, permitiendo seguimiento en tiempo real y depuración.
• La IA dual (PHANTOM y Context Analyzer) guarda análisis de contexto en tablas de Cadences, visibles para auditoría.
• Se proponen paneles dedicados de Game Master como evolución futura, aprovechando componentes existentes de Cadences.
• El documento incluye queries SQL listas para usar en analytics y depuración de jugadores específicos.

VOID es un juego de estrategia espacial asíncrono diseñado para profesionales de 35-50 años con tiempo limitado. Los jugadores exploran una galaxia, comercian y compiten en misiones que duran horas, no segundos, permitiendo jugar 'de fondo' mientras trabajan. El juego prioriza decisiones estratégicas sobre reflejos, con una economía dinámica y narrativa ambiental. Se monetizará mediante suscripción Cadences y cosméticos, sin pay-to-win agresivo, enfocándose primero en retención.

• Juego asíncrono: eventos duran minutos a horas, ideal para sesiones cortas.
• Economía dinámica influenciada por acciones de jugadores.
• Público objetivo: profesionales 35-50 años que buscan estrategia sin reflejos.
• Monetización inicial: suscripción Cadences y cosméticos, sin pay-to-win.
• MVP busca 100 DAU, retención D7 >30% y sesión promedio >8 min.

Este documento describe los servicios de backend del juego VOID, una experiencia de comercio espacial multijugador. Detalla cómo los jugadores pueden gestionar su perfil, naves, viajes, misiones, mercado y facciones a través de una API. El sistema incluye mecanismos para evitar que los jugadores queden atrapados sin combustible y para validar resultados de minijuegos. Es la guía técnica para desarrolladores que integren o mantengan la lógica del juego.

• El endpoint de estado del juego se consulta cada 2.5 segundos y solo envía cambios desde la última consulta para optimizar rendimiento.
• Incluye un sistema anti-softlock que permite a jugadores sin combustible recibir ayuda de emergencia pagando créditos o perdiendo reputación.
• Los minijuegos arcade se validan en el servidor usando semillas y checksums para evitar trampas.
• El mercado tiene seguimiento de volumen diario y créditos movidos para análisis económico.
• Todas las respuestas de error siguen un formato consistente con código y mensaje legible.

Este documento describe la arquitectura técnica de VOID, un juego de navegador que se ejecuta en la infraestructura de Cadences. Explica cómo se organizan los componentes: el frontend con Astro y React, el backend con Cloudflare Workers y bases de datos D1 y KV, y la comunicación mediante polling adaptativo en lugar de WebSockets para mantener costos bajos y simplicidad. También detalla el sistema de minijuegos arcade con semillas determinísticas y validación estadística para evitar trampas. Para el negocio, esto significa que VOID puede escalar sin grandes inversiones en infraestructura, reutilizando servicios existentes de Cadences como autenticación e inteligencia artificial.

• Frontend con Astro y React Islands, backend con Cloudflare Workers, D1 y KV.
• Comunicación mediante polling adaptativo (2.5s activo, 30s en segundo plano) en lugar de WebSockets para reducir costos y complejidad.
• Minijuegos arcade con semillas determinísticas y validación estadística anti-trampas.
• Reutilización de servicios Cadences: autenticación Google OAuth, AI Providers, notificaciones y organizaciones.
• Estructura de archivos clara con carpetas para páginas, componentes, islas React y endpoints API.

Este documento detalla una revisión profunda del código del juego VOID, identificando 37 hallazgos de seguridad, integridad de datos, rendimiento y lógica de juego. Todos los problemas críticos y altos fueron corregidos, incluyendo un bypass de autenticación, un exploit de créditos infinitos y la exposición de trazas de error al cliente. Las correcciones mejoran la estabilidad, seguridad y experiencia de usuario, asegurando que el juego funcione de manera confiable y justa para todos los jugadores.

• Se corrigió un bypass de autenticación que permitía modificar naves de otros jugadores.
• Se eliminó un exploit que otorgaba créditos infinitos al repetir el primer contacto con Harlock.
• Se implementó verificación de identidad en 8 handlers para evitar suplantación de jugadores.
• Se agregó rate limiting en endpoints clave para prevenir abuso.
• Se optimizaron consultas a base de datos y se mejoró el manejo de errores en frontend y backend.

Este documento describe la arquitectura del frontend del juego Void Game, construido con Astro y React Islands. Explica cómo se organizan los componentes, el sistema de polling adaptativo para mantener el estado del juego sincronizado, y las técnicas de optimización como actualizaciones optimistas e interpolación visual para que la experiencia sea fluida y responsiva. También detalla la estructura de archivos, el uso de Zustand para el estado global, y la implementación de minijuegos arcade con audio y RNG determinístico. Es una guía técnica esencial para entender cómo se construye la interfaz del juego.

• Stack: Astro con React Islands, Tailwind CSS, Zustand para estado global.
• Polling adaptativo: 2.5s en foco, 30s en background, 1min oculto.
• Actualizaciones optimistas para compra/venta: UI instantánea con rollback en error.
• Interpolación visual de posiciones de naves para movimiento suave.
• Minijuegos arcade con audio precargado y RNG determinístico basado en seed.

Este documento recopila los problemas y mejoras pendientes del juego VOID, ordenados por prioridad. Incluye fallos críticos como la desconexión entre la narrativa visual y los eventos del juego, que rompe la inmersión del jugador. También detalla soluciones ya implementadas, como la mejora del reconocimiento de voz en español y la personalidad de los tripulantes. Es una guía de trabajo para el equipo de desarrollo, con un plan de acción claro para las próximas fases.

• Problema crítico: la escena ambiental y la bitácora del puente muestran eventos contradictorios, rompiendo la coherencia narrativa.
• Se propone un nuevo estado de escena compartido para sincronizar ambos paneles según el contexto de la acción.
• Ya se resolvieron fallos importantes: actualización de efectos en la interfaz, limpieza de formato en respuestas y detección de tripulantes.
• Pendiente: generar imágenes épicas para eventos especiales y que las imágenes cambien con cada comando del jugador.
• El reconocimiento de voz se mejoró con múltiples proveedores y vocabulario específico del juego, priorizando español.

Este documento detalla el plan de desarrollo de 8 semanas para lanzar el MVP de Void Game, un juego espacial de navegador. El roadmap está organizado en cuatro fases: Foundation, Core Loops, Gameplay Features y Polish + Launch. Cada fase incluye tareas técnicas concretas, métricas de éxito (como 100 usuarios diarios y retención del 30%) y entregables claros. El objetivo es tener un producto funcional que permita viajar entre sistemas, comerciar, competir en carreras y explorar, con una economía balanceada desde el día uno.

• MVP en 8 semanas con cuatro fases: Foundation, Core Loops, Gameplay Features y Polish + Launch.
• Métricas clave: 100 DAU, 30% retención D7, sesiones de 5-10 minutos.
• Core loop: viajar, comerciar, competir en carreras de transporte y explorar con auto-resolve.
• El minijuego arcade se pospone a post-MVP para no retrasar el lanzamiento.
• Se incluyen money sinks (comisiones, impuestos) para evitar inflación económica.

Este documento describe los procesos automáticos que mantienen vivo el universo del juego Void Game. Explica cómo funcionan los cron jobs programados en Cloudflare para gestionar viajes de naves, exploraciones, carreras de transporte, dinámicas de mercado, generación de misiones y mantenimiento diario. Estos procesos son críticos para que el juego funcione sin intervención manual, asegurando que los jugadores tengan una experiencia continua y dinámica.

• Los cron jobs se ejecutan en intervalos de 1 minuto a 24 horas, cada uno con una función específica.
• El Travel Processor resuelve llegadas de naves, actualiza estados y cobra tasas de atraque.
• El Exploration Resolver maneja exploraciones automáticas o las marca para resolución manual.
• El Transport Engine gestiona carreras: inicio, cancelación, llegadas y generación de nuevas.
• El Market Dynamics actualiza precios según oferta/demanda y archiva volúmenes diarios.
• El Daily Maintenance realiza limpieza de datos antiguos y cobra mantenimiento de naves y territorios.

Este documento define las directrices para transformar un juego arcade en una experiencia narrativa inmersiva donde el usuario es el capitán de una nave espacial. Se establece la personalidad del sistema (una IA fría y leal), la generación de imágenes con estilo anime retro, el diseño de sonido inmersivo y mecánicas de interacción por voz. Además, introduce una capa de tensión burocrática inspirada en 'The Great Escape' y un módulo de exploración tipo dungeon crawler basado en 'Panama Joe'. El objetivo es crear un juego adictivo de sesiones cortas que combine atmósfera, tensión y aventura.

• La IA debe actuar como la computadora central de la nave, con tono frío y vocabulario náutico.
• Las imágenes se generan con estilo anime retro 80s/90s usando inyección automática de prompts.
• El sonido incluye ambiente de motor, SFX metálicos y voz TTS con filtro de radio.
• Mecánica 'El Ojo de la Federación': inspecciones aleatorias que aumentan la tensión y un nivel de sospecha.
• Módulo 'Panama': exploración de laberintos con llaves y puertas, con decisiones que pueden causar pérdidas.
• El ciclo de juego es de 30 segundos: notificación, escucha, orden por voz, resultado en 5 minutos.

Este documento describe el sistema de reconocimiento de voz (STT) del juego VOID, que permite a los jugadores dar comandos hablando en lugar de escribir. El sistema usa la Web Speech API del navegador para transcribir en tiempo real con latencia casi nula, y si no está disponible, recurre a servidores como Groq Whisper. Esto mejora la experiencia de juego al hacerla más rápida e inmersiva, especialmente en dispositivos móviles. Para el negocio, reduce la fricción en la interacción y puede aumentar la retención de usuarios.

• Transcripción en tiempo real con Web Speech API (0ms latencia) en Chrome, Edge y Safari.
• Fallback inteligente a Groq Whisper y otros proveedores si el navegador no soporta STT nativo.
• Configuración de micrófono optimizada con cancelación de eco y supresión de ruido.
• Vocabulario contextual de comandos del juego para mejorar precisión.
• Métricas de rendimiento: primera palabra visible en ~50ms, transcripción completa en ~200ms (nativo).

VOID es un juego de estrategia espacial asíncrono que funciona sobre la plataforma Cadences. Está pensado para jugadores de unos 40 años que prefieren la estrategia a los reflejos. El juego combina exploración de sistemas, comercio dinámico, carreras de transporte y minijuegos opcionales. Se apoya en la infraestructura de Cadences (Cloudflare Workers, D1 y Workflows) para ofrecer una experiencia sin necesidad de conexión en tiempo real.

• Juego de estrategia espacial asíncrono (no requiere WebSockets).
• Usa polling inteligente sobre Cloudflare Workers + D1 + Workflows de Cadences.
• Cuatro mecánicas principales: exploración, comercio, carreras de carga y minijuegos arcade.
• Público objetivo: jugadores adultos (~40 años) que valoran la estrategia.
• MVP planificado en 2 meses con fases de infraestructura, core loop, arcade/IA y polish.

Este documento detalla los efectos de sonido necesarios para el juego VOID: LEGACY, organizados por categorías como ambiente, interfaz, comunicaciones, alertas, navegación, combate y eventos. Define el estilo retro-analógico 80s, lista archivos requeridos con descripciones, y proporciona instrucciones para descargar sonidos gratuitos o generarlos con IA. Es una guía práctica para el equipo de desarrollo de audio, asegurando coherencia estética y técnica en el producto final.

• Estilo de audio retro-analógico 80s inspirado en Blade Runner y Captain Harlock.
• Lista completa de 30+ archivos de sonido organizados por categorías funcionales.
• Instrucciones para descargar SFX gratuitos desde Freesound y Pixabay.
• Opciones de generación de audio con IA (ElevenLabs, Riffusion, Suno).
• Especificaciones técnicas: WAV 16-bit, 44100 Hz, estéreo, normalizado a -3dB.
• Script de descarga automática incluido en el repositorio.

Este documento es la puerta de entrada al proyecto VOID, un juego de estrategia de ópera espacial dentro del ecosistema Cadences. Explica cómo instalar dependencias, iniciar el servidor de desarrollo y desplegar el juego en producción. También describe la pila tecnológica (Astro, React, TailwindCSS, Cloudflare Workers, D1) y la estructura del código fuente. Para el equipo de negocio, es relevante porque muestra que el juego está en desarrollo activo y listo para ser desplegado, aunque el documento en sí es un README técnico de configuración.

• El juego VOID es una aplicación web construida con Astro y React, desplegada en Cloudflare Pages.
• Incluye instrucciones de instalación, desarrollo y despliegue para el equipo técnico.
• La base de datos usa D1 (SQLite) y el backend se apoya en Cloudflare Workers compartidos con Cadences.
• Existe documentación detallada del juego en la carpeta /doc/void-game/ con 8 archivos que cubren visión, arquitectura, base de datos, APIs, frontend, mecánicas, flujos y hoja de ruta.
• El proyecto está activo y se despliega automáticamente en void.cadences.app.

Este documento lista las imágenes necesarias para el landing y la interfaz de usuario del juego VOID: LEGACY, incluyendo un fondo de estrellas y una imagen hero. Mientras no se tengan las imágenes finales, se usan gradientes CSS. También proporciona prompts para generar imágenes con estilo anime retro, usando herramientas como SDXL Lightning, Midjourney o DALL-E.

• Se requieren dos imágenes: starfield.png (500x500) y hero-bridge.jpg (1920x1080).
• Mientras no estén listas, se usan gradientes CSS como placeholder.
• Se incluyen prompts positivos y negativos para generar imágenes con estilo anime retro de los 80.
• Las imágenes pueden generarse con SDXL Lightning, Midjourney o DALL-E.