app tesis

# 📋 DOCUMENTO DE DISEÑO - APLICACIÓN EDUCATIVA RPG

## 🎯 TÍTULO DEL PROYECTO
**"Las Ecuaciones del Equilibrio"** (o el nombre que prefieras)

---

## 📖 SINOPSIS DE LA HISTORIA

El pueblo de Algebrania vivía en perfecta armonía gracias al Equilibrio Matemático, un poder antiguo sostenido por ecuaciones perfectas. Sin embargo, el villano Caos rompió este equilibrio, causando que las edificaciones del pueblo se deterioraran y quebraran.

El protagonista, X, un joven aprendiz de mago matemático, debe recorrer cuatro edificaciones dañadas del pueblo y restaurar el equilibrio resolviendo problemas matemáticos. En cada edificación aprenderá conceptos fundamentales que lo prepararán para enfrentar el desafío final: dominar las ecuaciones de segundo grado y derrotar a Caos.

---

## 👥 PERSONAJES PRINCIPALES

### **X (Protagonista)**
- Joven mago matemático aprendiz
- Edad aparente: 18-20 años
- Personalidad: Determinado, curioso, amigable
- Objetivo: Restaurar el equilibrio del pueblo
- Diseño: Mago chibi con túnica azul oscura/morada, gorro puntiagudo sin decoraciones

### **Caos (Antagonista)**
- Villano que rompió el Equilibrio Matemático
- Representa el desorden y la confusión matemática
- Aparece al final del juego como desafío supremo
- Diseño: Por definir (mago oscuro, sombra, criatura abstracta)

### **NPCs por Edificación** (4 personajes)
1. **Poblador de la Casa** - Enseña conceptos básicos
2. **Molinero** - Enseña operaciones y propiedades
3. **Sacerdote/Guardián de la Iglesia** - Enseña despejar variables
4. **Rey/Guardián del Castillo** - Enseña ecuaciones lineales avanzadas

---

## 🏗️ EDIFICACIONES Y PROGRESIÓN

### **1. CASA DEL POBLADOR**
- **Estado:** Paredes agrietadas, techo dañado
- **NPC:** Poblador común preocupado
- **Tema matemático:** Operaciones básicas y números enteros
- **Contenido:**
  - Suma y resta con negativos
  - Multiplicación y división
  - Jerarquía de operaciones
- **Al completar:** La casa se repara visualmente

### **2. MOLINO**
- **Estado:** Aspas rotas, mecanismo detenido
- **NPC:** Molinero frustrado
- **Tema matemático:** Propiedades algebraicas fundamentales
- **Contenido:**
  - Propiedad distributiva
  - Propiedad asociativa y conmutativa
  - Términos semejantes
  - Simplificación de expresiones
- **Al completar:** El molino comienza a girar nuevamente

### **3. IGLESIA**
- **Estado:** Vitrales rotos, campanario inclinado
- **NPC:** Sacerdote o guardián espiritual
- **Tema matemático:** Despejar incógnitas (ecuaciones simples)
- **Contenido:**
  - Concepto de variable (x)
  - Despejar x en ecuaciones tipo: x + a = b
  - Despejar x en ecuaciones tipo: ax = b
  - Ecuaciones con dos operaciones: ax + b = c
- **Al completar:** La iglesia recupera su brillo y armonía

### **4. CASTILLO**
- **Estado:** Torres derrumbadas, puente levadizo caído
- **NPC:** Rey o guardián del castillo
- **Tema matemático:** Ecuaciones lineales complejas y sistemas básicos
- **Contenido:**
  - Ecuaciones con x en ambos lados
  - Ecuaciones con paréntesis
  - Introducción a sistemas de ecuaciones (2 variables)
  - Preparación para ecuaciones cuadráticas
- **Al completar:** El castillo se restaura completamente

### **5. TORRE DEL CAOS (DESAFÍO FINAL)**
- **Estado:** Torre oscura que apareció en el centro del pueblo
- **Boss:** Caos (villano principal)
- **Tema matemático:** Ecuaciones de segundo grado
- **Contenido:**
  - Concepto de ecuación cuadrática
  - Fórmula general
  - Resolución de ecuaciones ax² + bx + c = 0
  - Problemas aplicados
- **Al completar:** El equilibrio se restaura, el pueblo brilla completamente

---

## 🎮 ESTRUCTURA DE LA APLICACIÓN

