Se busca un desarrollador experimentado para construir un servicio externo (api rest) que automatice el conteo de elementos en imágenes utilizando la capacidad de visión de chatgpt. Este servicio será un componente clave para la integración con un sistema existente, recibiendo una url de imagen y retornando un json con el conteo detectado.
Alcance del Proyecto (MVP):
El proyecto consiste en el desarrollo de una api rest robusta en
node.js, preferiblemente utilizando frameworks como Express o Fastify, con los siguientes endpoints:
- POST /v1/count: Este endpoint recibirá un cuerpo JSON con la estructura { "imageUrl": "string", "rules?": "object" } y responderá con { "count": "number", "details": "object" }.
- GET /v1/health: Un endpoint simple para verificar el estado operativo del servicio (healthcheck).
Integración con ChatGPT (Visión):
La funcionalidad central del servicio implicará la integración con ChatGPT (visión) para:
- Descargar la imagen desde la Imageurl proporcionada o pasar la url directamente al modelo de ia.
- Analizar la imagen para contar los elementos visibles, aplicando un conjunto de reglas configurables.
- Retornar el número total de elementos detectados y, opcionalmente, un desglose detallado por tipo de elemento.
Configuración por Ambiente (ENV):
El servicio debe ser fácilmente configurable para diferentes entornos, incluyendo:
- Gestión segura de claves API para la integración con ChatGPT.
- Configuración de tiempos de espera (timeouts) para las solicitudes externas.
- Ajuste de la "temperatura" del modelo de IA para controlar la creatividad/precisión de las respuestas.
- Implementación de una política de reintentos para manejar fallos temporales en la comunicación con servicios externos.
Validación y Manejo de Errores:
Es crucial que el servicio cuente con un manejo de errores exhaustivo, incluyendo:
- Detección y gestión de URLs de imagen inválidas.
- Manejo adecuado de imágenes inaccesibles o formatos de imagen no soportados.
- Control de tiempos de ejecución excedidos para evitar bloqueos.
Logs y Trazabilidad:
Se requiere la implementación de logs básicos en formato JSON, incluyendo un correlation-id por cada solicitud para facilitar la trazabilidad y depuración.
Documentación:
El proyecto debe incluir una documentación completa para facilitar su despliegue y uso:
- Un Dockerfile para la contenerización del servicio.
- Un archivo README con instrucciones claras para el despliegue local y en un servidor Linux.
- Documentación de la API utilizando OpenAPI/Swagger, con ejemplos de uso prácticos, incluyendo Postman.
Reglas de Conteo (Configurables):
Las reglas específicas para el conteo de elementos son fundamentales:
- Elemento: Se define como una unidad claramente separada (por ejemplo, una caja de impresora se cuenta como 1, cada rollo de etiquetas se cuenta como 1).
- Exclusiones: No se deben contar elementos como etiquetas impresas sueltas en el papel, ni texto o códigos QR en la hoja.
- Ambigüedad: En caso de ítems parcialmente ocultos, se contarán solo si su contorno sugiere claramente una pieza completa.
Plazo de Entrega: No definido