¡Bienvenido a la solución del proyecto Operación Fuego de Quásar! Esta implementación aborda la tarea de determinar la ubicación y el mensaje de auxilio de una nave en problemas utilizando satélites.
Este repositorio contiene la solución para el desarrollo backend del proyecto. A continuación, se describen los aspectos más importantes:
El código fuente de la aplicación se encuentra en el directorio src
. Aquí encontrarás la implementación de los algoritmos para calcular la ubicación y el mensaje. Los cuales fueron implementadas con base en una version simplificada de la arquitectura hexagonal ademas de otras buenas practicas.
Se ha implementado una API REST con tres endpoints principales:
-
/api/v1.0/rescue/topsecret
: Recibe información de los satélites a través de un POST y devuelve la ubicación y el mensaje de la nave. -
/api/v1.0/rescue/topsecret_split/{satellite_name}
: Permite actualizar la posición de un satélite específico mediante POST. -
/api/v1.0/rescue/topsecret_split
: Un endpoint GET que indica la posición y el mensaje si es posible determinarlo, con una estructura similar al ejemplo del Nivel 2. Responde con un mensaje de error si no hay suficiente información.
La documentación detallada de la API se encuentra en el archivo Docs/rescue_api_swagger.yaml
y Docs/rescue_api_swagger.html
. Este archivo describe los endpoints, los esquemas de solicitud y respuesta, así como cualquier información adicional relevante.
Para ejecutar la aplicación y probar los endpoints, sigue estos pasos:
- Clonar el Repositorio: Clona este repositorio en tu máquina local.
git clone https://github.com/bsdiaza/MELI-Challenge
- Ejecutar la Compilado: Navega al directorio
/out/artifacts/rescue_api_jar
. Allí encontrarás el archivorescue-api-1.0-ESTABLE.jar
, el cual puede ser ejecutado usando el siguiente comando:
java -jar rescue-api-1.0-ESTABLE.jar