Initial commit: Plataforma de Economía
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
This commit is contained in:
113
README.md
Normal file
113
README.md
Normal file
@@ -0,0 +1,113 @@
|
||||
# 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.
|
||||
Reference in New Issue
Block a user