Pregunta: Listar los entregables de la etapa de diseño que se entregaran.
En este entregable se explicita cómo MuleSoft aporta la arquitectura API-led (Experience, Process y System APIs), los dominios de integración y las responsabilidades de orquestación, transformación y aplicación de políticas. Se detalla la integración con Azure: API Management como front door y publicación, Service Bus para procesos asíncronos, Key Vault para secretos, App Insights/Azure Monitor para observabilidad y las decisiones de red (VNET, VPN/ExpressRoute) que habilitan la conectividad onpremise. Incluye criterios de escalabilidad, resiliencia y alta disponibilidad en ambos stacks.
Los diagramas muestran visualmente cómo los flujos pasan por MuleSoft y Azure: solicitud desde el portal hacia API Management, enruteo a Experience API en MuleSoft, orquestación en Process API y conectores System hacia servicios SOAP. Se representa la mensajería con Service Bus, los puntos de logging con Anypoint Monitoring y Azure Monitor, y los componentes de seguridad (OAuth2, policies, Key Vault). Esto permite validar dependencias, latencia esperada y puntos de fallo en cada hop, facilitando la toma de decisiones en diseño.
Las especificaciones de APIs definen contratos que MuleSoft expone o consume y cómo se registran en API Management. Se incluyen recursos, métodos, códigos de respuesta, esquemas JSON/XML, ejemplos y reglas de versionado. Para sistemas SOAP, se adjuntan WSDL y mapeos hacia REST. Se detalla cómo se aplican policies en MuleSoft y Azure (rate limiting, JWT validation, IP filtering) y cómo se publica en el developer portal para consumo interno/externo, manteniendo consistencia en toda la plataforma. Incluye ejemplos de errores y códigos de negocio para unificar manejo en MuleSoft y Azure.
El modelo de datos y transformaciones documenta cómo DataWeave en MuleSoft convierte XML legado a JSON canónico y viceversa, y cómo se manejan catálogos y campos obligatorios. Se define la ubicación de los esquemas (Anypoint Exchange o repositorio) y las validaciones previas al envío. Cuando Azure participa en flujos batch o eventos, se especifica el formato de mensajes en Service Bus, los headers de trazabilidad y las reglas de enriquecimiento con datos maestros almacenados en sistemas core. Se documenta el manejo de errores de parsing, las reglas de normalización y la trazabilidad de campos clave para auditoría. Esto ayuda a que MuleSoft y los servicios Azure compartan un modelo canónico consistente y eviten discrepancias entre ambientes.
Los NFR se traducen a configuraciones concretas: en MuleSoft, límites de concurrencia, timeouts, reintentos y circuit breakers; en Azure, SKUs de API Management, cuotas de Service Bus, escalado de App Service/AKS y retención de logs. Se establecen objetivos de disponibilidad, RTO/RPO, y se documenta la estrategia de observabilidad con correlación de IDs entre Anypoint y Azure Monitor. Incluye requisitos de cifrado, cumplimiento y planes de contingencia. Se incorporan SLIs/SLOs, umbrales de alertas, estrategias de throttling en API Management y políticas de retry/backoff alineadas entre MuleSoft y Service Bus para mantener estabilidad bajo carga.
El plan de integración y despliegue define cómo se promocionan APIs y aplicaciones Mule entre entornos, y cómo se coordinan los releases con recursos Azure. Se detalla la automatización con Azure DevOps, pipelines para empaquetar Mule apps, configuración de variables y secrets en Key Vault, y despliegues controlados en API Management. Además, se identifican ventanas de mantenimiento y dependencias de cambios en sistemas onpremise y contratos externos. Se contempla canary/blue-green en Azure, estrategia de rollback, control de versiones en Exchange y validación previa en entornos QA con datos sintéticos.
El backlog técnico traduce el diseño en historias de implementación para MuleSoft y Azure. Incluye tareas para crear APIs en Anypoint, configurar policies, crear colas en Service Bus, definir productos y suscripciones en API Management, y preparar dashboards en Azure Monitor. Cada historia debe especificar criterios de aceptación relacionados con integración, seguridad y performance, y vincularse a riesgos o supuestos documentados para asegurar trazabilidad. Se define definition of done técnica, dependencias con equipos de infraestructura y tiempos de aprovisionamiento de recursos Azure para evitar cuellos de botella.
El ADR registra decisiones sobre tecnología MuleSoft y Azure, por ejemplo por qué se elige API-led, qué patrones de integración se usarán (request/reply, pub/sub, batch), o qué servicios Azure sustituyen integraciones directas. Se justifican trade-offs de costos vs. latencia, o de simplicidad vs. resiliencia. Cada decisión incluye impacto en configuraciones de API Management, Service Bus, seguridad y estrategias de despliegue de Mule. El registro incluye responsables, fecha, alternativas evaluadas y una cadencia de revisión para asegurar vigencia, con impacto en costos de APIM, cuotas de Service Bus y licenciamiento MuleSoft.
El plan de pruebas define cómo se validarán los flujos MuleSoft y los componentes Azure: MUnit para APIs y transformaciones, pruebas de contract testing con API Management, pruebas de carga simulando picos en el portal, y validación de mensajería en Service Bus. Se incorporan pruebas de seguridad (tokens, scopes, policies) y validaciones de observabilidad para asegurar trazas completas entre Anypoint y Azure Monitor, incluyendo escenarios de falla y reintento. Se describen ambientes de prueba, mocks de sistemas onpremise, datos sensibles enmascarados y criterios de performance aceptable en APIs gestionadas por Azure.
La matriz de responsabilidades asigna dueños a cada API de MuleSoft, cada recurso en Azure y cada sistema onpremise. Define quién aprueba cambios de contratos, quién administra API Management y Service Bus, y quién opera la infraestructura. También describe los SLA/SLO por componente y las rutas de escalamiento para incidentes, lo que asegura gobernanza y continuidad del servicio, además de claridad en auditorías. Se indica RACI, ventanas de soporte 24x7, control de accesos con Azure AD y permisos en Anypoint, además de procesos de onboarding para nuevos responsables.