Saltar al contenido
AÑO // 2026 DESPLEGADO

// WEATHER API // 2026

CLIMA VUE

Aplicación web de clima en tiempo real: autocompletado de ciudades con la API de Geocoding, geolocalización GPS validada, historial local y manejo explícito de errores sobre datos de OpenWeatherMap.

// PROBLEMA
La consulta climática dependía de escribir el nombre exacto de la ciudad, sin sugerencias, validación de ubicación ni historial; los errores de red o permisos dejaban la interfaz sin respuesta útil.
// STACK TÉCNICO
  • Vue 3
  • JavaScript
  • Vite
  • Tailwind CSS
  • Axios
  • OpenWeatherMap
// IMPACTO
  • 350 ms Debounce — AUTOCOMPLETADO
  • 5 Búsquedas — HISTORIAL LOCAL
  • Vitest — PRUEBAS
  • ROLDesarrollador Frontend
  • CLIENTEProyecto Personal
  • DURACIÓNProyecto Personal // 2026

Especificaciones del proyecto

01 // ROL

Desarrollador Frontend

WEATHER API

02 // CLIENTE

Proyecto Personal

PROYECTO 2026

03 // DURACIÓN

Proyecto Personal // 2026

STATUS // DESPLEGADO

04 // STACK

Vue 3 • Vite • OpenWeatherMap

Vue 3 • JavaScript • Vite • Tailwind CSS • Axios • OpenWeatherMap

// 00. REGISTRO VISUAL & CAPTURAS DE INTERFAZ

Capturas del Sistema

Interfaz principal, autocompletado de ciudades y vista móvil del flujo de consulta climática.

clima-vue-vert.vercel.app //home
01 / 03
Vista principal de Clima Vue con temperatura actual y métricas meteorológicas

Consulta Actual

Temperatura, descripción, humedad, sensación térmica, mínima/máxima y viento en una sola vista.

Clima ActualOpenWeatherMapGlassmorphism
// 01. EL DESAFÍO TÉCNICO & AUDITORÍA

El Desafío

La primera versión resolvía la búsqueda con una petición directa por texto libre. Sin debounce ni validación, los nombres ambiguos generaban resultados inconsistentes y cada interacción podía disparar múltiples llamadas a la API.

  1. Búsqueda por texto libre sin autocompletado: nombres ambiguos y países fuera de cobertura producían resultados inconsistentes.

  2. Geolocalización sin validación: coordenadas inválidas o no soportadas rellenaban la ubicación sin verificar el resultado del reverse geocoding.

  3. Errores silenciosos y estado disperso: ciudad no encontrada, permiso denegado, timeout o falta de soporte dejaban la UI sin un mensaje claro ni historial reutilizable.

Reporte de Auditoría

API & UX VALIDADAS

DIAGNÓSTICO // HALLAZGO CRÍTICO

La consulta se hacía con una petición directa por nombre de ciudad, sin debounce, sin sugerencias y sin validar la ubicación obtenida por GPS. El estado de carga, error e historial vivía disperso en los componentes.

RESOLUCIÓN // SOLUCIÓN TÉCNICA

Se centralizó el flujo en el composable useClima: debounce de 350 ms para el autocompletado, Geocoding y current weather de OpenWeatherMap vía Axios, reverse geocoding para validar el GPS, historial en localStorage (máximo 5) y mensajes explícitos para cada escenario de error.

AUTOCOMPLETADO

350 ms Debounce

Geocoding API en tiempo real

HISTORIAL LOCAL

5 Búsquedas

localStorage, sin backend

PRUEBAS

Vitest

Composable useClima

Flujo de OpenWeatherMap, validación de ubicación y persistencia local implementados en el cliente; el composable useClima está cubierto por pruebas con Vitest.

// 02. ARQUITECTURA DE SOFTWARE

// ARCHITECTURE // MODULES

Arquitectura Modular

Tres capas verificables: reactividad en la interfaz, estado predictible y persistencia transaccional.

MODULE 01/03

MOD-A // Reactividad

Capa Reactiva con Vue 3 & Composition API

El composable useClima concentra búsqueda, carga, error y clima actual; la UI solo consume estado derivado y evita peticiones duplicadas.

  • Composable useClima por responsabilidad
  • Debounce de 350 ms en el autocompletado
  • Estado de carga y error explícito
MODULE 02/03

MOD-B // Integración API

OpenWeatherMap Current Weather & Geocoding

Consumo de Axios contra las APIs de clima y geocodificación, con reverse geocoding para validar la ubicación GPS y filtrar países soportados.

  • Current Weather + Geocoding
  • Reverse geocoding para GPS
  • Validación de país soportado
MODULE 03/03

MOD-C // Persistencia Local

Historial y Privacidad en el Cliente

Historial de las últimas cinco búsquedas en localStorage, sin backend ni almacenamiento de coordenadas en servidor.

  • Historial máximo de 5 búsquedas
  • LocalStorage como única persistencia
  • GPS procesado solo en el navegador