### **PANTALLA 1: INICIO**
- Logo/Título del juego
- Botón "Comenzar"
- Botón "Continuar" (si hay progreso guardado)
- Botón "Créditos"

### **PANTALLA 2: CINEMÁTICA INICIAL**
- Narración breve de la historia
- Imágenes estáticas o diapositivas pixel art
- Explicación de la misión de X
- Puede ser estilo novela visual con retratos

### **PANTALLA 3: HUB/MENÚ PRINCIPAL**
- **Fondo:** Vista isométrica simple del pueblo dañado
- **Elementos visibles:**
  - 4 edificaciones dañadas (Casa, Molino, Iglesia, Castillo)
  - Torre del Caos (bloqueada hasta completar las 4)
  - Retrato de X en la esquina superior
  - Barra de progreso general
- **Interacción:** Click/tap en cada edificación para entrar
- **Progreso visual:** Las edificaciones se reparan conforme avanzas

### **PANTALLA 4: INTERIOR DE EDIFICACIÓN (se repite por cada una)**

**Estructura:**
- **Sección superior:** Retrato del NPC correspondiente
- **Sección media:** Cuadro de diálogo estilo Pokémon
- **Sección inferior:** Botones de navegación

**Subsecciones dentro de cada edificación:**

1. **Introducción**
   - NPC explica el problema
   - Contexto narrativo del daño

2. **Lección Teórica**
   - Explicación del concepto matemático
   - Ejemplos visuales con animaciones simples
   - Puede tener 2-4 pantallas de contenido

3. **Práctica Guiada**
   - 3-5 ejercicios con ayuda/hints disponibles
   - Feedback inmediato (correcto/incorrecto)
   - Explicación si falla

4. **Desafío**
   - 5-10 ejercicios progresivos sin ayuda
   - Sistema de vidas o intentos
   - Recompensa por desempeño (estrellas 1-3)

5. **Cierre Narrativo**
   - NPC agradece
   - La edificación se repara (animación corta)
   - Recompensa: monedas, experiencia, fragmento del equilibrio

### **PANTALLA 5: BATALLA FINAL (Torre del Caos)**
- Interfaz especial de batalla
- Sistema de preguntas con tiempo limitado (opcional)
- Barra de vida de Caos que disminuye con respuestas correctas
- Cinemática de victoria al completar

### **PANTALLA 6: FINAL**
- Cinemática de cierre
- Pueblo completamente restaurado
- Créditos
- Estadísticas finales del jugador

---

## 📊 SISTEMAS DE LA APLICACIÓN

### **Sistema de Progresión**
- Edificaciones se desbloquean en orden lineal
- Cada edificación tiene 4 subsecciones obligatorias
- Progreso guardado automáticamente
- No se puede avanzar sin completar la sección actual

### **Sistema de Recompensas**
- **Estrellas:** 1-3 por desafío según desempeño
- **Monedas matemáticas:** Por cada ejercicio correcto
- **Experiencia:** X sube de nivel (visual)
- **Fragmentos del Equilibrio:** 1 por edificación completada

### **Sistema de Ayuda**
- Botón "Hint" con pistas limitadas (3 por desafío)
- Botón "Ver ejemplo" repite la teoría
- Opción "Saltar" si está bloqueado (después de 3 fallos)

### **Sistema de Feedback**
- Correcto: Sonido positivo, animación de estrella
- Incorrecto: Sonido suave negativo, explicación breve
- Sin castigo severo (enfoque educativo)

### **Sistema de Guardado**
- Guardado automático después de cada ejercicio
- Almacenamiento local en dispositivo
- Posibilidad de reiniciar progreso

---

## 🎨 ESTILO VISUAL

### **Estética General**
- Pixel art estilo Pokémon/Stardew Valley
- Proporciones chibi (3-4 cabezas de altura)
- Paleta de colores oscuros y apagados (no saturados)
- Tonos tierra, verdes oscuros, morados, azules

### **Edificaciones**
- **Dañadas:** Grietas, colores apagados, elementos rotos
- **Reparadas:** Brillantes, colores más vivos, completas

### **Interfaz**
- Cuadros de texto estilo Pokémon (blancos con borde oscuro)
- Botones pixel art grandes y claros
- Fuente legible (no pixelada para textos largos)
- Iconos matemáticos simples

---

## 📱 PLATAFORMA Y TECNOLOGÍA

