# 📚 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`