Plataforma de Aprendizaje de Economía

📚 Descripción

Plataforma web interactiva para enseñar economía a través de 4 módulos basados en material académico PDF.

🎯 Objetivo

Crear una experiencia de aprendizaje gamificada con ejercicios interactivos, visualizaciones dinámicas y seguimiento de progreso.

📖 Módulos Educativos

Módulo 1: Fundamentos de Economía

• Temas: Definición de economía, agentes económicos, factores de producción, flujo circular
• Ejercicios: Simulador de disyuntivas, Quiz de clasificación de bienes, Juego del flujo circular

Módulo 2: Oferta, Demanda y Equilibrio

• Temas: Curvas de oferta/demanda, equilibrio de mercado, controles de precios
• Ejercicios: Constructor de curvas interactivo, Simulador de precios máximos/mínimos

Módulo 3: Utilidad y Elasticidad

• Temas: Utilidad marginal, elasticidades, clasificación de bienes
• Ejercicios: Calculadora de elasticidad, Ejercicios tipo examen, Clasificador de bienes

Módulo 4: Teoría del Productor

• Temas: Costos, producción, competencia perfecta, maximización de beneficios
• Ejercicios: Simulador de decisión de producción, Calculadora de costos

🏗️ Arquitectura Técnica

Stack Tecnológico

• Frontend: React 18 + TypeScript + Tailwind CSS
• Visualización: D3.js + Recharts
• Estado: Zustand
• Routing: React Router v6
• Build: Vite
• Container: Docker + Docker Compose

Estructura de Carpetas

econ-learning/
├── src/
│   ├── components/          # Componentes reutilizables
│   │   ├── charts/         # Gráficos interactivos
│   │   ├── exercises/      # Ejercicios específicos
│   │   └── ui/             # Componentes UI base
│   ├── modules/            # Módulos educativos
│   │   ├── clase1/
│   │   ├── clase2/
│   │   ├── clase3/
│   │   └── clase4/
│   ├── hooks/              # Custom hooks
│   ├── stores/             # Estado global
│   └── utils/              # Utilidades
├── public/                 # Assets estáticos
├── docker/                 # Configuración Docker
└── docs/                   # Documentación técnica

🚀 Instrucciones de Despliegue

Desarrollo Local

# Instalar dependencias
npm install

# Iniciar servidor de desarrollo
npm run dev

Producción con Docker

# Construir imagen
docker-compose up -d

# Ver logs
docker-compose logs -f

📝 Roadmap

Fase 1: Fundamentos (Semana 1-2)

• Setup del proyecto con Vite + React + TS
• Configuración de Docker
• Componentes base UI
• Estructura de routing

Fase 2: Módulo 1 (Semana 3)

• Contenido teórico del Módulo 1
• Simulador de disyuntivas
• Quiz de clasificación de bienes
• Juego del flujo circular

Fase 3: Módulo 2 (Semana 4)

• Constructor de curvas interactivo
• Simulador de precios
• Ejercicios de equilibrio

Fase 4: Módulos 3-4 (Semana 5-6)

• Calculadora de elasticidad
• Simulador de costos
• Sistema de puntuación

Fase 5: Pulido (Semana 7)

• Tests
• Optimización de rendimiento
• Documentación final

🔧 Requisitos del Sistema

• Node.js 18+
• Docker (opcional)
• Navegador moderno con soporte ES6+

📄 Licencia

Proyecto educativo personal.