Documentación Proyecto “Carrera Solidaria de Mascotas”

CONTEXTO

Problema del Negocio

Problema Principal: Las organizaciones de rescate animal requieren nuevos mecanismos de recaudación que sean:

  • Atractivos para público general

  • Fáciles de operar durante eventos físicos

  • Bajos en costo tecnológico

  • Transparentes en la gestión de apuestas y premios

  • Rápidos de ejecutar sin depender de infraestructura externa

Actualmente, muchos eventos benéficos carecen de actividades interactivas que atraigan al público más joven y generen experiencias memorables orientadas a donaciones.

Necesidad crítica: Crear un videojuego divertido, temático y con mecánicas simples donde participantes puedan “apostar” fichas que posteriormente se canjean por premios del evento.

HIPÓTESIS Y SUPUESTOS

Qué SÍ es el proyecto

  • Un videojuego arcade/simulación desarrollado en TIC-80.

  • Reproducción de una carrera de personajes adorables (perritos, gatitos y animales tiernos).

  • Módulo completo de gestión de apuestas con fichas.

  • Cálculo automático de multiplicadores aleatorios (2 a 5) por cada “palo” o corredor.

  • Ejecución multiplataforma: Android, iOS y Web.

  • Música y sonidos originales.

Qué NO es el proyecto

  • ❌ No es un sistema real de apuestas con dinero.

  • ❌ No incluye transacciones financieras ni pagos digitales.

  • ❌ No es un sistema móvil nativo (se empaqueta TIC-80).

  • ❌ No incluye estadísticas avanzadas ni backend en la nube.

Supuestos técnicos validados

  1. TIC-80 permite exportación funcional a Web, Android e iOS.

  2. El performance requerido es mínimo unicamente con sprites 2D.

  3. Los multiplicadores se generan aleatoriamente en cada partida.

  4. Las fichas ganadas se reportan en pantalla.

MÉTRICAS E IMPACTO

KPIs del Evento (Nivel Negocio)

KPI Línea Base Meta

Participación del público

Actividades tradicionales tienen baja interacción

> 60% de asistentes participan

Recaudación promedio por actividad

< USD $50

> USD $200 por sesión

Tiempo promedio por partida

No aplica

< 3 minutos

Nivel de satisfacción

Sin medición previa

> 4.5/5

KPIs de Experiencia de Usuario

KPI Meta Frecuencia

Claridad en reglas de apuesta

100% entendible sin instrucciones orales

Cada partida

Tiempo para iniciar una carrera

< 10 segundos

Permanente

Estabilidad multiplataforma

99% funcionamiento sin fallas

Cada plataforma

Percepción estética

“Bonito / adorable”

Validado con stakeholders

USUARIOS Y CLIENTES

User Personas

Persona 2: Participante del Evento – “Lucas (niño de 10 años)”

Intereses: animales, colores, juegos rápidos

Necesidades: - Personajes adorables - Animaciones llamativas - Reglas muy simples

Escenario ideal: “Elijo un perrito, veo si gano y me emociono por el premio.”

Flujos de Negocio Críticos

Flujo Principal: Apuesta → Carrera → Resultado

  1. El participante anuncia inicio de partidas.

  2. Participantes seleccionan un corredor (palo)**.

  3. El juego muestra multiplicadores aleatorios (x2 a x5)**.

  4. El juego ingresa fichas apostadas.

  5. Se presiona “Iniciar Carrera”.

  6. Los personajes avanzan cuadro a cuadro automaticamente.

  7. Se determina el ganador.

  8. El sistema calcula ganancia o pérdida.

  9. Se muestra pantalla de “Premios” o “Lo intentaste”*.

Flujo Secundario: Elección de diseño/personajes*

  1. El diseñador prepara sprites temáticos de animales.

  2. El operador selecciona set visual antes del evento.

SOLUCIÓN TÉCNICA

Resumen de la solución

El sistema es un videojuego TIC-80 multiplataforma con:

  • Módulo de apuestas

  • Simulación visual de carrera

  • Audio y música original

  • Pantallas adaptadas a público familiar

  • Animaciones simples y fluidas

  • Exportación para Web, Android e iOS

Permite operación en eventos benéficos sin conexión a internet.

Nivel de Contexto

Diagrama C4 - Contexto

Nivel de Contenedores

Diagrama C4 - Contenedores

Modelo Entidad-Relación

Diagrama ER

(Este modelo es mínimo; incluye Apuesta, Multiplicador, Corredor, Resultado y Partida)

Requisitos Funcionales, Restricciones y Dependencias

I. Requisitos Funcionales

  • RF1: Permitir registrar apuestas por corredor.

  • RF2: Mostrar multiplicador aleatorio por corredor.

  • RF3: Iniciar carrera.

  • RF4: Determinar ganador mediante avance aleatorio.

  • RF5: Calcular ganancias o pérdidas.

  • RF6: Mostrar resultados en pantalla final.

  • RF7: Reproducir música y efectos de sonido.

  • RF8: Cambiar diseños/temáticas de personajes.

II. Requisitos No Funcionales

  • RNF1: Ejecución multiplataforma (Android, iOS, Web).

  • RNF2: Interfaz amigable e infantil.

  • RNF3: Respuesta inmediata (<100 ms).

  • RNF4: Tamaño del juego <5MB.

III. Dependencias

  • TIC-80 para exportación.

  • Repositorio GitHub.

  • Equipo de sonido para música original.

ARQUITECTURA DETALLADA

Componentes Principales

  • Core Game Engine (TIC-80)

  • Módulo Apuestas

  • Módulo de Animación de Carrera

  • Módulo de UI

  • Módulo Sonido/Música

  • Módulo de Exportación Multiplataforma

Roles del Equipo y Responsabilidades

Nombre Rol Responsabilidades

Fabián

Gamedev 1 – Tech Lead

Arquitectura del juego, compilación Android, mecánicas principales

Juan

Gamedev 2 – Software Engineer

Lógica UI, sistema de apuestas, compilación iOS

Bruno

Música & Arte

Composición musical, efectos de sonido, sprites Tier A

Javier

Arte & Web Build

Animaciones, diseño adorable, compilación Web

Jeremías

EM – Gestión & Documentación

Antora Docs, planificación, control de versiones

SEGURIDAD, CALIDAD Y PRUEBAS

Seguridad

  • No se manejan datos personales.

  • No existen transacciones monetarias.

  • Código abierto para auditorías del evento.

Testing

  • Pruebas unitarias en los módulos de lógica.

  • Pruebas manuales de animación.

  • QA multiplataforma en los tres entornos.

Validación con Stakeholders

  • Se realizan demos previas al evento.

  • Se validan diseños visuales con la organización benéfica.

CRITERIOS DE ACEPTACIÓN

  • El juego debe ejecutar correctamente en Android, iOS y Web.

  • Los multiplicadores deben cambiar aleatoriamente en cada partida.

  • El cálculo de ganancias/pérdidas debe ser 100% exacto.

  • Todo el arte debe ser temático de mascotas y aprobado por la organización.

  • La documentación final debe estar en Antora.

DEPENDENCIAS DE NEGOCIO

Lenguaje y Herramientas

  • TIC-80 (Javascript) como base principal del motor.

  • GitHub (repositorio).

  • Antora Docs para documentación.

  • Herramientas de arte 2D.