馃摌 Introducci贸n
Descripci贸n
Este proyecto es una API de Clima Local implementada con Laravel 12, que ofrece un servicio RESTful para obtener informaci贸n clim谩tica basada en coordenadas geogr谩ficas.
A diferencia de las soluciones que dependen de APIs externas, esta API consulta directamente una base de datos local que contiene registros hist贸ricos y precargados de datos clim谩ticos.
La carga de datos en la base de datos se realiza mediante un proceso automatizado con N8N, el cual consulta peri贸dicamente la API de CONAGUA y persiste la informaci贸n localmente. La aplicaci贸n sigue principios de dise帽o limpio, utilizando Laravel Actions para la encapsulaci贸n de la l贸gica de negocio y Laravel API Resources para una transformaci贸n y presentaci贸n de datos consistente y limpia.
Objetivo
Proveer un servicio confiable y eficiente para la consulta de informaci贸n clim谩tica basada en coordenadas geogr谩ficas, a trav茅s de una API RESTful construida con Laravel 12. Esta soluci贸n permite acceder a datos meteorol贸gicos hist贸ricos y actualizados sin depender de fuentes externas, gracias a una base de datos local alimentada autom谩ticamente desde la API de CONAGUA mediante N8N. El sistema garantiza respuestas consistentes y estructuradas, siguiendo principios de dise帽o limpio que facilitan su mantenimiento, escalabilidad e integraci贸n con otras aplicaciones o servicios institucionales.
Caracter铆sticas Principales
- Obtenci贸n de datos clim谩ticos actuales desde una base de datos local.
- Organizaci贸n de la l贸gica de negocio mediante Actions.
- Serializaci贸n de respuestas API limpia y consistente con API Resources.
Tecnolog铆as Utilizadas
- Laravel 12: Framework de PHP para el desarrollo web.
- PHP 8.2+.
- Composer: Gestor de dependencias de PHP.
- MySQL: Base de datos (configurada en
.env). - Carbon: Para el manejo de fechas y horas.