// 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.

Consulta Actual
Temperatura, descripción, humedad, sensación térmica, mínima/máxima y viento en una sola vista.
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.
Búsqueda por texto libre sin autocompletado: nombres ambiguos y países fuera de cobertura producían resultados inconsistentes.
Geolocalización sin validación: coordenadas inválidas o no soportadas rellenaban la ubicación sin verificar el resultado del reverse geocoding.
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 VALIDADASDIAGNÓ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.
// ARCHITECTURE // MODULES
Arquitectura Modular
Tres capas verificables: reactividad en la interfaz, estado predictible y persistencia transaccional.
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
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
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