api / documentation /integrations /M7_debugging_evento_no_recibido.md
juampisor's picture
Corrige contrato M7 (idPacienteExterno/idEpisodioExterno) y agrega debugging guide
bff144c
|
Raw History Blame Contribute Delete
7.22 kB

M7 — El evento CIERRE_INTERNACION no llega, pese al 201 del Core

Para el equipo de Módulo 7 (Facturación). Publicamos el evento (event_type_id=19, facturacion.internacion.cama-lista.requested) contra el Core y recibimos 201, pero del lado de ustedes nunca aparece procesado. Este documento tiene dos partes: qué encontramos auditando su propio repo (modulo7-impl, que nos compartieron) y un checklist accionable para corregirlo.

Parte A — Diagnóstico

El 201 no prueba entrega. POST /events/log devuelve 201 en cuanto el Core acepta y loguea el mensaje (models.EventLog, estado inicial pending) — es una confirmación de que nosotros publicamos bien, no de que RabbitMQ lo entregó a facturacion.requests ni de que su consumer lo levantó. Ambos pasos ocurren después y de forma completamente desacoplada de nuestra llamada.

Revisamos su consumer real (src/main/java/com/grupo7/modulofacturacion/messaging/InternacionM6EventListener.java) y encontramos varios puntos donde el mensaje puede perderse sin ningún error visible:

  1. El bean completo es condicional (línea 20):

    @ConditionalOnExpression("${integracion.m6.eventos.enabled:true} && ${rabbitmq.enabled:true}")
    

    Si INTEGRACION_M6_EVENTOS_ENABLED o RABBITMQ_ENABLED resuelven a false (o a un valor que Spring no interprete como el booleano esperado) en su deploy de Render, el listener ni siquiera se registra. No hay excepción ni log de error — simplemente el bean no existe en el contexto de Spring. Nos pasó dos veces con variables de Hugging Face Spaces declaradas pero efectivamente vacías; vale la pena descartar lo mismo acá.

  2. Conexión a RabbitMQ con defaults de desarrollo local (src/main/resources/application.properties, líneas 69-73):

    spring.rabbitmq.host=${RABBITMQ_HOST:localhost}
    spring.rabbitmq.port=${RABBITMQ_PORT:5672}
    spring.rabbitmq.username=${RABBITMQ_USER:guest}
    spring.rabbitmq.password=${RABBITMQ_PASSWORD:guest}
    spring.rabbitmq.virtual-host=${RABBITMQ_VHOST:/}
    

    Si esas 5 variables no están seteadas en Render con los datos del broker compartido real, el consumer intenta conectar a localhost:5672 dentro de su propio contenedor — nunca va a encontrar nada ahí. Esto no afecta su API REST en absoluto (que sigue respondiendo normalmente, incluido el 401 que nos devuelve a nosotros en el fallback), así que desde afuera todo parece "andar bien" aunque el consumer nunca haya podido conectar.

  3. Filtro silencioso por event_type_id (isSupportedEvent, líneas 97-105): si M6_FACTURACION_EVENT_TYPE_ID está seteado a un valor distinto de 19, el mensaje se descarta sin reject ni excepción — solo:

    LOGGER.info("Se ignora evento Core no asociado a M6/M7. eventTypeId=..., eventTypeName=...")
    

    Indistinguible de "nunca llegó" a simple vista en el log si no se busca ese string puntual.

  4. Nombre de cola (application.properties línea 60): ${M6_FACTURACION_QUEUE_NAME:facturacion.requests} — el default coincide con lo que documentamos juntos, pero confirmar que no haya quedado sobreescrito a otra cosa.

  5. Si el mensaje sí llega pero falla al deserializar, el log a buscar es:

    LOGGER.warn("Payload M6 invalido: ...")   // IllegalArgumentException de IntegracionService
    LOGGER.warn("Payload M6 no es JSON valido") // JsonProcessingException
    

    Comparamos campo por campo nuestro payload contra controller/dto/InternacionM6Request.java y los nombres calzan exactamente (evento, camaId, idPacienteExterno, timestampEvento, idEventoExterno, idInternacionExterna, idEpisodioExterno, fechaIngreso, fechaAlta, tipoAlta) — de nuestro lado corregimos además idPacienteExterno para que viaje como número JSON (su DTO lo tipa Long, no String como mostraba nuestro doc anterior). Con esto, esta hipótesis es la menos probable, pero queda como último recurso antes de escalar al equipo de Core.

Nota aparte, no bloqueante: su propio M7_integration.md tampoco documenta que InternacionM6Request acepta camasUtilizadas, medicoSolicitanteId, medicoFirmanteId, diagnosticoIngreso y observaciones (todos opcionales) — su doc pública quedó un paso atrás de su código, el mismo tipo de desvío que nosotros tuvimos que corregir la sesión pasada. Sugerimos alinearla, sin apuro.

Parte B — Checklist de corrección (en orden de probabilidad)

  • Confirmar en Render que RABBITMQ_HOST, RABBITMQ_PORT, RABBITMQ_USER, RABBITMQ_PASSWORD, RABBITMQ_VHOST apuntan al broker compartido real (mismo host que usamos nosotros: queue.healthgrid.cantero.ar:5672, vhost /), no a los defaults de localhost/guest/guest. Cada módulo se autentica contra RabbitMQ con su propio email de cuenta de servicio del Core — confirmar que el de M7 esté efectivamente provisionado como usuario de RabbitMQ (no hay un usuario compartido entre módulos).
  • Revisar logs de arranque en Render buscando AmqpConnectException, Connection refused o PossibleAuthenticationFailureException repitiéndose en loop — sería la confirmación directa de que el punto anterior es la causa.
  • Confirmar INTEGRACION_M6_EVENTOS_ENABLED y RABBITMQ_ENABLED resuelven a true (o quedan directamente sin setear, ya que ambos defaultean a true). Ojo con variables declaradas en el panel de Render pero dejadas en blanco.
  • Confirmar M6_FACTURACION_EVENT_TYPE_ID sin setear o en exactamente 19. Si hay alguna discrepancia, van a ver el mensaje "Se ignora evento Core no asociado a M6/M7" en sus logs para cada intento nuestro.
  • Confirmar M6_FACTURACION_QUEUE_NAME sin setear o en facturacion.requests, y reconfirmar con el equipo de Core que el binding event_id: 19 → facturacion.requests sigue activo (nosotros no tenemos forma de consultarlo — el Core no expone un GET para listar bindings, solo el POST de alta).
  • Si nada de lo anterior explica el problema, buscar "Payload M6 invalido" / "Payload M6 no es JSON valido" en logs, y si aparece, compartirnos el log completo del lado nuestro (log_id — ver nota abajo) para comparar el payload exacto enviado.
  • Opcional, mejora de observabilidad: PATCH /events/log/{id}/status (Core) permite reportar delivered/failed una vez procesado un mensaje. Hoy onMessage no la llama — sumarla haría que GET /events/log/{id} refleje entrega real en vez de quedar en pending para siempre, útil para diagnosticar futuros casos desde cualquiera de los dos lados sin depender de compartir logs manualmente.

De nuestro lado: a partir de este cambio, cada publicación exitosa a POST /events/log queda logueada con el id (log_id) que devuelve el Core (app/integrations/core_events.py::publish_event) — se lo podemos pasar apenas lo pidan para que lo busquen puntualmente con GET /events/log/{id} si hace falta escalar un caso concreto.