# 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
```bash
# Instalar dependencias
npm install

# Iniciar servidor de desarrollo
npm run dev
```

### Producción con Docker
```bash
# 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.