08f1d61e25
- Add English and Spanish sections - Improve project description and features - Add professional formatting
113 lines
3.8 KiB
Markdown
113 lines
3.8 KiB
Markdown
# 📚 Econ - Interactive Economics Learning Platform
|
|
|
|
## 📝 Description / Descripción
|
|
|
|
**English:**
|
|
An interactive web platform for learning economics through exercises, simulations, and visualizations. Built with Go backend and React frontend, featuring gamification elements like badges, progress tracking, and achievement systems.
|
|
|
|
**Español:**
|
|
Una plataforma web interactiva para aprender economía mediante ejercicios, simulaciones y visualizaciones. Construida con backend en Go y frontend en React, con elementos de gamificación como insignias, seguimiento de progreso y sistemas de logros.
|
|
|
|
## 🚀 Features / Características
|
|
|
|
**English:**
|
|
- Interactive exercises with instant feedback
|
|
- Supply and demand curve simulations
|
|
- Production possibility frontier (PPF) visualizations
|
|
- Elasticity calculators and exercises
|
|
- Cost curves and profit maximization
|
|
- Progress tracking with badges and scores
|
|
- Audio classes and PDF resources
|
|
- User authentication and data persistence
|
|
- Responsive design for all devices
|
|
|
|
**Español:**
|
|
- Ejercicios interactivos con retroalimentación instantánea
|
|
- Simulaciones de curvas de oferta y demanda
|
|
- Visualizaciones de frontera de posibilidades de producción (FPP)
|
|
- Calculadoras y ejercicios de elasticidad
|
|
- Curvas de costos y maximización de beneficios
|
|
- Seguimiento de progreso con insignias y puntajes
|
|
- Clases en audio y recursos PDF
|
|
- Autenticación de usuarios y persistencia de datos
|
|
- Diseño responsive para todos los dispositivos
|
|
|
|
## 🛠️ Tech Stack / Stack Tecnológico
|
|
|
|
### Backend
|
|
- **Language:** Go 1.21+
|
|
- **Framework:** Standard library + gorilla/mux
|
|
- **Database:** PostgreSQL
|
|
- **Authentication:** JWT
|
|
- **API:** RESTful
|
|
|
|
### Frontend
|
|
- **Framework:** React 18 + TypeScript
|
|
- **Build Tool:** Vite
|
|
- **Styling:** Tailwind CSS
|
|
- **State Management:** Zustand
|
|
- **Charts:** Custom D3/Recharts
|
|
|
|
### Infrastructure
|
|
- **Containerization:** Docker + Docker Compose
|
|
- **Reverse Proxy:** Nginx
|
|
- **Deployment:** Self-hosted
|
|
|
|
## 📚 Content Modules / Módulos de Contenido
|
|
|
|
1. **Module 1 / Módulo 1:** Introduction to Economics / Introducción a la Economía
|
|
- Economic agents / Agentes económicos
|
|
- Production factors / Factores de producción
|
|
- Opportunity cost / Costo de oportunidad
|
|
- PPF / FPP
|
|
|
|
2. **Module 2 / Módulo 2:** Supply and Demand / Oferta y Demanda
|
|
- Law of demand / Ley de la demanda
|
|
- Law of supply / Ley de la oferta
|
|
- Market equilibrium / Equilibrio de mercado
|
|
- Elasticity / Elasticidad
|
|
|
|
3. **Module 3 / Módulo 3:** Consumer Theory / Teoría del Consumidor
|
|
- Utility maximization / Maximización de utilidad
|
|
- Indifference curves / Curvas de indiferencia
|
|
- Budget constraints / Restricciones presupuestarias
|
|
|
|
4. **Module 4 / Módulo 4:** Producer Theory / Teoría del Productor
|
|
- Production functions / Funciones de producción
|
|
- Cost curves / Curvas de costos
|
|
- Profit maximization / Maximización de beneficios
|
|
|
|
## 🔧 Setup / Configuración
|
|
|
|
**English:**
|
|
1. Clone repository: `git clone <repo-url>`
|
|
2. Start with Docker Compose: `docker-compose up -d`
|
|
3. Access frontend at `http://localhost`
|
|
4. Backend API at `http://localhost:8080`
|
|
|
|
**Español:**
|
|
1. Clona repositorio: `git clone <repo-url>`
|
|
2. Inicia con Docker Compose: `docker-compose up -d`
|
|
3. Accede al frontend en `http://localhost`
|
|
4. API backend en `http://localhost:8080`
|
|
|
|
## 🎯 Gamification / Gamificación
|
|
|
|
- **Badges / Insignias:** Complete modules to earn badges
|
|
- **Points / Puntos:** Score based on exercise accuracy
|
|
- **Progress / Progreso:** Visual progress bars for each module
|
|
- **Streaks / Rachas:** Consecutive day learning bonuses
|
|
|
|
## 👨💻 Author / Autor
|
|
|
|
**Renato CBC**
|
|
- GitHub: [renato97](https://gitea.cbcren.online/renato97)
|
|
|
|
## 📄 License / Licencia
|
|
|
|
Private project / Proyecto privado
|
|
|
|
---
|
|
|
|
**Tags / Etiquetas:** `go` `react` `typescript` `economics` `education` `gamification` `docker` `e-learning`
|