Backend Developers

Actúa como un Arquitecto Senior de Backend y experto en Diseño de APIs para generar un esquema GraphQL (SDL) de grado empresarial destinado a un [Nombre del Proyecto de Gestión de Inventario]. El objetivo es construir una estructura de datos escalable, tipada de forma estricta y optimizada para el consumo de aplicaciones modernas de alto rendimiento, siguiendo las convenciones de nomenclatura más rigurosas de la industria y el principio de diseño orientado al dominio.


Define detalladamente los tipos de datos principales, incluyendo 'Product', 'InventoryLevel', 'Warehouse', 'Supplier', 'Category' y 'StockMovement'. Cada entidad debe contar con campos de identificación únicos (ID), sellos de tiempo de auditoría (createdAt, updatedAt) y metadatos extensibles. Es imperativo que implementes relaciones complejas, como la capacidad de consultar el stock total de un producto a través de múltiples almacenes o rastrear el historial de movimientos de inventario filtrado por tipos de transacción como 'RESTOCK', 'SALE', 'RETURN' o 'ADJUSTMENT'.


Diseña un sistema de consultas (Queries) que soporte paginación basada en cursores (estándar Relay) para manejar grandes volúmenes de datos sin degradar el rendimiento, junto con argumentos de filtrado y ordenamiento dinámico. En cuanto a las mutaciones (Mutations), desarrolla operaciones atómicas y seguras para la creación de productos, la actualización masiva de precios y, fundamentalmente, la lógica de ajuste de stock que prevenga condiciones de carrera, utilizando tipos de entrada (Input Types) específicos y devolviendo tipos de respuesta que incluyan posibles errores de dominio.


Incorpora características avanzadas como el uso de 'Enums' para estados de pedidos y tipos de movimiento, 'Scalars' personalizados para fechas (DateTime) y coordenadas geográficas de almacenes, y 'Directivas' para el control de acceso basado en roles (RBAC) directamente en el esquema. El entregable final debe presentarse en un bloque de código SDL limpio, con descripciones detalladas para cada campo que sirvan como documentación técnica automática para desarrolladores frontend y socios externos que integren el sistema [Nombre del Socio Estratégico].

Si falta información clave para completar los campos entre corchetes, hazme las preguntas necesarias antes de responder.

Actúa como un Arquitecto de Soluciones Senior y Technical Writer especializado en el sector de logística y transporte en México. Tu misión es redactar una documentación técnica exhaustiva y profesional para la API de [NOMBRE_DE_LA_EMPRESA], diseñada específicamente para la integración de socios transportistas y proveedores de última milla. Esta guía será el recurso principal para desarrolladores externos que necesiten conectar sus sistemas con nuestra infraestructura central para la gestión de envíos, recolecciones y tracking en tiempo real.


La documentación debe iniciar con una introducción técnica que explique la arquitectura de la API (RESTful), el uso de HTTPS para todas las comunicaciones y el esquema de autenticación mediante [METODO_AUTENTICACION, ej. OAuth 2.0 o API Keys]. Es imperativo que la guía cumpla con las normativas fiscales vigentes en México, haciendo especial énfasis en la integración de datos requeridos para el Complemento Carta Porte 3.0 y la Factura Electrónica 4.0 del SAT. Debes detallar cómo los proveedores deben enviar los nodos de [DATOS_VEHICULO] y [DATOS_OPERADOR] dentro de los objetos JSON de la petición.


Estructura una sección detallada de 'Endpoints Principales'. Para cada endpoint (ej. POST /v1/shipments, GET /v1/tracking/{id}, PUT /v1/incidents), incluye: una descripción clara de su función, una tabla de parámetros de encabezado (headers), el esquema del cuerpo de la petición (request body) con tipos de datos específicos (string, integer, boolean) y ejemplos de respuestas exitosas (200 OK, 201 Created). No olvides incluir el manejo de errores con códigos de estado HTTP estandarizados (400 Bad Request, 401 Unauthorized, 422 Unprocessable Entity) y mensajes de error descriptivos que ayuden al desarrollador a corregir fallos en la integración de [SISTEMA_ORIGEN].


Proporciona una sección de 'Casos de Uso y Flujos de Trabajo' que explique visualmente (mediante descripción de pasos) el ciclo de vida de un envío, desde la creación del servicio hasta la confirmación de entrega (Proof of Delivery - POD). Incluye detalles sobre cómo enviar archivos binarios o Base64 para las evidencias fotográficas y firmas digitales. Además, define las reglas de negocio para el cálculo de costos basados en [ZONAS_GEOGRAFICAS] y pesos volumétricos, asegurando que la lógica sea transparente para el proveedor logístico.


Finalmente, incluye una sección de 'Mejores Prácticas y Límites de Tasa' (Rate Limiting). Explica la importancia de implementar mecanismos de reintento con backoff exponencial y cómo manejar los límites de [NUMERO_PETICIONES] solicitudes por minuto para garantizar la estabilidad del servicio. Concluye con un ejemplo de implementación rápida (Quickstart) en [LENGUAJE_DE_PROGRAMACION] que realice una petición autenticada básica para consultar el estado de una guía, permitiendo que el equipo de backend del socio externo pueda realizar su primera prueba exitosa en menos de 5 minutos.

Si falta información clave para completar los campos entre corchetes, hazme las preguntas necesarias antes de responder.