Files
econ/README.md
Renato97 08f1d61e25 docs: update README with bilingual documentation
- Add English and Spanish sections
- Improve project description and features
- Add professional formatting
2026-03-31 01:32:53 -03:00

3.8 KiB

📚 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

📄 License / Licencia

Private project / Proyecto privado


Tags / Etiquetas: go react typescript economics education gamification docker e-learning