File size: 17,174 Bytes
9f05894 8defa71 9f05894 8defa71 9f05894 a440d33 9f05894 8defa71 a440d33 efe5cdf a440d33 8defa71 a440d33 efe5cdf 9f05894 4a2396c bff144c 2f4ab65 4a2396c 9f05894 a440d33 efe5cdf 8defa71 a440d33 9f05894 efe5cdf 8defa71 2f4ab65 9f05894 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 | # Bus de eventos del Core (M10): cola y eventos de M6
**Health Grid · Módulo 6 (Internación y Gestión de Camas)**
> Referencia completa de la infraestructura de RabbitMQ/eventos que M6 tiene dada de alta en el Core y de cómo se conecta con el código. Para el contrato genérico del bus (cómo crear colas/eventos/bindings, formato del envelope) ver [`integrations/M10_integration.md`](integrations/M10_integration.md). Para el porqué de la migración y su alcance, ver [`M6_DISEÑO.md`](M6_DISEÑO.md) §7.5.
---
## 1. Resumen
M6 recibe notificaciones de M1 (HCE), M9 (Monitoreo) y M2 (Turnos) por dos vías en paralelo durante la transición:
- **REST directo** (`app/routers/webhooks.py`) — el mecanismo original, sigue activo sin cambios.
- **Bus de eventos del Core** (RabbitMQ, configurado y creado vía la API del Core) — el mecanismo nuevo, hacia el que se está migrando.
Del lado saliente (M6 → M1/M9/M7), el código de publicación al bus ya está escrito y conectado, pero **apagado**: no hay tráfico real hasta que cada equipo receptor comparta su `event_type_id`.
Cirugía urgente (`POST /webhooks/hce/cirugia-urgente`) queda fuera de esta migración — sigue siendo solo REST (ver §5).
---
## 2. Infraestructura creada en el Core (real, ya ejecutada)
### 2.1 Cola
| Cola | Tipo | DLQ |
|---|---|---|
| `internacion.requests` | `requests` | `internacion.requests.dlq` |
Creada con:
```http
POST /rabbit/queues
Authorization: Bearer <token cuenta de servicio>
Content-Type: application/json
{ "queue_name": "internacion", "queue_type": "requests" }
```
M6 es un único consumer sobre esta cola; distingue el tipo de mensaje por `event_type_name` del envelope (ver §4), igual que antes distinguía por el path del webhook REST.
### 2.2 Event types entrantes (M1/M9/M2 → M6)
Los 5 eventos que otros módulos usan para mandarle "requests" a M6, todos bindeados a `internacion.requests`:
| `event_type_id` | `name` | Emisor | Reemplaza (REST) | Payload (schema Pydantic) |
|---|---|---|---|---|
| **14** | `internacion.solicitud.creada` | M1 HCE | `POST /webhooks/hce/solicitud` | `SolicitudHceWebhook` |
| **15** | `internacion.alta-medica.registrada` | M1 HCE | `POST /webhooks/hce/alta-medica` | `AltaMedicaWebhook` |
| **16** | `internacion.alerta-emergencia.detectada` | M9 Monitoreo | `POST /webhooks/monitoreo/alerta-emergencia` | `AlertaEmergenciaRequest` |
| **17** | `internacion.alerta-resuelta.notificada` | M9 Monitoreo | `POST /webhooks/monitoreo/alerta-resuelta` | `AlertaResueltaRequest` |
| **18** | `internacion.turno.cancelado` | M2 Turnos | `POST /turnos/{turnoId}/cancelacion` | `CancelacionQuirofanoRequest` + `turno_id` |
Todos `source_module: "internacion"`. Ninguno lleva `correlation_id`/`response_event_id`: son notificaciones fire-and-forget, no esperan respuesta.
**Nota sobre `internacion.turno.cancelado` (id 18):** en el REST equivalente, `turno_id` viaja en el path (`/turnos/{turnoId}/cancelacion`). Como el bus no tiene "path", el payload del evento **debe incluir** `turno_id` explícitamente junto al resto de los campos de `CancelacionQuirofanoRequest` (`motivo`, `tipo_cancelacion`, `timestamp`).
Creados con (uno por fila):
```http
POST /events/types
Authorization: Bearer <token cuenta de servicio>
Content-Type: application/json
{ "name": "internacion.solicitud.creada", "description": "...", "source_module": "internacion" }
```
### 2.3 Bindings
Los 5 event types de arriba están bindeados a `internacion.requests`:
```http
POST /rabbit/bindings
Authorization: Bearer <token cuenta de servicio>
Content-Type: application/json
{ "event_id": 14, "queue_name": "internacion.requests" }
```
(repetido para los ids 15, 16, 17 y 18)
### 2.4 Lo que NO se creó
No hay ninguna cola ni event type mock/placeholder para el lado saliente (§5). Se decidió explícitamente no generar infraestructura ni tráfico contra el Core compartido para simular a M1/M9/M7 — ver `M6_DISEÑO.md` §14.6, punto 32.
---
## 3. Credenciales y conexión
- **API REST del Core** (alta de colas/eventos/bindings, `POST /events/log`): cuenta de servicio de M6, `CORE_SERVICE_EMAIL`/`CORE_SERVICE_PASSWORD` (`.env`). Es la misma cuenta que M6 ya usa para las llamadas salientes a M1/M2/M7/M10 (`app/integrations/core_auth.py::get_service_token`).
- **Broker RabbitMQ** (consumo directo de la cola): **las mismas credenciales** — el email de la cuenta de servicio ya está provisionado como usuario de RabbitMQ (confirmado: `POST /rabbit/queues` y `POST /rabbit/bindings` exigen que el usuario autenticado exista como usuario de RabbitMQ, y ambas llamadas funcionaron).
- **Host/puerto/vhost del broker:** pendiente de conseguir con el equipo de Core — hoy son placeholders (`localhost:5672`, vhost `/`). Sin este dato, el consumer no puede conectar de verdad (ver §6).
---
## 4. Formato de los mensajes
El mensaje que llega por RabbitMQ tiene un envelope externo (lo arma el Core), y adentro un `payload` que viaja **como string JSON**:
```json
{
"event_type_id": 15,
"event_type_name": "internacion.alta-medica.registrada",
"source_module": "internacion",
"publisher_module": "hce",
"log_id": 89,
"payload": "{\"paciente_id\": 999, \"medico_firmante_id\": 1, \"tipo_alta\": \"ALTA_MEDICA\", \"timestamp\": \"2026-07-09T12:00:00Z\"}",
"published_at": "2026-07-10T01:24:06Z"
}
```
El consumer de M6 (§6) parsea primero el envelope, después el `payload` interno, y recién ahí valida contra el schema Pydantic correspondiente.
---
## 5. Qué queda fuera de esta migración
**Cirugía urgente** (`POST /webhooks/hce/cirugia-urgente`) no tiene evento en el bus. El webhook REST devuelve sincrónicamente qué quirófano/reserva se asignó y qué reservas se desplazaron; no existe hoy un canal de respuesta asíncrono equivalente. Migrarla requeriría acordar con M1 un evento de respuesta (`correlation_id` + `response_event_id`, como el patrón `billing`/`appointments` de `M10_integration.md`). Sigue siendo solo REST.
**Los 5 endpoints REST de `app/routers/webhooks.py` (equivalentes a los eventos de §2.2) se mantienen activos sin cambios** mientras dura la transición. No hay fecha de corte: se retiran cuando M1, M9 y M2 confirmen que ya publican por la cola.
---
## 6. Lado entrante: el consumer (`app/integrations/rabbit_consumer.py`)
Cliente async sobre `aio-pika`. Por cada mensaje de `internacion.requests`:
1. Parsea el envelope externo y extrae `event_type_name` y `payload` (como string).
2. Parsea `payload` con `json.loads`.
3. Despacha por `event_type_name` (`dispatch()`) a la **misma función de servicio** que usa el router REST — sin lógica de negocio nueva:
| `event_type_name` | Función de servicio |
|---|---|
| `internacion.solicitud.creada` | `solicitud_service.recibir_solicitud` |
| `internacion.alta-medica.registrada` | `solicitud_service.procesar_alta_medica` |
| `internacion.alerta-emergencia.detectada` | `solicitud_service.procesar_alerta_emergencia` |
| `internacion.alerta-resuelta.notificada` | `solicitud_service.procesar_alerta_resuelta` |
| `internacion.turno.cancelado` | `solicitud_service.cancelar_reserva_por_turno` |
4. Si el procesamiento fue exitoso, hace `ack`. Si el JSON es malformado, el `event_type_name` no está mapeado, o el servicio de negocio lanza una excepción, hace `reject(requeue=False)` — el mensaje cae a `internacion.requests.dlq` en vez de reintentarse en loop.
La deduplicación por id de origen (`solicitud_hce_id`, etc., exigida en `M6_DISEÑO.md` §6) sigue viviendo dentro de esas mismas funciones de servicio — no se reimplementó nada.
**Wiring:** `app/main.py` arranca `rabbit_consumer.run_consumer()` como task de `asyncio` en el `lifespan`, solo si `settings.rabbitmq_consumer_enabled` es `True` (default `False` — ver §3, falta el broker real). Al apagar la app, la task se cancela prolijamente.
**Verificado en vivo (2026-07):** se publicó un evento real contra el id 15 (`POST /events/log`) y se confirmó que `dispatch()` lo procesa de punta a punta: parseo → validación Pydantic → `procesar_alta_medica` → la cama pasa a `EN_LIMPIEZA` → `ack`. Esto prueba la lógica de consumo; falta conectar contra el broker real para que corra en producción.
---
## 7. Lado saliente: el publisher (`app/integrations/core_events.py`)
`publish_event(event_type_id: int | None, payload: dict, publisher_module: str = "internacion") -> bool`:
- Si `event_type_id is None` → **no-op**: loguea a nivel `info` y devuelve `True`, sin ningún request HTTP.
- Si hay un id configurado → `POST /events/log` real contra el Core (`{"event_type_id", "publisher_module", "payload": json.dumps(payload)}`).
Los 4 puntos de notificación saliente de M6 (`M6_DISEÑO.md` §7.2):
| Función | Notificación | Receptor | Config del `event_type_id` | Estado |
|---|---|---|---|---|
| `hce.notify_resultado_solicitud` | `SOLICITUD_RESUELTA` | M1 HCE | `hce_solicitud_resuelta_event_type_id` | **Activo — solo evento, `event_type_id=25`** |
| `monitoreo.notify_alta` | `ALTA_MONITOREO` | M9 Monitoreo | `monitoreo_alta_event_type_id` | **Activo — `event_type_id=26`, confirmado por M9** |
| `monitoreo.notify_baja` | `BAJA_MONITOREO` | M9 Monitoreo | `monitoreo_baja_event_type_id` | **Activo — `event_type_id=27`, confirmado por M9** |
| `facturacion.notify_cama_lista` | `CIERRE_INTERNACION` (`facturacion.internacion.cama-lista.requested`) | M7 Facturación | `facturacion_cama_lista_event_type_id` | **Pausado — `facturacion_cierre_habilitado=false`, no se manda nada (ni evento ni REST)** |
El evento/cola de cada notificación lo crea y comparte el módulo receptor, no M6 (misma
regla que aplica al revés en §2.2). Su payload es distinto entre sí — ver
`app/integrations/facturacion.py::notify_cama_lista` y `M6_DISEÑO.md` §7.2/§14.9 para el
detalle completo del de M7, incluido el bloqueante de `idEpisodioExterno`.
**Corrección 2026-07 — `SOLICITUD_RESUELTA` deja de ser dual-write.** M1 estaba leyendo las
aprobaciones como rechazadas. Se detectó que el REST directo (`POST /hce/solicitudes/{id}/
resultado`) apuntaba a un path que **no existe** en el contrato real de M1 (su OpenAPI expone
`POST /solicitudes-cama/{id}/resolver` con el schema `SolicitudCamaResolver`, que usa el campo
`decision: aceptada|rechazada`, no `resultado: APROBADA|RECHAZADA`). Se deprecó el REST
directo — `hce.notify_resultado_solicitud` ahora publica **solo** el evento del bus. **Pendiente
de confirmar con M1**: si su consumer de eventos usa el mismo vocabulario `decision/aceptada`
en vez de `resultado/APROBADA`, el problema original podría persistir por el bus — no se tocó
el payload del evento en esta corrección, solo se sacó el REST.
**Pausa manual 2026-07 — `CIERRE_INTERNACION` (M7) desactivado.** Nueva setting
`facturacion_cierre_habilitado` (default `false`) corta `notify_cama_lista` antes de armar
cualquier payload — no sale ni evento ni REST a M7 mientras esté en `false`. Reactivar
poniendo la variable en `true` (sin otro cambio de código).
**Corrección 2026-07 (`cama_id` en los eventos de M9):** `ALTA_MONITOREO`/`BAJA_MONITOREO`
ahora llevan también `cama_id` en el payload — M9 lo necesita para saber a qué cama
corresponde el alta/baja de monitoreo. Regla de qué cama va en cada notificación: en un
ingreso, `notify_alta` lleva la cama destino; en un traslado, `notify_baja` lleva la cama
**origen** (la que el paciente deja) y `notify_alta` lleva la cama **destino** (la nueva);
en un alta médica, `notify_baja` lleva la cama que se libera. Ver
`app/integrations/monitoreo.py`.
**Corrección 2026-07 (auditoría contra el contrato real de M7):** una prueba end-to-end
contra el broker real mostró que el evento a M7 nunca salía (`facturacion_cama_lista_event_type_id`
resolvía a `None` en el deploy pese a estar documentado como activo — variable no seteada
realmente en HF, no un bug de código; verificar con `GET /api/v1/_debug/settings`). De paso
se auditó el payload contra `M7_integration.md` y se corrigieron 3 desvíos reales: los
timestamps iban con sufijo `+00:00` en vez de `Z`, `idPacienteExterno` iba como `int` en vez
del `string` que mostraba el ejemplo de la doc, y el payload incluía `camaId`/`camasUtilizadas`
— dos campos que ni `M7_integration.md` ni `M6_DISEÑO.md` §7.2 documentan como parte del
evento acordado (se sacaron, junto con la reconstrucción de tramos vía `auditoria` que solo
existía para alimentarlos).
**Segunda corrección (2026-07, tras acceder al código real de M7):** con el repo de M7
disponible (`documentation/modulo7-impl/`) se confirmó que `InternacionM6Request.idPacienteExterno`
es `Long`, no `String` — el ejemplo de `M7_integration.md` que motivó el cambio anterior
estaba desactualizado respecto al código. Se revirtió `idPacienteExterno` a número JSON en
ambos payloads (evento y REST). El sufijo `Z` no hizo falta revertirlo:
`fechaIngreso`/`fechaAlta`/`timestampEvento` son `OffsetDateTime`, que parsea `Z` y `+00:00`
indistintamente. Diagnóstico completo y checklist de corrección para el equipo de M7 (por qué
el evento sigue sin llegarles pese al `201` del Core) en
`documentation/integrations/M7_debugging_evento_no_recibido.md`.
**Tercera corrección (2026-07): `idEpisodioExterno` deja de ser una constante `None`.**
Ahora sale de `cama.episodio_id` (columna nueva, mismo patrón que `solicitud_hce_id`), como
número entero — consistente con `idPacienteExterno`.
**Cuarta corrección (2026-07): la fuente real de `episodio_id` es la solicitud, no el
alta.** Se pidió originalmente a M1 en `internacion.alta-medica.registrada` (§4.3 de
`M6_INTEGRACION_M1_HCE.md`), asumiendo que M1 lo tenía recién al dar el alta. El dominio
real es otro: **M1 crea el episodio al crear la solicitud**. El campo se movió a
`internacion.solicitud.creada` (requerido para `tipo=INTERNACION`), se persiste en
`Solicitud`, se copia a `cama.episodio_id` al aprobar la internación, se **hereda** de la
cama origen en el traslado (mismo paciente, mismo episodio), y se limpia de la cama que un
paciente abandona —por alta o por traslado— cuando esa cama se libera de verdad. El
webhook de alta médica ya no toca `episodio_id` en absoluto: antes lo pisaba con `None`
justo antes de mandar el evento a M7, que es lo que causaba el `idEpisodioExterno: null`
pese a que el episodio ya estaba cargado. Ver `M6_DISEÑO.md` §14 punto 50 y
`M6_INTEGRACION_M1_HCE.md` §4.3 para el detalle completo.
Pendiente correr en Supabase: `ALTER TABLE solicitudes ADD COLUMN IF NOT EXISTS episodio_id integer;`
(la de `camas` ya está aplicada).
---
## 8. Configuración (`app/config.py` / `.env`)
```bash
# Consumer entrante
RABBITMQ_CONSUMER_ENABLED=false # true cuando se tenga el broker real
RABBITMQ_HOST=localhost # placeholder — pendiente el dato real del broker compartido
RABBITMQ_PORT=5672
RABBITMQ_VHOST=/
INTERNACION_REQUESTS_QUEUE=internacion.requests
# Publisher saliente:
HCE_SOLICITUD_RESUELTA_EVENT_TYPE_ID=25 # solo evento — REST deprecado
MONITOREO_ALTA_EVENT_TYPE_ID=26
MONITOREO_BAJA_EVENT_TYPE_ID=27
FACTURACION_CAMA_LISTA_EVENT_TYPE_ID=19
FACTURACION_CIERRE_HABILITADO=false # pausa manual — M7 no recibe nada mientras esté en false
```
Las credenciales del broker (`login`/`password` en `aio_pika.connect_robust`) son `CORE_SERVICE_EMAIL`/`CORE_SERVICE_PASSWORD`, ya definidas para el resto de la integración con el Core — no hay settings de usuario/password nuevas para RabbitMQ.
---
## 9. Pendientes
- **Host/puerto/vhost reales del broker RabbitMQ compartido** — sin esto, `RABBITMQ_CONSUMER_ENABLED=true` no puede conectar. Único bloqueante para que el consumer corra contra el broker de verdad.
- ~~`event_type_id` de M1 (`SOLICITUD_RESUELTA`)~~ — **resuelto**: M1 confirmó `event_type_id=25`, ya activo.
- ~~`event_type_id` de M9 (`ALTA_MONITOREO`, `BAJA_MONITOREO`)~~ — **resuelto**: M9 confirmó `event_type_id=26`/`27`, ya activos.
- ~~`event_type_id` de M7 (`CAMA_LISTA`)~~ — **resuelto**: M7 confirmó `event_type_id=19`, ya activo.
- **`episodio_id` de M1** — pendiente que M1 agregue este campo a `internacion.solicitud.creada` (requerido para `tipo=INTERNACION`, ya no a `alta-medica` — ver corrección 2026-07 en §7 de este doc). Ver `M6_DISEÑO.md` §14 punto 50 y `documentation/M6_INTEGRACION_M1_HCE.md` §4.3.
- **Coordinar con M1/M9/M2 la migración de sus emisores** hacia los 5 eventos entrantes de §2.2, y una fecha de retiro de los webhooks REST equivalentes una vez confirmada.
- **Cirugía urgente** (§5): decisión pendiente de si migrar a un patrón request/response por eventos, condicionada a acordar el evento de respuesta con M1.
---
## 10. Tests
- `tests/test_rabbit_consumer.py` — despacho por `event_type_name`, manejo de payload malformado, ack/reject.
- `tests/test_core_events.py` — `publish_event` no-op sin id / publica con id; los 4 `notify_*` siguen haciendo el mismo request REST de siempre y además llaman a `publish_event` (hoy inerte).
- `tests/test_webhooks.py` — la vía REST entrante, sin cambios.
|