### **Plataforma Objetivo**
- Aplicación móvil (Android/iOS)
- Orientación vertical principalmente
- Táctil optimizado

### **Tecnología Sugerida** (tú decides)
- React Native (multiplataforma)
- Unity 2D (motor de juegos)
- Godot Engine (open source)
- HTML5 + Phaser (si es web)

---

## 📚 CONTENIDO MATEMÁTICO DETALLADO

### **Progresión Curricular:**

**Casa (Fundamentos):**
- Números enteros y operaciones
- Jerarquía de operaciones (PEMDAS)
- 15-20 ejercicios totales

**Molino (Álgebra Básica):**
- Expresiones algebraicas
- Términos semejantes
- Propiedad distributiva
- 20-25 ejercicios totales

**Iglesia (Ecuaciones Simples):**
- x + a = b
- ax = b
- ax + b = c
- x/a = b
- 25-30 ejercicios totales

**Castillo (Ecuaciones Complejas):**
- ax + b = cx + d
- a(x + b) = c
- Sistemas 2x2 simples
- 30-35 ejercicios totales

**Torre Final (Ecuaciones Cuadráticas):**
- ax² + bx + c = 0
- Fórmula general
- Factorización simple
- Problemas aplicados
- 20-25 ejercicios finales

**Total estimado:** 130-155 ejercicios en toda la aplicación

---

## 🎯 OBJETIVOS EDUCATIVOS

### **Objetivo General:**
El estudiante será capaz de resolver ecuaciones de segundo grado mediante la comprensión progresiva de conceptos algebraicos fundamentales.

### **Objetivos Específicos:**
1. Dominar operaciones con números enteros
2. Comprender y aplicar propiedades algebraicas
3. Despejar variables en ecuaciones simples
4. Resolver ecuaciones lineales complejas
5. Aplicar la fórmula general para ecuaciones cuadráticas

---

## 📈 MÉTRICAS Y EVALUACIÓN

### **Datos a Recopilar (para tu tesis):**
- Tiempo promedio por edificación
- Tasa de aciertos por tipo de ejercicio
- Número de hints utilizados
- Ejercicios con más dificultad
- Tasa de abandono por sección
- Tiempo total de juego

### **Evaluación Final:**
- Pre-test antes de jugar
- Post-test después de completar
- Comparación de resultados

---

## ⚙️ CARACTERÍSTICAS TÉCNICAS NECESARIAS

### **Assets Requeridos:**
- 1 sprite de X (frontal)
- 8 sprites de movimiento de X (4 direcciones × 2 frames)
- 4 retratos de NPCs
- 1 sprite/imagen del villano Caos
- 4 edificaciones dañadas (pixel art)
- 4 edificaciones reparadas (pixel art)
- 1 torre oscura
- Tileset de suelo (césped simple)
- UI elements (botones, cuadros de texto, iconos)
- Efectos de partículas (opcional)

### **Sonidos/Música:**
- Música de fondo tranquila (pueblo)
- Música tensa (Torre final)
- Efectos de sonido (correcto, incorrecto, completar)
- Efectos de reparación de edificios

### **Funcionalidades Clave:**
- Sistema de input matemático (teclado numérico)
- Validación de respuestas
- Generador de ejercicios aleatorios (opcional)
- Sistema de guardado local
- Animaciones de transición
- Sistema de diálogos con avance manual

---

## 🚀 FASES DE DESARROLLO SUGERIDAS

### **Fase 1: Prototipo Básico**
- Personaje X (frontal)
- 1 edificación funcional (Casa)
- Sistema de diálogos
- 10 ejercicios de prueba
- Navegación básica

### **Fase 2: Contenido Completo**
- 4 edificaciones implementadas
- Todos los ejercicios
- Sistema de progresión
- Guardado funcional

### **Fase 3: Torre Final**
- Boss fight con Caos
- Ecuaciones cuadráticas
- Cinemáticas de inicio y final

### **Fase 4: Pulido**
- Todas las animaciones
- Sonidos y música
- Balance de dificultad
- Testing con usuarios

---

## 📝 NOMBRE FINAL SUGERIDO
**"X: Guardián del Equilibrio"**
o
**"Las Ecuaciones de Algebrania"**
o
**"X y el Equilibrio Perdido"**

---

**¿Esta estructura es lo que necesitabas? ¿Quieres que modifique o agregue algo específico?** 📋✨