|
Download documentation/integrations/M7_debugging_evento_no_recibido.md from Modulo-6/api: direct link, hf CLI and curl.
- Browser
- Download file 7.22 kB
-
https://huggingface.co/spaces/Modulo-6/api/resolve/main/documentation/integrations/M7_debugging_evento_no_recibido.md
- Command line
-
hf download hf://spaces/Modulo-6/api/documentation/integrations/M7_debugging_evento_no_recibido.md
-
curl -L -o M7_debugging_evento_no_recibido.md https://huggingface.co/spaces/Modulo-6/api/resolve/main/documentation/integrations/M7_debugging_evento_no_recibido.md
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): | |
| ```java | |
| @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): | |
| ```properties | |
| 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. | |