Countries Explorer - Prueba Técnica

Aplicación fullstack que consume la API REST Countries para explorar información de países con filtros y paginación.

Características

Backend (Node.js + TypeScript)

• API REST con Express
• Caché inteligente (10 minutos)
• Validación de requests
• Manejo de errores
• Tests unitarios

Frontend (React + TypeScript)

• Diseño responsivo con Tailwind CSS
• Filtros por región y búsqueda
• Paginación
• Estados de carga y error

Estructura del Proyecto

├── backend/        # API Node.js
│   ├── src/
│   └── __tests__/
└── src/           # Frontend React
    ├── components/
    └── services/

Instalación y Ejecución

# Instalar dependencias
npm install
cd backend && npm install && cd ..

# Ejecutar aplicación completa
npm run dev:full

# Solo backend: npm run backend:dev
# Solo frontend: npm run dev

URLs:

• Frontend: http://localhost:5173
• Backend: http://localhost:3001

API Endpoints

GET /api/countries

Obtiene países con filtros opcionales:

• region: Filtrar por región
• name: Buscar por nombre
• page: Número de página
• limit: Elementos por página

Ejemplo:

GET /api/countries?region=Europe&page=1&limit=10

GET /api/countries/regions

Obtiene lista de regiones disponibles.

Testing

cd backend && npm test

Tecnologías

• Backend: Node.js, Express, TypeScript, Jest
• Frontend: React, TypeScript, Tailwind CSS, Vite

Funcionalidades Implementadas

✅ API REST que consume REST Countries
✅ Filtros por región y búsqueda por nombre
✅ Paginación de resultados
✅ Caché para optimizar rendimiento
✅ Validación de entrada
✅ Manejo de errores
✅ Diseño responsivo
✅ Tests unitarios