d31575a143
Features: - React 18 + TypeScript frontend with Vite - Go + Gin backend API - PostgreSQL database - JWT authentication with refresh tokens - User management (admin panel) - Docker containerization - Progress tracking system - 4 economic modules structure Fixed: - Login with username or email - User creation without required email - Database nullable timestamps - API response field naming
114 lines
3.4 KiB
Markdown
114 lines
3.4 KiB
Markdown
# 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.
|